Base implementation of a text geometry. More...

#include <BaseText.hh>

Public Member Functions
	~BaseText () override
	Destructor. More...

gz::math::AxisAlignedBox	AABB () const override
	Get the axis aligned bounding box of the text. More...

float	Baseline () const override
	Get the baseline height in meters. More...

float	CharHeight () const override
	Get the height of the characters in meters return Height of the characters. More...

gz::math::Color	Color () const override
	Get the text color. More...

void	Destroy () override
	Destroy any resources associated with this object. Invoking any other functions after destroying an object will result in undefined behavior. More...

std::string	FontName () const override
	Get the font name. More...

TextHorizontalAlign	HorizontalAlignment () const override
	Get the horizontal alignment of the text. More...

void	PreRender () override
	Prepare this object and any of its children for rendering. This should be called for each object in a scene just before rendering, which can be achieved by a single call to Scene::PreRender. More...

void	SetBaseline (const float _baseline) override
	Set the baseline height of the text. More...

void	SetCharHeight (const float _height) override
	Set the height of the character in meters. More...

void	SetColor (const gz::math::Color &_color) override
	Set the text color. More...

void	SetFontName (const std::string &_font) override
	Set the font. More...

void	SetShowOnTop (const bool _onTop) override
	True = text always is displayed on top. More...

void	SetSpaceWidth (const float _width) override
	Set the width of spaces between words. More...

void	SetTextAlignment (const TextHorizontalAlign &_hAlign, const TextVerticalAlign &_vAlign) override
	Set the alignment of the text. More...

void	SetTextString (const std::string &_text) override
	Set the text to display. More...

bool	ShowOnTop () const override
	Get whether the is displayed above other objects. More...

float	SpaceWidth () const override
	Get the width of spaces between words. More...

std::string	TextString () const override
	Get the displayed text. More...

TextVerticalAlign	VerticalAlignment () const override
	Get the vertical alignment of the text. More...

Public Member Functions inherited from Text
	Text ()=default
	Constructor. More...

virtual	~Text ()
	Destructor. More...

Public Member Functions inherited from Geometry
virtual	~Geometry ()
	Destructor. More...

virtual GeometryPtr	Clone () const =0
	Clone the geometry. More...

virtual bool	HasParent () const =0
	Determine if this Geometry is attached to a Visual. More...

virtual MaterialPtr	Material () const =0
	Get the material of this geometry. More...

virtual VisualPtr	Parent () const =0
	Get the parent Visual. More...

virtual void	RemoveParent ()=0
	Detach this Geometry from its parent Visual. If this Geometry does not have a parent, no work will be done. More...

virtual void	SetMaterial (const std::string &_name, bool _unique=true)=0
	Set the materials of this Geometry. The specified material will be retrieved from the parent Scene. If no material is registered by the given name, no work will be done. More...

virtual void	SetMaterial (MaterialPtr _material, bool _unique=true)=0
	Set the materials of this Geometry. More...

Public Member Functions inherited from Object
virtual	~Object ()
	Destructor. More...

virtual unsigned int	Id () const =0
	Get the object ID. This ID will be unique across all objects inside a given scene, but necessarily true for objects across different scenes. More...

virtual std::string	Name () const =0
	Get the object name. This name will be unique across all objects inside a given scene, but necessarily true for objects across different scenes. More...

virtual void	PostRender ()=0
	Post process this object and any of its children after rendering. More...

virtual ScenePtr	Scene () const =0
	Get the Scene that created this object. More...

Protected Member Functions
	BaseText ()
	Constructor. More...

Protected Attributes
float	baseline = 0
	Baseline height in meters. More...

float	charHeight = 1.0
	Character height in meters. More...

gz::math::Color	color = gz::math::Color::White
	Text color. More...

std::string	fontName = "Liberation Sans"
	Font name, such as "Liberation Sans". More...

TextHorizontalAlign	horizontalAlign
	Horizontal alignment. More...

bool	onTop = false
	True for text to be displayed on top of other objects in the scene. More...

float	spaceWidth = 0
	Width of space between letters. More...

std::string	text
	Text being displayed. More...

bool	textDirty = false
	Flag to indicate text properties have changed. More...

TextVerticalAlign	verticalAlign = TextVerticalAlign::BOTTOM
	Vertical alignment. More...

Detailed Description

template<class T>
class gz::rendering::BaseText< T >

Base implementation of a text geometry.

Constructor & Destructor Documentation

◆ BaseText()

BaseText

protected

Constructor.

◆ ~BaseText()

~BaseText

override

Destructor.

Member Function Documentation

◆ AABB()

gz::math::AxisAlignedBox AABB ( ) const

overridevirtual

Get the axis aligned bounding box of the text.

Returns: The axis aligned bounding box.

Implements Text.

◆ Baseline()

float Baseline ( ) const

overridevirtual

Get the baseline height in meters.

Returns: Baseline height

See also: SetBaseline()

Implements Text.

◆ CharHeight()

float CharHeight ( ) const

overridevirtual

Get the height of the characters in meters return Height of the characters.

See also: SetCharHeight()

Implements Text.

◆ Color()

gz::math::Color Color ( ) const

overridevirtual

Get the text color.

Returns: Text color.

See also: SetColor()

