VTK  9.7.1
vtkPointHandleRepresentation3D.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
18 #ifndef vtkPointHandleRepresentation3D_h
19 #define vtkPointHandleRepresentation3D_h
20 
21 #include "vtkCursor3D.h" // Needed for delegation to cursor3D
23 #include "vtkInteractionWidgetsModule.h" // For export macro
24 #include "vtkWrappingHints.h" // For VTK_MARSHALAUTO
25 
26 VTK_ABI_NAMESPACE_BEGIN
27 class vtkCursor3D;
28 class vtkProperty;
29 class vtkActor;
30 class vtkPolyDataMapper;
31 class vtkCellPicker;
32 
33 class VTKINTERACTIONWIDGETS_EXPORT VTK_MARSHALAUTO vtkPointHandleRepresentation3D
35 {
36 public:
41 
43 
47  void PrintSelf(ostream& os, vtkIndent indent) override;
49 
51 
53 
60  void SetWorldPosition(double p[3]) override;
61  void SetDisplayPosition(double p[3]) override;
63 
67  void SetOutline(int o) { this->Cursor3D->SetOutline(o); }
68  int GetOutline() { return this->Cursor3D->GetOutline(); }
69  void OutlineOn() { this->Cursor3D->OutlineOn(); }
70  void OutlineOff() { this->Cursor3D->OutlineOff(); }
71 
75  void SetXShadows(int o) { this->Cursor3D->SetXShadows(o); }
76  int GetXShadows() { return this->Cursor3D->GetXShadows(); }
77  void XShadowsOn() { this->Cursor3D->XShadowsOn(); }
78  void XShadowsOff() { this->Cursor3D->XShadowsOff(); }
79 
83  void SetYShadows(int o) { this->Cursor3D->SetYShadows(o); }
84  int GetYShadows() { return this->Cursor3D->GetYShadows(); }
85  void YShadowsOn() { this->Cursor3D->YShadowsOn(); }
86  void YShadowsOff() { this->Cursor3D->YShadowsOff(); }
87 
91  void SetZShadows(int o) { this->Cursor3D->SetZShadows(o); }
92  int GetZShadows() { return this->Cursor3D->GetZShadows(); }
93  void ZShadowsOn() { this->Cursor3D->ZShadowsOn(); }
94  void ZShadowsOff() { this->Cursor3D->ZShadowsOff(); }
95 
97 
108  void SetTranslationMode(vtkTypeBool mode);
109  vtkGetMacro(TranslationMode, vtkTypeBool);
110  vtkBooleanMacro(TranslationMode, vtkTypeBool);
112 
114 
117  void AllOn()
118  {
119  this->OutlineOn();
120  this->XShadowsOn();
121  this->YShadowsOn();
122  this->ZShadowsOn();
123  }
124  void AllOff()
125  {
126  this->OutlineOff();
127  this->XShadowsOff();
128  this->YShadowsOff();
129  this->ZShadowsOff();
130  }
132 
134 
137  void SetProperty(vtkProperty*);
138  void SetSelectedProperty(vtkProperty*);
139  vtkGetObjectMacro(Property, vtkProperty);
140  vtkGetObjectMacro(SelectedProperty, vtkProperty);
142 
144 
147  void SetInteractionColor(double, double, double);
148  void SetInteractionColor(double c[3]) { this->SetInteractionColor(c[0], c[1], c[2]); }
149  void SetForegroundColor(double, double, double);
150  void SetForegroundColor(double c[3]) { this->SetForegroundColor(c[0], c[1], c[2]); }
152 
154 
160  vtkSetClampMacro(HotSpotSize, double, 0.0, 1.0);
161  vtkGetMacro(HotSpotSize, double);
163 
167  void SetHandleSize(double size) override;
168 
170 
173  double* GetBounds() VTK_SIZEHINT(6) override;
174  void BuildRepresentation() override;
175  void StartWidgetInteraction(double eventPos[2]) override;
176  void WidgetInteraction(double eventPos[2]) override;
177  int ComputeInteractionState(int X, int Y, int modify = 0) override;
178  void PlaceWidget(double bounds[6]) override;
179  void StartComplexInteraction(vtkRenderWindowInteractor* iren, vtkAbstractWidget* widget,
180  unsigned long event, void* calldata) override;
181  void ComplexInteraction(vtkRenderWindowInteractor* iren, vtkAbstractWidget* widget,
182  unsigned long event, void* calldata) override;
183  int ComputeComplexInteractionState(vtkRenderWindowInteractor* iren, vtkAbstractWidget* widget,
184  unsigned long event, void* calldata, int modify = 0) override;
186 
188 
191  void ShallowCopy(vtkProp* prop) override;
192  void DeepCopy(vtkProp* prop) override;
193  void GetActors(vtkPropCollection*) override;
194  void ReleaseGraphicsResources(vtkWindow*) override;
195  int RenderOpaqueGeometry(vtkViewport* viewport) override;
196  int RenderTranslucentPolygonalGeometry(vtkViewport* viewport) override;
197  vtkTypeBool HasTranslucentPolygonalGeometry() override;
199 
200  void Highlight(int highlight) override;
201 
203 
214  vtkSetMacro(SmoothMotion, vtkTypeBool);
215  vtkGetMacro(SmoothMotion, vtkTypeBool);
216  vtkBooleanMacro(SmoothMotion, vtkTypeBool);
218 
219  /*
220  * Register internal Pickers within PickingManager
221  */
222  void RegisterPickers() override;
223 
230  void SetVisibility(vtkTypeBool visible) override;
231 
232 protected:
234  ~vtkPointHandleRepresentation3D() override;
235 
236  // the cursor3D
237  vtkActor* Actor;
239  vtkCursor3D* Cursor3D;
240 
241  // Do the picking
242  vtkCellPicker* CursorPicker;
243  double LastPickPosition[3];
244  double LastEventPosition[3];
245 
246  // Methods to manipulate the cursor
247  int ConstraintAxis;
248  void Translate(const double* p1, const double* p2) override;
249  void Scale(const double* p1, const double* p2, const double eventPos[2]);
250  void MoveFocus(const double* p1, const double* p2);
251  void SizeBounds();
252 
264  void MoveFocusRequest(
265  const double* p1, const double* p2, const double currPos[2], double center[3]);
266 
267  // Properties used to control the appearance of selected objects and
268  // the manipulator in general.
269  vtkProperty* Property;
270  vtkProperty* SelectedProperty;
271  void CreateDefaultProperties();
272 
273  // The size of the hot spot.
274  double HotSpotSize;
275  int DetermineConstraintAxis(int constraint, double* x, double* startPoint);
276  int WaitingForMotion;
277  int WaitCount;
278 
279  // Current handle sized (may reflect scaling)
280  double CurrentHandleSize;
281 
282  // Control how translation works
283  vtkTypeBool TranslationMode;
284 
285  vtkTypeBool SmoothMotion;
286 
287 private:
288  vtkPointHandleRepresentation3D(const vtkPointHandleRepresentation3D&) = delete;
289  void operator=(const vtkPointHandleRepresentation3D&) = delete;
290 };
291 
292 VTK_ABI_NAMESPACE_END
293 #endif
abstract superclass for all actors, volumes and annotations
Definition: vtkProp.h:49
virtual void SetWorldPosition(double pos[3])
Handles usually have their coordinates set in display coordinates (generally by an associated widget)...
represents an object (geometry & properties) in a rendered scene
Definition: vtkActor.h:41
abstract class for representing widget handles
represent the position of a point in 3D space
abstract specification for Viewports
Definition: vtkViewport.h:46
represent surface properties of a geometric object
Definition: vtkProperty.h:59
void AllOn()
Convenience methods to turn outline and shadows on and off.
virtual void SetHandleSize(double)
Set/Get the factor that controls the size of the handles that appear as part of the widget (if any)...
void PrintSelf(ostream &os, vtkIndent indent) override
Standard methods for instances of this class.
void SetYShadows(int o)
Turn on/off the wireframe y-shadows.
void SetInteractionColor(double c[3])
Set the widget color, and the color of interactive handles.
double * GetBounds() override
Methods to make this class behave as a vtkProp.
an ordered list of Props
int vtkTypeBool
Definition: vtkABI.h:64
window superclass for vtkRenderWindow
Definition: vtkWindow.h:41
platform-independent render window interaction including picking and frame rate control.
void SetZShadows(int o)
Turn on/off the wireframe z-shadows.
void SetOutline(int o)
Turn on/off the wireframe bounding box.
virtual void SetDisplayPosition(double pos[2])
Handles usually have their coordinates set in display coordinates (generally by an associated widget)...
a simple class to control print indentation
Definition: vtkIndent.h:28
#define VTK_SIZEHINT(...)
define the API for widget / widget representation
map vtkPolyData to graphics primitives
void AllOff()
Convenience methods to turn outline and shadows on and off.
ray-cast cell picker for all kinds of Prop3Ds
Definition: vtkCellPicker.h:62
#define VTK_MARSHALAUTO
generate a 3D cursor representation
Definition: vtkCursor3D.h:28
static vtkObject * New()
Create an object with Debug turned off, modified time initialized to zero, and reference counting on...
virtual void Translate(const double *p1, const double *p2)
Translates world position by vector p1p2 projected on the constraint axis if any. ...
void SetXShadows(int o)
Turn on/off the wireframe x-shadows.
void SetForegroundColor(double c[3])
Set the widget color, and the color of interactive handles.