vtkImageTracerWidget Class Reference

#include <vtkImageTracerWidget.h>

Inheritance diagram for vtkImageTracerWidget:

[legend]

Collaboration diagram for vtkImageTracerWidget:

[legend]

List of all members.

Detailed Description

3D widget for tracing on planar props.

vtkImageTracerWidget is different from other widgets in three distinct ways: 1) any sub-class of vtkProp can be input rather than just vtkProp3D, so that vtkImageActor can be set as the prop and then traced over, 2) the widget fires pick events at the input prop to decide where to move its handles, 3) the widget has 2D glyphs for handles instead of 3D spheres as is done in other sub-classes of vtk3DWidget. This widget is primarily designed for manually tracing over image data. The button actions and key modifiers are as follows for controlling the widget: 1) left button click over the image, hold and drag draws a free hand line. 2) left button click and release erases the widget line, if it exists, and repositions the first handle. 3) middle button click starts a snap drawn line. The line is terminated by clicking the middle button while depressing the ctrl key. 4) when tracing a continuous or snap drawn line, if the last cursor position is within a specified tolerance to the first handle, the widget line will form a closed loop. 5) right button clicking and holding on any handle that is part of a snap drawn line allows handle dragging: existing line segments are updated accordingly. If the path is open and AutoClose is set to On, the path can be closed by repositioning the first and last points over one another. 6) ctrl key + right button down on any handle will erase it: existing snap drawn line segments are updated accordingly. If the line was formed by continous tracing, the line is deleted leaving one handle. 7) shift key + right button down on any snap drawn line segment will insert a handle at the cursor position. The line segment is split accordingly.

Warning:: the input vtkDataSet should be vtkImageData.

See also:: vtk3DWidget vtkBoxWidget vtkLineWidget vtkPointWidget vtkSphereWidget vtkImagePlaneWidget vtkImplicitPlaneWidget vtkPlaneWidget

Events:: vtkCommand::DisableEvent vtkCommand::EndInteractionEvent vtkCommand::InteractionEvent vtkCommand::StartInteractionEvent vtkCommand::EnableEvent

Tests:: vtkImageTracerWidget (Tests)

Definition at line 84 of file vtkImageTracerWidget.h.


Public Types
typedef vtk3DWidget	Superclass
Public Member Functions
virtual const char *	GetClassName ()
virtual int	IsA (const char *type)
void	PrintSelf (ostream &os, vtkIndent indent)
void	SetViewProp (vtkProp *prop)
void	GetPath (vtkPolyData *pd)
vtkGlyphSource2D *	GetGlyphSource ()
void	InitializeHandles (vtkPoints *)
int	IsClosed ()
void	SetProp (vtkProp *prop)

virtual void	SetEnabled (int)
virtual void	PlaceWidget (double bounds[6])
void	PlaceWidget ()
void	PlaceWidget (double xmin, double xmax, double ymin, double ymax, double zmin, double zmax)

virtual void	SetHandleProperty (vtkProperty *)
virtual vtkProperty *	GetHandleProperty ()
virtual void	SetSelectedHandleProperty (vtkProperty *)
virtual vtkProperty *	GetSelectedHandleProperty ()

virtual void	SetLineProperty (vtkProperty *)
virtual vtkProperty *	GetLineProperty ()
virtual void	SetSelectedLineProperty (vtkProperty *)
virtual vtkProperty *	GetSelectedLineProperty ()

virtual void	SetProjectToPlane (int)
virtual int	GetProjectToPlane ()
virtual void	ProjectToPlaneOn ()
virtual void	ProjectToPlaneOff ()

virtual void	SetProjectionNormal (int)
virtual int	GetProjectionNormal ()
void	SetProjectionNormalToXAxes ()
void	SetProjectionNormalToYAxes ()
void	SetProjectionNormalToZAxes ()

void	SetProjectionPosition (double position)
virtual double	GetProjectionPosition ()

void	SetSnapToImage (int snap)
virtual int	GetSnapToImage ()
virtual void	SnapToImageOn ()
virtual void	SnapToImageOff ()

virtual void	SetAutoClose (int)
virtual int	GetAutoClose ()
virtual void	AutoCloseOn ()
virtual void	AutoCloseOff ()

virtual void	SetCaptureRadius (double)
virtual double	GetCaptureRadius ()

virtual void	SetImageSnapType (int)
virtual int	GetImageSnapType ()

void	SetHandlePosition (int handle, double xyz[3])
void	SetHandlePosition (int handle, double x, double y, double z)
void	GetHandlePosition (int handle, double xyz[3])
double *	GetHandlePosition (int handle)

virtual int	GetNumberOfHandles ()

void	SetInteraction (int interact)
virtual int	GetInteraction ()
virtual void	InteractionOn ()
virtual void	InteractionOff ()
Static Public Member Functions
static vtkImageTracerWidget *	New ()
static int	IsTypeOf (const char *type)
static vtkImageTracerWidget *	SafeDownCast (vtkObject *o)
Protected Types
enum	WidgetState { Start = 0, Tracing, Snapping, Erasing, Inserting, Moving, Translating, Outside }
Protected Member Functions
	vtkImageTracerWidget ()
	~vtkImageTracerWidget ()
