#include <vtkContourRepresentation.h>

Inheritance diagram for vtkContourRepresentation:

Collaboration diagram for vtkContourRepresentation:

Public Types
enum	{ Outside =0, Nearby }

enum	{ Inactive = 0, Translate, Shift, Scale }

Public Types inherited from vtkWidgetRepresentation
typedef vtkProp	Superclass

Public Member Functions
virtual int	SetActiveNodeToWorldPosition (double pos[3])

virtual int	SetActiveNodeToWorldPosition (double pos[3], double orient[9])

virtual int	GetActiveNodeWorldPosition (double pos[3])

virtual int	GetActiveNodeWorldOrientation (double orient[9])

virtual int	GetActiveNodeDisplayPosition (double pos[2])

virtual int	GetNumberOfNodes ()

virtual int	GetNthNodeDisplayPosition (int n, double pos[2])

virtual int	GetNthNodeWorldPosition (int n, double pos[3])

virtual int	GetNthNodeWorldOrientation (int n, double orient[9])

virtual int	GetNthNodeSlope (int idx, double slope[3])

virtual int	GetNumberOfIntermediatePoints (int n)

virtual int	DeleteLastNode ()

virtual int	DeleteActiveNode ()

virtual int	DeleteNthNode (int n)

virtual void	ClearAllNodes ()

virtual int	AddNodeOnContour (int X, int Y)

void	SetPointPlacer (vtkPointPlacer *)

virtual vtkPointPlacer *	GetPointPlacer ()

void	GetNodePolyData (vtkPolyData *poly)

virtual void	SetRebuildLocator (bool)


virtual int	AddNodeAtWorldPosition (double x, double y, double z)

virtual int	AddNodeAtWorldPosition (double worldPos[3])

virtual int	AddNodeAtWorldPosition (double worldPos[3], double worldOrient[9])


virtual int	AddNodeAtDisplayPosition (double displayPos[2])

virtual int	AddNodeAtDisplayPosition (int displayPos[2])

virtual int	AddNodeAtDisplayPosition (int X, int Y)


virtual int	ActivateNode (double displayPos[2])

virtual int	ActivateNode (int displayPos[2])

virtual int	ActivateNode (int X, int Y)


virtual int	SetActiveNodeToDisplayPosition (double pos[2])

virtual int	SetActiveNodeToDisplayPosition (int pos[2])

virtual int	SetActiveNodeToDisplayPosition (int X, int Y)


virtual int	ToggleActiveNodeSelected ()

virtual int	GetActiveNodeSelected ()

virtual int	GetNthNodeSelected (int)

virtual int	SetNthNodeSelected (int)


virtual vtkContourRepresentationNode *	GetNthNode (int n)


virtual int	SetNthNodeDisplayPosition (int n, int X, int Y)

virtual int	SetNthNodeDisplayPosition (int n, int pos[2])

virtual int	SetNthNodeDisplayPosition (int n, double pos[2])


virtual int	SetNthNodeWorldPosition (int n, double pos[3])

virtual int	SetNthNodeWorldPosition (int n, double pos[3], double orient[9])


virtual int	GetIntermediatePointWorldPosition (int n, int idx, double point[3])


virtual int	AddIntermediatePointWorldPosition (int n, double point[3])


virtual int	AddIntermediatePointWorldPosition (int n, double point[3], vtkIdType ptId)


virtual void	SetPixelTolerance (int)

virtual int	GetPixelTolerance ()


virtual void	SetWorldTolerance (double)

virtual double	GetWorldTolerance ()


virtual int	GetCurrentOperation ()

virtual void	SetCurrentOperation (int)

void	SetCurrentOperationToInactive ()

void	SetCurrentOperationToTranslate ()

void	SetCurrentOperationToShift ()

void	SetCurrentOperationToScale ()


void	SetLineInterpolator (vtkContourLineInterpolator *)

virtual vtkContourLineInterpolator *	GetLineInterpolator ()


virtual void	BuildRepresentation ()=0

virtual int	ComputeInteractionState (int X, int Y, int modified=0)=0

virtual void	StartWidgetInteraction (double e[2])=0

virtual void	WidgetInteraction (double e[2])=0


virtual void	ReleaseGraphicsResources (vtkWindow *w)=0

virtual int	RenderOverlay (vtkViewport *viewport)=0

virtual int	RenderOpaqueGeometry (vtkViewport *viewport)=0

virtual int	RenderTranslucentPolygonalGeometry (vtkViewport *viewport)=0

