BitmapText Class Reference

An actor that holds a Font and draws text to the screen. More...

#include <BitmapText.h>

Inheritance diagram for BitmapText:

Collaboration diagram for BitmapText:

Classes
struct	Attribute
struct	BMT_TweenState

Public Member Functions
	BitmapText (const BitmapText &cpy)
auto	operator= (const BitmapText &cpy) -> BitmapText &
void	LoadFromNode (const XNode *pNode) override
auto	Copy () const -> BitmapText *override
auto	BMT_DestTweenState () -> BMT_TweenState &
auto	BMT_DestTweenState () const -> BMT_TweenState const &
void	SetCurrentTweenStart () override
void	EraseHeadTween () override
void	UpdatePercentThroughTween (float between) override
void	BeginTweening (float time, ITween *interp) override
virtual void	BeginTweening (float time, TweenType tt=TWEEN_LINEAR) override
void	StopTweening () override
void	FinishTweening () override
auto	LoadFromFont (const std::string &sFontName) -> bool
auto	LoadFromTextureAndChars (const std::string &sTexturePath, const std::string &sChars) -> bool
virtual void	SetText (const std::string &sText, const std::string &sAlternateText="", int iWrapWidthPixels=-1)
void	SetVertSpacing (int iSpacing)
void	SetMaxWidth (float fMaxWidth)
void	SetMaxHeight (float fMaxHeight)
void	SetMaxDimUseZoom (bool use)
void	SetWrapWidthPixels (int iWrapWidthPixels)
void	CropLineToWidth (size_t l, int width)
void	CropToWidth (int width)
auto	EarlyAbortDraw () const -> bool override
	Allow the Actor to be aborted early.
void	DrawPrimitives () override
	Draw the primitives of the Actor.
void	SetUppercase (bool b)
void	SetRainbowScroll (bool b)
void	SetJitter (bool b)
void	SetDistortion (float f)
void	UnSetDistortion ()
void	set_mult_attrs_with_diffuse (bool m)
auto	get_mult_attrs_with_diffuse () const -> bool
void	SetHorizAlign (float f) override
void	SetStrokeColor (const RageColor &c)
auto	GetStrokeColor () -> RageColor const &
void	SetCurrStrokeColor (const RageColor &c)
auto	GetCurrStrokeColor () -> RageColor const &
void	SetTextGlowMode (TextGlowMode tgm)
void	GetLines (std::vector< std::wstring > &wTextLines) const
auto	GetLines () const -> const std::vector< std::wstring > &
auto	GetText () const -> std::string
auto	StringWillUseAlternate (const std::string &sText, const std::string &sAlternateText) const -> bool
auto	GetDefaultAttribute () const -> Attribute
void	AddAttribute (size_t iPos, const Attribute &attr)
void	ClearAttributes ()
void	PushSelf (lua_State *L) override
Public Member Functions inherited from Actor
	Actor ()
	Set up the Actor with its initial settings.
	Actor (const Actor &cpy)
	Copy a new Actor to the old one.
Actor &	operator= (const Actor &x)
virtual void	InitState ()
auto	PartiallyOpaque () const -> bool
auto	IsOver (float mx, float my) -> bool
auto	GetFakeParentOrParent () -> Actor *
auto	GetTrueX () -> float
auto	GetTrueY () -> float
auto	GetTrueZ () -> float
auto	GetTrueRotationX () -> float
auto	GetTrueRotationY () -> float
auto	GetTrueRotationZ () -> float
auto	GetTrueZoom () -> float
auto	GetTrueZoomX () -> float
auto	GetTrueZoomY () -> float
auto	GetTrueZoomZ () -> float
auto	IsVisible () -> bool
void	Draw ()
	Calls multiple functions for drawing the Actors.
virtual void	PreDraw ()
	Calculate values that may be needed for drawing.
virtual void	PostDraw ()
	Reset internal diffuse and glow.
virtual void	BeginDraw ()
	Start the drawing and push the transform on the world matrix stack.
virtual void	SetGlobalRenderStates ()
	Set the global rendering states of this Actor.
virtual void	SetTextureRenderStates ()
	Set the texture rendering states of this Actor.
virtual void	EndDraw ()
	Pop the transform from the world matrix stack.
virtual void	Update (float fDeltaTime)
virtual void	UpdateInternal (float fDeltaTime)
void	UpdateTweening (float fDeltaTime)
void	CalcPercentThroughTween ()
auto	get_tween_uses_effect_delta () const -> bool
void	set_tween_uses_effect_delta (bool t)
auto	GetName () const -> const std::string &
	Retrieve the Actor's name.
