Saga3D API Documentation  1.0-RC4
saga::scene::IBillboardTextSceneNode Class Referenceabstract

A billboard text scene node. More...

#include <IBillboardTextSceneNode.h>

Inheritance diagram for saga::scene::IBillboardTextSceneNode:
saga::scene::IBillboardSceneNode saga::scene::ISceneNode saga::IEventReceiver

Public Member Functions

 IBillboardTextSceneNode (ISceneNode *parent, ISceneManager *mgr, std::int32_t id, const glm::vec3 &position=glm::vec3(0, 0, 0))
 Constructor. More...
 
virtual void setSize (const glm::vec2 &size)=0
 Sets the size of the billboard. More...
 
virtual const glm::vec2 & getSize () const =0
 Returns the size of the billboard. More...
 
virtual void setColor (const video::SColor &overallColor)=0
 Set the color of all vertices of the billboard. More...
 
virtual void setColor (const video::SColor &topColor, const video::SColor &bottomColor)=0
 Set the color of the top and bottom vertices of the billboard. More...
 
virtual void getColor (video::SColor &topColor, video::SColor &bottomColor) const =0
 Gets the color of the top and bottom vertices of the billboard. More...
 
virtual void setText (const char *text)=0
 sets the text string More...
 
virtual const char * getText () const =0
 get the text string More...
 
virtual void setTextColor (video::SColor color)
 
virtual gui::IGUIFont * getFont () const =0
 Get the font used to draw the text. More...
 
- Public Member Functions inherited from saga::scene::IBillboardSceneNode
 IBillboardSceneNode (ISceneNode *parent, ISceneManager *mgr, std::int32_t id, const glm::vec3 &position=glm::vec3(0, 0, 0))
 Constructor. More...
 
virtual void setSize (float height, float bottomEdgeWidth, float topEdgeWidth)=0
 Sets the size of the billboard with independent widths of the bottom and top edges. More...
 
virtual void getSize (float &height, float &bottomEdgeWidth, float &topEdgeWidth) const =0
 Gets the size of the the billboard and handles independent top and bottom edge widths correctly. More...
 
virtual const core::aabbox3d< float > & getTransformedBillboardBoundingBox (const saga::scene::ICameraSceneNode *camera)=0
 Get the real boundingbox used by the billboard, which can depend on the active camera. More...
 
- Public Member Functions inherited from saga::scene::ISceneNode
 ISceneNode (const std::shared_ptr< ISceneNode > &parent, const std::shared_ptr< ISceneManager > &mgr, const glm::vec3 &position=glm::vec3(0, 0, 0), const glm::vec3 &rotation=glm::vec3(0, 0, 0), const glm::vec3 &scale=glm::vec3(1.0f, 1.0f, 1.0f))
 Constructor. More...
 
virtual void onEvent (const SDL_Event &event) override
 Called when an SDL event is fired. More...
 
virtual ~ISceneNode ()
 Destructor. More...
 
void setID (const ID id)
 
const auto getID () const
 
virtual void onRegisterSceneNode (video::RenderPassHandle pass)
 This method is called just before the rendering process of the whole scene. More...
 
virtual void onUnregisterSceneNode (video::RenderPassHandle pass)
 
void setOnRender (std::function< void()> func)
 
void onRender ()
 
bool hasDrawCommands () const
 
void setDrawCommands (video::DrawCommandList &&list)
 
const auto & getDrawCommands () const
 
auto getTexture (int slot) const
 
auto & getTextures ()
 
void setTexture (int slot, video::TextureHandle texture)
 
virtual void setPipeline (video::PipelineHandle pipeline)
 
auto getPipeline () const
 
virtual void onAnimate (const float time)
 onAnimate() is called just before rendering the whole scene. More...
 
virtual const std::string & getName () const
 Returns the name of the node. More...
 
virtual void setName (const std::string &name)
 Sets the name of the node. More...
 
