vtkPicker Class Reference

#include <vtkPicker.h>

Inheritance diagram for vtkPicker:

Inheritance graph
[legend]
Collaboration diagram for vtkPicker:

Collaboration graph
[legend]

List of all members.


Detailed Description

superclass for 3D geometric pickers (uses ray cast)

vtkPicker is used to select instances of vtkProp3D by shooting a ray into a graphics window and intersecting with the actor's bounding box. The ray is defined from a point defined in window (or pixel) coordinates, and a point located from the camera's position.

vtkPicker may return more than one vtkProp3D, since more than one bounding box may be intersected. vtkPicker returns the list of props that were hit, the pick coordinates in world and untransformed mapper space, and the prop (vtkProp3D) and mapper that are "closest" to the camera. The closest prop is the one whose center point (i.e., center of bounding box) projected on the ray is closest to the camera.

See also:
vtkPicker is used for quick geometric picking. If you desire to pick points or cells, use the subclass vtkPointPicker or vtkCellPicker, respectively. Or you may use hardware picking to pick any type of vtkProp
Events:
vtkCommand::PickEvent vtkCommand::EndPickEvent vtkCommand::StartPickEvent

Definition at line 52 of file vtkPicker.h.


Public Types

typedef vtkAbstractPropPicker Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
vtkProp3DCollectionGetProp3Ds ()
vtkActorCollectionGetActors ()
vtkPointsGetPickedPositions ()
virtual void SetTolerance (double)
virtual double GetTolerance ()
virtual double * GetMapperPosition ()
virtual void GetMapperPosition (double data[3])
virtual vtkAbstractMapper3DGetMapper ()
virtual vtkDataSetGetDataSet ()
virtual int Pick (double selectionX, double selectionY, double selectionZ, vtkRenderer *renderer)
int Pick (double selectionPt[3], vtkRenderer *ren)

Static Public Member Functions

static vtkPickerNew ()
static int IsTypeOf (const char *type)
static vtkPickerSafeDownCast (vtkObject *o)

Protected Member Functions

 vtkPicker ()
 ~vtkPicker ()
void MarkPicked (vtkAssemblyPath *path, vtkProp3D *p, vtkAbstractMapper3D *m, double tMin, double mapperPos[3])
virtual double IntersectWithLine (double p1[3], double p2[3], double tol, vtkAssemblyPath *path, vtkProp3D *p, vtkAbstractMapper3D *m)
virtual void Initialize ()

Protected Attributes

double Tolerance
double MapperPosition [3]
vtkAbstractMapper3DMapper
vtkDataSetDataSet
double GlobalTMin
vtkTransformTransform
vtkActorCollectionActors
vtkProp3DCollectionProp3Ds
vtkPointsPickedPositions

Member Typedef Documentation

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, and vtkPointPicker.

Definition at line 56 of file vtkPicker.h.


Constructor & Destructor Documentation

vtkPicker::vtkPicker (  )  [protected]

vtkPicker::~vtkPicker (  )  [protected]


Member Function Documentation

static vtkPicker* vtkPicker::New (  )  [static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkObject.

Reimplemented in vtkCellPicker, and vtkPointPicker.

virtual const char* vtkPicker::GetClassName (  )  [virtual]

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, and vtkPointPicker.

static int vtkPicker::IsTypeOf ( const char *  name  )  [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, and vtkPointPicker.

virtual int vtkPicker::IsA ( const char *  name  )  [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, and vtkPointPicker.

static vtkPicker* vtkPicker::SafeDownCast ( vtkObject o  )  [static]

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, and vtkPointPicker.

void vtkPicker::PrintSelf ( ostream &  os,
vtkIndent  indent 
) [virtual]

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, and vtkPointPicker.

virtual void vtkPicker::SetTolerance ( double   )  [virtual]

Specify tolerance for performing pick operation. Tolerance is specified as fraction of rendering window size. (Rendering window size is measured across diagonal.)

virtual double vtkPicker::GetTolerance (  )  [virtual]

Specify tolerance for performing pick operation. Tolerance is specified as fraction of rendering window size. (Rendering window size is measured across diagonal.)

virtual double* vtkPicker::GetMapperPosition (  )  [virtual]

Return position in mapper (i.e., non-transformed) coordinates of pick point.

virtual void vtkPicker::GetMapperPosition ( double  data[3]  )  [virtual]

Return position in mapper (i.e., non-transformed) coordinates of pick point.

virtual vtkAbstractMapper3D* vtkPicker::GetMapper (  )  [virtual]

Return mapper that was picked (if any).

virtual vtkDataSet* vtkPicker::GetDataSet (  )  [virtual]

Get a pointer to the dataset that was picked (if any). If nothing was picked then NULL is returned.

vtkProp3DCollection* vtkPicker::GetProp3Ds (  )  [inline]

Return a collection of all the prop 3D's that were intersected by the pick ray. This collection is not sorted.

Definition at line 86 of file vtkPicker.h.

vtkActorCollection* vtkPicker::GetActors (  ) 

Return a collection of all the actors that were intersected. This collection is not sorted. (This is a convenience method to maintain backward compatibility.)

vtkPoints* vtkPicker::GetPickedPositions (  )  [inline]

Return a list of the points the the actors returned by GetActors were intersected at. The order of this list will match the order of GetActors.

Definition at line 96 of file vtkPicker.h.

virtual int vtkPicker::Pick ( double  selectionX,
double  selectionY,
double  selectionZ,
vtkRenderer renderer 
) [virtual]

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.

Implements vtkAbstractPicker.

int vtkPicker::Pick ( double  selectionPt[3],
vtkRenderer ren 
) [inline]

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.

Reimplemented from vtkAbstractPicker.

Definition at line 112 of file vtkPicker.h.

void vtkPicker::MarkPicked ( vtkAssemblyPath path,
vtkProp3D p,
vtkAbstractMapper3D m,
double  tMin,
double  mapperPos[3] 
) [protected]

virtual double vtkPicker::IntersectWithLine ( double  p1[3],
double  p2[3],
double  tol,
vtkAssemblyPath path,
vtkProp3D p,
vtkAbstractMapper3D m 
) [protected, virtual]

Reimplemented in vtkCellPicker, and vtkPointPicker.

virtual void vtkPicker::Initialize (  )  [protected, virtual]

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, and vtkPointPicker.


Member Data Documentation

double vtkPicker::Tolerance [protected]

Definition at line 127 of file vtkPicker.h.

double vtkPicker::MapperPosition[3] [protected]

Definition at line 128 of file vtkPicker.h.

Definition at line 130 of file vtkPicker.h.

Definition at line 131 of file vtkPicker.h.

double vtkPicker::GlobalTMin [protected]

Definition at line 133 of file vtkPicker.h.

Definition at line 134 of file vtkPicker.h.

Definition at line 135 of file vtkPicker.h.

Definition at line 136 of file vtkPicker.h.

Definition at line 137 of file vtkPicker.h.


The documentation for this class was generated from the following file:

Generated on Wed Jun 3 19:23:49 2009 for VTK by  doxygen 1.5.6