#include <vtkImagePlaneWidget.h>
Inheritance diagram for vtkImagePlaneWidget:
This 3D widget defines a plane that can be interactively placed in an image volume. A nice feature of the object is that the vtkImagePlaneWidget, like any 3D widget, will work with the current interactor style. That is, if vtkImagePlaneWidget does not handle an event, then all other registered observers (including the interactor style) have an opportunity to process the event. Otherwise, the vtkImagePlaneWidget will terminate the processing of the event that it handles.
The core functionality of the widget is provided by a vtkImageReslice object which passes its output onto a texture mapping pipeline for fast slicing through volumetric data. See the key methods: GenerateTexturePlane() and UpdatePlane() for implementation details.
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. If the "i" key (for "interactor") is pressed, the vtkImagePlaneWidget will appear. (See superclass documentation for information about changing this behavior.)
Selecting the widget with the middle mouse button with and without holding the shift or control keys enables complex reslicing capablilites. To facilitate use, a set of 'margins' (left, right, top, bottom) are shown as a set of plane-axes aligned lines, the properties of which can be changed as a group. Without keyboard modifiers: selecting in the middle of the margins enables translation of the plane along its normal. Selecting one of the corners within the margins enables spinning around the plane's normal at its center. Selecting within a margin allows rotating about the center of the plane around an axis aligned with the margin (i.e., selecting left margin enables rotating around the plane's local y-prime axis). With control key modifier: margin selection enables edge translation (i.e., a constrained form of scaling). Selecting within the margins enables translation of the entire plane. With shift key modifier: uniform plane scaling is enabled. Moving the mouse up enlarges the plane while downward movement shrinks it.
Window-level is achieved by using the right mouse button. The left mouse button can be used to query the underlying image data with a snap-to cross-hair cursor. Currently, the nearest point in the input image data to the mouse cursor generates the cross-hairs. With oblique slicing, this behaviour may appear unsatisfactory. Text display of window-level and image coordinates/data values are provided by a text actor/mapper pair. 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 vtkImagePlaneWidget has several methods that can be used in conjunction with other VTK objects. The GetPolyData() method can be used to get the polygonal representation of the plane and can be used as input for other VTK objects. 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 plane's outline; the text actor via its vtkTextProperty; the cross-hair cursor. In addition there are methods to constrain the plane so that it is aligned along the x-y-z axes. Finally, one can specify the degree of interpolation (vtkImageReslice): nearest neighbour, linear, and cubic.
Definition at line 132 of file vtkImagePlaneWidget.h.
|
Reimplemented from vtkPolyDataSourceWidget. Definition at line 138 of file vtkImagePlaneWidget.h. |
|
Set action associated to buttons. BTX Definition at line 413 of file vtkImagePlaneWidget.h. |
|
Set the auto-modifiers associated to buttons. This allows users to bind some buttons to actions that are usually triggered by a key modifier. For example, if you do not need cursoring, you can bind the left button action to SLICE_MOTION_ACTION (see above) and the left button auto modifier to CONTROL_MODIFIER: you end up with the left button controling panning without pressing a key. BTX Definition at line 435 of file vtkImagePlaneWidget.h. |
|
Definition at line 465 of file vtkImagePlaneWidget.h. |
|
Definition at line 477 of file vtkImagePlaneWidget.h. |
|
|
|
|
|
Instantiate the object. Reimplemented from vtkObject. |
|
Reimplemented from vtkPolyDataSourceWidget. |
|
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 vtkTypeRevisionMacro found in vtkSetGet.h. Reimplemented from vtkPolyDataSourceWidget. |
|
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 vtkTypeRevisionMacro found in vtkSetGet.h. Reimplemented from vtkPolyDataSourceWidget. |
|
Reimplemented from vtkPolyDataSourceWidget. |
|
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 vtkPolyDataSourceWidget. |
|
Methods that satisfy the superclass' API. Reimplemented from vtkInteractorObserver. |
|
We have to redeclare this abstract, PlaceWidget() requires it. You HAVE to override this in your concrete child classes. If there's no Prop3D and no Input, your PlaceWidget must make use of the underlying PolyDataSource to do its work. Implements vtkPolyDataSourceWidget. |
|
Overrides vtk3DWidget PlaceWidget() so that it doesn't complain if there's no Input and no Prop3D. Reimplemented from vtkPolyDataSourceWidget. Definition at line 145 of file vtkImagePlaneWidget.h. |
|
Convenience method brought over from vtkPlaneWidget. Reimplemented from vtkPolyDataSourceWidget. Definition at line 147 of file vtkImagePlaneWidget.h. |
|
Set the vtkImageData* input for the vtkImageReslice. Reimplemented from vtk3DWidget. |
|
Set/Get the origin of the plane. |
|
Set the vtkImageData* input for the vtkImageReslice. |
|
Set the vtkImageData* input for the vtkImageReslice. |
|
Set the vtkImageData* input for the vtkImageReslice. |
|
Set/Get the position of the point defining the first axis of the plane. |
|
Set/Get the position of the point defining the first axis of the plane. |
|
Set/Get the position of the point defining the first axis of the plane. |
|
Set/Get the position of the point defining the first axis of the plane. |
|
Set/Get the position of the point defining the second axis of the plane. |
|
Set/Get the position of the point defining the second axis of the plane. |
|
Set/Get the position of the point defining the second axis of the plane. |
|
Set/Get the position of the point defining the second axis of the plane. |
|
Get the center of the plane. |
|
Get the center of the plane. |
|
Get the normal to the plane. |
|
Get the normal to the plane. |
|
Get the vector from the plane origin to point1. |
|
Get the vector from the plane origin to point2. |
|
Get the slice position in terms of the data extent. |
|
Set the slice position in terms of the data extent. |
|
Get the position of the slice along its normal. |
|
Set the position of the slice along its normal. |
|
Set the interpolation to use when texturing the plane. |
|
Set the position of the slice along its normal. |
|
Set the position of the slice along its normal. Definition at line 215 of file vtkImagePlaneWidget.h. References VTK_NEAREST_RESLICE. |
|
Set the position of the slice along its normal. Definition at line 217 of file vtkImagePlaneWidget.h. References VTK_LINEAR_RESLICE. |
|
Set the position of the slice along its normal. Definition at line 219 of file vtkImagePlaneWidget.h. References VTK_CUBIC_RESLICE. |
|
Convenience method to get the vtkImageReslice output. |
|
Make sure that the plane remains within the volume. Default is On. |
|
Convenience method to get the vtkImageReslice output. |
|
Convenience method to get the vtkImageReslice output. |
|
Convenience method to get the vtkImageReslice output. |
|
Let the user control the lookup table. NOTE: apply this method BEFORE applying the SetLookupTable method. Default is Off. |
|
Let the user control the lookup table. NOTE: apply this method BEFORE applying the SetLookupTable method. Default is Off. |
|
Let the user control the lookup table. NOTE: apply this method BEFORE applying the SetLookupTable method. Default is Off. |
|
Let the user control the lookup table. NOTE: apply this method BEFORE applying the SetLookupTable method. Default is Off. |
|
Specify whether to interpolate the texture or not. When off, the reslice interpolation is nearest neighbour regardless of how the interpolation is set through the API. Set before setting the vtkImageData imput. Default is On. |
|
Specify whether to interpolate the texture or not. When off, the reslice interpolation is nearest neighbour regardless of how the interpolation is set through the API. Set before setting the vtkImageData imput. Default is On. |
|
Specify whether to interpolate the texture or not. When off, the reslice interpolation is nearest neighbour regardless of how the interpolation is set through the API. Set before setting the vtkImageData imput. Default is On. |
|
Specify whether to interpolate the texture or not. When off, the reslice interpolation is nearest neighbour regardless of how the interpolation is set through the API. Set before setting the vtkImageData imput. Default is On. |
|
Control the visibility of the actual texture mapped reformatted plane. in some cases you may only want the plane outline for example. |
|
Control the visibility of the actual texture mapped reformatted plane. in some cases you may only want the plane outline for example. |
|
Control the visibility of the actual texture mapped reformatted plane. in some cases you may only want the plane outline for example. |
|
Control the visibility of the actual texture mapped reformatted plane. in some cases you may only want the plane outline for example. |
|
Grab the polydata (including points) that defines the plane. The polydata consists of (res+1)*(res+1) points, and res*res quadrilateral polygons, where res is the resolution of the plane. These point values 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 polyplane are added to it. |
|
Satisfies superclass API. This returns a pointer to the underlying PolyData. Make changes to this before calling the initial PlaceWidget() to have the initial placement follow suit. Or, make changes after the widget has been initialised and call UpdatePlacement() to realise. Implements vtkPolyDataSourceWidget. |
|
Satisfies superclass API. This will change the state of the widget to match changes that have been made to the underlying PolyDataSource Implements vtkPolyDataSourceWidget. |
|
Convenience method to get the texture used by this widget. This can be used in external slice viewers. |
|
Convenience method to get the vtkImageMapToColors filter used by this widget. The user can properly render other transparent actors in a scene by calling the filter's SetOuputFormatToRGB and PassAlphaToOutputOff. |
|
Convenience method to get the texture used by this widget. This can be used in external slice viewers. |
|
Set/Get the plane's outline properties. The properties of the plane's outline when selected and unselected can be manipulated. |
|
Set/Get the plane's outline properties. The properties of the plane's outline when selected and unselected can be manipulated. |
|
Set/Get the plane's outline properties. The properties of the plane's outline when selected and unselected can be manipulated. |
|
Set/Get the plane's outline properties. The properties of the plane's outline when selected and unselected can be manipulated. |
|
Convenience method sets the plane orientation normal to the x, y, or z axes. Default is XAxes (0). |
|
Convenience method sets the plane orientation normal to the x, y, or z axes. Default is XAxes (0). |
|
Convenience method sets the plane orientation normal to the x, y, or z axes. Default is XAxes (0). Definition at line 306 of file vtkImagePlaneWidget.h. |
|
Convenience method sets the plane orientation normal to the x, y, or z axes. Default is XAxes (0). Definition at line 308 of file vtkImagePlaneWidget.h. |
|
Convenience method sets the plane orientation normal to the x, y, or z axes. Default is XAxes (0). Definition at line 310 of file vtkImagePlaneWidget.h. |
|
Set the internal picker to one defined by the user. In this way, a set of three orthogonal planes can share the same picker so that picking is performed correctly. The default internal picker can be re-set/allocated by setting to 0 (NULL). |
|
Set/Get the internal lookuptable (lut) to one defined by the user, or, alternatively, to the lut of another vtkImgePlaneWidget. In this way, a set of three orthogonal planes can share the same lut so that window-levelling is performed uniformly among planes. The default internal lut can be re- set/allocated by setting to 0 (NULL). |
|
Set the internal picker to one defined by the user. In this way, a set of three orthogonal planes can share the same picker so that picking is performed correctly. The default internal picker can be re-set/allocated by setting to 0 (NULL). |
|
Enable/disable text display of window-level, image coords and values in a render window. |
|
Enable/disable text display of window-level, image coords and values in a render window. |
|
Enable/disable text display of window-level, image coords and values in a render window. |
|
Enable/disable text display of window-level, image coords and values in a render window. |
|
Set the properties of the cross-hair cursor. |
|
Set the properties of the cross-hair cursor. |
|
Set the properties of the margins. |
|
Set the properties of the margins. |
|
Set/Get the text property for the image data and window-level annotation. |
|
Set/Get the text property for the image data and window-level annotation. |
|
Set/Get the property for the resliced image. |
|
Set/Get the property for the resliced image. |
|
Set/Get the current window and level values. Set should only be called after SetInput. |
|
Set/Get the current window and level values. Set should only be called after SetInput. |
|
Get the image coordinate position and voxel value. Currently only supports single component image data. |
|
Get the status of the cursor data. If this returns 1 the CurrentCursorPosition and CurrentImageValue will have current data. If it returns 0, these values are invalid. |
|
Get the current cursor position. To be used in conjunction with GetCursorDataStatus. |
|
Get the status of the cursor data. If this returns 1 the CurrentCursorPosition and CurrentImageValue will have current data. If it returns 0, these values are invalid. |
|
Get the current image value at the current cursor position. To be used in conjunction with GetCursorDataStatus. The value is VTK_DOUBLE_MAX when the data is invalid. |
|
Choose between voxel centered or continuous cursor probing. With voxel centered probing, the cursor snaps to the nearest voxel and the reported cursor coordinates are extent based. With continuous probing, voxel data is interpolated using vtkDataSetAttributes' InterpolatePoint method and the reported coordinates are 3D spacial continuous. |
|
Choose between voxel centered or continuous cursor probing. With voxel centered probing, the cursor snaps to the nearest voxel and the reported cursor coordinates are extent based. With continuous probing, voxel data is interpolated using vtkDataSetAttributes' InterpolatePoint method and the reported coordinates are 3D spacial continuous. |
|
Choose between voxel centered or continuous cursor probing. With voxel centered probing, the cursor snaps to the nearest voxel and the reported cursor coordinates are extent based. With continuous probing, voxel data is interpolated using vtkDataSetAttributes' InterpolatePoint method and the reported coordinates are 3D spacial continuous. |
|
Choose between voxel centered or continuous cursor probing. With voxel centered probing, the cursor snaps to the nearest voxel and the reported cursor coordinates are extent based. With continuous probing, voxel data is interpolated using vtkDataSetAttributes' InterpolatePoint method and the reported coordinates are 3D spacial continuous. |
|
Enable/disable mouse interaction so the widget remains on display. |
|
Enable/disable mouse interaction so the widget remains on display. |
|
Enable/disable mouse interaction so the widget remains on display. |
|
Enable/disable mouse interaction so the widget remains on display. |
|
Set action associated to buttons. BTX |
|
Set action associated to buttons. BTX |
|
Set action associated to buttons. BTX |
|
Set action associated to buttons. BTX |
|
Set action associated to buttons. BTX |
|
Set action associated to buttons. BTX |
|
Set the auto-modifiers associated to buttons. This allows users to bind some buttons to actions that are usually triggered by a key modifier. For example, if you do not need cursoring, you can bind the left button action to SLICE_MOTION_ACTION (see above) and the left button auto modifier to CONTROL_MODIFIER: you end up with the left button controling panning without pressing a key. BTX |
|
Set the auto-modifiers associated to buttons. This allows users to bind some buttons to actions that are usually triggered by a key modifier. For example, if you do not need cursoring, you can bind the left button action to SLICE_MOTION_ACTION (see above) and the left button auto modifier to CONTROL_MODIFIER: you end up with the left button controling panning without pressing a key. BTX |
|
Set the auto-modifiers associated to buttons. This allows users to bind some buttons to actions that are usually triggered by a key modifier. For example, if you do not need cursoring, you can bind the left button action to SLICE_MOTION_ACTION (see above) and the left button auto modifier to CONTROL_MODIFIER: you end up with the left button controling panning without pressing a key. BTX |
|
Set the auto-modifiers associated to buttons. This allows users to bind some buttons to actions that are usually triggered by a key modifier. For example, if you do not need cursoring, you can bind the left button action to SLICE_MOTION_ACTION (see above) and the left button auto modifier to CONTROL_MODIFIER: you end up with the left button controling panning without pressing a key. BTX |
|
Set the auto-modifiers associated to buttons. This allows users to bind some buttons to actions that are usually triggered by a key modifier. For example, if you do not need cursoring, you can bind the left button action to SLICE_MOTION_ACTION (see above) and the left button auto modifier to CONTROL_MODIFIER: you end up with the left button controling panning without pressing a key. BTX |
|
Set the auto-modifiers associated to buttons. This allows users to bind some buttons to actions that are usually triggered by a key modifier. For example, if you do not need cursoring, you can bind the left button action to SLICE_MOTION_ACTION (see above) and the left button auto modifier to CONTROL_MODIFIER: you end up with the left button controling panning without pressing a key. BTX |
|
Handles the char widget activation event. Also handles the delete event. Reimplemented from vtkInteractorObserver. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Definition at line 454 of file vtkImagePlaneWidget.h. |
|
Definition at line 456 of file vtkImagePlaneWidget.h. |
|
Definition at line 457 of file vtkImagePlaneWidget.h. |
|
Definition at line 458 of file vtkImagePlaneWidget.h. |
|
Definition at line 460 of file vtkImagePlaneWidget.h. |
|
Definition at line 461 of file vtkImagePlaneWidget.h. |
|
Definition at line 462 of file vtkImagePlaneWidget.h. |
|
Definition at line 473 of file vtkImagePlaneWidget.h. |
|
Definition at line 476 of file vtkImagePlaneWidget.h. |
|
Definition at line 519 of file vtkImagePlaneWidget.h. |
|
Definition at line 520 of file vtkImagePlaneWidget.h. |
|
Definition at line 521 of file vtkImagePlaneWidget.h. |
|
Definition at line 522 of file vtkImagePlaneWidget.h. |
|
Definition at line 523 of file vtkImagePlaneWidget.h. |
|
Definition at line 524 of file vtkImagePlaneWidget.h. |
|
Definition at line 525 of file vtkImagePlaneWidget.h. |
|
Definition at line 526 of file vtkImagePlaneWidget.h. |
|
Definition at line 527 of file vtkImagePlaneWidget.h. |
|
Definition at line 528 of file vtkImagePlaneWidget.h. |
|
Definition at line 529 of file vtkImagePlaneWidget.h. |
|
Definition at line 532 of file vtkImagePlaneWidget.h. |
|
Definition at line 533 of file vtkImagePlaneWidget.h. |
|
Definition at line 534 of file vtkImagePlaneWidget.h. |
|
Definition at line 542 of file vtkImagePlaneWidget.h. |
|
Definition at line 552 of file vtkImagePlaneWidget.h. |
|
Definition at line 553 of file vtkImagePlaneWidget.h. |
|
Definition at line 554 of file vtkImagePlaneWidget.h. |
|
Definition at line 555 of file vtkImagePlaneWidget.h. |
|
Definition at line 556 of file vtkImagePlaneWidget.h. |
|
Definition at line 557 of file vtkImagePlaneWidget.h. |
|
Definition at line 558 of file vtkImagePlaneWidget.h. |
|
Definition at line 559 of file vtkImagePlaneWidget.h. |
|
Definition at line 566 of file vtkImagePlaneWidget.h. |
|
Definition at line 567 of file vtkImagePlaneWidget.h. |
|
Definition at line 568 of file vtkImagePlaneWidget.h. |
|
Definition at line 569 of file vtkImagePlaneWidget.h. |
|
Definition at line 570 of file vtkImagePlaneWidget.h. |
|
Definition at line 578 of file vtkImagePlaneWidget.h. |
|
Definition at line 579 of file vtkImagePlaneWidget.h. |
|
Definition at line 580 of file vtkImagePlaneWidget.h. |
|
Definition at line 581 of file vtkImagePlaneWidget.h. |
|
Definition at line 587 of file vtkImagePlaneWidget.h. |
|
Definition at line 590 of file vtkImagePlaneWidget.h. |
|
Definition at line 591 of file vtkImagePlaneWidget.h. |
|
Definition at line 597 of file vtkImagePlaneWidget.h. |
|
Definition at line 598 of file vtkImagePlaneWidget.h. |
|
Definition at line 602 of file vtkImagePlaneWidget.h. |
|
Definition at line 603 of file vtkImagePlaneWidget.h. |
|
Definition at line 604 of file vtkImagePlaneWidget.h. |