Gamedev Framework (gf)  0.10.0
A C++14 framework for 2D games
Public Member Functions | Protected Member Functions | List of all members
gf::TextWidget Class Reference

A simple text widget. More...

#include <gf/Widgets.h>

Inheritance diagram for gf::TextWidget:
Inheritance graph
[legend]

Public Member Functions

 TextWidget (std::string text, Font &font, unsigned characterSize=30)
 Constructor. More...
 
virtual void draw (RenderTarget &target, const RenderStates &states) override
 Draw the object to a render target. More...
 
virtual bool contains (Vector2f coords) override
 Check if the widget contains the coordinates. More...
 
void setTextOutlineThickness (float thickness)
 Set the thickness of the outline. More...
 
void setDisabledTextColor (const Color4f &color)
 Set the text's color of the button when disabled. More...
 
void setDisabledTextOutlineColor (const Color4f &color)
 Set the outline's color of the button when disabled. More...
 
void setDefaultTextColor (const Color4f &color)
 Set the text's color of the button when it's in a normal state. More...
 
void setDefaultTextOutlineColor (const Color4f &color)
 Set the outline's color of the button when it's in a normal state. More...
 
void setSelectedTextColor (const Color4f &color)
 Set the text's color of the button when selected. More...
 
void setSelectedTextOutlineColor (const Color4f &color)
 Set the outline's color of the button when selected. More...
 
RectF getLocalBounds () const
 Get the local bounding rectangle of the entity. More...
 
void setAnchor (Anchor anchor)
 Set the anchor origin of the entity. More...
 
- Public Member Functions inherited from gf::Widget
 Widget ()
 Constructor. More...
 
void setDisabled ()
 Disable the widget. More...
 
bool isDisabled () const noexcept
 Check if the widget is disabled. More...
 
void setDefault ()
 Set the widget to it's default state. More...
 
bool isDefault () const noexcept
 Check if the widget is in default state. More...
 
void setSelected ()
 Select the widget. More...
 
bool isSelected () const
 Check if the widget is selected. More...
 
void setState (WidgetState state)
 Set the state of the widget directly. More...
 
WidgetState getState () const noexcept
 Get the state of the widget. More...
 
void setCallback (std::function< void()> callback)
 Set the callback of the widget. More...
 
void triggerCallback ()
 Execute the callback function. More...
 
- Public Member Functions inherited from gf::Transformable
 Transformable ()
 Default constructor. More...
 
void setOrigin (Vector2f origin)
 Set the local origin of the object. More...
 
Vector2f getOrigin () const
 Get the local origin of the object. More...
 
void setPosition (Vector2f position)
 Set the position of the object. More...
 
Vector2f getPosition () const
 Get the position of the object. More...
 
void move (Vector2f offset)
 Move the object by a given offset. More...
 
void setRotation (float angle)
 Set the orientation of the object. More...
 
float getRotation () const
 Get the orientation of the object. More...
 
void rotate (float angle)
 Rotate the object. More...
 
void setScale (Vector2f factors)
 Set the scale factors of the object. More...
 
void setScale (float factor)
 Set the scale factor of the object. More...
 
Vector2f getScale () const
 Get the current scale of the object. More...
 
void scale (Vector2f factors)
 Scale the object. More...
 
void scale (float factor)
 Scale the object. More...
 
Matrix3f getTransform () const
 Get the combined transform of the object. More...
 
Matrix3f getInverseTransform () const
 Get the inverse of the combined transform of the object. More...
 
- Public Member Functions inherited from gf::Drawable
virtual ~Drawable ()
 Virtual desctructor. More...
 

Protected Member Functions

void updateCurrentStateColors ()
 
void updateColors (Color4f textColor, Color4f outlineColor)
 
void updateGeometry ()
 
virtual void onStateChanged () override
 Function called when the state changes. More...
 
BasicTextgetText ()
 
- Protected Member Functions inherited from gf::Widget
virtual void triggered ()
 Function called when the callback is triggered. More...
 
