VTK
Public Member Functions | Static Public Member Functions | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Friends
vtkBiDimensionalWidget Class Reference

measure the bi-dimensional lengths of an object More...

#include <vtkBiDimensionalWidget.h>

Inheritance diagram for vtkBiDimensionalWidget:
Inheritance graph
[legend]
Collaboration diagram for vtkBiDimensionalWidget:
Collaboration graph
[legend]

List of all members.

Public Types

enum  { EndWidgetSelectEvent = 10050 }
enum  { Start = 0, Define, Manipulate }

Public Member Functions

virtual void SetEnabled (int)
void CreateDefaultRepresentation ()
int IsMeasureValid ()
virtual void SetProcessEvents (int)
void SetRepresentation (vtkBiDimensionalRepresentation *r)
vtkBiDimensionalRepresentationGetBiDimensionalRepresentation ()
virtual void SetWidgetStateToStart ()
virtual void SetWidgetStateToManipulate ()
virtual int GetWidgetState ()

Static Public Member Functions

static vtkBiDimensionalWidgetNew ()

Protected Member Functions

 vtkBiDimensionalWidget ()
 ~vtkBiDimensionalWidget ()
void StartBiDimensionalInteraction ()
virtual void EndBiDimensionalInteraction ()

Static Protected Member Functions

static void AddPointAction (vtkAbstractWidget *)
static void MoveAction (vtkAbstractWidget *)
static void EndSelectAction (vtkAbstractWidget *)

Protected Attributes

int WidgetState
int CurrentHandle
int HandleLine1Selected
int HandleLine2Selected
int Line1InnerSelected
int Line1OuterSelected
int Line2InnerSelected
int Line2OuterSelected
int CenterSelected
vtkHandleWidgetPoint1Widget
vtkHandleWidgetPoint2Widget
vtkHandleWidgetPoint3Widget
vtkHandleWidgetPoint4Widget
vtkBiDimensionalWidgetCallbackBiDimensionalWidgetCallback1
vtkBiDimensionalWidgetCallbackBiDimensionalWidgetCallback2
vtkBiDimensionalWidgetCallbackBiDimensionalWidgetCallback3
vtkBiDimensionalWidgetCallbackBiDimensionalWidgetCallback4

Friends

class vtkBiDimensionalWidgetCallback
typedef vtkAbstractWidget Superclass
static int IsTypeOf (const char *type)
static vtkBiDimensionalWidgetSafeDownCast (vtkObjectBase *o)
virtual int IsA (const char *type)
vtkBiDimensionalWidgetNewInstance () const
void PrintSelf (ostream &os, vtkIndent indent)
virtual vtkObjectBaseNewInstanceInternal () const

Detailed Description

measure the bi-dimensional lengths of an object

The vtkBiDimensionalWidget is used to measure the bi-dimensional length of an object. The bi-dimensional measure is defined by two finite, orthogonal lines that intersect within the finite extent of both lines. The lengths of these two lines gives the bi-dimensional measure. Each line is defined by two handle widgets at the end points of each line.

The orthogonal constraint on the two lines limits how the four end points can be positioned. The first two points can be placed arbitrarily to define the first line (similar to vtkDistanceWidget). The placement of the third point is limited by the finite extent of the first line. As the third point is placed, the fourth point is placed on the opposite side of the first line. Once the third point is placed, the second line is defined since the fourth point is defined at the same time, but the fourth point can be moved along the second line (i.e., maintaining the orthogonal relationship between the two lines). Once defined, any of the four points can be moved along their constraint lines. Also, each line can be translated along the other line (in an orthogonal direction), and the whole bi-dimensional widget can be rotated about its center point (see the description of the event bindings). Finally, selecting the point where the two orthogonal axes intersect, the entire widget can be translated in any direction.