virtual void	SetName (const std::string &sName)
	Set the Actor's name to a new one.
void	SetParent (Actor *pParent)
	Give this Actor a new parent.
auto	GetParent () const -> Actor *
	Retrieve the Actor's parent.
auto	GetLineage () const -> std::string
	Retrieve the Actor's lineage.
void	SetFakeParent (Actor *mailman)
auto	GetFakeParent () const -> Actor *
void	AddWrapperState ()
void	RemoveWrapperState (size_t i)
auto	GetWrapperState (size_t i) -> Actor *
auto	GetNumWrapperStates () const -> size_t
auto	GetX () const -> float
	Retrieve the Actor's x position.
auto	GetY () const -> float
	Retrieve the Actor's y position.
auto	GetZ () const -> float
	Retrieve the Actor's z position.
auto	GetDestX () const -> float
auto	GetDestY () const -> float
auto	GetDestZ () const -> float
void	SetX (float x)
void	SetY (float y)
void	SetZ (float z)
void	SetXY (float x, float y)
void	AddX (float x)
	Add to the x position of this Actor.
void	AddY (float y)
	Add to the y position of this Actor.
void	AddZ (float z)
	Add to the z position of this Actor.
auto	GetUnzoomedWidth () const -> float
auto	GetUnzoomedHeight () const -> float
auto	GetZoomedWidth () const -> float
auto	GetZoomedHeight () const -> float
void	SetWidth (float width)
void	SetHeight (float height)
auto	GetBaseZoomX () const -> float
void	SetBaseZoomX (float zoom)
auto	GetBaseZoomY () const -> float
void	SetBaseZoomY (float zoom)
auto	GetBaseZoomZ () const -> float
void	SetBaseZoomZ (float zoom)
void	SetBaseZoom (float zoom)
void	SetBaseRotationX (float rot)
void	SetBaseRotationY (float rot)
void	SetBaseRotationZ (float rot)
void	SetBaseRotation (const RageVector3 &rot)
virtual void	SetBaseAlpha (float fAlpha)
void	SetInternalDiffuse (const RageColor &c)
void	SetInternalGlow (const RageColor &c)
auto	GetZoom () const -> float
	Retrieve the general zoom factor, using the x coordinate of the Actor.
auto	GetZoomX () const -> float
	Retrieve the zoom factor for the x coordinate of the Actor.
auto	GetZoomY () const -> float
	Retrieve the zoom factor for the y coordinate of the Actor.
auto	GetZoomZ () const -> float
	Retrieve the zoom factor for the z coordinate of the Actor.
void	SetZoom (float zoom)
	Set the zoom factor for all dimensions of the Actor.
void	SetZoomX (float zoom)
	Set the zoom factor for the x dimension of the Actor.
void	SetZoomY (float zoom)
	Set the zoom factor for the y dimension of the Actor.
void	SetZoomZ (float zoom)
	Set the zoom factor for the z dimension of the Actor.
