Section: Visualization Toolkit Rendering Classes
The API to this class is to invoke the Pick() method with a selection point (in display coordinates - pixels) and a renderer. Then get the resulting pick position in global coordinates with the GetPickPosition() method.
vtkPicker fires events during the picking process. These events are StartPickEvent, PickEvent, and EndPickEvent which are invoked prior to picking, when something is picked, and after all picking candidates have been tested. Note that during the pick process the PickEvent of vtkProp (and its subclasses such as vtkActor) is fired prior to the PickEvent of vtkPicker.
To create an instance of class vtkAbstractPicker, simply invoke its constructor as follows
obj = vtkAbstractPicker
obj
is an instance of the vtkAbstractPicker class.
string = obj.GetClassName ()
int = obj.IsA (string name)
vtkAbstractPicker = obj.NewInstance ()
vtkAbstractPicker = obj.SafeDownCast (vtkObject o)
vtkRenderer = obj.GetRenderer ()
- Get the renderer in which pick event occurred.
double = obj. GetSelectionPoint ()
- Get the selection point in screen (pixel) coordinates. The third
value is related to z-buffer depth. (Normally should be =0.)
double = obj. GetPickPosition ()
- Return position in global coordinates of pick point.
int = obj.Pick (double selectionX, double selectionY, double selectionZ, vtkRenderer renderer)
- Perform pick operation with selection point provided. Normally the
first two values for the selection point are x-y pixel coordinate, and
the third value is =0. Return non-zero if something was successfully
picked.
int = obj.Pick (double selectionPt[3], vtkRenderer ren)
- provided. Normally the first two values for the selection point
are x-y pixel coordinate, and the third value is =0. Return
non-zero if something was successfully picked.
obj.SetPickFromList (int )
- Use these methods to control whether to limit the picking to this list
(rather than renderer's actors). Make sure that the pick list contains
actors that referred to by the picker's renderer.
int = obj.GetPickFromList ()
- Use these methods to control whether to limit the picking to this list
(rather than renderer's actors). Make sure that the pick list contains
actors that referred to by the picker's renderer.
obj.PickFromListOn ()
- Use these methods to control whether to limit the picking to this list
(rather than renderer's actors). Make sure that the pick list contains
actors that referred to by the picker's renderer.
obj.PickFromListOff ()
- Use these methods to control whether to limit the picking to this list
(rather than renderer's actors). Make sure that the pick list contains
actors that referred to by the picker's renderer.
obj.InitializePickList ()
- Initialize list of actors in pick list.
obj.AddPickList (vtkProp )
- Add an actor to the pick list.
obj.DeletePickList (vtkProp )
- Delete an actor from the pick list.
vtkPropCollection = obj.GetPickList ()