VTK  9.0.1
vtkPickingManager.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkPickingManager.h
5 
6  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
7  All rights reserved.
8  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
9 
10  This software is distributed WITHOUT ANY WARRANTY; without even
11  the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
12  PURPOSE. See the above copyright notice for more information.
13 
14 =========================================================================*/
15 
16 /*==============================================================================
17 
18  Library: MSVTK
19 
20  Copyright (c) Kitware Inc.
21 
22  Licensed under the Apache License, Version 2.0 (the "License");
23  you may not use this file except in compliance with the License.
24  You may obtain a copy of the License at
25 
26  http://www.apache.org/licenses/LICENSE-2.0.txt
27 
28  Unless required by applicable law or agreed to in writing, software
29  distributed under the License is distributed on an "AS IS" BASIS,
30  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
31  See the License for the specific language governing permissions and
32  limitations under the License.
33 
34 ==============================================================================*/
35 
70 #ifndef vtkPickingManager_h
71 #define vtkPickingManager_h
72 
73 #include "vtkObject.h"
74 #include "vtkRenderingCoreModule.h" // For export macro
75 
76 class vtkAbstractPicker;
78 class vtkAssemblyPath;
79 class vtkRenderer;
81 
82 class VTKRENDERINGCORE_EXPORT vtkPickingManager : public vtkObject
83 {
84 public:
86  vtkTypeMacro(vtkPickingManager, vtkObject);
87  void PrintSelf(ostream& os, vtkIndent indent) override;
88 
90 
95  vtkBooleanMacro(Enabled, bool);
96  vtkSetMacro(Enabled, bool);
97  vtkGetMacro(Enabled, bool);
99 
101 
110  void SetOptimizeOnInteractorEvents(bool optimize);
111  vtkGetMacro(OptimizeOnInteractorEvents, bool);
113 
115 
119  vtkGetMacro(Interactor, vtkRenderWindowInteractor*);
121 
129  void AddPicker(vtkAbstractPicker* picker, vtkObject* object = nullptr);
130 
135  void RemovePicker(vtkAbstractPicker* picker, vtkObject* object = nullptr);
136 
142  void RemoveObject(vtkObject* object);
143 
150  bool Pick(vtkAbstractPicker* picker, vtkObject* object);
151 
157  bool Pick(vtkObject* object);
158 
164  bool Pick(vtkAbstractPicker* picker);
165 
173  vtkAssemblyPath* GetAssemblyPath(double X, double Y, double Z, vtkAbstractPropPicker* picker,
174  vtkRenderer* renderer, vtkObject* obj);
175 
182 
188 
189 protected:
191  ~vtkPickingManager() override;
192 
193  // Used to associate the manager with the interactor
195  bool Enabled;
197 
198 private:
199  vtkPickingManager(const vtkPickingManager&) = delete;
200  void operator=(const vtkPickingManager&) = delete;
201 
202  class vtkInternal;
203  vtkInternal* Internal;
204 };
205 
206 #endif
vtkPickingManager::GetNumberOfPickers
int GetNumberOfPickers()
Return the number of pickers registered.
vtkPickingManager::GetAssemblyPath
vtkAssemblyPath * GetAssemblyPath(double X, double Y, double Z, vtkAbstractPropPicker *picker, vtkRenderer *renderer, vtkObject *obj)
If the picking manager is enabled, it runs the picking selection process and return the assembly path...
vtkPickingManager::Enabled
bool Enabled
Definition: vtkPickingManager.h:195
vtkPickingManager::SetOptimizeOnInteractorEvents
void SetOptimizeOnInteractorEvents(bool optimize)
Enable/Disable optimization depending on the renderWindowInteractor events.
vtkPickingManager::Pick
bool Pick(vtkAbstractPicker *picker, vtkObject *object)
Run the picking selection process and return true if the object is associated with the given picker i...
vtkPickingManager::vtkPickingManager
vtkPickingManager()
vtkPickingManager::RemoveObject
void RemoveObject(vtkObject *object)
Remove all occurrence of the object from the registered list.
vtkObject
abstract base class for most VTK objects
Definition: vtkObject.h:54
vtkAbstractPicker
define API for picking subclasses
Definition: vtkAbstractPicker.h:69
vtkAssemblyPath
a list of nodes that form an assembly path
Definition: vtkAssemblyPath.h:42
vtkPickingManager::AddPicker
void AddPicker(vtkAbstractPicker *picker, vtkObject *object=nullptr)
Register a picker into the picking manager.
vtkPickingManager::SetInteractor
void SetInteractor(vtkRenderWindowInteractor *iren)
Set the window interactor associated with the manager.
vtkPickingManager::OptimizeOnInteractorEvents
bool OptimizeOnInteractorEvents
Definition: vtkPickingManager.h:196
vtkIndent
a simple class to control print indentation
Definition: vtkIndent.h:34
vtkPickingManager::Pick
bool Pick(vtkAbstractPicker *picker)
Run the picking selection process and return if picker is the one selected.
vtkRenderWindowInteractor
platform-independent render window interaction including picking and frame rate control.
Definition: vtkRenderWindowInteractor.h:74
vtkPickingManager::New
static vtkPickingManager * New()
vtkPickingManager::Interactor
vtkRenderWindowInteractor * Interactor
Definition: vtkPickingManager.h:194
vtkAbstractPropPicker
abstract API for pickers that can pick an instance of vtkProp
Definition: vtkAbstractPropPicker.h:80
vtkObject.h
vtkPickingManager::Pick
bool Pick(vtkObject *object)
Run the picking selection process and return true if the object is associated with the best picker.
vtkPickingManager::PrintSelf
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
vtkRenderer
abstract specification for renderers
Definition: vtkRenderer.h:59
vtkPickingManager::~vtkPickingManager
~vtkPickingManager() override
vtkPickingManager::RemovePicker
void RemovePicker(vtkAbstractPicker *picker, vtkObject *object=nullptr)
Unregister the picker from the picking manager.
vtkPickingManager::GetNumberOfObjectsLinked
int GetNumberOfObjectsLinked(vtkAbstractPicker *picker)
Return the number of objects linked with a given picker.
vtkPickingManager
Class defines API to manage the picking process.
Definition: vtkPickingManager.h:83