.. role:: ts-api-decorator

###########
PickHandler
###########

.. js:module:: cee
   :noindex:

.. container:: ts-api-section

   .. js:class:: PickHandler

      Defines the signature of PickHandlers, which are called by the viewer when the user performs a picking action. 

      The picking action is defined as a clean click with the left mouse button or a clean touch.
      In this handler you should determine whether to perform picking on the remote model (using the 
      ``ug.RemoteModel.rayIntersect`` function, by far the most common action) 
      or to perform any other action.

      When the picking is done the callback passed to the rayIntersect() function will be called.
      In this function you can determine what to do with the result. The possibilities include:

      - Highlighting the element
      - Showing picking info in a dialog
      - Adding an annotation
      - Positioning a cutting plane
      - Adding a seed point for a particle trace
      - etc...