- Protected Member Functions inherited from gf::Transformable
void setOriginFromAnchorAndBounds (Anchor anchor, const RectF &bounds)
 Set the origin from an anchor and bounds. More...
 

Detailed Description

A simple text widget.

See also
gf::Text

Constructor & Destructor Documentation

◆ TextWidget()

gf::TextWidget::TextWidget ( std::string  text,
Font font,
unsigned  characterSize = 30 
)

Constructor.

Parameters
textA text to convert to a widget.
fontFont used to draw the text
characterSizeBase size of characters, in pixels

Member Function Documentation

◆ contains()

virtual bool gf::TextWidget::contains ( Vector2f  coords)
overridevirtual

Check if the widget contains the coordinates.

Parameters
coordsThe coordinates to check
Returns
True if the coordinates are inside the widget

Implements gf::Widget.

Reimplemented in gf::TextButtonWidget.

◆ draw()

virtual void gf::TextWidget::draw ( RenderTarget target,
const RenderStates states 
)
overridevirtual

Draw the object to a render target.

This is a pure virtual function that has to be implemented by the derived class to define how the drawable should be drawn.

Parameters
targetRender target to draw to
statesCurrent render states

Implements gf::Drawable.

Reimplemented in gf::TextButtonWidget.

◆ getLocalBounds()

RectF gf::TextWidget::getLocalBounds ( ) const
inline

Get the local bounding rectangle of the entity.

The returned rectangle is in local coordinates, which means that it ignores the transformations (translation, rotation, scale, ...) that are applied to the entity. In other words, this function returns the bounds of the entity in the entity's coordinate system.

Returns
Local bounding rectangle of the entity

◆ getText()

BasicText& gf::TextWidget::getText ( )
inlineprotected

◆ onStateChanged()

virtual void gf::TextWidget::onStateChanged ( )
overrideprotectedvirtual

Function called when the state changes.

Reimplemented from gf::Widget.

Reimplemented in gf::TextButtonWidget.

◆ setAnchor()

void gf::TextWidget::setAnchor ( Anchor  anchor)

Set the anchor origin of the entity.

Compute the origin of the entity based on the local bounds and the specified anchor. Internally, this function calls Transformable::setOrigin().

Parameters
anchorThe anchor of the entity
See also
getLocalBounds(), Transformable::setOrigin()

◆ setDefaultTextColor()

void gf::TextWidget::setDefaultTextColor ( const Color4f color)

Set the text's color of the button when it's in a normal state.

Parameters
colorThe new color to apply

◆ setDefaultTextOutlineColor()

void gf::TextWidget::setDefaultTextOutlineColor ( const Color4f color)

Set the outline's color of the button when it's in a normal state.

Parameters
colorThe new color to apply

◆ setDisabledTextColor()

void gf::TextWidget::setDisabledTextColor ( const Color4f color)

Set the text's color of the button when disabled.

Parameters
colorThe new color to apply

◆ setDisabledTextOutlineColor()

void gf::TextWidget::setDisabledTextOutlineColor ( const Color4f color)

Set the outline's color of the button when disabled.

Parameters
colorThe new color to apply

◆ setSelectedTextColor()

void gf::TextWidget::setSelectedTextColor ( const Color4f color)

Set the text's color of the button when selected.

Parameters
colorThe new color to apply

◆ setSelectedTextOutlineColor()

void gf::TextWidget::setSelectedTextOutlineColor ( const Color4f color)

Set the outline's color of the button when selected.

Parameters
colorThe new color to apply

◆ setTextOutlineThickness()

void gf::TextWidget::setTextOutlineThickness ( float  thickness)

Set the thickness of the outline.

Parameters
thicknessThe new value of the outline thickness.

◆ updateColors()

void gf::TextWidget::updateColors ( Color4f  textColor,
Color4f  outlineColor 
)
protected

◆ updateCurrentStateColors()

void gf::TextWidget::updateCurrentStateColors ( )
protected

◆ updateGeometry()

void gf::TextWidget::updateGeometry ( )
protected