Placement of any point results in a special PlacePointEvent invocation so that special operations may be performed to reposition the point. Motion of any point, moving the lines, or rotating the widget cause InteractionEvents to be invoked. Note that the widget has two fundamental modes: a define mode (when initially placing the points) and a manipulate mode (after the points are placed). Line translation and rotation are only possible in manipulate mode.

To use this widget, specify an instance of vtkBiDimensionalWidget and a representation (e.g., vtkBiDimensionalRepresentation2D). The widget is implemented using four instances of vtkHandleWidget which are used to position the end points of the two intersecting lines. The representations for these handle widgets are provided by the vtkBiDimensionalRepresentation class.

Event Bindings:
By default, the widget responds to the following VTK events (i.e., it watches the vtkRenderWindowInteractor for these events):
   LeftButtonPressEvent - define a point or manipulate a handle, line,
                          perform rotation or translate the widget.
   MouseMoveEvent - position the points, move a line, rotate or translate the widget
   LeftButtonReleaseEvent - release the selected handle and end interaction
 
Event Bindings:
Note that the event bindings described above can be changed using this class's vtkWidgetEventTranslator. This class translates VTK events into the vtkBiDimensionalWidget's widget events:
   vtkWidgetEvent::AddPoint -- (In Define mode:) Add one point; depending on the
                               state it may the first, second, third or fourth
                               point added. (In Manipulate mode:) If near a handle,
                               select the handle. Or if near a line, select the line.
   vtkWidgetEvent::Move -- (In Define mode:) Position the second, third or fourth
                           point. (In Manipulate mode:) Move the handle, line or widget.
   vtkWidgetEvent::EndSelect -- the manipulation process has completed.
 
Event Bindings:
This widget invokes the following VTK events on itself (which observers can listen for):
   vtkCommand::StartInteractionEvent (beginning to interact)
   vtkCommand::EndInteractionEvent (completing interaction)
   vtkCommand::InteractionEvent (moving a handle, line or performing rotation)
   vtkCommand::PlacePointEvent (after a point is positioned;
                                call data includes handle id (0,1,2,4))
 
See also:
vtkHandleWidget vtkDistanceWidget
Events:
vtkCommand::EndInteractionEvent vtkCommand::InteractionEvent vtkCommand::LeftButtonPressEvent vtkCommand::StartInteractionEvent vtkCommand::PlacePointEvent vtkCommand::LeftButtonReleaseEvent
Tests:
vtkBiDimensionalWidget (Tests)

Definition at line 110 of file vtkBiDimensionalWidget.h.


Member Typedef Documentation

Standard methods for a VTK class.

Reimplemented from vtkAbstractWidget.

Definition at line 118 of file vtkBiDimensionalWidget.h.


Member Enumeration Documentation

anonymous enum

Events.

Enumerator:
EndWidgetSelectEvent 

Definition at line 151 of file vtkBiDimensionalWidget.h.

anonymous enum

Enum defining the state of the widget. By default the widget is in Start mode, and expects to be interactively placed. While placing the points the widget transitions to Define state. Once placed, the widget enters the Manipulate state. BTX

Enumerator:
Start 
Define 
Manipulate 

Definition at line 167 of file vtkBiDimensionalWidget.h.


Constructor & Destructor Documentation


Member Function Documentation

Instantiate this class.

Reimplemented from vtkObject.

static int vtkBiDimensionalWidget::IsTypeOf ( const char *  type) [static]

Standard methods for a VTK class.

Reimplemented from vtkAbstractWidget.

virtual int vtkBiDimensionalWidget::IsA ( const char *  type) [virtual]

Standard methods for a VTK class.

Reimplemented from vtkAbstractWidget.

Standard methods for a VTK class.

Reimplemented from vtkAbstractWidget.

virtual vtkObjectBase* vtkBiDimensionalWidget::NewInstanceInternal ( ) const [protected, virtual]

Standard methods for a VTK class.

Reimplemented from vtkAbstractWidget.

Standard methods for a VTK class.

Reimplemented from vtkAbstractWidget.

