VTK
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes
vtkPickingManager Class Reference

#include <vtkPickingManager.h>

Inheritance diagram for vtkPickingManager:
Inheritance graph
[legend]
Collaboration diagram for vtkPickingManager:
Collaboration graph
[legend]

List of all members.

Public Types

typedef vtkObject Superclass

Public Member Functions

virtual int IsA (const char *type)
vtkPickingManagerNewInstance () const
void PrintSelf (ostream &os, vtkIndent indent)
void AddPicker (vtkAbstractPicker *picker, vtkObject *object=0)
void RemovePicker (vtkAbstractPicker *picker, vtkObject *object=0)
void RemoveObject (vtkObject *object)
bool Pick (vtkAbstractPicker *picker, vtkObject *object)
bool Pick (vtkObject *object)
bool Pick (vtkAbstractPicker *picker)
int GetNumberOfPickers ()
int GetNumberOfObjectsLinked (vtkAbstractPicker *picker)
virtual void EnabledOn ()
virtual void EnabledOff ()
virtual void SetEnabled (bool)
virtual bool GetEnabled ()
void SetOptimizeOnInteractorEvents (bool optimize)
virtual bool GetOptimizeOnInteractorEvents ()
void SetInteractor (vtkRenderWindowInteractor *iren)
virtual vtkRenderWindowInteractorGetInteractor ()
vtkAssemblyPathGetAssemblyPath (double X, double Y, double Z, vtkAbstractPropPicker *picker, vtkRenderer *renderer, vtkObject *obj)

Static Public Member Functions

static vtkPickingManagerNew ()
static int IsTypeOf (const char *type)
static vtkPickingManagerSafeDownCast (vtkObjectBase *o)

Protected Member Functions

virtual vtkObjectBaseNewInstanceInternal () const
 vtkPickingManager ()
 ~vtkPickingManager ()

Protected Attributes

vtkRenderWindowInteractorInteractor
bool Enabled
bool OptimizeOnInteractorEvents

Detailed Description

Class defines API to manage the picking process.

The Picking Manager (PM) coordinates picking across widgets simultaneously. It maintains a collection of registered pickers; when the manager is picked (e.g. vtkPickingManager::Pick()), a pick is run on each picker but only the best picker (e.g. closest to camera point) is selected. It finally returns the widget/representation or picker that was selected.

Warning:
Every time a vtkWidget and/or a vtkWidgetRepresentation is instantiated, it automatically registers its picker(s) and start being managed by delegating all its pick calls to the picking manager. It is possible to customize with the management in two ways: at the widget level, the “ManagesPicking” variable can be changed from the widget/representation class to tell whether to use the manager or not. Directly disable the picking manager itself with the boolean variable
See also:
Enabled using vtkPickingManager::EnabledOn(), EnabledOff(), SetEnabled(bool).
Important:
The picking manager is not active by default as it slightly reduces the performances when interacting with the scene.
Important:
When registering pickers, a null object is considered valid because we can managed picker without any associated object. It is really important to note that a null object is different from one to an other !! This has been done to allow adding multiple times the same picker to the manager by not passing the referenced object to not force the supression of all pickers
Tests:
vtkPickingManager (Tests)

Definition at line 84 of file vtkPickingManager.h.


Member Typedef Documentation

Reimplemented from vtkObject.

Definition at line 88 of file vtkPickingManager.h.


Constructor & Destructor Documentation


Member Function Documentation

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

Reimplemented from vtkObject.

static int vtkPickingManager::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 vtkObject.

virtual int vtkPickingManager::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 vtkObject.

Reimplemented from vtkObject.

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

Reimplemented from vtkObject.

Reimplemented from vtkObject.

void vtkPickingManager::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 vtkObject.

virtual void vtkPickingManager::EnabledOn ( ) [virtual]

Enable/Disable management. When disabled, it redirects every pick on the picker. By default the picking manager is disabled when initialized.

virtual void vtkPickingManager::EnabledOff ( ) [virtual]

Enable/Disable management. When disabled, it redirects every pick on the picker. By default the picking manager is disabled when initialized.

virtual void vtkPickingManager::SetEnabled ( bool  ) [virtual]

Enable/Disable management. When disabled, it redirects every pick on the picker. By default the picking manager is disabled when initialized.

virtual bool vtkPickingManager::GetEnabled ( ) [virtual]

Enable/Disable management. When disabled, it redirects every pick on the picker. By default the picking manager is disabled when initialized.

Enable/Disable optimization depending on the renderWindowInteractor events. The mechanism keeps in cache the last selected picker as well as the last render time to recompute the selection only if a new render event occurred after the last selection; otherwise, it simply returns the last picker selected. By default pickingManagers does use the optimization. Warning: Turning off the caching significantly decreases performance.

Enable/Disable optimization depending on the renderWindowInteractor events. The mechanism keeps in cache the last selected picker as well as the last render time to recompute the selection only if a new render event occurred after the last selection; otherwise, it simply returns the last picker selected. By default pickingManagers does use the optimization. Warning: Turning off the caching significantly decreases performance.

Set the window interactor associated with the manager.

Set the window interactor associated with the manager.

void vtkPickingManager::AddPicker ( vtkAbstractPicker picker,
vtkObject object = 0 
)

Register a picker into the picking manager. It can be internally associated (optional) with an object. This allows the removal of all the pickers of the given object. Note that a picker can be registered multiple times with different objects.

See also:
RemovePicker(), RemoveObject().
void vtkPickingManager::RemovePicker ( vtkAbstractPicker picker,
vtkObject object = 0 
)

Unregister the picker from the picking manager. If object is non null, only the pair (picker, object) is removed.

Remove all occurences of the object from the registered list. If a picker associated with the object is not also associated with any other object, it is removed from the list as well.

bool vtkPickingManager::Pick ( vtkAbstractPicker picker,
vtkObject object 
)

Run the picking selection process and return true if the object is associated with the given picker if it is the best one, false otherwise. If OptimizeOnInteractorEvents is true, the pick can reuse cached information.

bool vtkPickingManager::Pick ( vtkObject object)

Run the picking selection process and return true if the object is associated with the best picker. This is an overloaded function.

Run the picking selection process and return if picker is the one selected. This is an overloaded function.

If the picking manager is enabled, it runs the picking selection process and return the assembly path associated to the picker passed as argument if it is the one mediated. Otherwise it simply proceeds to a pick using the given renderer and returns the corresponding assembly path.

Return the number of pickers registered. If the same picker is added multiple times with different objects, it is counted once.

Return the number of objects linked with a given picker. Note: a null object is counted as an associated object.


Member Data Documentation

Definition at line 173 of file vtkPickingManager.h.

bool vtkPickingManager::Enabled [protected]

Definition at line 174 of file vtkPickingManager.h.

Definition at line 175 of file vtkPickingManager.h.


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