void	ZoomTo (float fX, float fY)
void	ZoomToWidth (float zoom)
void	ZoomToHeight (float zoom)
auto	GetRotationX () const -> float
auto	GetRotationY () const -> float
auto	GetRotationZ () const -> float
void	SetRotationX (float rot)
void	SetRotationY (float rot)
void	SetRotationZ (float rot)
void	AddRotationX (float rot)
void	AddRotationY (float rot)
void	AddRotationZ (float rot)
void	AddRotationH (float rot)
void	AddRotationP (float rot)
void	AddRotationR (float rot)
void	SetSkewX (float fAmount)
auto	GetSkewX (float) const -> float
void	SetSkewY (float fAmount)
auto	GetSkewY (float) const -> float
auto	GetCropLeft () const -> float
auto	GetCropTop () const -> float
auto	GetCropRight () const -> float
auto	GetCropBottom () const -> float
void	SetCropLeft (float percent)
void	SetCropTop (float percent)
void	SetCropRight (float percent)
void	SetCropBottom (float percent)
void	SetFadeLeft (float percent)
void	SetFadeTop (float percent)
void	SetFadeRight (float percent)
void	SetFadeBottom (float percent)
void	SetGlobalDiffuseColor (const RageColor &c)
virtual void	SetDiffuse (const RageColor &c)
virtual void	SetDiffuseAlpha (float f)
auto	GetCurrentDiffuseAlpha () const -> float
void	SetDiffuseColor (const RageColor &c)
void	SetDiffuses (int i, const RageColor &c)
void	SetDiffuseUpperLeft (const RageColor &c)
void	SetDiffuseUpperRight (const RageColor &c)
void	SetDiffuseLowerLeft (const RageColor &c)
void	SetDiffuseLowerRight (const RageColor &c)
void	SetDiffuseTopEdge (const RageColor &c)
void	SetDiffuseRightEdge (const RageColor &c)
void	SetDiffuseBottomEdge (const RageColor &c)
void	SetDiffuseLeftEdge (const RageColor &c)
auto	GetDiffuse () const -> RageColor
auto	GetDiffuses (int i) const -> RageColor
auto	GetDiffuseAlpha () const -> float
void	SetGlow (const RageColor &c)
auto	GetGlow () const -> RageColor
void	SetAux (float f)
auto	GetAux () const -> float
void	Sleep (float time)
void	QueueCommand (const std::string &sCommandName)
void	QueueMessage (const std::string &sMessageName)
virtual void	HurryTweening (float factor)
virtual auto	GetTweenTimeLeft () const -> float
auto	DestTweenState () -> TweenState &
auto	DestTweenState () const -> const TweenState &
void	ScaleToCover (const RectF &rect)
void	ScaleToFitInside (const RectF &rect)
void	ScaleTo (const RectF &rect, StretchType st)
void	StretchTo (const RectF &rect)
virtual void	SetVertAlign (float f)
void	SetHorizAlign (HorizAlign ha)
void	SetVertAlign (VertAlign va)
virtual auto	GetHorizAlign () -> float
virtual auto	GetVertAlign () -> float
void	StopEffect ()
auto	GetEffect () const -> Effect
auto	GetSecsIntoEffect () const -> float
auto	GetEffectDelta () const -> float
void	SetEffectColor1 (const RageColor &c)
void	SetEffectColor2 (const RageColor &c)
void	RecalcEffectPeriod ()
void	SetEffectPeriod (float fTime)
auto	GetEffectPeriod () const -> float
auto	SetEffectTiming (float ramp_toh, float at_half, float ramp_tof, float at_zero, float at_full, std::string &err) -> bool
auto	SetEffectHoldAtFull (float haf, std::string &err) -> bool
void	SetEffectOffset (float fTime)
void	SetEffectClock (EffectClock c)
void	SetEffectClockString (const std::string &s)
void	SetEffectMagnitude (const RageVector3 &vec)
auto	GetEffectMagnitude () const -> RageVector3
void	ResetEffectTimeIfDifferent (Effect new_effect)
void	SetEffectDiffuseBlink (float fEffectPeriodSeconds, const RageColor &c1, const RageColor &c2)
void	SetEffectDiffuseShift (float fEffectPeriodSeconds, const RageColor &c1, const RageColor &c2)
void	SetEffectDiffuseRamp (float fEffectPeriodSeconds, const RageColor &c1, const RageColor &c2)
void	SetEffectGlowBlink (float fEffectPeriodSeconds, const RageColor &c1, const RageColor &c2)
void	SetEffectGlowShift (float fEffectPeriodSeconds, const RageColor &c1, const RageColor &c2)
void	SetEffectGlowRamp (float fEffectPeriodSeconds, const RageColor &c1, const RageColor &c2)
void	SetEffectRainbow (float fEffectPeriodSeconds)
void	SetEffectWag (float fPeriod, const RageVector3 &vect)
void	SetEffectBounce (float fPeriod, const RageVector3 &vect)
void	SetEffectBob (float fPeriod, const RageVector3 &vect)
void	SetEffectPulse (float fPeriod, float fMinZoom, float fMaxZoom)
void	SetEffectSpin (const RageVector3 &vect)
void	SetEffectVibrate (const RageVector3 &vect)
auto	GetVisible () const -> bool
	Determine if the Actor is visible at this time.
