vtkOrientationMarkerWidget Class Reference

#include <vtkOrientationMarkerWidget.h>

Inheritance diagram for vtkOrientationMarkerWidget:

Inheritance graph
[legend]
Collaboration diagram for vtkOrientationMarkerWidget:

Collaboration graph
[legend]

List of all members.


Detailed Description

2D widget for manipulating a marker prop

This class provides support for interactively manipulating the position, size, and apparent orientation of a prop that represents an orientation marker. This class works by adding its internal renderer to an external "parent" renderer on a different layer. The input orientation marker is rendered as an overlay on the parent renderer and, thus, appears superposed over all props in the parent's scene. The camera view of the orientation the marker is made to match that of the parent's by means of an observer mechanism, giving the illusion that the orientation of the marker reflects that of the prop(s) in the parent's scene.

The widget listens to left mouse button and mouse movement events. It will change the cursor shape based on its location. If the cursor is over the overlay renderer, it will change the cursor shape to a SIZEALL shape or to a resize corner shape (e.g., SIZENW) if the cursor is near a corner. If the left mouse button is pressed and held down while moving, the overlay renderer, and hence, the orientation marker, is resized or moved. I the case of a resize operation, releasing the left mouse button causes the widget to enforce its renderer to be square. The diagonally opposite corner to the one moved is repositioned such that all edges of the renderer have the same length: the minimum.

To use this object, there are two key steps: 1) invoke SetInteractor() with the argument of the method a vtkRenderWindowInteractor, and 2) invoke SetOrientationMarker with an instance of vtkProp (see caveats below). Specifically, vtkAxesActor and vtkAnnoatedCubeActor are two classes designed to work with this class. A composite orientation marker can be generated by adding instances of vtkAxesActor and vtkAnnoatedCubeActor to a vtkPropAssembly, which can then be set as the input orientation marker. The widget can be also be set up in a non-interactive fashion by setting Ineractive to Off and sizing/placing the overlay renderer in its parent renderer by calling the widget's SetViewport method.

Thanks:
This class was based originally on Paraview's vtkPVAxesWidget.
Warning:
The input orientation marker prop should calculate its bounds as though they are symmetric about it's origin. This must currently be done to correctly implement the camera synchronization between the ivar renderer and the renderer associated with the set interactor. Importantly, the InteractorStyle associated with the interactor must be of the type vtkInteractorStyle*Camera. Where desirable, the parent renderer should be set by the SetDefaultRenderer method. The parent renderer's number of layers is modified to 2 where required.
See also:
vtkInteractorObserver vtkXYPlotWidget vtkScalarBarWidget vtkAxesActor vtkAnnotatedCubeActor
Events:
vtkCommand::DisableEvent vtkCommand::EndInteractionEvent vtkCommand::InteractionEvent vtkCommand::StartInteractionEvent vtkCommand::EnableEvent
Examples:
vtkOrientationMarkerWidget (Examples)
Tests:
vtkOrientationMarkerWidget (Tests)

Definition at line 88 of file vtkOrientationMarkerWidget.h.


Public Types

typedef vtkInteractorObserver Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
virtual void SetEnabled (int)
void ExecuteCameraUpdateEvent (vtkObject *o, unsigned long event, void *calldata)
virtual void SetOrientationMarker (vtkProp *prop)
virtual vtkPropGetOrientationMarker ()
void SetInteractive (int state)
virtual int GetInteractive ()
virtual void InteractiveOn ()
virtual void InteractiveOff ()
void SetOutlineColor (double r, double g, double b)
double * GetOutlineColor ()
void SetViewport (double minX, double minY, double maxX, double maxY)
double * GetViewport ()

Static Public Member Functions

static vtkOrientationMarkerWidgetNew ()
static int IsTypeOf (const char *type)
static vtkOrientationMarkerWidgetSafeDownCast (vtkObject *o)

Protected Types

enum  WidgetState {
  Outside = 0, Inside, Moving, AdjustingP1,
  AdjustingP2, AdjustingP3, AdjustingP4
}

Protected Member Functions

 vtkOrientationMarkerWidget ()
 ~vtkOrientationMarkerWidget ()
void OnLeftButtonDown ()
void OnLeftButtonUp ()
void OnMouseMove ()
int ComputeStateBasedOnPosition (int X, int Y, int *pos1, int *pos2)
void SetCursor (int state)
void MoveWidget (int X, int Y)
void ResizeTopLeft (int X, int Y)
void ResizeTopRight (int X, int Y)
void ResizeBottomLeft (int X, int Y)
void ResizeBottomRight (int X, int Y)
void SquareRenderer ()
void UpdateOutline ()

Static Protected Member Functions

static void ProcessEvents (vtkObject *object, unsigned long event, void *clientdata, void *calldata)

Protected Attributes

vtkRendererRenderer
vtkPropOrientationMarker
vtkPolyDataOutline
vtkActor2DOutlineActor
unsigned long StartEventObserverId
vtkOrientationMarkerWidgetObserver * Observer
int Interactive
int StartPosition [2]
int State

Member Typedef Documentation

Reimplemented from vtkInteractorObserver.

Definition at line 92 of file vtkOrientationMarkerWidget.h.


Member Enumeration Documentation

Enumerator:
Outside 
Inside 
Moving 
AdjustingP1 
AdjustingP2 
AdjustingP3 
AdjustingP4 

