VTK  9.0.3
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
define API for picking subclasses
abstract API for pickers that can pick an instance of vtkProp
a list of nodes that form an assembly path
a simple class to control print indentation
Definition: vtkIndent.h:34
abstract base class for most VTK objects
Definition: vtkObject.h:63
Class defines API to manage the picking process.
vtkRenderWindowInteractor * Interactor
bool Pick(vtkAbstractPicker *picker)
Run the picking selection process and return if picker is the one selected.
void AddPicker(vtkAbstractPicker *picker, vtkObject *object=nullptr)
Register a picker into the picking manager.
void RemoveObject(vtkObject *object)
Remove all occurrence of the object from the registered list.
bool Pick(vtkAbstractPicker *picker, vtkObject *object)
Run the picking selection process and return true if the object is associated with the given picker i...
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
static vtkPickingManager * New()
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...
void RemovePicker(vtkAbstractPicker *picker, vtkObject *object=nullptr)
Unregister the picker from the picking manager.
bool Pick(vtkObject *object)
Run the picking selection process and return true if the object is associated with the best picker.
int GetNumberOfObjectsLinked(vtkAbstractPicker *picker)
Return the number of objects linked with a given picker.
void SetInteractor(vtkRenderWindowInteractor *iren)
Set the window interactor associated with the manager.
~vtkPickingManager() override
int GetNumberOfPickers()
Return the number of pickers registered.
void SetOptimizeOnInteractorEvents(bool optimize)
Enable/Disable optimization depending on the renderWindowInteractor events.
platform-independent render window interaction including picking and frame rate control.
abstract specification for renderers
Definition: vtkRenderer.h:68