void	SetVisible (bool b)
void	SetShadowLength (float fLength)
void	SetShadowLengthX (float fLengthX)
void	SetShadowLengthY (float fLengthY)
void	SetShadowColor (const RageColor &c)
void	SetDrawOrder (int iOrder)
auto	GetDrawOrder () const -> int
virtual void	EnableAnimation (bool b)
void	StartAnimating ()
void	StopAnimating ()
void	SetBlendMode (BlendMode mode)
void	SetTextureTranslate (float x, float y)
void	SetTextureWrapping (bool b)
void	SetTextureFiltering (bool b)
void	SetClearZBuffer (bool b)
void	SetUseZBuffer (bool b)
virtual void	SetZTestMode (ZTestMode mode)
virtual void	SetZWrite (bool b)
void	SetZBias (float f)
virtual void	SetCullMode (CullMode mode)
virtual void	PushContext (lua_State *L)
void	AddCommand (const std::string &sCmdName, const apActorCommands &apac, bool warn=true)
auto	HasCommand (const std::string &sCmdName) const -> bool
auto	GetCommand (const std::string &sCommandName) const -> const apActorCommands *
void	PlayCommand (const std::string &sCommandName)
void	PlayCommandNoRecurse (const Message &msg)
virtual void	RunCommands (const LuaReference &cmds, const LuaReference *pParamTable=nullptr)
virtual void	RunCommands (const apActorCommands &cmds, const LuaReference *pParamTable=nullptr)
virtual void	RunCommandsRecursively (const LuaReference &cmds, const LuaReference *pParamTable=nullptr)
virtual void	RunCommandsOnLeaves (const LuaReference &cmds, const LuaReference *pParamTable=nullptr)
void	HandleMessage (const Message &msg) override
virtual auto	GetNumStates () const -> int
virtual void	SetState (int)
virtual auto	GetAnimationLengthSeconds () const -> float
virtual void	SetSecondsIntoAnimation (float)
virtual void	SetUpdateRate (float)
virtual auto	GetUpdateRate () -> float
Public Member Functions inherited from MessageSubscriber
	MessageSubscriber (const MessageSubscriber &cpy)
auto	operator= (const MessageSubscriber &cpy) -> MessageSubscriber &
void	SubscribeToMessage (MessageID message)
void	SubscribeToMessage (const std::string &sMessageName)
void	UnsubscribeAll ()
Public Member Functions inherited from IMessageSubscriber
void	ClearMessages (const std::string &sMessage="")

Public Attributes
std::vector< RageSpriteVertex >	m_aVertices
Public Attributes inherited from Actor
std::unique_ptr< LuaClass >	m_pLuaInstance

Protected Member Functions
void	BuildChars ()
void	DrawChars (bool bUseStrokeTexture)
void	UpdateBaseZoom ()
Protected Member Functions inherited from Actor
auto	GetEffectDeltaTime () const -> float

Protected Attributes
Font *	m_pFont
bool	m_bUppercase
std::string	m_sText
std::vector< std::wstring >	m_wTextLines
std::vector< int >	m_iLineWidths
int	m_iWrapWidthPixels
float	m_fMaxWidth
float	m_fMaxHeight
bool	m_MaxDimensionUsesZoom
bool	m_bRainbowScroll
bool	m_bJitter
bool	m_bUsingDistortion
bool	m_mult_attrs_with_diffuse
float	m_fDistortion
int	m_iVertSpacing
std::vector< FontPageTextures * >	m_vpFontPageTextures
std::map< size_t, Attribute >	m_mAttributes
bool	m_bHasGlowAttribute
TextGlowMode	m_TextGlowMode
Protected Attributes inherited from Actor
std::string	m_sName
	the name of the Actor.
Actor *	m_pParent
	the current parent of this Actor if it exists.
Actor *	m_FakeParent
std::vector< Actor * >	m_WrapperStates
RageVector3	m_baseRotation
RageVector3	m_baseScale
float	m_fBaseAlpha {}
RageColor	m_internalDiffuse
RageColor	m_internalGlow
RageVector2	m_size
TweenState	m_current
TweenState	m_start
std::vector< TweenStateAndInfo * >	m_Tweens
TweenState *	m_pTempState {}
	Temporary variables that are filled just before drawing.
float	m_fHorizAlign {}
	The particular horizontal alignment.
float	m_fVertAlign {}
	The particular vertical alignment.
Effect	m_Effect
float	m_fSecsIntoEffect {}
float	m_fEffectDelta {}
float	m_effect_ramp_to_half {}
float	m_effect_hold_at_half {}
float	m_effect_ramp_to_full {}
float	m_effect_hold_at_full {}
float	m_effect_hold_at_zero {}
float	m_fEffectOffset {}
float	m_effect_period {}
EffectClock	m_EffectClock
bool	m_tween_uses_effect_delta
RageColor	m_effectColor1
RageColor	m_effectColor2
RageVector3	m_vEffectMagnitude
bool	m_bVisible {}
bool	m_bIsAnimating {}
float	m_fShadowLengthX {}
float	m_fShadowLengthY {}
RageColor	m_ShadowColor
int	m_iDrawOrder {}
	The draw order priority.
