superclass for 3D geometric pickers (uses ray cast) More...

#include <vtkPicker.h>

Inheritance diagram for vtkPicker:

Collaboration diagram for vtkPicker:

Public Types
typedef vtkAbstractPropPicker	Superclass
Public Member Functions
virtual int	IsA (const char *type)
vtkPicker *	NewInstance () const
void	PrintSelf (ostream &os, vtkIndent indent)
vtkActorCollection *	GetActors ()

virtual void	SetTolerance (double)
virtual double	GetTolerance ()

virtual double *	GetMapperPosition ()
virtual void	GetMapperPosition (double data[3])

virtual vtkAbstractMapper3D *	GetMapper ()

virtual vtkDataSet *	GetDataSet ()

vtkProp3DCollection *	GetProp3Ds ()

vtkPoints *	GetPickedPositions ()

virtual int	Pick (double selectionX, double selectionY, double selectionZ, vtkRenderer *renderer)

int	Pick (double selectionPt[3], vtkRenderer *ren)
Static Public Member Functions
static vtkPicker *	New ()
static int	IsTypeOf (const char *type)
static vtkPicker *	SafeDownCast (vtkObjectBase *o)
Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const
	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]
vtkAbstractMapper3D *	Mapper
vtkDataSet *	DataSet
double	GlobalTMin
vtkTransform *	Transform
vtkActorCollection *	Actors
vtkProp3DCollection *	Prop3Ds
vtkPoints *	PickedPositions

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 an unsorted list of props that were hit, and a list of the corresponding world points of the hits. For the vtkProp3D that is closest to the camera, vtkPicker returns the pick coordinates in world and untransformed mapper space, the prop itself, the data set, and the mapper. For vtkPicker the closest prop is the one whose center point (i.e., center of bounding box) projected on the view ray is closest to the camera. Subclasses of vtkPicker use other methods for computing the pick point.

See also:: vtkPicker is used for quick geometric picking. If you desire more precise picking of points or cells based on the geometry of any vtkProp3D, use the subclasses vtkPointPicker or vtkCellPicker. For hardware-accelerated picking of any type of vtkProp, use vtkPropPicker or vtkWorldPointPicker.

Events:: vtkCommand::PickEvent vtkCommand::EndPickEvent vtkCommand::StartPickEvent

Tests:: vtkPicker (Tests)

Definition at line 59 of file vtkPicker.h.

Member Typedef Documentation

typedef vtkAbstractPropPicker vtkPicker::Superclass

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, vtkResliceCursorPicker, vtkVolumePicker, and vtkPointPicker.

Definition at line 63 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, vtkResliceCursorPicker, vtkVolumePicker, 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 vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, vtkResliceCursorPicker, vtkVolumePicker, 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 vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, vtkResliceCursorPicker, vtkVolumePicker, and vtkPointPicker.

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

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, vtkResliceCursorPicker, vtkVolumePicker, and vtkPointPicker.

virtual vtkObjectBase* vtkPicker::NewInstanceInternal ( ) const [protected, virtual]

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, vtkResliceCursorPicker, vtkVolumePicker, and vtkPointPicker.

vtkPicker* vtkPicker::NewInstance ( ) const

Reimplemented from vtkAbstractPropPicker.

Reimplemented in vtkCellPicker, vtkResliceCursorPicker, vtkVolumePicker, 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, vtkResliceCursorPicker, vtkVolumePicker, 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 94 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 GetProp3Ds were intersected at. The order of this list will match the order of GetProp3Ds.

Definition at line 107 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.

Reimplemented in vtkCellPicker, and vtkResliceCursorPicker.

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 125 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]`