void	OnLeftButtonDown ()
void	OnLeftButtonUp ()
void	OnMiddleButtonDown ()
void	OnMiddleButtonUp ()
void	OnRightButtonDown ()
void	OnRightButtonUp ()
void	OnMouseMove ()
void	AddObservers ()
void	Trace (int, int)
void	Snap (double *)
void	MovePoint (const double , const double )
void	Translate (const double , const double )
void	ClosePath ()
void	AppendHandles (double *)
void	ResetHandles ()
void	AllocateHandles (const int &)
void	AdjustHandlePosition (const int &, double *)
int	HighlightHandle (vtkProp *)
void	EraseHandle (const int &)
virtual void	SizeHandles ()
void	InsertHandleOnLine (double *)
void	HighlightLine (const int &)
void	BuildLinesFromHandles ()
void	ResetLine (double *)
void	AppendLine (double *)
void	CreateDefaultProperties ()
Static Protected Member Functions
static void	ProcessEvents (vtkObject object, unsigned long event, void clientdata, void *calldata)
Protected Attributes
int	State
int	Interaction
int	ProjectionNormal
double	ProjectionPosition
int	ProjectToPlane
int	ImageSnapType
int	SnapToImage
double	CaptureRadius
int	AutoClose
int	IsSnapping
int	LastX
int	LastY
vtkActor **	Handle
vtkPolyData **	HandleGeometry
vtkGlyphSource2D *	HandleGenerator
vtkTransformPolyDataFilter *	TransformFilter
vtkTransform *	Transform
vtkFloatArray *	TemporaryHandlePoints
int	NumberOfHandles
vtkActor *	CurrentHandle
int	CurrentHandleIndex
vtkProp *	ViewProp
vtkPropPicker *	PropPicker
vtkPoints *	LinePoints
vtkCellArray *	LineCells
vtkActor *	LineActor
vtkPolyData *	LineData
vtkIdType	CurrentPoints [2]
int	PickCount
vtkCellPicker *	HandlePicker
vtkCellPicker *	LinePicker
vtkAbstractPropPicker *	CurrentPicker
vtkProperty *	HandleProperty
vtkProperty *	SelectedHandleProperty
vtkProperty *	LineProperty
vtkProperty *	SelectedLineProperty

Member Typedef Documentation

typedef vtk3DWidget vtkImageTracerWidget::Superclass

Reimplemented from vtk3DWidget.

Definition at line 90 of file vtkImageTracerWidget.h.

Member Enumeration Documentation

enum vtkImageTracerWidget::WidgetState [protected]

Enumerator:

Start
Tracing
Snapping
Erasing
Inserting
Moving
Translating
Outside

Definition at line 251 of file vtkImageTracerWidget.h.

Constructor & Destructor Documentation

vtkImageTracerWidget::vtkImageTracerWidget ( ) [protected]

vtkImageTracerWidget::~vtkImageTracerWidget ( ) [protected]

Member Function Documentation

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

Instantiate the object.

Reimplemented from vtkObject.

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

Reimplemented from vtk3DWidget.

static int vtkImageTracerWidget::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 vtk3DWidget.

virtual int vtkImageTracerWidget::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 vtk3DWidget.

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

Reimplemented from vtk3DWidget.

void vtkImageTracerWidget::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 vtkImageTracerWidget::SetEnabled ( int ) [virtual]

Methods that satisfy the superclass' API.

Reimplemented from vtkInteractorObserver.

virtual void vtkImageTracerWidget::PlaceWidget ( double bounds[6] ) [virtual]

Methods that satisfy the superclass' API.

Implements vtk3DWidget.

void vtkImageTracerWidget::PlaceWidget ( ) [inline, virtual]

Methods that satisfy the superclass' API.

Reimplemented from vtk3DWidget.

Definition at line 97 of file vtkImageTracerWidget.h.

void vtkImageTracerWidget::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 99 of file vtkImageTracerWidget.h.

virtual void vtkImageTracerWidget::SetHandleProperty ( vtkProperty * ) [virtual]

Set/Get the handle properties (the 2D glyphs are the handles). The properties of the handles when selected and normal can be manipulated.

virtual vtkProperty* vtkImageTracerWidget::GetHandleProperty ( ) [virtual]

Set/Get the handle properties (the 2D glyphs are the handles). The properties of the handles when selected and normal can be manipulated.

virtual void vtkImageTracerWidget::SetSelectedHandleProperty ( vtkProperty * ) [virtual]

Set/Get the handle properties (the 2D glyphs are the handles). The properties of the handles when selected and normal can be manipulated.

virtual vtkProperty* vtkImageTracerWidget::GetSelectedHandleProperty ( ) [virtual]

Set/Get the handle properties (the 2D glyphs are the handles). The properties of the handles when selected and normal can be manipulated.

virtual void vtkImageTracerWidget::SetLineProperty ( vtkProperty * ) [virtual]

Set/Get the line properties. The properties of the line when selected and unselected can be manipulated.

virtual vtkProperty* vtkImageTracerWidget::GetLineProperty ( ) [virtual]

Set/Get the line properties. The properties of the line when selected and unselected can be manipulated.

virtual void vtkImageTracerWidget::SetSelectedLineProperty ( vtkProperty * ) [virtual]

Set/Get the line properties. The properties of the line when selected and unselected can be manipulated.

virtual vtkProperty* vtkImageTracerWidget::GetSelectedLineProperty ( ) [virtual]

Set/Get the line properties. The properties of the line when selected and unselected can be manipulated.

void vtkImageTracerWidget::SetViewProp ( vtkProp * prop )

Set the prop, usually a vtkImageActor, to trace over.

virtual void vtkImageTracerWidget::SetProjectToPlane ( int ) [virtual]

Force handles to be on a specific ortho plane.

virtual int vtkImageTracerWidget::GetProjectToPlane ( ) [virtual]

Force handles to be on a specific ortho plane.

virtual void vtkImageTracerWidget::ProjectToPlaneOn ( ) [virtual]

Force handles to be on a specific ortho plane.

virtual void vtkImageTracerWidget::ProjectToPlaneOff ( ) [virtual]

Force handles to be on a specific ortho plane.

virtual void vtkImageTracerWidget::SetProjectionNormal ( int ) [virtual]