Definition at line 158 of file vtkOrientationMarkerWidget.h.


Constructor & Destructor Documentation

vtkOrientationMarkerWidget::vtkOrientationMarkerWidget (  )  [protected]

vtkOrientationMarkerWidget::~vtkOrientationMarkerWidget (  )  [protected]


Member Function Documentation

static vtkOrientationMarkerWidget* vtkOrientationMarkerWidget::New (  )  [static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkObject.

virtual const char* vtkOrientationMarkerWidget::GetClassName (  )  [virtual]

Reimplemented from vtkInteractorObserver.

static int vtkOrientationMarkerWidget::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 vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkInteractorObserver.

virtual int vtkOrientationMarkerWidget::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 vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkInteractorObserver.

static vtkOrientationMarkerWidget* vtkOrientationMarkerWidget::SafeDownCast ( vtkObject o  )  [static]

Reimplemented from vtkInteractorObserver.

void vtkOrientationMarkerWidget::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 vtkInteractorObserver.

virtual void vtkOrientationMarkerWidget::SetOrientationMarker ( vtkProp prop  )  [virtual]

Set/get the orientation marker to be displayed in this widget.

virtual vtkProp* vtkOrientationMarkerWidget::GetOrientationMarker (  )  [virtual]

Set/get the orientation marker to be displayed in this widget.

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

Enable/disable the widget.

Reimplemented from vtkInteractorObserver.

void vtkOrientationMarkerWidget::ExecuteCameraUpdateEvent ( vtkObject o,
unsigned long  event,
void *  calldata 
)

Callback to keep the camera for the orientation marker up to date with the camera in the parent renderer.

void vtkOrientationMarkerWidget::SetInteractive ( int  state  ) 

Set/get whether to allow this widget to be interactively moved/scaled.

virtual int vtkOrientationMarkerWidget::GetInteractive (  )  [virtual]

Set/get whether to allow this widget to be interactively moved/scaled.

virtual void vtkOrientationMarkerWidget::InteractiveOn (  )  [virtual]

Set/get whether to allow this widget to be interactively moved/scaled.

virtual void vtkOrientationMarkerWidget::InteractiveOff (  )  [virtual]

Set/get whether to allow this widget to be interactively moved/scaled.

void vtkOrientationMarkerWidget::SetOutlineColor ( double  r,
double  g,
double  b 
)

Set/get the color of the outline of this widget. The outline is visible when (in interactive mode) the cursor is over this widget.

double* vtkOrientationMarkerWidget::GetOutlineColor (  ) 

Set/get the color of the outline of this widget. The outline is visible when (in interactive mode) the cursor is over this widget.

void vtkOrientationMarkerWidget::SetViewport ( double  minX,
double  minY,
double  maxX,
double  maxY 
)

Set/get the viewport to position/size this widget.

double* vtkOrientationMarkerWidget::GetViewport (  ) 

Set/get the viewport to position/size this widget.

static void vtkOrientationMarkerWidget::ProcessEvents ( vtkObject object,
unsigned long  event,
void *  clientdata,
void *  calldata 
) [static, protected]

Handles the char widget activation event. Also handles the delete event.

Reimplemented from vtkInteractorObserver.

void vtkOrientationMarkerWidget::OnLeftButtonDown (  )  [protected]

void vtkOrientationMarkerWidget::OnLeftButtonUp (  )  [protected]

void vtkOrientationMarkerWidget::OnMouseMove (  )  [protected]

int vtkOrientationMarkerWidget::ComputeStateBasedOnPosition ( int  X,
int  Y,
int *  pos1,
int *  pos2 
) [protected]

void vtkOrientationMarkerWidget::SetCursor ( int  state  )  [protected]

void vtkOrientationMarkerWidget::MoveWidget ( int  X,
int  Y 
) [protected]

void vtkOrientationMarkerWidget::ResizeTopLeft ( int  X,
int  Y 
) [protected]

void vtkOrientationMarkerWidget::ResizeTopRight ( int  X,
int  Y 
) [protected]

void vtkOrientationMarkerWidget::ResizeBottomLeft ( int  X,
int  Y 
) [protected]

void vtkOrientationMarkerWidget::ResizeBottomRight ( int  X,
int  Y 
) [protected]

void vtkOrientationMarkerWidget::SquareRenderer (  )  [protected]

void vtkOrientationMarkerWidget::UpdateOutline (  )  [protected]


Member Data Documentation

Definition at line 133 of file vtkOrientationMarkerWidget.h.

Definition at line 134 of file vtkOrientationMarkerWidget.h.

Definition at line 135 of file vtkOrientationMarkerWidget.h.

Definition at line 136 of file vtkOrientationMarkerWidget.h.

Definition at line 138 of file vtkOrientationMarkerWidget.h.

vtkOrientationMarkerWidgetObserver* vtkOrientationMarkerWidget::Observer [protected]

Definition at line 149 of file vtkOrientationMarkerWidget.h.

Definition at line 151 of file vtkOrientationMarkerWidget.h.

Definition at line 154 of file vtkOrientationMarkerWidget.h.

Definition at line 157 of file vtkOrientationMarkerWidget.h.


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

Generated on Sat Dec 27 13:40:11 2008 for VTK by  doxygen 1.5.6