virtual const core::aabbox3d< float > & getBoundingBox () const =0
 Get the axis aligned, not transformed bounding box of this node. More...
 
virtual const core::aabbox3d< float > getTransformedBoundingBox () const
 Get the axis aligned, transformed and animated absolute bounding box of this node. More...
 
virtual void getTransformedBoundingBoxEdges (std::vector< glm::vec3 > &edges) const
 
virtual const glm::mat4 & getAbsoluteTransformation () const
 Get the absolute transformation of the node. Is recalculated every onAnimate()-call. More...
 
virtual glm::mat4 getRelativeTransformation () const
 Returns the relative transformation of the scene node. More...
 
virtual bool isVisible () const
 Returns whether the node should be visible (if all of its parents are visible). More...
 
virtual bool isTrulyVisible () const
 Check whether the node is truly visible, taking into accounts its parents' visibility. More...
 
virtual void setVisible (bool isVisible)
 Sets if the node should be visible or not. More...
 
virtual void addChild (const std::shared_ptr< ISceneNode > &child)
 Adds a child to this scene node. More...
 
virtual bool removeChild (const std::shared_ptr< ISceneNode > &child)
 
virtual void removeAll ()
 Removes all children of this scene node. More...
 
virtual void remove ()
 Removes this scene node from the scene. More...
 
virtual void addAnimator (const std::shared_ptr< ISceneNodeAnimator > &animator)
 Adds an animator which should animate this node. More...
 
const auto & getAnimators () const
 Get a list of all scene node animators. More...
 
virtual void removeAnimator (const std::shared_ptr< ISceneNodeAnimator > &animator)
 Removes an animator from this scene node. More...
 
virtual void removeAnimators ()
 Removes all animators from this scene node. More...
 
virtual const glm::vec3 & getScale () const
 Gets the scale of the scene node relative to its parent. More...
 
virtual void setScale (const glm::vec3 &scale)
 Sets the relative scale of the scene node. More...
 
virtual const glm::vec3 & getRotation () const
 Gets the rotation of the node relative to its parent. More...
 
virtual void setRotation (const glm::vec3 &rotation)
 Sets the rotation of the node relative to its parent. More...
 
virtual const glm::vec3 & getPosition () const
 Gets the position of the node relative to its parent. More...
 
virtual void setPosition (const glm::vec3 &newpos)
 Sets the position of the node relative to its parent. More...
 
virtual glm::vec3 getAbsolutePosition () const
 Gets the absolute position of the node in world coordinates. More...
 
const std::vector< std::shared_ptr< ISceneNode > > & getChildren () const
 Returns a const reference to the list of all children. More...
 
virtual void setParent (const std::shared_ptr< ISceneNode > &newParent)
 Changes the parent of the scene node. More...
 
virtual void updateAbsolutePosition ()
 Returns the triangle selector attached to this scene node. More...
 
const std::shared_ptr< ISceneNode > & getParent () const
 Returns the parent of this scene node. More...
 
virtual E_SCENE_NODE_TYPE getType () const
 Returns type of the scene node. More...
 
virtual std::shared_ptr< ISceneNodeclone (const std::shared_ptr< ISceneNode > &newParent=0)
 Creates a clone of this scene node and its children. More...
 
virtual const std::shared_ptr< ISceneManager > & getSceneManager () const
 Retrieve the scene manager for this node. More...
 
- Public Member Functions inherited from saga::IEventReceiver
virtual ~IEventReceiver ()
 Destructor. More...
 

Additional Inherited Members

- Protected Attributes inherited from saga::scene::ISceneNode
ID NodeID = INVALID_ID
 A clone function for the ISceneNode members. More...
 
std::string Name
 Name of the scene node. More...
 
glm::mat4 AbsoluteTransformation
 Absolute transformation of the node. More...
 
glm::vec3 RelativeTranslation
 Relative translation of the scene node. More...
 
glm::vec3 RelativeRotation
 Relative rotation of the scene node. More...
 