virtual int	HasTranslucentPolygonalGeometry ()=0


void	SetClosedLoop (int val)

virtual int	GetClosedLoop ()

virtual void	ClosedLoopOn ()

virtual void	ClosedLoopOff ()


virtual void	SetShowSelectedNodes (int)

virtual int	GetShowSelectedNodes ()

virtual void	ShowSelectedNodesOn ()

virtual void	ShowSelectedNodesOff ()


virtual vtkPolyData *	GetContourRepresentationAsPolyData ()=0

Public Member Functions inherited from vtkWidgetRepresentation
virtual void	PickingManagedOn ()

virtual void	PickingManagedOff ()

virtual void	SetPickingManaged (bool)

virtual bool	GetPickingManaged ()

virtual void	SetRenderer (vtkRenderer *ren)

virtual vtkRenderer *	GetRenderer ()

virtual void	PlaceWidget (double *vtkNotUsed(bounds[6]))

virtual void	EndWidgetInteraction (double newEventPos[2])

virtual int	GetInteractionState ()

virtual void	Highlight (int vtkNotUsed(highlightOn))

virtual void	SetPlaceFactor (double)

virtual double	GetPlaceFactor ()

virtual void	SetHandleSize (double)

virtual double	GetHandleSize ()

virtual int	GetNeedToRender ()

virtual void	SetNeedToRender (int)

virtual void	NeedToRenderOn ()

virtual void	NeedToRenderOff ()

virtual double *	GetBounds ()

virtual void	ShallowCopy (vtkProp *prop)

virtual void	GetActors (vtkPropCollection *)

virtual void	GetActors2D (vtkPropCollection *)

virtual void	GetVolumes (vtkPropCollection *)

virtual int	RenderOverlay (vtkViewport *vtkNotUsed(viewport))

virtual int	RenderOpaqueGeometry (vtkViewport *vtkNotUsed(viewport))

virtual int	RenderTranslucentPolygonalGeometry (vtkViewport *vtkNotUsed(viewport))

virtual int	RenderVolumetricGeometry (vtkViewport *vtkNotUsed(viewport))

vtkWidgetRepresentation *	NewInstance () const

void	PrintSelf (ostream &os, vtkIndent indent)

Protected Member Functions
	vtkContourRepresentation ()

	~vtkContourRepresentation ()

void	AddNodeAtPositionInternal (double worldPos[3], double worldOrient[9], int displayPos[2])

void	AddNodeAtPositionInternal (double worldPos[3], double worldOrient[9], double displayPos[2])

void	SetNthNodeWorldPositionInternal (int n, double worldPos[3], double worldOrient[9])

virtual void	UpdateLines (int index)

void	UpdateLine (int idx1, int idx2)

virtual int	FindClosestPointOnContour (int X, int Y, double worldPos[3], int *idx)

virtual void	BuildLines ()=0

virtual int	UpdateContour ()

void	ComputeMidpoint (double p1[3], double p2[3], double mid[3])

virtual void	Initialize (vtkPolyData , vtkIdList )

virtual void	Initialize (vtkPolyData *)

virtual void	InitializeContour (vtkPolyData , vtkIdList )

void	ResetLocator ()

void	BuildLocator ()


void	GetRendererComputedDisplayPositionFromWorldPosition (double worldPos[3], double worldOrient[9], int displayPos[2])

void	GetRendererComputedDisplayPositionFromWorldPosition (double worldPos[3], double worldOrient[9], double displayPos[2])

Protected Member Functions inherited from vtkWidgetRepresentation
	vtkWidgetRepresentation ()

	~vtkWidgetRepresentation ()

void	AdjustBounds (double bounds[6], double newBounds[6], double center[3])

virtual void	RegisterPickers ()

virtual void	UnRegisterPickers ()

virtual void	PickersModified ()

vtkPickingManager *	GetPickingManager ()

double	SizeHandlesRelativeToViewport (double factor, double pos[3])

double	SizeHandlesInPixels (double factor, double pos[3])

vtkAssemblyPath *	GetAssemblyPath (double X, double Y, double Z, vtkAbstractPropPicker *picker)

Protected Attributes
int	PixelTolerance

double	WorldTolerance

vtkPointPlacer *	PointPlacer

vtkContourLineInterpolator *	LineInterpolator

int	ActiveNode

int	CurrentOperation

int	ClosedLoop

int	ShowSelectedNodes

