2D text annotation More...

#include <vtkTextMapper.h>

Inheritance diagram for vtkTextMapper:

Collaboration diagram for vtkTextMapper:

Public Types
typedef vtkMapper2D	Superclass
Public Member Functions
virtual int	IsA (const char *type)
vtkTextMapper *	NewInstance () const
void	PrintSelf (ostream &os, vtkIndent indent)
void	ShallowCopy (vtkTextMapper *tm)
int	GetNumberOfLines (const char *input)

virtual void	GetSize (vtkViewport *, int size[2])
virtual int	GetWidth (vtkViewport *v)
virtual int	GetHeight (vtkViewport *v)

virtual void	SetInput (const char *inputString)
virtual char *	GetInput ()

virtual void	SetTextProperty (vtkTextProperty *p)
virtual vtkTextProperty *	GetTextProperty ()

virtual int	GetNumberOfLines ()

virtual int	GetSystemFontSize (int size)
Static Public Member Functions
static int	IsTypeOf (const char *type)
static vtkTextMapper *	SafeDownCast (vtkObjectBase *o)
static vtkTextMapper *	New ()

static int	SetMultipleConstrainedFontSize (vtkViewport , int targetWidth, int targetHeight, vtkTextMapper mappers, int nbOfMappers, int maxResultingSize)

static int	SetRelativeFontSize (vtkTextMapper , vtkViewport , int winSize, int stringSize, float sizeFactor=0.0)
static int	SetMultipleRelativeFontSize (vtkViewport viewport, vtkTextMapper textMappers, int nbOfMappers, int winSize, int *stringSize, float sizeFactor)
Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const
	vtkTextMapper ()
	~vtkTextMapper ()
char *	NextLine (const char *input, int lineNum)
void	GetMultiLineSize (vtkViewport *viewport, int size[2])
void	RenderOverlayMultipleLines (vtkViewport viewport, vtkActor2D actor)
Protected Attributes
char *	Input
vtkTextProperty *	TextProperty
int	LineSize
int	NumberOfLines
int	NumberOfLinesAllocated
vtkTextMapper **	TextLines
static int	SetConstrainedFontSize (vtkTextMapper , vtkViewport , int targetWidth, int targetHeight)
virtual int	SetConstrainedFontSize (vtkViewport *, int targetWidth, int targetHeight)

Detailed Description

2D text annotation

vtkTextMapper provides 2D text annotation support for VTK. It is a vtkMapper2D that can be associated with a vtkActor2D and placed into a vtkRenderer.

To use vtkTextMapper, specify an input text string.

See also:: vtkMapper2D vtkActor2D vtkLegendBoxActor vtkCaptionActor2D vtkVectorText vtkTextProperty

Examples:: vtkTextMapper (Examples)

Tests:: vtkTextMapper (Tests)

Definition at line 44 of file vtkTextMapper.h.

Member Typedef Documentation

typedef vtkMapper2D vtkTextMapper::Superclass

Reimplemented from vtkMapper2D.

Reimplemented in vtkOpenGLFreeTypeTextMapper.

Definition at line 47 of file vtkTextMapper.h.

Constructor & Destructor Documentation

vtkTextMapper::vtkTextMapper ( ) [protected]

vtkTextMapper::~vtkTextMapper ( ) [protected]

Member Function Documentation

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

Reimplemented from vtkMapper2D.

Reimplemented in vtkOpenGLFreeTypeTextMapper.

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

Reimplemented from vtkMapper2D.

Reimplemented in vtkOpenGLFreeTypeTextMapper.

static vtkTextMapper* vtkTextMapper::SafeDownCast ( vtkObjectBase * o ) [static]

Reimplemented from vtkMapper2D.

Reimplemented in vtkOpenGLFreeTypeTextMapper.

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

Reimplemented from vtkMapper2D.

Reimplemented in vtkOpenGLFreeTypeTextMapper.

vtkTextMapper* vtkTextMapper::NewInstance ( ) const

Reimplemented from vtkMapper2D.

Reimplemented in vtkOpenGLFreeTypeTextMapper.

void vtkTextMapper::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 vtkMapper2D.

Reimplemented in vtkOpenGLFreeTypeTextMapper.

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

Creates a new text mapper.

Reimplemented from vtkAlgorithm.

Reimplemented in vtkOpenGLFreeTypeTextMapper.

virtual void vtkTextMapper::GetSize	(	vtkViewport *	,
		int	size[2]
	)		`[inline, virtual]`

Return the size[2]/width/height of the rectangle required to draw this mapper (in pixels).

Reimplemented in vtkOpenGLFreeTypeTextMapper.

Definition at line 56 of file vtkTextMapper.h.

virtual int vtkTextMapper::GetWidth ( vtkViewport * v ) [virtual]

Return the size[2]/width/height of the rectangle required to draw this mapper (in pixels).

virtual int vtkTextMapper::GetHeight ( vtkViewport * v ) [virtual]

Return the size[2]/width/height of the rectangle required to draw this mapper (in pixels).

virtual void vtkTextMapper::SetInput ( const char * inputString ) [virtual]

Set the input text string to the mapper. The mapper recognizes "\n" as a carriage return/linefeed (line separator).

virtual char* vtkTextMapper::GetInput ( ) [virtual]

Set the input text string to the mapper. The mapper recognizes "\n" as a carriage return/linefeed (line separator).

virtual void vtkTextMapper::SetTextProperty ( vtkTextProperty * p ) [virtual]

Set/Get the text property.

virtual vtkTextProperty* vtkTextMapper::GetTextProperty ( ) [virtual]

Set/Get the text property.

void vtkTextMapper::ShallowCopy ( vtkTextMapper * tm )

Shallow copy of an actor.

int vtkTextMapper::GetNumberOfLines ( const char * input )

Determine the number of lines in the input string (delimited by "\n").

virtual int vtkTextMapper::GetNumberOfLines ( ) [virtual]

Get the number of lines in the input string (the method GetNumberOfLines(char*) must have been previously called for the return value to be valid).

virtual int vtkTextMapper::SetConstrainedFontSize	(	vtkViewport *	,
		int	targetWidth,
		int	targetHeight
	)		`[virtual]`

Set and return the font size (in points) required to make this mapper fit in a given target rectangle (width x height, in pixels). A static version of the method is also available for convenience to other classes (e.g., widgets).

static int vtkTextMapper::SetConstrainedFontSize	(	vtkTextMapper *	,
		vtkViewport *	,
		int	targetWidth,
		int	targetHeight
	)		`[static]`

Set and return the font size (in points) required to make this mapper fit in a given target rectangle (width x height, in pixels). A static version of the method is also available for convenience to other classes (e.g., widgets).

static int vtkTextMapper::SetMultipleConstrainedFontSize	(	vtkViewport *	,
		int	targetWidth,
		int	targetHeight,
		vtkTextMapper **	mappers,
		int	nbOfMappers,
		int *	maxResultingSize
	)		`[static]`

Set and return the font size (in points) required to make each element of an array of mappers fit in a given rectangle (width x height, in pixels). This font size is the smallest size that was required to fit the largest mapper in this constraint.

static int vtkTextMapper::SetRelativeFontSize	(	vtkTextMapper *	,
		vtkViewport *	,
		int *	winSize,
		int *	stringSize,
		float	sizeFactor = `0.0`
	)		`[static]`

Use these methods when setting font size relative to the renderer's size. These methods are static so that external classes (e.g., widgets) can easily use them.

static int vtkTextMapper::SetMultipleRelativeFontSize	(	vtkViewport *	viewport,
		vtkTextMapper **	textMappers,
		int	nbOfMappers,
		int *	winSize,
		int *	stringSize,
		float	sizeFactor
	)		`[static]`

Use these methods when setting font size relative to the renderer's size. These methods are static so that external classes (e.g., widgets) can easily use them.

virtual int vtkTextMapper::GetSystemFontSize ( int size ) [inline, virtual]