Implements Text.

◆ Destroy()

void Destroy ( )

overridevirtual

Destroy any resources associated with this object. Invoking any other functions after destroying an object will result in undefined behavior.

Implements Object.

◆ FontName()

std::string FontName ( ) const

overridevirtual

Get the font name.

Returns: The font name.

See also: SetFontName()

Implements Text.

◆ HorizontalAlignment()

TextHorizontalAlign HorizontalAlignment ( ) const

overridevirtual

Get the horizontal alignment of the text.

Returns: Text horizontal alignment

Implements Text.

◆ PreRender()

void PreRender ( )

overridevirtual

Prepare this object and any of its children for rendering. This should be called for each object in a scene just before rendering, which can be achieved by a single call to Scene::PreRender.

Implements Object.

◆ SetBaseline()

void SetBaseline ( const float _baseline )

overridevirtual

Set the baseline height of the text.

Parameters

[in] _baseline Baseline height

See also: Baseline()

Implements Text.

◆ SetCharHeight()

void SetCharHeight ( const float _height )

overridevirtual

Set the height of the character in meters.

Parameters

[in] _height Height of the characters.

See also: CharHeight()

Implements Text.

◆ SetColor()

void SetColor ( const gz::math::Color & _color )

overridevirtual

Set the text color.

Parameters

[in] _color Text color.

See also: Color()

Implements Text.

◆ SetFontName()

void SetFontName ( const std::string & _font )

overridevirtual

Set the font.

Parameters

[in] _font Name of the font

See also: FontName()

Implements Text.

◆ SetShowOnTop()

void SetShowOnTop ( const bool _onTop )

overridevirtual

True = text always is displayed on top.

Parameters

[in] _onTop Set to true to render the text on top of all other drawables.

See also: ShowOnTop()

Implements Text.

◆ SetSpaceWidth()

void SetSpaceWidth ( const float _width )

overridevirtual

Set the width of spaces between words.

Parameters

[in] _width Space width

See also: SpaceWidth()

Implements Text.

◆ SetTextAlignment()

void SetTextAlignment	(	const TextHorizontalAlign &	_hAlign,
		const TextVerticalAlign &	_vAlign
	)

overridevirtual

Set the alignment of the text.

Parameters

[in]	_hAlign	Horizontal alignment
[in]	_vAlign	Vertical alignment

Implements Text.

◆ SetTextString()

void SetTextString ( const std::string & _text )

overridevirtual

Set the text to display.

Parameters

[in] _text The text to display.

See also: Text()

Implements Text.

◆ ShowOnTop()

bool ShowOnTop ( ) const

overridevirtual

Get whether the is displayed above other objects.

Returns: True if it is on top.

See also: SetShowOnTop()

Implements Text.

◆ SpaceWidth()

float SpaceWidth ( ) const

overridevirtual

Get the width of spaces between words.

Returns: Space width

See also: SetSpaceWidth()

Implements Text.

◆ TextString()

std::string TextString ( ) const

overridevirtual

Get the displayed text.

Returns: The displayed text.

See also: SetText()

Implements Text.

◆ VerticalAlignment()

TextVerticalAlign VerticalAlignment ( ) const

overridevirtual

Get the vertical alignment of the text.

Returns: Text vertical alignment

Implements Text.

Member Data Documentation

◆ baseline

float baseline = 0

protected

Baseline height in meters.

◆ charHeight

float charHeight = 1.0

protected

Character height in meters.

◆ color

gz::math::Color color = gz::math::Color::White

protected

Text color.

◆ fontName

std::string fontName = "Liberation Sans"

protected

Font name, such as "Liberation Sans".

◆ horizontalAlign

TextHorizontalAlign horizontalAlign

protected

Initial value:

=

TextHorizontalAlign::LEFT

Horizontal alignment.

◆ onTop

bool onTop = false

protected

True for text to be displayed on top of other objects in the scene.

◆ spaceWidth

float spaceWidth = 0

protected

Width of space between letters.

◆ text

std::string text

protected

Text being displayed.

◆ textDirty

bool textDirty = false

protected

Flag to indicate text properties have changed.

◆ verticalAlign

TextVerticalAlign verticalAlign = TextVerticalAlign::BOTTOM

protected

Vertical alignment.

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

BaseText.hh

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

template<class T> class gz::rendering::BaseText< T >

Constructor & Destructor Documentation

◆ BaseText()

◆ ~BaseText()

Member Function Documentation

◆ AABB()

◆ Baseline()

◆ CharHeight()

◆ Color()

◆ Destroy()

◆ FontName()

◆ HorizontalAlignment()

◆ PreRender()

◆ SetBaseline()

◆ SetCharHeight()

◆ SetColor()

◆ SetFontName()

◆ SetShowOnTop()

◆ SetSpaceWidth()

◆ SetTextAlignment()

◆ SetTextString()

◆ ShowOnTop()

◆ SpaceWidth()

◆ TextString()

◆ VerticalAlignment()

Member Data Documentation

◆ baseline

◆ charHeight

◆ color

◆ fontName

◆ horizontalAlign

◆ onTop

◆ spaceWidth

◆ text

◆ textDirty

◆ verticalAlign

template<class T>
class gz::rendering::BaseText< T >