glm::vec3 RelativeScale
 Relative scale of the scene node. More...
 
std::shared_ptr< ISceneNodeParent = nullptr
 Pointer to the parent. More...
 
std::vector< std::shared_ptr< ISceneNode > > Children
 List of all children of this node. More...
 
std::array< video::STexture::HandleType, video::MAX_NODE_TEXTURESTextures = { video::NULL_GPU_RESOURCE_HANDLE }
 Texture list. More...
 
std::vector< std::shared_ptr< ISceneNodeAnimator > > Animators
 List of all animator nodes. More...
 
std::shared_ptr< ISceneManagerSceneManager = nullptr
 Pointer to the scene manager. More...
 
std::function< void()> OnRenderCallback = nullptr
 Custom hook into rendering process of the scene node. More...
 
video::DrawCommandList DrawCommands
 
video::PipelineHandle Pipeline = video::NULL_GPU_RESOURCE_HANDLE
 
bool IsVisible = true
 Is the node visible? More...
 

Detailed Description

A billboard text scene node.

Acts like a billboard which displays the currently set text. Due to the exclusion of RTTI in Irrlicht we have to avoid multiple inheritance. Hence, changes to the ITextSceneNode interface have to be copied here manually.

Definition at line 27 of file IBillboardTextSceneNode.h.

Constructor & Destructor Documentation

◆ IBillboardTextSceneNode()

saga::scene::IBillboardTextSceneNode::IBillboardTextSceneNode ( ISceneNode parent,
ISceneManager mgr,
std::int32_t  id,
const glm::vec3 &  position = glm::vec3(0,0,0) 
)
inline

Constructor.

Definition at line 32 of file IBillboardTextSceneNode.h.

Member Function Documentation

◆ getColor()

virtual void saga::scene::IBillboardTextSceneNode::getColor ( video::SColor topColor,
video::SColor bottomColor 
) const
pure virtual

Gets the color of the top and bottom vertices of the billboard.

Parameters
topColorstores the color of the top vertices
bottomColorstores the color of the bottom vertices

Implements saga::scene::IBillboardSceneNode.

◆ getFont()

virtual gui::IGUIFont* saga::scene::IBillboardTextSceneNode::getFont ( ) const
pure virtual

Get the font used to draw the text.

◆ getSize()

virtual const glm::vec2& saga::scene::IBillboardTextSceneNode::getSize ( ) const
pure virtual

Returns the size of the billboard.

Implements saga::scene::IBillboardSceneNode.

◆ getText()

virtual const char* saga::scene::IBillboardTextSceneNode::getText ( ) const
pure virtual

get the text string

◆ setColor() [1/2]

virtual void saga::scene::IBillboardTextSceneNode::setColor ( const video::SColor overallColor)
pure virtual

Set the color of all vertices of the billboard.

Parameters
overallColorthe color to set

Implements saga::scene::IBillboardSceneNode.

◆ setColor() [2/2]

virtual void saga::scene::IBillboardTextSceneNode::setColor ( const video::SColor topColor,
const video::SColor bottomColor 
)
pure virtual

Set the color of the top and bottom vertices of the billboard.

Parameters
topColorthe color to set the top vertices
bottomColorthe color to set the bottom vertices

Implements saga::scene::IBillboardSceneNode.

◆ setSize()

virtual void saga::scene::IBillboardTextSceneNode::setSize ( const glm::vec2 &  size)
pure virtual

Sets the size of the billboard.

Implements saga::scene::IBillboardSceneNode.

◆ setText()

virtual void saga::scene::IBillboardTextSceneNode::setText ( const char *  text)
pure virtual

sets the text string

◆ setTextColor()

virtual void saga::scene::IBillboardTextSceneNode::setTextColor ( video::SColor  color)
inlinevirtual

sets the color of the text You can use setColor instead which does the same

Definition at line 64 of file IBillboardTextSceneNode.h.


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