void vtkBiDimensionalWidget::PrintSelf ( ostream &  os,
vtkIndent  indent 
) [virtual]

Standard methods for a VTK class.

Reimplemented from vtkAbstractWidget.

virtual void vtkBiDimensionalWidget::SetEnabled ( int  ) [virtual]

The method for activating and deactivating this widget. This method must be overridden because it is a composite widget and does more than its superclasses' vtkAbstractWidget::SetEnabled() method.

Reimplemented from vtkAbstractWidget.

Specify an instance of vtkWidgetRepresentation used to represent this widget in the scene. Note that the representation is a subclass of vtkProp so it can be added to the renderer independent of the widget.

Definition at line 131 of file vtkBiDimensionalWidget.h.

Return the representation as a vtkBiDimensionalRepresentation.

Definition at line 137 of file vtkBiDimensionalWidget.h.

Create the default widget representation if one is not set.

Implements vtkAbstractWidget.

A flag indicates whether the bi-dimensional measure is valid. The widget becomes valid after two of the four points are placed.

virtual void vtkBiDimensionalWidget::SetProcessEvents ( int  ) [virtual]

Methods to change the whether the widget responds to interaction. Overridden to pass the state to component widgets.

Reimplemented from vtkAbstractWidget.

Set the state of the widget. If the state is set to "Manipulate" then it is assumed that the widget and its representation will be initialized programmatically and is not interactively placed. Initially the widget state is set to "Start" which means nothing will appear and the user must interactively place the widget with repeated mouse selections. Set the state to "Start" if you want interactive placement. Generally state changes must be followed by a Render() for things to visually take effect.

Set the state of the widget. If the state is set to "Manipulate" then it is assumed that the widget and its representation will be initialized programmatically and is not interactively placed. Initially the widget state is set to "Start" which means nothing will appear and the user must interactively place the widget with repeated mouse selections. Set the state to "Start" if you want interactive placement. Generally state changes must be followed by a Render() for things to visually take effect.

virtual int vtkBiDimensionalWidget::GetWidgetState ( ) [inline, virtual]

Return the current widget state.

Definition at line 186 of file vtkBiDimensionalWidget.h.

static void vtkBiDimensionalWidget::AddPointAction ( vtkAbstractWidget ) [static, protected]
static void vtkBiDimensionalWidget::MoveAction ( vtkAbstractWidget ) [static, protected]
static void vtkBiDimensionalWidget::EndSelectAction ( vtkAbstractWidget ) [static, protected]
virtual void vtkBiDimensionalWidget::EndBiDimensionalInteraction ( ) [protected, virtual]

Friends And Related Function Documentation

friend class vtkBiDimensionalWidgetCallback [friend]

Definition at line 227 of file vtkBiDimensionalWidget.h.


Member Data Documentation

Definition at line 195 of file vtkBiDimensionalWidget.h.

Definition at line 196 of file vtkBiDimensionalWidget.h.

Definition at line 197 of file vtkBiDimensionalWidget.h.

Definition at line 198 of file vtkBiDimensionalWidget.h.

Definition at line 199 of file vtkBiDimensionalWidget.h.

Definition at line 200 of file vtkBiDimensionalWidget.h.

Definition at line 201 of file vtkBiDimensionalWidget.h.

Definition at line 202 of file vtkBiDimensionalWidget.h.

Definition at line 203 of file vtkBiDimensionalWidget.h.

Definition at line 212 of file vtkBiDimensionalWidget.h.

Definition at line 213 of file vtkBiDimensionalWidget.h.

Definition at line 214 of file vtkBiDimensionalWidget.h.

Definition at line 215 of file vtkBiDimensionalWidget.h.

Definition at line 216 of file vtkBiDimensionalWidget.h.

Definition at line 217 of file vtkBiDimensionalWidget.h.

Definition at line 218 of file vtkBiDimensionalWidget.h.

Definition at line 219 of file vtkBiDimensionalWidget.h.


The documentation for this class was generated from the following file: