3D widget for manipulating a spline More...
#include <vtkSplineWidget.h>
Detailed Description
3D widget for manipulating a spline
This 3D widget defines a spline that can be interactively placed in a scene. The spline has handles, the number of which can be changed, plus it can be picked on the spline itself to translate or rotate it in the scene. A nice feature of the object is that the vtkSplineWidget, like any 3D widget, will work with the current interactor style. That is, if vtkSplineWidget does not handle an event, then all other registered observers (including the interactor style) have an opportunity to process the event. Otherwise, the vtkSplineWidget will terminate the processing of the event that it handles.
To use this object, just invoke SetInteractor() with the argument of the method a vtkRenderWindowInteractor. You may also wish to invoke "PlaceWidget()" to initially position the widget. The interactor will act normally until the "i" key (for "interactor") is pressed, at which point the vtkSplineWidget will appear. (See superclass documentation for information about changing this behavior.) Events that occur outside of the widget (i.e., no part of the widget is picked) are propagated to any other registered obsevers (such as the interaction style). Turn off the widget by pressing the "i" key again (or invoke the Off() method).
The button actions and key modifiers are as follows for controlling the widget: 1) left button down on and drag one of the spherical handles to change the shape of the spline: the handles act as "control points". 2) left button or middle button down on a line segment forming the spline allows uniform translation of the widget. 3) ctrl + middle button down on the widget enables spinning of the widget about its center. 4) right button down on the widget enables scaling of the widget. By moving the mouse "up" the render window the spline will be made bigger; by moving "down" the render window the widget will be made smaller. 5) ctrl key + right button down on any handle will erase it providing there will be two or more points remaining to form a spline. 6) shift key + right button down on any line segment will insert a handle onto the spline at the cursor position.
The vtkSplineWidget has several methods that can be used in conjunction with other VTK objects. The Set/GetResolution() methods control the number of subdivisions of the spline; the GetPolyData() method can be used to get the polygonal representation and can be used for things like seeding streamlines or probing other data sets. Typical usage of the widget is to make use of the StartInteractionEvent, InteractionEvent, and EndInteractionEvent events. The InteractionEvent is called on mouse motion; the other two events are called on button down and button up (either left or right button).
Some additional features of this class include the ability to control the properties of the widget. You can set the properties of the selected and unselected representations of the spline. For example, you can set the property for the handles and spline. In addition there are methods to constrain the spline so that it is aligned with a plane. Note that a simple ruler widget can be derived by setting the resolution to 1, the number of handles to 2, and calling the GetSummedLength method!
- Thanks:
- Thanks to Dean Inglis for developing and contributing this class.
- See also:
- vtk3DWidget vtkBoxWidget vtkLineWidget vtkPointWidget vtkSphereWidget vtkImagePlaneWidget vtkImplicitPlaneWidget vtkPlaneWidget
- Events:
- vtkCommand::DisableEvent vtkCommand::EndInteractionEvent vtkCommand::InteractionEvent vtkCommand::StartInteractionEvent vtkCommand::EnableEvent
- Examples:
- vtkSplineWidget (Examples)
- Tests:
- vtkSplineWidget (Tests)
Definition at line 112 of file vtkSplineWidget.h.
Member Typedef Documentation
Reimplemented from vtk3DWidget.
Definition at line 118 of file vtkSplineWidget.h.
Member Enumeration Documentation
enum vtkSplineWidget::WidgetState [protected] |
Definition at line 270 of file vtkSplineWidget.h.
Constructor & Destructor Documentation
| vtkSplineWidget::vtkSplineWidget | ( | ) | [protected] |
| vtkSplineWidget::~vtkSplineWidget | ( | ) | [protected] |
Member Function Documentation
| static vtkSplineWidget* vtkSplineWidget::New | ( | ) | [static] |
Instantiate the object.
Reimplemented from vtkObject.
| static int vtkSplineWidget::IsTypeOf | ( | const char * | name | ) | [static] |
Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.
Reimplemented from vtk3DWidget.
| virtual int vtkSplineWidget::IsA | ( | const char * | name | ) | [virtual] |
Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.
Reimplemented from vtk3DWidget.
| static vtkSplineWidget* vtkSplineWidget::SafeDownCast | ( | vtkObjectBase * | o | ) | [static] |
Reimplemented from vtk3DWidget.
| virtual vtkObjectBase* vtkSplineWidget::NewInstanceInternal | ( | ) | const [protected, virtual] |
Reimplemented from vtk3DWidget.
| vtkSplineWidget* vtkSplineWidget::NewInstance | ( | ) | const |
Reimplemented from vtk3DWidget.
| void vtkSplineWidget::PrintSelf | ( | ostream & | os, |
| vtkIndent | indent | ||
| ) | [virtual] |
Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.
Reimplemented from vtk3DWidget.
| virtual void vtkSplineWidget::SetEnabled | ( | int | ) | [virtual] |
Methods that satisfy the superclass' API.
Reimplemented from vtkInteractorObserver.
| virtual void vtkSplineWidget::PlaceWidget | ( | double | bounds[6] | ) | [virtual] |
Methods that satisfy the superclass' API.
Implements vtk3DWidget.
| void vtkSplineWidget::PlaceWidget | ( | ) | [inline, virtual] |
Methods that satisfy the superclass' API.
Reimplemented from vtk3DWidget.
Definition at line 125 of file vtkSplineWidget.h.
| void vtkSplineWidget::PlaceWidget | ( | double | xmin, |
| double | xmax, | ||
| double | ymin, | ||
| double | ymax, | ||
| double | zmin, | ||
| double | zmax | ||
| ) | [inline, virtual] |
Methods that satisfy the superclass' API.
Reimplemented from vtk3DWidget.
Definition at line 127 of file vtkSplineWidget.h.
| virtual void vtkSplineWidget::SetProjectToPlane | ( | int | ) | [virtual] |
Force the spline widget to be projected onto one of the orthogonal planes. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the spline to the plane if it is originally not aligned. The normal in SetProjectionNormal is 0,1,2 for YZ,XZ,XY planes respectively and 3 for arbitrary oblique planes when the widget is tied to a vtkPlaneSource.
| virtual int vtkSplineWidget::GetProjectToPlane | ( | ) | [virtual] |
Force the spline widget to be projected onto one of the orthogonal planes. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the spline to the plane if it is originally not aligned. The normal in SetProjectionNormal is 0,1,2 for YZ,XZ,XY planes respectively and 3 for arbitrary oblique planes when the widget is tied to a vtkPlaneSource.
| virtual void vtkSplineWidget::ProjectToPlaneOn | ( | ) | [virtual] |
Force the spline widget to be projected onto one of the orthogonal planes. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the spline to the plane if it is originally not aligned. The normal in SetProjectionNormal is 0,1,2 for YZ,XZ,XY planes respectively and 3 for arbitrary oblique planes when the widget is tied to a vtkPlaneSource.
| virtual void vtkSplineWidget::ProjectToPlaneOff | ( | ) | [virtual] |
Force the spline widget to be projected onto one of the orthogonal planes. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the spline to the plane if it is originally not aligned. The normal in SetProjectionNormal is 0,1,2 for YZ,XZ,XY planes respectively and 3 for arbitrary oblique planes when the widget is tied to a vtkPlaneSource.
| void vtkSplineWidget::SetPlaneSource | ( | vtkPlaneSource * | plane | ) |
Set up a reference to a vtkPlaneSource that could be from another widget object, e.g. a vtkPolyDataSourceWidget.
| virtual void vtkSplineWidget::SetProjectionNormal | ( | int | ) | [virtual] |
| virtual int vtkSplineWidget::GetProjectionNormal | ( | ) | [virtual] |
| void vtkSplineWidget::SetProjectionNormalToXAxes | ( | ) | [inline] |
Definition at line 150 of file vtkSplineWidget.h.
| void vtkSplineWidget::SetProjectionNormalToYAxes | ( | ) | [inline] |
Definition at line 152 of file vtkSplineWidget.h.
| void vtkSplineWidget::SetProjectionNormalToZAxes | ( | ) | [inline] |
Definition at line 154 of file vtkSplineWidget.h.
| void vtkSplineWidget::SetProjectionNormalToOblique | ( | ) | [inline] |
Definition at line 156 of file vtkSplineWidget.h.
| void vtkSplineWidget::SetProjectionPosition | ( | double | position | ) |
Set the position of spline handles and points in terms of a plane's position. i.e., if ProjectionNormal is 0, all of the x-coordinate values of the points are set to position. Any value can be passed (and is ignored) to update the spline points when Projection normal is set to 3 for arbritrary plane orientations.
| virtual double vtkSplineWidget::GetProjectionPosition | ( | ) | [virtual] |
Set the position of spline handles and points in terms of a plane's position. i.e., if ProjectionNormal is 0, all of the x-coordinate values of the points are set to position. Any value can be passed (and is ignored) to update the spline points when Projection normal is set to 3 for arbritrary plane orientations.
| void vtkSplineWidget::GetPolyData | ( | vtkPolyData * | pd | ) |
Grab the polydata (including points) that defines the spline. The polydata consists of points and line segments numbering Resolution + 1 and Resoltuion, respectively. Points are guaranteed to be up-to-date when either the InteractionEvent or EndInteraction events are invoked. The user provides the vtkPolyData and the points and polyline are added to it.
| virtual void vtkSplineWidget::SetHandleProperty | ( | vtkProperty * | ) | [virtual] |
Set/Get the handle properties (the spheres are the handles). The properties of the handles when selected and unselected can be manipulated.
| virtual vtkProperty* vtkSplineWidget::GetHandleProperty | ( | ) | [virtual] |
Set/Get the handle properties (the spheres are the handles). The properties of the handles when selected and unselected can be manipulated.
| virtual void vtkSplineWidget::SetSelectedHandleProperty | ( | vtkProperty * | ) | [virtual] |
Set/Get the handle properties (the spheres are the handles). The properties of the handles when selected and unselected can be manipulated.
| virtual vtkProperty* vtkSplineWidget::GetSelectedHandleProperty | ( | ) | [virtual] |
Set/Get the handle properties (the spheres are the handles). The properties of the handles when selected and unselected can be manipulated.
| virtual void vtkSplineWidget::SetLineProperty | ( | vtkProperty * | ) | [virtual] |
Set/Get the line properties. The properties of the line when selected and unselected can be manipulated.
| virtual vtkProperty* vtkSplineWidget::GetLineProperty | ( | ) | [virtual] |
Set/Get the line properties. The properties of the line when selected and unselected can be manipulated.
| virtual void vtkSplineWidget::SetSelectedLineProperty | ( | vtkProperty * | ) | [virtual] |
Set/Get the line properties. The properties of the line when selected and unselected can be manipulated.
| virtual vtkProperty* vtkSplineWidget::GetSelectedLineProperty | ( | ) | [virtual] |
Set/Get the line properties. The properties of the line when selected and unselected can be manipulated.
| virtual void vtkSplineWidget::SetNumberOfHandles | ( | int | npts | ) | [virtual] |
Set/Get the number of handles for this widget.
| virtual int vtkSplineWidget::GetNumberOfHandles | ( | ) | [virtual] |
Set/Get the number of handles for this widget.
| void vtkSplineWidget::SetResolution | ( | int | resolution | ) |
Set/Get the number of line segments representing the spline for this widget.
| virtual int vtkSplineWidget::GetResolution | ( | ) | [virtual] |
Set/Get the number of line segments representing the spline for this widget.
| virtual void vtkSplineWidget::SetParametricSpline | ( | vtkParametricSpline * | ) | [virtual] |
Set the parametric spline object. Through vtkParametricSpline's API, the user can supply and configure one of currently two types of spline: vtkCardinalSpline, vtkKochanekSpline. The widget controls the open or closed configuration of the spline. WARNING: The widget does not enforce internal consistency so that all three are of the same type.
| virtual vtkParametricSpline* vtkSplineWidget::GetParametricSpline | ( | ) | [virtual] |
Set the parametric spline object. Through vtkParametricSpline's API, the user can supply and configure one of currently two types of spline: vtkCardinalSpline, vtkKochanekSpline. The widget controls the open or closed configuration of the spline. WARNING: The widget does not enforce internal consistency so that all three are of the same type.
| void vtkSplineWidget::SetHandlePosition | ( | int | handle, |
| double | x, | ||
| double | y, | ||
| double | z | ||
| ) |
Set/Get the position of the spline handles. Call GetNumberOfHandles to determine the valid range of handle indices.
| void vtkSplineWidget::SetHandlePosition | ( | int | handle, |
| double | xyz[3] | ||
| ) |
Set/Get the position of the spline handles. Call GetNumberOfHandles to determine the valid range of handle indices.
| void vtkSplineWidget::GetHandlePosition | ( | int | handle, |
| double | xyz[3] | ||
| ) |
Set/Get the position of the spline handles. Call GetNumberOfHandles to determine the valid range of handle indices.
| double* vtkSplineWidget::GetHandlePosition | ( | int | handle | ) |
Set/Get the position of the spline handles. Call GetNumberOfHandles to determine the valid range of handle indices.
| void vtkSplineWidget::SetClosed | ( | int | closed | ) |
Control whether the spline is open or closed. A closed spline forms a continuous loop: the first and last points are the same, and derivatives are continuous. A minimum of 3 handles are required to form a closed loop. This method enforces consistency with user supplied subclasses of vtkSpline.
| virtual int vtkSplineWidget::GetClosed | ( | ) | [virtual] |
Control whether the spline is open or closed. A closed spline forms a continuous loop: the first and last points are the same, and derivatives are continuous. A minimum of 3 handles are required to form a closed loop. This method enforces consistency with user supplied subclasses of vtkSpline.
| virtual void vtkSplineWidget::ClosedOn | ( | ) | [virtual] |
Control whether the spline is open or closed. A closed spline forms a continuous loop: the first and last points are the same, and derivatives are continuous. A minimum of 3 handles are required to form a closed loop. This method enforces consistency with user supplied subclasses of vtkSpline.
| virtual void vtkSplineWidget::ClosedOff | ( | ) | [virtual] |
Control whether the spline is open or closed. A closed spline forms a continuous loop: the first and last points are the same, and derivatives are continuous. A minimum of 3 handles are required to form a closed loop. This method enforces consistency with user supplied subclasses of vtkSpline.
Convenience method to determine whether the spline is closed in a geometric sense. The widget may be set "closed" but still be geometrically open (e.g., a straight line).
Get the approximate vs. the true arc length of the spline. Calculated as the summed lengths of the individual straight line segments. Use SetResolution to control the accuracy.
| void vtkSplineWidget::InitializeHandles | ( | vtkPoints * | points | ) |
Convenience method to allocate and set the handles from a vtkPoints instance. If the first and last points are the same, the spline sets Closed to the on state and disregards the last point, otherwise Closed remains unchanged.
| virtual void vtkSplineWidget::SetProcessEvents | ( | int | ) | [virtual] |
Turn on / off event processing for this widget. If off, the widget will not respond to user interaction
| virtual int vtkSplineWidget::GetProcessEvents | ( | ) | [virtual] |
Turn on / off event processing for this widget. If off, the widget will not respond to user interaction
| virtual void vtkSplineWidget::ProcessEventsOn | ( | ) | [virtual] |
Turn on / off event processing for this widget. If off, the widget will not respond to user interaction
| virtual void vtkSplineWidget::ProcessEventsOff | ( | ) | [virtual] |
Turn on / off event processing for this widget. If off, the widget will not respond to user interaction
| static void vtkSplineWidget::ProcessEventsHandler | ( | vtkObject * | object, |
| unsigned long | event, | ||
| void * | clientdata, | ||
| void * | calldata | ||
| ) | [static, protected] |
| void vtkSplineWidget::OnLeftButtonDown | ( | ) | [protected] |
| void vtkSplineWidget::OnLeftButtonUp | ( | ) | [protected] |
| void vtkSplineWidget::OnMiddleButtonDown | ( | ) | [protected] |
| void vtkSplineWidget::OnMiddleButtonUp | ( | ) | [protected] |
| void vtkSplineWidget::OnRightButtonDown | ( | ) | [protected] |
| void vtkSplineWidget::OnRightButtonUp | ( | ) | [protected] |
| void vtkSplineWidget::OnMouseMove | ( | ) | [protected] |
| void vtkSplineWidget::ProjectPointsToPlane | ( | ) | [protected] |
| void vtkSplineWidget::ProjectPointsToOrthoPlane | ( | ) | [protected] |
| void vtkSplineWidget::ProjectPointsToObliquePlane | ( | ) | [protected] |
| void vtkSplineWidget::BuildRepresentation | ( | ) | [protected] |
| void vtkSplineWidget::HighlightLine | ( | int | highlight | ) | [protected] |
| void vtkSplineWidget::Initialize | ( | ) | [protected] |
| int vtkSplineWidget::HighlightHandle | ( | vtkProp * | prop | ) | [protected] |
| virtual void vtkSplineWidget::SizeHandles | ( | ) | [protected, virtual] |
Reimplemented from vtk3DWidget.
| void vtkSplineWidget::InsertHandleOnLine | ( | double * | pos | ) | [protected] |
| void vtkSplineWidget::EraseHandle | ( | const int & | ) | [protected] |
| virtual void vtkSplineWidget::RegisterPickers | ( | ) | [protected, virtual] |
Register internal Pickers in the Picking Manager. Must be reimplemented by concrete widgets to register their pickers.
Reimplemented from vtkInteractorObserver.
| void vtkSplineWidget::MovePoint | ( | double * | p1, |
| double * | p2 | ||
| ) | [protected] |
| void vtkSplineWidget::Scale | ( | double * | p1, |
| double * | p2, | ||
| int | X, | ||
| int | Y | ||
| ) | [protected] |
| void vtkSplineWidget::Translate | ( | double * | p1, |
| double * | p2 | ||
| ) | [protected] |
| void vtkSplineWidget::Spin | ( | double * | p1, |
| double * | p2, | ||
| double * | vpn | ||
| ) | [protected] |
| void vtkSplineWidget::CreateDefaultProperties | ( | ) | [protected] |
| void vtkSplineWidget::CalculateCentroid | ( | ) | [protected] |
Member Data Documentation
int vtkSplineWidget::State [protected] |
Definition at line 269 of file vtkSplineWidget.h.
int vtkSplineWidget::ProjectionNormal [protected] |
Definition at line 298 of file vtkSplineWidget.h.
double vtkSplineWidget::ProjectionPosition [protected] |
Definition at line 299 of file vtkSplineWidget.h.
int vtkSplineWidget::ProjectToPlane [protected] |
Definition at line 300 of file vtkSplineWidget.h.
vtkPlaneSource* vtkSplineWidget::PlaneSource [protected] |
Definition at line 301 of file vtkSplineWidget.h.
vtkParametricSpline* vtkSplineWidget::ParametricSpline [protected] |
Definition at line 309 of file vtkSplineWidget.h.
Definition at line 310 of file vtkSplineWidget.h.
int vtkSplineWidget::NumberOfHandles [protected] |
Definition at line 311 of file vtkSplineWidget.h.
int vtkSplineWidget::Closed [protected] |
Definition at line 312 of file vtkSplineWidget.h.
vtkActor* vtkSplineWidget::LineActor [protected] |
Definition at line 316 of file vtkSplineWidget.h.
int vtkSplineWidget::Resolution [protected] |
Definition at line 318 of file vtkSplineWidget.h.
vtkActor** vtkSplineWidget::Handle [protected] |
Definition at line 321 of file vtkSplineWidget.h.
vtkSphereSource** vtkSplineWidget::HandleGeometry [protected] |
Definition at line 322 of file vtkSplineWidget.h.
vtkCellPicker* vtkSplineWidget::HandlePicker [protected] |
Definition at line 330 of file vtkSplineWidget.h.
vtkCellPicker* vtkSplineWidget::LinePicker [protected] |
Definition at line 331 of file vtkSplineWidget.h.
vtkActor* vtkSplineWidget::CurrentHandle [protected] |
Definition at line 332 of file vtkSplineWidget.h.
int vtkSplineWidget::CurrentHandleIndex [protected] |
Definition at line 333 of file vtkSplineWidget.h.
vtkTransform* vtkSplineWidget::Transform [protected] |
Definition at line 345 of file vtkSplineWidget.h.
vtkProperty* vtkSplineWidget::HandleProperty [protected] |
Definition at line 349 of file vtkSplineWidget.h.
vtkProperty* vtkSplineWidget::SelectedHandleProperty [protected] |
Definition at line 350 of file vtkSplineWidget.h.
vtkProperty* vtkSplineWidget::LineProperty [protected] |
Definition at line 351 of file vtkSplineWidget.h.
vtkProperty* vtkSplineWidget::SelectedLineProperty [protected] |
Definition at line 352 of file vtkSplineWidget.h.
double vtkSplineWidget::Centroid[3] [protected] |
Definition at line 356 of file vtkSplineWidget.h.
int vtkSplineWidget::ProcessEvents [protected] |
Definition at line 358 of file vtkSplineWidget.h.
The documentation for this class was generated from the following file:
- dox/Interaction/Widgets/vtkSplineWidget.h