vtkContourRepresentationInternals *	Internal

vtkTimeStamp	ContourBuildTime

vtkIncrementalOctreePointLocator *	Locator

bool	RebuildLocator

Protected Attributes inherited from vtkWidgetRepresentation
vtkWeakPointer< vtkRenderer >	Renderer

int	InteractionState

double	StartEventPosition [3]

double	PlaceFactor

int	Placed

double	InitialBounds [6]

double	InitialLength

int	ValidPick

bool	PickingManaged

double	HandleSize

int	NeedToRender

vtkTimeStamp	BuildTime

Friends
class	vtkContourWidget

typedef vtkWidgetRepresentation	Superclass

static int	IsTypeOf (const char *type)

static vtkContourRepresentation *	SafeDownCast (vtkObjectBase *o)

virtual int	IsA (const char *type)

vtkContourRepresentation *	NewInstance () const

void	PrintSelf (ostream &os, vtkIndent indent)

virtual vtkObjectBase *	NewInstanceInternal () const

Detailed Description

represent the vtkContourWidget

The vtkContourRepresentation is a superclass for various types of representations for the vtkContourWidget.

Managing contour points:: The classes vtkContourRepresentationNode, vtkContourRepresentationInternals, vtkContourRepresentationPoint manage the data structure used to represent nodes and points on a contour. A contour may contain several nodes and several more points. Nodes are usually the result of user clicked points on the contour. Additional points are created between nodes to generate a smooth curve using some Interpolator. See the method SetLineInterpolator.

: The data structure stores both the world and display positions for every point. (This may seem like a duplication.) The default behaviour of this class is to use the WorldPosition to do all the math. Typically a point is added at a given display position. Its corresponding world position is computed using the point placer and stored. Any query of the display position of a stored point is done via the Renderer, which computes the display position given a world position.

Managing contour points:

: So why maintain the display position ? Consider drawing a contour on a volume widget. You might want the contour to be located at a certain world position in the volume or you might want to be overlayed over the window like an Actor2D. The default behaviour of this class is to provide the former behaviour.

Managing contour points:

: To achieve the latter behaviour override the methods that return the display position (to return the set display position instead of computing it from the world positions) and the method BuildLines() to interpolate lines using their display positions intead of world positions.

See Also: vtkContourWidget

Tests:: vtkContourRepresentation (Tests)

Definition at line 119 of file vtkContourRepresentation.h.

Member Typedef Documentation

typedef vtkWidgetRepresentation vtkContourRepresentation::Superclass

Standard VTK methods.

Definition at line 127 of file vtkContourRepresentation.h.

Member Enumeration Documentation

anonymous enum

Enumerator
Outside
Nearby

Definition at line 309 of file vtkContourRepresentation.h.

anonymous enum

Enumerator
Inactive
Translate
Shift
Scale

Definition at line 314 of file vtkContourRepresentation.h.

Constructor & Destructor Documentation

vtkContourRepresentation::vtkContourRepresentation ( )

protected

vtkContourRepresentation::~vtkContourRepresentation ( )

protected

Member Function Documentation

static int vtkContourRepresentation::IsTypeOf ( const char * type )

static

Standard VTK methods.

virtual int vtkContourRepresentation::IsA ( const char * type )

virtual

Standard VTK methods.

Reimplemented from vtkWidgetRepresentation.

Reimplemented in vtkOrientedGlyphFocalPlaneContourRepresentation, vtkOrientedGlyphContourRepresentation, and vtkFocalPlaneContourRepresentation.

static vtkContourRepresentation* vtkContourRepresentation::SafeDownCast ( vtkObjectBase * o )

static

Standard VTK methods.

virtual vtkObjectBase* vtkContourRepresentation::NewInstanceInternal ( ) const

protectedvirtual

Standard VTK methods.

Reimplemented from vtkWidgetRepresentation.

Reimplemented in vtkOrientedGlyphFocalPlaneContourRepresentation, vtkOrientedGlyphContourRepresentation, and vtkFocalPlaneContourRepresentation.

vtkContourRepresentation* vtkContourRepresentation::NewInstance ( ) const

Standard VTK methods.

void vtkContourRepresentation::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)

Standard VTK methods.

virtual int vtkContourRepresentation::AddNodeAtWorldPosition	(	double	x,
		double	y,
		double	z
	)

virtual

Add a node at a specific world position. Returns 0 if the node could not be added, 1 otherwise.

