VTK
vtkSplineWidget.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkSplineWidget.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 =========================================================================*/
87 #ifndef vtkSplineWidget_h
88 #define vtkSplineWidget_h
89 
90 #include "vtkInteractionWidgetsModule.h" // For export macro
91 #include "vtk3DWidget.h"
92 
93 class vtkActor;
94 class vtkCellPicker;
97 class vtkPlaneSource;
98 class vtkPoints;
99 class vtkPolyData;
100 class vtkProp;
101 class vtkProperty;
102 class vtkSphereSource;
103 class vtkTransform;
104 
105 #define VTK_PROJECTION_YZ 0
106 #define VTK_PROJECTION_XZ 1
107 #define VTK_PROJECTION_XY 2
108 #define VTK_PROJECTION_OBLIQUE 3
109 
110 class VTKINTERACTIONWIDGETS_EXPORT vtkSplineWidget : public vtk3DWidget
111 {
112 public:
116  static vtkSplineWidget *New();
117 
119  void PrintSelf(ostream& os, vtkIndent indent) override;
120 
122 
125  void SetEnabled(int) override;
126  void PlaceWidget(double bounds[6]) override;
127  void PlaceWidget() override
128  {this->Superclass::PlaceWidget();}
129  void PlaceWidget(double xmin, double xmax, double ymin, double ymax,
130  double zmin, double zmax) override
131  {this->Superclass::PlaceWidget(xmin,xmax,ymin,ymax,zmin,zmax);}
133 
135 
143  vtkSetMacro(ProjectToPlane,vtkTypeBool);
144  vtkGetMacro(ProjectToPlane,vtkTypeBool);
145  vtkBooleanMacro(ProjectToPlane,vtkTypeBool);
147 
152  void SetPlaneSource(vtkPlaneSource* plane);
153 
154  vtkSetClampMacro(ProjectionNormal,int,VTK_PROJECTION_YZ,VTK_PROJECTION_OBLIQUE);
155  vtkGetMacro(ProjectionNormal,int);
157  { this->SetProjectionNormal(0); }
159  { this->SetProjectionNormal(1); }
161  { this->SetProjectionNormal(2); }
163  { this->SetProjectionNormal(3); }
164 
166 
173  void SetProjectionPosition(double position);
174  vtkGetMacro(ProjectionPosition, double);
176 
184  void GetPolyData(vtkPolyData *pd);
185 
187 
191  virtual void SetHandleProperty(vtkProperty*);
192  vtkGetObjectMacro(HandleProperty, vtkProperty);
193  virtual void SetSelectedHandleProperty(vtkProperty*);
194  vtkGetObjectMacro(SelectedHandleProperty, vtkProperty);
196 
198 
202  virtual void SetLineProperty(vtkProperty*);
203  vtkGetObjectMacro(LineProperty, vtkProperty);
204  virtual void SetSelectedLineProperty(vtkProperty*);
205  vtkGetObjectMacro(SelectedLineProperty, vtkProperty);
207 
209 
212  virtual void SetNumberOfHandles(int npts);
213  vtkGetMacro(NumberOfHandles, int);
215 
217 
221  void SetResolution(int resolution);
222  vtkGetMacro(Resolution,int);
224 
226 
234  virtual void SetParametricSpline(vtkParametricSpline*);
235  vtkGetObjectMacro(ParametricSpline,vtkParametricSpline);
237 
239 
243  void SetHandlePosition(int handle, double x, double y, double z);
244  void SetHandlePosition(int handle, double xyz[3]);
245  void GetHandlePosition(int handle, double xyz[3]);
246  double* GetHandlePosition(int handle) VTK_SIZEHINT(3);
248 
250 
257  void SetClosed(vtkTypeBool closed);
258  vtkGetMacro(Closed,vtkTypeBool);
259  vtkBooleanMacro(Closed,vtkTypeBool);
261 
267  int IsClosed();
268 
274  double GetSummedLength();
275 
282  void InitializeHandles(vtkPoints* points);
283 
285 
289  vtkSetClampMacro(ProcessEvents, vtkTypeBool, 0, 1);
290  vtkGetMacro(ProcessEvents, vtkTypeBool);
291  vtkBooleanMacro( ProcessEvents, vtkTypeBool );
293 
294 protected:
295  vtkSplineWidget();
296  ~vtkSplineWidget() override;
297 
298  // Manage the state of the widget
299  int State;
301  {
302  Start=0,
308  Outside
309  };
310 
311  //handles the events
312  static void ProcessEventsHandler(vtkObject* object,
313  unsigned long event,
314  void* clientdata,
315  void* calldata);
316 
317  // ProcessEventsHandler() dispatches to these methods.
318  void OnLeftButtonDown();
319  void OnLeftButtonUp();
320  void OnMiddleButtonDown();
321  void OnMiddleButtonUp();
322  void OnRightButtonDown();
323  void OnRightButtonUp();
324  void OnMouseMove();
325 
326  // Controlling vars
331 
332  // Projection capabilities
333  void ProjectPointsToPlane();
334  void ProjectPointsToOrthoPlane();
335  void ProjectPointsToObliquePlane();
336 
337  // The spline
342  void BuildRepresentation();
343 
344  // The line segments
346  void HighlightLine(int highlight);
348 
349  // Glyphs representing hot spots (e.g., handles)
352  void Initialize();
353  int HighlightHandle(vtkProp *prop); //returns handle index or -1 on fail
354  void SizeHandles() override;
355  void InsertHandleOnLine(double* pos);
356  void EraseHandle(const int&);
357 
358  // Do the picking
363 
364  // Register internal Pickers within PickingManager
365  void RegisterPickers() override;
366 
367  // Methods to manipulate the spline.
368  void MovePoint(double *p1, double *p2);
369  void Scale(double *p1, double *p2, int X, int Y);
370  void Translate(double *p1, double *p2);
371  void Spin(double *p1, double *p2, double *vpn);
372 
373  // Transform the control points (used for spinning)
375 
376  // Properties used to control the appearance of selected objects and
377  // the manipulator in general.
382  void CreateDefaultProperties();
383 
384  // For efficient spinning
385  double Centroid[3];
386  void CalculateCentroid();
388 
389 private:
390  vtkSplineWidget(const vtkSplineWidget&) = delete;
391  void operator=(const vtkSplineWidget&) = delete;
392 };
393 
394 #endif
vtkPoints
represent and manipulate 3D points
Definition: vtkPoints.h:39
vtkSplineWidget::Scaling
Definition: vtkSplineWidget.h:304
vtkSplineWidget::CurrentHandleIndex
int CurrentHandleIndex
Definition: vtkSplineWidget.h:362
vtkSplineWidget::PlaneSource
vtkPlaneSource * PlaneSource
Definition: vtkSplineWidget.h:330
vtkSplineWidget::Inserting
Definition: vtkSplineWidget.h:306
vtkParametricFunctionSource
tessellate parametric functions
Definition: vtkParametricFunctionSource.h:59
vtkSplineWidget::PlaceWidget
void PlaceWidget() override
Definition: vtkSplineWidget.h:127
vtkX3D::resolution
Definition: vtkX3D.h:466
vtkObject::New
static vtkObject * New()
Create an object with Debug turned off, modified time initialized to zero, and reference counting on.
vtkSplineWidget::LinePicker
vtkCellPicker * LinePicker
Definition: vtkSplineWidget.h:360
vtkPlaneSource
create an array of quadrilaterals located in a plane
Definition: vtkPlaneSource.h:60
vtkSplineWidget::SetProjectionNormalToYAxes
void SetProjectionNormalToYAxes()
Definition: vtkSplineWidget.h:158
vtkObject
abstract base class for most VTK objects
Definition: vtkObject.h:59
vtkSplineWidget::ParametricFunctionSource
vtkParametricFunctionSource * ParametricFunctionSource
Definition: vtkSplineWidget.h:339
vtk3DWidget::PrintSelf
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
vtkSplineWidget::Spinning
Definition: vtkSplineWidget.h:305
vtkSplineWidget::WidgetState
WidgetState
Definition: vtkSplineWidget.h:300
vtkSplineWidget::NumberOfHandles
int NumberOfHandles
Definition: vtkSplineWidget.h:340
vtkTransform
describes linear transformations via a 4x4 matrix
Definition: vtkTransform.h:60
vtkSplineWidget::Closed
vtkTypeBool Closed
Definition: vtkSplineWidget.h:341
vtkParametricSpline
parametric function for 1D interpolating splines
Definition: vtkParametricSpline.h:53
vtkSplineWidget::SelectedHandleProperty
vtkProperty * SelectedHandleProperty
Definition: vtkSplineWidget.h:379
vtkX3D::position
Definition: vtkX3D.h:261
vtkX3D::points
Definition: vtkX3D.h:446
VTK_SIZEHINT
#define VTK_SIZEHINT(...)
Definition: vtkWrappingHints.h:42
vtkSplineWidget::Handle
vtkActor ** Handle
Definition: vtkSplineWidget.h:350
vtkSplineWidget::Moving
Definition: vtkSplineWidget.h:303
vtkSplineWidget::LineActor
vtkActor * LineActor
Definition: vtkSplineWidget.h:345
vtkSphereSource
create a polygonal sphere centered at the origin
Definition: vtkSphereSource.h:46
vtkSplineWidget::SelectedLineProperty
vtkProperty * SelectedLineProperty
Definition: vtkSplineWidget.h:381
vtkActor
represents an object (geometry & properties) in a rendered scene
Definition: vtkActor.h:51
vtkInteractorObserver::SetEnabled
virtual void SetEnabled(int)
Methods for turning the interactor observer on and off, and determining its state.
Definition: vtkInteractorObserver.h:73
vtkIndent
a simple class to control print indentation
Definition: vtkIndent.h:39
vtkSplineWidget::Erasing
Definition: vtkSplineWidget.h:307
vtkSplineWidget::ProcessEvents
vtkTypeBool ProcessEvents
Definition: vtkSplineWidget.h:387
vtkSplineWidget::HandleGeometry
vtkSphereSource ** HandleGeometry
Definition: vtkSplineWidget.h:351
vtkSplineWidget::SetProjectionNormalToXAxes
void SetProjectionNormalToXAxes()
Definition: vtkSplineWidget.h:156
vtkSplineWidget::CurrentHandle
vtkActor * CurrentHandle
Definition: vtkSplineWidget.h:361
vtkSplineWidget::HandleProperty
vtkProperty * HandleProperty
Definition: vtkSplineWidget.h:378
vtkSplineWidget::LineProperty
vtkProperty * LineProperty
Definition: vtkSplineWidget.h:380
vtk3DWidget
an abstract superclass for 3D widgets
Definition: vtk3DWidget.h:67
VTK_PROJECTION_OBLIQUE
#define VTK_PROJECTION_OBLIQUE
Definition: vtkSplineWidget.h:108
vtkSplineWidget::HandlePicker
vtkCellPicker * HandlePicker
Definition: vtkSplineWidget.h:359
vtkSplineWidget::ParametricSpline
vtkParametricSpline * ParametricSpline
Definition: vtkSplineWidget.h:338
vtkSplineWidget::State
int State
Definition: vtkSplineWidget.h:299
vtkSplineWidget::SetProjectionNormalToZAxes
void SetProjectionNormalToZAxes()
Definition: vtkSplineWidget.h:160
vtkInteractorObserver::RegisterPickers
virtual void RegisterPickers()
Register internal Pickers in the Picking Manager.
vtkSplineWidget::ProjectToPlane
vtkTypeBool ProjectToPlane
Definition: vtkSplineWidget.h:329
vtkProp
abstract superclass for all actors, volumes and annotations
Definition: vtkProp.h:52
vtkSplineWidget
3D widget for manipulating a spline
Definition: vtkSplineWidget.h:110
vtkSplineWidget::Resolution
int Resolution
Definition: vtkSplineWidget.h:347
vtk3DWidget::SizeHandles
virtual void SizeHandles()
Definition: vtk3DWidget.h:152
vtk3DWidget::PlaceWidget
virtual void PlaceWidget()
vtkSplineWidget::Transform
vtkTransform * Transform
Definition: vtkSplineWidget.h:374
VTK_PROJECTION_YZ
#define VTK_PROJECTION_YZ
Definition: vtkSplineWidget.h:105
vtkPolyData
concrete dataset represents vertices, lines, polygons, and triangle strips
Definition: vtkPolyData.h:85
vtkSplineWidget::SetProjectionNormalToOblique
void SetProjectionNormalToOblique()
Definition: vtkSplineWidget.h:162
vtkSplineWidget::ProjectionPosition
double ProjectionPosition
Definition: vtkSplineWidget.h:328
vtkSplineWidget::PlaceWidget
void PlaceWidget(double xmin, double xmax, double ymin, double ymax, double zmin, double zmax) override
Definition: vtkSplineWidget.h:129
vtk3DWidget.h
vtkProperty
represent surface properties of a geometric object
Definition: vtkProperty.h:66
vtkSplineWidget::ProjectionNormal
int ProjectionNormal
Definition: vtkSplineWidget.h:327
vtkCellPicker
ray-cast cell picker for all kinds of Prop3Ds
Definition: vtkCellPicker.h:69
vtkTypeBool
int vtkTypeBool
Definition: vtkABI.h:69