BlendMode	m_BlendMode
ZTestMode	m_ZTestMode
CullMode	m_CullMode
RageVector2	m_texTranslate
bool	m_bTextureWrapping {}
bool	m_bTextureFiltering {}
bool	m_bClearZBuffer {}
bool	m_bZWrite {}
float	m_fZBias {}
	The amount of bias.

Additional Inherited Members
Public Types inherited from Actor
enum	Effect {   no_effect , diffuse_blink , diffuse_shift , diffuse_ramp ,   glow_blink , glow_shift , glow_ramp , rainbow ,   wag , bounce , bob , pulse ,   spin , vibrate }
	The list of the different effects. More...
enum	EffectClock {   CLOCK_TIMER , CLOCK_TIMER_GLOBAL , CLOCK_BGM_TIME , CLOCK_BGM_BEAT ,   CLOCK_BGM_TIME_NO_OFFSET , CLOCK_BGM_BEAT_NO_OFFSET , CLOCK_BGM_BEAT_PLAYER1 , CLOCK_BGM_BEAT_PLAYER2 ,   CLOCK_LIGHT_1 = 1000 , CLOCK_LIGHT_LAST = 1100 , NUM_CLOCKS }
	Various values an Actor's effect can be tied to.
enum	StretchType { fit_inside , cover }
	How do we handle stretching the Actor? More...
Static Public Member Functions inherited from Actor
static void	SetBGMTime (float fTime, float fBeat, float fTimeNoOffset, float fBeatNoOffset)
static void	SetPlayerBGMBeat (float fBeat, float fBeatNoOffset)
Static Protected Attributes inherited from Actor
static float	g_fCurrentBGMTime = 0
static float	g_fCurrentBGMBeat
static float	g_fCurrentBGMTimeNoOffset = 0
static float	g_fCurrentBGMBeatNoOffset = 0
static std::vector< float >	g_vfCurrentBGMBeatPlayer
static std::vector< float >	g_vfCurrentBGMBeatPlayerNoOffset

Detailed Description

An actor that holds a Font and draws text to the screen.

Member Function Documentation

BeginTweening() [1/2]

void BitmapText::BeginTweening ( float  time, ITween *  interp  )

overridevirtual

Reimplemented from Actor.

BeginTweening() [2/2]

virtual void BitmapText::BeginTweening ( float  time, TweenType  tt = TWEEN_LINEAR  )

inlineoverridevirtual

Reimplemented from Actor.

Copy()

auto BitmapText::Copy ( ) const -> BitmapText *override

overridevirtual

Reimplemented from Actor.

Reimplemented in SongBPMDisplay, and BPMDisplay.

DrawPrimitives()

void BitmapText::DrawPrimitives ( )

overridevirtual

Draw the primitives of the Actor.

Derivative classes should override this function.

Reimplemented from Actor.

Reimplemented in ColorBitmapText, and RollingNumbers.

EarlyAbortDraw()

bool BitmapText::EarlyAbortDraw ( ) const -> bool

overridevirtual

Allow the Actor to be aborted early.

Subclasses may wish to overwrite this to allow for aborted actors.

Returns

false, as by default Actors shouldn't be aborted on drawing.

Reimplemented from Actor.

EraseHeadTween()

void BitmapText::EraseHeadTween ( )

overridevirtual

Reimplemented from Actor.

FinishTweening()

void BitmapText::FinishTweening ( )

overridevirtual

Reimplemented from Actor.

LoadFromNode()

void BitmapText::LoadFromNode ( const XNode *  pNode )

overridevirtual

Reimplemented from Actor.

PushSelf()

void BitmapText::PushSelf ( lua_State *  L )

overridevirtual

Reimplemented from Actor.

SetCurrentTweenStart()

void BitmapText::SetCurrentTweenStart ( )

overridevirtual

Reimplemented from Actor.

SetHorizAlign()

void BitmapText::SetHorizAlign ( float  f )

overridevirtual

Reimplemented from Actor.

SetText()

void BitmapText::SetText ( const std::string &  sText, const std::string &  sAlternateText = "", int  iWrapWidthPixels = -1  )

virtual

Reimplemented in ColorBitmapText.

StopTweening()

void BitmapText::StopTweening ( )

overridevirtual

Reimplemented from Actor.

UpdatePercentThroughTween()

void BitmapText::UpdatePercentThroughTween ( float  between )

overridevirtual

Reimplemented from Actor.

---

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

• /home/runner/work/etterna/etterna/src/Etterna/Actor/Base/BitmapText.h
• /home/runner/work/etterna/etterna/src/Etterna/Actor/Base/BitmapText.cpp