virtual int vtkContourRepresentation::AddNodeAtWorldPosition ( double worldPos[3] )

virtual

Add a node at a specific world position. Returns 0 if the node could not be added, 1 otherwise.

virtual int vtkContourRepresentation::AddNodeAtWorldPosition	(	double	worldPos[3],
		double	worldOrient[9]
	)

virtual

Add a node at a specific world position. Returns 0 if the node could not be added, 1 otherwise.

virtual int vtkContourRepresentation::AddNodeAtDisplayPosition ( double displayPos[2] )

virtual

Add a node at a specific display position. This will be converted into a world position according to the current constraints of the point placer. Return 0 if a point could not be added, 1 otherwise.

virtual int vtkContourRepresentation::AddNodeAtDisplayPosition ( int displayPos[2] )

virtual

Add a node at a specific display position. This will be converted into a world position according to the current constraints of the point placer. Return 0 if a point could not be added, 1 otherwise.

virtual int vtkContourRepresentation::AddNodeAtDisplayPosition	(	int	X,
		int	Y
	)

virtual

Add a node at a specific display position. This will be converted into a world position according to the current constraints of the point placer. Return 0 if a point could not be added, 1 otherwise.

virtual int vtkContourRepresentation::ActivateNode ( double displayPos[2] )

virtual

Given a display position, activate a node. The closest node within tolerance will be activated. If a node is activated, 1 will be returned, otherwise 0 will be returned.

virtual int vtkContourRepresentation::ActivateNode ( int displayPos[2] )

virtual

Given a display position, activate a node. The closest node within tolerance will be activated. If a node is activated, 1 will be returned, otherwise 0 will be returned.

virtual int vtkContourRepresentation::ActivateNode	(	int	X,
		int	Y
	)

virtual

Given a display position, activate a node. The closest node within tolerance will be activated. If a node is activated, 1 will be returned, otherwise 0 will be returned.

virtual int vtkContourRepresentation::SetActiveNodeToWorldPosition ( double pos[3] )

virtual

virtual int vtkContourRepresentation::SetActiveNodeToWorldPosition	(	double	pos[3],
		double	orient[9]
	)

virtual

virtual int vtkContourRepresentation::SetActiveNodeToDisplayPosition ( double pos[2] )

virtual

Move the active node based on a specified display position. The display position will be converted into a world position. If the new position is not valid or there is no active node, a 0 will be returned. Otherwise, on success a 1 will be returned.

virtual int vtkContourRepresentation::SetActiveNodeToDisplayPosition ( int pos[2] )

virtual

Move the active node based on a specified display position. The display position will be converted into a world position. If the new position is not valid or there is no active node, a 0 will be returned. Otherwise, on success a 1 will be returned.

virtual int vtkContourRepresentation::SetActiveNodeToDisplayPosition	(	int	X,
		int	Y
	)

virtual

Move the active node based on a specified display position. The display position will be converted into a world position. If the new position is not valid or there is no active node, a 0 will be returned. Otherwise, on success a 1 will be returned.

virtual int vtkContourRepresentation::ToggleActiveNodeSelected ( )

virtual

Set/Get whether the active or nth node is selected.

virtual int vtkContourRepresentation::GetActiveNodeSelected ( )

virtual

Set/Get whether the active or nth node is selected.

virtual int vtkContourRepresentation::GetNthNodeSelected ( int )

virtual

Set/Get whether the active or nth node is selected.

virtual int vtkContourRepresentation::SetNthNodeSelected ( int )

virtual

Set/Get whether the active or nth node is selected.

virtual int vtkContourRepresentation::GetActiveNodeWorldPosition ( double pos[3] )

virtual

Get the world position of the active node. Will return 0 if there is no active node, or 1 otherwise.

virtual int vtkContourRepresentation::GetActiveNodeWorldOrientation ( double orient[9] )

virtual

Get the world orientation of the active node. Will return 0 if there is no active node, or 1 otherwise.

virtual int vtkContourRepresentation::GetActiveNodeDisplayPosition ( double pos[2] )

virtual

Get the display position of the active node. Will return 0 if there is no active node, or 1 otherwise.

virtual int vtkContourRepresentation::GetNumberOfNodes ( )

virtual

Get the number of nodes.

virtual int vtkContourRepresentation::GetNthNodeDisplayPosition	(	int	n,
		double	pos[2]
	)

virtual

Get the nth node's display position. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting).

Reimplemented in vtkFocalPlaneContourRepresentation.

