VTK
vtkImplicitPlaneWidget.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkImplicitPlaneWidget.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 =========================================================================*/
70 #ifndef vtkImplicitPlaneWidget_h
71 #define vtkImplicitPlaneWidget_h
72 
73 #include "vtkInteractionWidgetsModule.h" // For export macro
75 
76 class vtkActor;
77 class vtkPolyDataMapper;
78 class vtkCellPicker;
79 class vtkConeSource;
80 class vtkLineSource;
81 class vtkSphereSource;
82 class vtkTubeFilter;
83 class vtkPlane;
84 class vtkCutter;
85 class vtkProperty;
86 class vtkImageData;
87 class vtkOutlineFilter;
88 class vtkFeatureEdges;
89 class vtkPolyData;
90 class vtkTransform;
91 
92 class VTKINTERACTIONWIDGETS_EXPORT vtkImplicitPlaneWidget : public vtkPolyDataSourceWidget
93 {
94 public:
99 
101  void PrintSelf(ostream& os, vtkIndent indent);
102 
104 
107  virtual void SetEnabled(int);
108  virtual void PlaceWidget(double bounds[6]);
109  void PlaceWidget()
110  {this->Superclass::PlaceWidget();}
111  void PlaceWidget(double xmin, double xmax, double ymin, double ymax,
112  double zmin, double zmax)
113  {this->Superclass::PlaceWidget(xmin,xmax,ymin,ymax,zmin,zmax);}
115 
117 
120  virtual void SetOrigin(double x, double y, double z);
121  virtual void SetOrigin(double x[3]);
122  double* GetOrigin();
123  void GetOrigin(double xyz[3]);
125 
127 
130  void SetNormal(double x, double y, double z);
131  void SetNormal(double x[3]);
132  double* GetNormal();
133  void GetNormal(double xyz[3]);
135 
137 
144  void SetNormalToXAxis(int);
145  vtkGetMacro(NormalToXAxis,int);
146  vtkBooleanMacro(NormalToXAxis,int);
147  void SetNormalToYAxis(int);
148  vtkGetMacro(NormalToYAxis,int);
149  vtkBooleanMacro(NormalToYAxis,int);
150  void SetNormalToZAxis(int);
151  vtkGetMacro(NormalToZAxis,int);
152  vtkBooleanMacro(NormalToZAxis,int);
154 
156 
160  vtkSetMacro(Tubing,int);
161  vtkGetMacro(Tubing,int);
162  vtkBooleanMacro(Tubing,int);
164 
166 
172  void SetDrawPlane(int plane);
173  vtkGetMacro(DrawPlane,int);
174  vtkBooleanMacro(DrawPlane,int);
176 
178 
182  vtkSetMacro(OutlineTranslation,int);
183  vtkGetMacro(OutlineTranslation,int);
184  vtkBooleanMacro(OutlineTranslation,int);
186 
188 
191  vtkSetMacro(OutsideBounds,int);
192  vtkGetMacro(OutsideBounds,int);
193  vtkBooleanMacro(OutsideBounds,int);
195 
197 
200  vtkSetMacro(ScaleEnabled,int);
201  vtkGetMacro(ScaleEnabled,int);
202  vtkBooleanMacro(ScaleEnabled,int);
204 
206 
210  vtkSetMacro(OriginTranslation,int);
211  vtkGetMacro(OriginTranslation,int);
212  vtkBooleanMacro(OriginTranslation,int);
214 
216 
220  vtkSetClampMacro(DiagonalRatio,double,0,2);
221  vtkGetMacro(DiagonalRatio,double);
223 
229 
235 
242  void GetPlane(vtkPlane *plane);
243 
249 
253  virtual void SizeHandles();
254 
256 
259  vtkGetObjectMacro(NormalProperty,vtkProperty);
260  vtkGetObjectMacro(SelectedNormalProperty,vtkProperty);
262 
264 
268  vtkGetObjectMacro(PlaneProperty,vtkProperty);
269  vtkGetObjectMacro(SelectedPlaneProperty,vtkProperty);
271 
273 
276  vtkGetObjectMacro(OutlineProperty,vtkProperty);
277  vtkGetObjectMacro(SelectedOutlineProperty,vtkProperty);
279 
281 
285  vtkGetObjectMacro(EdgesProperty,vtkProperty);
287 
288 protected:
291 
292  // Manage the state of the widget
293  int State;
295  {
296  Start=0,
303  Outside
304  };
305 
306  //handles the events
307  static void ProcessEvents(vtkObject* object, unsigned long event,
308  void* clientdata, void* calldata);
309 
310  // ProcessEvents() dispatches to these methods.
317  void OnMouseMove();
318 
319  // Controlling ivars
324 
325  // The actual plane which is being manipulated
327 
328  // The bounding box is represented by a single voxel image data
333  void HighlightOutline(int highlight);
334  int OutlineTranslation; //whether the outline can be moved
335  int ScaleEnabled; //whether the widget can be scaled
336  int OutsideBounds; //whether the widget can be moved outside input's bounds
337 
338  // The cut plane is produced with a vtkCutter
343  virtual void HighlightPlane(int highlight);
344 
345  // Optional tubes are represented by extracting boundary edges and tubing
350  int Tubing; //control whether tubing is on
351 
352  // Control final length of the arrow:
354 
355  // The + normal cone
359  void HighlightNormal(int highlight);
360 
361  // The + normal line
365 
366  // The - normal cone
370 
371  // The - normal line
375 
376  // The origin positioning handle
380  int OriginTranslation; //whether the origin (sphere) can be moved
381 
382  // Do the picking
384 
385  // Register internal Pickers within PickingManager
386  virtual void RegisterPickers();
387 
388  // Transform the normal (used for rotation)
390 
391  // Methods to manipulate the plane
392  void ConstrainOrigin(double x[3]);
393  void Rotate(int X, int Y, double *p1, double *p2, double *vpn);
394  void TranslatePlane(double *p1, double *p2);
395  void TranslateOutline(double *p1, double *p2);
396  void TranslateOrigin(double *p1, double *p2);
397  void Push(double *p1, double *p2);
398  void Scale(double *p1, double *p2, int X, int Y);
399 
400  // Properties used to control the appearance of selected objects and
401  // the manipulator in general.
410 
412 
413 private:
414  vtkImplicitPlaneWidget(const vtkImplicitPlaneWidget&) VTK_DELETE_FUNCTION;
415  void operator=(const vtkImplicitPlaneWidget&) VTK_DELETE_FUNCTION;
416 };
417 
418 #endif
vtkPolyDataMapper
map vtkPolyData to graphics primitives
Definition: vtkPolyDataMapper.h:43
vtkImplicitPlaneWidget::Scale
void Scale(double *p1, double *p2, int X, int Y)
vtkImplicitPlaneWidget::ConeActor2
vtkActor * ConeActor2
Definition: vtkImplicitPlaneWidget.h:369
vtkImplicitPlaneWidget::Pushing
@ Pushing
Definition: vtkImplicitPlaneWidget.h:301
vtkImplicitPlaneWidget::vtkImplicitPlaneWidget
vtkImplicitPlaneWidget()
vtkPlane
perform various plane computations
Definition: vtkPlane.h:38
vtkImplicitPlaneWidget::SetNormalToYAxis
void SetNormalToYAxis(int)
vtkImplicitPlaneWidget::ConeSource2
vtkConeSource * ConeSource2
Definition: vtkImplicitPlaneWidget.h:367
vtkImplicitPlaneWidget::Rotating
@ Rotating
Definition: vtkImplicitPlaneWidget.h:302
vtkImplicitPlaneWidget::GetPlane
void GetPlane(vtkPlane *plane)
Get the implicit function for the plane.
vtkImplicitPlaneWidget::TranslateOutline
void TranslateOutline(double *p1, double *p2)
vtkImplicitPlaneWidget::SizeHandles
virtual void SizeHandles()
Control widget appearance.
vtkCutter
Cut vtkDataSet with user-specified implicit function.
Definition: vtkCutter.h:70
vtkImplicitPlaneWidget::SetOrigin
virtual void SetOrigin(double x, double y, double z)
Get the origin of the plane.
vtkImplicitPlaneWidget::ConeMapper2
vtkPolyDataMapper * ConeMapper2
Definition: vtkImplicitPlaneWidget.h:368
vtkImplicitPlaneWidget::Plane
vtkPlane * Plane
Definition: vtkImplicitPlaneWidget.h:326
vtkImplicitPlaneWidget::OutlineTranslation
int OutlineTranslation
Definition: vtkImplicitPlaneWidget.h:334
vtkImplicitPlaneWidget::LineSource
vtkLineSource * LineSource
Definition: vtkImplicitPlaneWidget.h:362
vtkImplicitPlaneWidget::SetOrigin
virtual void SetOrigin(double x[3])
vtkImplicitPlaneWidget::GetPolyData
void GetPolyData(vtkPolyData *pd)
Grab the polydata that defines the plane.
vtkImplicitPlaneWidget::LineSource2
vtkLineSource * LineSource2
Definition: vtkImplicitPlaneWidget.h:372
vtkImplicitPlaneWidget::OnRightButtonUp
void OnRightButtonUp()
vtkImplicitPlaneWidget::HighlightPlane
virtual void HighlightPlane(int highlight)
vtkImplicitPlaneWidget::UpdateRepresentation
void UpdateRepresentation()
vtkImplicitPlaneWidget::Edges
vtkFeatureEdges * Edges
Definition: vtkImplicitPlaneWidget.h:346
vtkImplicitPlaneWidget::OnLeftButtonUp
void OnLeftButtonUp()
vtkImplicitPlaneWidget::NormalToYAxis
int NormalToYAxis
Definition: vtkImplicitPlaneWidget.h:321
vtkImplicitPlaneWidget::Picker
vtkCellPicker * Picker
Definition: vtkImplicitPlaneWidget.h:383
vtkConeSource
generate polygonal cone
Definition: vtkConeSource.h:45
vtkImplicitPlaneWidget::GetOrigin
void GetOrigin(double xyz[3])
vtkImplicitPlaneWidget::SphereActor
vtkActor * SphereActor
Definition: vtkImplicitPlaneWidget.h:379
vtkObject
abstract base class for most VTK objects
Definition: vtkObject.h:60
vtkImplicitPlaneWidget::NormalToXAxis
int NormalToXAxis
Definition: vtkImplicitPlaneWidget.h:320
vtkImplicitPlaneWidget::OnRightButtonDown
void OnRightButtonDown()
vtkImplicitPlaneWidget::MovingOutline
@ MovingOutline
Definition: vtkImplicitPlaneWidget.h:298
vtkImplicitPlaneWidget::NormalProperty
vtkProperty * NormalProperty
Definition: vtkImplicitPlaneWidget.h:402
vtkImplicitPlaneWidget::SetDrawPlane
void SetDrawPlane(int plane)
Enable/disable the drawing of the plane.
vtkImplicitPlaneWidget::Transform
vtkTransform * Transform
Definition: vtkImplicitPlaneWidget.h:389
vtkImplicitPlaneWidget::SelectedOutlineProperty
vtkProperty * SelectedOutlineProperty
Definition: vtkImplicitPlaneWidget.h:407
vtkImplicitPlaneWidget::LineMapper
vtkPolyDataMapper * LineMapper
Definition: vtkImplicitPlaneWidget.h:363
vtkImplicitPlaneWidget::Rotate
void Rotate(int X, int Y, double *p1, double *p2, double *vpn)
vtkImplicitPlaneWidget::OnMiddleButtonDown
void OnMiddleButtonDown()
vtkTransform
describes linear transformations via a 4x4 matrix
Definition: vtkTransform.h:61
vtkImplicitPlaneWidget::PrintSelf
void PrintSelf(ostream &os, vtkIndent indent)
Methods invoked by print to print information about the object including superclasses.
vtkImplicitPlaneWidget::LineMapper2
vtkPolyDataMapper * LineMapper2
Definition: vtkImplicitPlaneWidget.h:373
vtkImplicitPlaneWidget::EdgesActor
vtkActor * EdgesActor
Definition: vtkImplicitPlaneWidget.h:349
vtkImplicitPlaneWidget::DiagonalRatio
double DiagonalRatio
Definition: vtkImplicitPlaneWidget.h:353
vtkImplicitPlaneWidget::ConstrainOrigin
void ConstrainOrigin(double x[3])
vtkImplicitPlaneWidget::HighlightOutline
void HighlightOutline(int highlight)
vtkImplicitPlaneWidget::TranslateOrigin
void TranslateOrigin(double *p1, double *p2)
vtkImplicitPlaneWidget::NormalToZAxis
int NormalToZAxis
Definition: vtkImplicitPlaneWidget.h:322
vtkImplicitPlaneWidget::GetPolyDataAlgorithm
vtkPolyDataAlgorithm * GetPolyDataAlgorithm()
Satisfies superclass API.
vtkImplicitPlaneWidget::SetNormal
void SetNormal(double x, double y, double z)
Get the normal to the plane.
vtkImplicitPlaneWidget::ConeActor
vtkActor * ConeActor
Definition: vtkImplicitPlaneWidget.h:358
vtkImplicitPlaneWidget::GetOrigin
double * GetOrigin()
vtkTubeFilter
filter that generates tubes around lines
Definition: vtkTubeFilter.h:84
vtkImplicitPlaneWidget::SetEnabled
virtual void SetEnabled(int)
Methods that satisfy the superclass' API.
vtkImplicitPlaneWidget::SetNormalToXAxis
void SetNormalToXAxis(int)
Force the plane widget to be aligned with one of the x-y-z axes.
vtkImplicitPlaneWidget::SetNormal
void SetNormal(double x[3])
vtkImplicitPlaneWidget::ProcessEvents
static void ProcessEvents(vtkObject *object, unsigned long event, void *clientdata, void *calldata)
vtkImplicitPlaneWidget::CutMapper
vtkPolyDataMapper * CutMapper
Definition: vtkImplicitPlaneWidget.h:340
vtkImplicitPlaneWidget::PlaceWidget
virtual void PlaceWidget(double bounds[6])
We have to redeclare this abstract, PlaceWidget() requires it.
vtkSphereSource
create a polygonal sphere centered at the origin
Definition: vtkSphereSource.h:47
vtkImplicitPlaneWidget::LineActor
vtkActor * LineActor
Definition: vtkImplicitPlaneWidget.h:364
vtkImplicitPlaneWidget::OutlineActor
vtkActor * OutlineActor
Definition: vtkImplicitPlaneWidget.h:332
vtkImplicitPlaneWidget::PlaceWidget
void PlaceWidget(double xmin, double xmax, double ymin, double ymax, double zmin, double zmax)
Definition: vtkImplicitPlaneWidget.h:111
vtkActor
represents an object (geometry & properties) in a rendered scene
Definition: vtkActor.h:52
vtkImplicitPlaneWidget::SphereMapper
vtkPolyDataMapper * SphereMapper
Definition: vtkImplicitPlaneWidget.h:378
vtkImplicitPlaneWidget::HighlightNormal
void HighlightNormal(int highlight)
vtkImageData
topologically and geometrically regular array of data
Definition: vtkImageData.h:46
vtkIndent
a simple class to control print indentation
Definition: vtkIndent.h:40
vtkImplicitPlaneWidget::SetNormalToZAxis
void SetNormalToZAxis(int)
vtkImplicitPlaneWidget::TranslatePlane
void TranslatePlane(double *p1, double *p2)
vtkFeatureEdges
extract boundary, non-manifold, and/or sharp edges from polygonal data
Definition: vtkFeatureEdges.h:53
vtkImplicitPlaneWidget::SelectedPlaneProperty
vtkProperty * SelectedPlaneProperty
Definition: vtkImplicitPlaneWidget.h:405
vtkImplicitPlaneWidget::OnMouseMove
void OnMouseMove()
vtkImplicitPlaneWidget::New
static vtkImplicitPlaneWidget * New()
Instantiate the object.
vtkImplicitPlaneWidget::Box
vtkImageData * Box
Definition: vtkImplicitPlaneWidget.h:329
vtkImplicitPlaneWidget::EdgesTuber
vtkTubeFilter * EdgesTuber
Definition: vtkImplicitPlaneWidget.h:347
vtkLineSource
create a line defined by two end points
Definition: vtkLineSource.h:43
vtkImplicitPlaneWidget::SelectedNormalProperty
vtkProperty * SelectedNormalProperty
Definition: vtkImplicitPlaneWidget.h:403
vtkImplicitPlaneWidget::ConeMapper
vtkPolyDataMapper * ConeMapper
Definition: vtkImplicitPlaneWidget.h:357
vtkBooleanMacro
vtkBooleanMacro(IgnoreDriverBugs, bool)
Updates the extensions string.
vtkSetMacro
vtkSetMacro(IgnoreDriverBugs, bool)
Updates the extensions string.
vtkImplicitPlaneWidget::ScaleEnabled
int ScaleEnabled
Definition: vtkImplicitPlaneWidget.h:335
vtkImplicitPlaneWidget::MovingPlane
@ MovingPlane
Definition: vtkImplicitPlaneWidget.h:297
vtkImplicitPlaneWidget::GetNormal
void GetNormal(double xyz[3])
vtkImplicitPlaneWidget::LineActor2
vtkActor * LineActor2
Definition: vtkImplicitPlaneWidget.h:374
vtkImplicitPlaneWidget::WidgetState
WidgetState
Definition: vtkImplicitPlaneWidget.h:295
vtkImplicitPlaneWidget::MovingOrigin
@ MovingOrigin
Definition: vtkImplicitPlaneWidget.h:299
vtkImplicitPlaneWidget::RegisterPickers
virtual void RegisterPickers()
Register internal Pickers in the Picking Manager.
vtk3DWidget::PlaceWidget
virtual void PlaceWidget()
vtkImplicitPlaneWidget::PlaceWidget
void PlaceWidget()
Overrides vtk3DWidget PlaceWidget() so that it doesn't complain if there's no Input and no Prop3D.
Definition: vtkImplicitPlaneWidget.h:109
vtkImplicitPlaneWidget::Tubing
int Tubing
Definition: vtkImplicitPlaneWidget.h:350
vtkImplicitPlaneWidget
3D widget for manipulating an infinite plane
Definition: vtkImplicitPlaneWidget.h:93
vtkImplicitPlaneWidget::ConeSource
vtkConeSource * ConeSource
Definition: vtkImplicitPlaneWidget.h:356
vtkPolyDataSourceWidget
abstract PolyDataSource-based 3D widget
Definition: vtkPolyDataSourceWidget.h:46
vtkPolyData
concrete dataset represents vertices, lines, polygons, and triangle strips
Definition: vtkPolyData.h:86
vtkOutlineFilter
create wireframe outline for arbitrary data set
Definition: vtkOutlineFilter.h:39
vtkImplicitPlaneWidget::UpdatePlacement
void UpdatePlacement()
Satisfies the superclass API.
vtkImplicitPlaneWidget::EdgesProperty
vtkProperty * EdgesProperty
Definition: vtkImplicitPlaneWidget.h:408
vtkImplicitPlaneWidget::Push
void Push(double *p1, double *p2)
vtkImplicitPlaneWidget::State
int State
Definition: vtkImplicitPlaneWidget.h:293
vtkImplicitPlaneWidget::OnMiddleButtonUp
void OnMiddleButtonUp()
vtkProperty
represent surface properties of a geometric object
Definition: vtkProperty.h:65
vtkImplicitPlaneWidget::GeneratePlane
void GeneratePlane()
vtkImplicitPlaneWidget::PlaneProperty
vtkProperty * PlaneProperty
Definition: vtkImplicitPlaneWidget.h:404
vtkImplicitPlaneWidget::OutlineMapper
vtkPolyDataMapper * OutlineMapper
Definition: vtkImplicitPlaneWidget.h:331
vtkImplicitPlaneWidget::Scaling
@ Scaling
Definition: vtkImplicitPlaneWidget.h:300
vtkImplicitPlaneWidget::Cutter
vtkCutter * Cutter
Definition: vtkImplicitPlaneWidget.h:339
vtkImplicitPlaneWidget::OriginTranslation
int OriginTranslation
Definition: vtkImplicitPlaneWidget.h:380
vtkCellPicker
ray-cast cell picker for all kinds of Prop3Ds
Definition: vtkCellPicker.h:70
vtkImplicitPlaneWidget::OutlineProperty
vtkProperty * OutlineProperty
Definition: vtkImplicitPlaneWidget.h:406
vtkImplicitPlaneWidget::CreateDefaultProperties
void CreateDefaultProperties()
vtkImplicitPlaneWidget::OnLeftButtonDown
void OnLeftButtonDown()
vtkImplicitPlaneWidget::~vtkImplicitPlaneWidget
~vtkImplicitPlaneWidget()
vtkImplicitPlaneWidget::CutActor
vtkActor * CutActor
Definition: vtkImplicitPlaneWidget.h:341
vtkImplicitPlaneWidget::Outline
vtkOutlineFilter * Outline
Definition: vtkImplicitPlaneWidget.h:330
vtkImplicitPlaneWidget::DrawPlane
int DrawPlane
Definition: vtkImplicitPlaneWidget.h:342
vtkImplicitPlaneWidget::OutsideBounds
int OutsideBounds
Definition: vtkImplicitPlaneWidget.h:336
vtkPolyDataSourceWidget.h
vtkImplicitPlaneWidget::Sphere
vtkSphereSource * Sphere
Definition: vtkImplicitPlaneWidget.h:377
vtkImplicitPlaneWidget::GetNormal
double * GetNormal()
vtkImplicitPlaneWidget::EdgesMapper
vtkPolyDataMapper * EdgesMapper
Definition: vtkImplicitPlaneWidget.h:348
vtkPolyDataAlgorithm
Superclass for algorithms that produce only polydata as output.
Definition: vtkPolyDataAlgorithm.h:45