VTK  9.5.20250807
vtkAbstractPicker.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2// SPDX-License-Identifier: BSD-3-Clause
75#ifndef vtkAbstractPicker_h
76#define vtkAbstractPicker_h
77
78#include "vtkObject.h"
79#include "vtkRenderingCoreModule.h" // For export macro
80#include "vtkWrappingHints.h" // For VTK_MARSHALAUTO
81
82VTK_ABI_NAMESPACE_BEGIN
83class vtkRenderer;
84class vtkProp;
86
87class VTKRENDERINGCORE_EXPORT VTK_MARSHALAUTO vtkAbstractPicker : public vtkObject
88{
89public:
91 void PrintSelf(ostream& os, vtkIndent indent) override;
92
94
97 vtkGetObjectMacro(Renderer, vtkRenderer);
99
101
105 vtkGetVectorMacro(SelectionPoint, double, 3);
107
109
112 vtkGetVectorMacro(PickPosition, double, 3);
114
121 virtual int Pick(
122 double selectionX, double selectionY, double selectionZ, vtkRenderer* renderer) = 0;
123
129 int Pick(double selectionPt[3], vtkRenderer* ren)
130 {
131 return this->Pick(selectionPt[0], selectionPt[1], selectionPt[2], ren);
132 }
133
139 virtual int Pick3DPoint(double /* selectionPt */[3], vtkRenderer* /*ren*/)
140 {
141 vtkErrorMacro("Pick3DPoint called without implementation");
142 return 0;
143 }
144
150 virtual int Pick3DRay(double /* selectionPt */[3], double /* orient */[4], vtkRenderer* /*ren*/)
151 {
152 vtkErrorMacro("Pick3DRay called without implementation");
153 return 0;
154 }
155
157
162 vtkSetMacro(PickFromList, vtkTypeBool);
163 vtkGetMacro(PickFromList, vtkTypeBool);
164 vtkBooleanMacro(PickFromList, vtkTypeBool);
166
171
176
181
185 vtkPropCollection* GetPickList() { return this->PickList; }
186
187protected:
190
191 virtual void Initialize();
192
193 vtkRenderer* Renderer; // pick occurred in this renderer's viewport
194 double SelectionPoint[3]; // selection point in window (pixel) coordinates
195 double PickPosition[3]; // selection point in world coordinates
196
197 // use the following to control picking from a list
200
201private:
202 vtkAbstractPicker(const vtkAbstractPicker&) = delete;
203 void operator=(const vtkAbstractPicker&) = delete;
204};
205
206VTK_ABI_NAMESPACE_END
207#endif
define API for picking subclasses
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
virtual int Pick(double selectionX, double selectionY, double selectionZ, vtkRenderer *renderer)=0
Perform pick operation with selection point provided.
vtkPropCollection * GetPickList()
Return the list of actors in the PickList.
virtual void Initialize()
virtual int Pick3DRay(double[3], double[4], vtkRenderer *)
Perform pick operation with selection point and orientation provided.
void DeletePickList(vtkProp *)
Delete an actor from the pick list.
~vtkAbstractPicker() override
void AddPickList(vtkProp *)
Add an actor to the pick list.
void InitializePickList()
Initialize list of actors in pick list.
virtual int Pick3DPoint(double[3], vtkRenderer *)
Perform pick operation with selection point provided.
int Pick(double selectionPt[3], vtkRenderer *ren)
provided.
vtkPropCollection * PickList
a simple class to control print indentation
Definition vtkIndent.h:108
abstract base class for most VTK objects
Definition vtkObject.h:162
an ordered list of Props
abstract superclass for all actors, volumes and annotations
Definition vtkProp.h:69
abstract specification for renderers
int vtkTypeBool
Definition vtkABI.h:64
#define VTK_MARSHALAUTO