virtual int vtkContourRepresentation::GetNthNodeWorldPosition	(	int	n,
		double	pos[3]
	)

virtual

Get the nth node's world position. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting).

Reimplemented in vtkFocalPlaneContourRepresentation.

virtual vtkContourRepresentationNode* vtkContourRepresentation::GetNthNode ( int n )

virtual

Get the nth node.

virtual int vtkContourRepresentation::GetNthNodeWorldOrientation	(	int	n,
		double	orient[9]
	)

virtual

Get the nth node's world orientation. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting).

virtual int vtkContourRepresentation::SetNthNodeDisplayPosition	(	int	n,
		int	X,
		int	Y
	)

virtual

Set the nth node's display position. Display position will be converted into world position according to the constraints of the point placer. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting) or the world position is not valid.

virtual int vtkContourRepresentation::SetNthNodeDisplayPosition	(	int	n,
		int	pos[2]
	)

virtual

Set the nth node's display position. Display position will be converted into world position according to the constraints of the point placer. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting) or the world position is not valid.

virtual int vtkContourRepresentation::SetNthNodeDisplayPosition	(	int	n,
		double	pos[2]
	)

virtual

Set the nth node's display position. Display position will be converted into world position according to the constraints of the point placer. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting) or the world position is not valid.

virtual int vtkContourRepresentation::SetNthNodeWorldPosition	(	int	n,
		double	pos[3]
	)

virtual

Set the nth node's world position. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting) or the world position is not valid according to the point placer.

virtual int vtkContourRepresentation::SetNthNodeWorldPosition	(	int	n,
		double	pos[3],
		double	orient[9]
	)

virtual

Set the nth node's world position. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting) or the world position is not valid according to the point placer.

virtual int vtkContourRepresentation::GetNthNodeSlope	(	int	idx,
		double	slope[3]
	)

virtual

Get the nth node's slope. Will return 1 on success, or 0 if there are not at least (n+1) nodes (0 based counting).

virtual int vtkContourRepresentation::GetNumberOfIntermediatePoints ( int n )

virtual

virtual int vtkContourRepresentation::GetIntermediatePointWorldPosition	(	int	n,
		int	idx,
		double	point[3]
	)

virtual

Get the world position of the intermediate point at index idx between nodes n and (n+1) (or n and 0 if n is the last node and the loop is closed). Returns 1 on success or 0 if n or idx are out of range.

Reimplemented in vtkFocalPlaneContourRepresentation.

virtual int vtkContourRepresentation::AddIntermediatePointWorldPosition	(	int	n,
		double	point[3]
	)

virtual

Add an intermediate point between node n and n+1 (or n and 0 if n is the last node and the loop is closed). Returns 1 on success or 0 if n is out of range.

virtual int vtkContourRepresentation::AddIntermediatePointWorldPosition	(	int	n,
		double	point[3],
		vtkIdType	ptId
	)

virtual

Add an intermediate point between node n and n+1 (or n and 0 if n is the last node and the loop is closed). Returns 1 on success or 0 if n is out of range. The added point is assigned a ptId as supplied.

virtual int vtkContourRepresentation::DeleteLastNode ( )

virtual

Delete the last node. Returns 1 on success or 0 if there were not any nodes.

virtual int vtkContourRepresentation::DeleteActiveNode ( )

virtual

Delete the active node. Returns 1 on success or 0 if the active node did not indicate a valid node.

virtual int vtkContourRepresentation::DeleteNthNode ( int n )

virtual

Delete the nth node. Return 1 on success or 0 if n is out of range.

virtual void vtkContourRepresentation::ClearAllNodes ( )

virtual

Delete all nodes.

virtual int vtkContourRepresentation::AddNodeOnContour	(	int	X,
		int	Y
	)

virtual

Given a specific X, Y pixel location, add a new node on the contour at this location.

virtual void vtkContourRepresentation::SetPixelTolerance ( int )

virtual

The tolerance to use when calculations are performed in display coordinates

virtual int vtkContourRepresentation::GetPixelTolerance ( )

virtual

The tolerance to use when calculations are performed in display coordinates

virtual void vtkContourRepresentation::SetWorldTolerance ( double )

virtual

The tolerance to use when calculations are performed in world coordinates

virtual double vtkContourRepresentation::GetWorldTolerance ( )

virtual

The tolerance to use when calculations are performed in world coordinates

virtual int vtkContourRepresentation::GetCurrentOperation ( )

virtual