Base implementation of a text geometry. More...

#include <BaseText.hh>

Public Member Functions
virtual	~BaseText ()
	Destructor.

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

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

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

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

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

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

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

virtual 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.

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

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

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

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

void	SetShowOnTop (const bool _onTop) override
	True = text always is displayed ontop.

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

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

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

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

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

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

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

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

virtual	~Text ()
	Destructor.

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

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

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

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

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

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

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.

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

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

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.

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.

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

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

Protected Member Functions
	BaseText ()
	Constructor.

Protected Attributes
float	baseline = 0
	Baseline height in meters.

float	charHeight = 1.0
	Character height in meters.

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

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

TextHorizontalAlign	horizontalAlign
	Horizontal alignment.

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

float	spaceWidth = 0
	Width of space between letters.

std::string	text
	Text being displayed.

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

TextVerticalAlign	verticalAlign = TextVerticalAlign::BOTTOM
	Vertical alignment.

Detailed Description

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

Base implementation of a text geometry.

Constructor & Destructor Documentation

◆ BaseText()

template<class T >

BaseText ( )

protected

Constructor.

◆ ~BaseText()

template<class T >

~BaseText ( )

virtual

Destructor.

Member Function Documentation

◆ AABB()

template<class T >

gz::math::AxisAlignedBox AABB ( ) const

overridevirtual

Get the axis aligned bounding box of the text.

Returns: The axis aligned bounding box.

Implements Text.

Reimplemented in OgreText.

◆ Baseline()

template<class T >

float Baseline ( ) const

overridevirtual

Get the baseline height in meters.

Returns: Baseline height

See also: SetBaseline()

Implements Text.

◆ CharHeight()

template<class T >

float CharHeight ( ) const

overridevirtual

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

See also: SetCharHeight()

Implements Text.

◆ Color()

template<class T >

gz::math::Color Color ( ) const

overridevirtual

Get the text color.

Returns: Text color.

See also: SetColor()

Implements Text.

◆ Destroy()

template<class T >

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()

template<class T >

std::string FontName ( ) const

overridevirtual

Get the font name.

Returns: The font name.

See also: SetFontName()

Implements Text.

◆ HorizontalAlignment()

template<class T >

TextHorizontalAlign HorizontalAlignment ( ) const

overridevirtual

Get the horizontal alignment of the text.

Returns: Text horizontal alignment

Implements Text.

◆ PreRender()

template<class T >

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.

Reimplemented in OgreText.

◆ SetBaseline()

template<class T >

void SetBaseline ( const float _baseline )

overridevirtual

Set the baseline height of the text.

Parameters

[in] _baseline Baseline height

See also: Baseline()

Implements Text.

Reimplemented in OgreText.

◆ SetCharHeight()

template<class T >

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.

Reimplemented in OgreText.

◆ SetColor()

template<class T >

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

overridevirtual

Set the text color.

Parameters

[in] _color Text color.

See also: Color()

Implements Text.

Reimplemented in OgreText.

◆ SetFontName()

template<class T >

void SetFontName ( const std::string & _font )

overridevirtual

Set the font.

Parameters

[in] _font Name of the font

See also: FontName()

Implements Text.

Reimplemented in OgreText.

◆ SetShowOnTop()

template<class T >

void SetShowOnTop ( const bool _onTop )

overridevirtual

True = text always is displayed ontop.

Parameters

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

See also: ShowOnTop()

Implements Text.

Reimplemented in OgreText.

◆ SetSpaceWidth()

template<class T >

void SetSpaceWidth ( const float _width )

overridevirtual

Set the width of spaces between words.

Parameters

[in] _width Space width

See also: SpaceWidth()

Implements Text.

Reimplemented in OgreText.

◆ SetTextAlignment()

template<class T >

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.

Reimplemented in OgreText.

◆ SetTextString()

template<class T >

void SetTextString ( const std::string & _text )

overridevirtual

Set the text to display.

Parameters

[in] _text The text to display.

See also: Text()

Implements Text.

Reimplemented in OgreText.

◆ ShowOnTop()

template<class T >

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()

template<class T >

float SpaceWidth ( ) const

overridevirtual

Get the width of spaces between words.

Returns: Space width

See also: SetSpaceWidth()

Implements Text.

◆ TextString()

template<class T >

std::string TextString ( ) const

overridevirtual

Get the displayed text.

Returns: The displayed text.

See also: SetText()

Implements Text.

◆ VerticalAlignment()

template<class T >

TextVerticalAlign VerticalAlignment ( ) const

overridevirtual

Get the vertical alignment of the text.

Returns: Text verical alignment

protected

BaseText.hh

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

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