An animation that controls the position of an object. More...

#include <STranslateAnimation.h>

Inheritance diagram for STranslateAnimation:

Public Member Functions
	STranslateAnimation ()
	Default constructor for STranslateAnimation.

void	init (const SValueDescription &fromX, const SValueDescription &toX, const SValueDescription &fromY, const SValueDescription &toY)
	Constructor to use when building a TranslateAnimation from code.

void	initialize (int width, int height, int parentWidth, int parentHeight, int nScale) OVERRIDE
	Initializes the animation with the dimensions of the object and its parent.

virtual HRESULT	SetAttribute (const SNS::SStringW &amp;amp;amp;strAttribName, const SNS::SStringW &amp;amp;amp;strValue, BOOL bLoading=FALSE)
	Attributes for STranslateAnimation.

Public Member Functions inherited from SAnimation
	SAnimation ()
	Default constructor for SAnimation.

	~SAnimation ()
	Destructor for SAnimation.

IAnimation *	clone () SCONST OVERRIDE
	Creates a new animation with a duration of 0ms, the default interpolator, with fillBefore set to true and fillAfter set to false.

void	copy (const IAnimation *src) OVERRIDE
	Copies the properties of another animation to this animation.

void	reset () OVERRIDE
	Resets the animation to its initial state.

void	cancel () OVERRIDE
	Cancels the animation.

void	setInterpolator (IInterpolator *i) OVERRIDE
	Sets the interpolator used by the animation to smooth the movement.

void	setDuration (long durationMillis) OVERRIDE
	Sets the duration of one animation cycle in milliseconds.

void	scaleCurrentDuration (float scale) OVERRIDE
	Scales the current duration of the animation.

void	setFillBefore (BOOL bFill) OVERRIDE
	Sets whether the animation transformation should be applied before the animation starts.

void	setFillAfter (BOOL bFill) OVERRIDE
	Sets whether the animation transformation should be applied after the animation ends.

BOOL	getFillBefore () SCONST OVERRIDE
	Gets whether the animation transformation should be applied before the animation starts.

BOOL	getFillAfter () SCONST OVERRIDE
	Gets whether the animation transformation should be applied after the animation ends.

void	setStartOffset (long offset) OVERRIDE
	Sets the delay in milliseconds after which the animation must start.

BOOL	isFillEnabled () SCONST OVERRIDE
	Checks whether fillBefore should be taken into account.

void	setFillEnabled (BOOL fillEnabled) OVERRIDE
	Sets whether fillBefore should be taken into account.

void	setStartTime (int64_t startTimeMillis) OVERRIDE
	Sets the start time of the animation.

void	start () OVERRIDE
	Starts the animation.

void	startNow () OVERRIDE
	Starts the animation immediately.

void	setRepeatMode (RepeatMode repeatMode) OVERRIDE
	Sets the repeat mode of the animation.

void	setRepeatCount (int repeatCount) OVERRIDE
	Sets the number of times the animation must repeat.

void	setZAdjustment (ZAdjustment zAdjustment) OVERRIDE
	Sets the desired Z order mode during animation.

IInterpolator *	getInterpolator () SCONST OVERRIDE
	Gets the interpolator used by the animation.

int64_t	getStartTime () SCONST OVERRIDE
	Gets the start time of the animation.

long	getDuration () SCONST OVERRIDE
	Gets the duration of one animation cycle.

long	getStartOffset () SCONST OVERRIDE
	Gets the delay in milliseconds after which the animation must start.

RepeatMode	getRepeatMode () SCONST OVERRIDE
	Gets the repeat mode of the animation.

int	getRepeatCount () SCONST OVERRIDE
	Gets the number of times the animation must repeat.

ZAdjustment	getZAdjustment () SCONST OVERRIDE
	Gets the desired Z order mode during animation.

void	setAnimationListener (IAnimationListener *listener) OVERRIDE
	Sets the animation listener to be notified when the animation starts, ends, or repeats.

long	computeDurationHint () SCONST OVERRIDE
	Computes the duration hint for the animation.

BOOL	getTransformation2 (uint64_t currentTime, ITransformation *outTransformation, float scale) OVERRIDE
	Gets the transformation at a specific time.

BOOL	getTransformation (uint64_t currentTime, ITransformation *outTransformation) OVERRIDE
	Gets the transformation at a specific time.

BOOL	hasStarted () SCONST OVERRIDE
	Checks whether the animation has started.

BOOL	hasEnded () SCONST OVERRIDE
	Checks whether the animation has ended.

void	applyTransformation (float interpolatedTime, ITransformation *t) OVERRIDE
	Applies the transformation at a specific interpolated time.

BOOL	hasAlpha () SCONST OVERRIDE
	Checks whether the animation affects the alpha property.

void	initialize (int width, int height, int parentWidth, int parentHeight, int nScale) OVERRIDE
	Initializes the animation with the dimensions of the object and its parent.

void	setUserData (ULONG_PTR data) OVERRIDE
	Sets user data associated with the animation.

ULONG_PTR	getUserData () SCONST OVERRIDE
	Gets user data associated with the animation.

void	pause () OVERRIDE
	Pauses the animation.

void	resume () OVERRIDE
	Resumes the animation.

Public Member Functions inherited from TObjRefImpl< SObjectImpl< IAnimation > >
	TObjRefImpl ()
	Constructor that initializes the reference count to 1.

virtual	~TObjRefImpl ()
	Virtual destructor.

long	AddRef () override
	Increments the reference count.

long	Release () override
	Decrements the reference count and deletes the object if the count reaches zero.

void	OnFinalRelease () override
	Deletes the object.

Public Member Functions inherited from SObjectImpl< IAnimation >
	SObjectImpl ()
	Constructor.

BOOL	InitFromXml (IXmlNode *pXmlNode) OVERRIDE
	Initializes the object from an XML node.

LPCWSTR	GetName () SCONST OVERRIDE
	Retrieves the object's name.

LPCSTR	GetNameA () SCONST OVERRIDE
	Retrieves the object's name in ANSI format.

void	SetName (LPCWSTR pszName) OVERRIDE
	Sets the object's name.

int	GetID () SCONST OVERRIDE
	Retrieves the object's ID.

void	SetID (int nID) OVERRIDE
	Sets the object's ID.

HRESULT	AfterAttribute (LPCWSTR strAttribName, LPCWSTR strValue, BOOL bLoading, HRESULT hr) OVERRIDE
	Handles attribute processing after setting an attribute.

HRESULT	SetAttributeA (LPCSTR pszAttr, LPCSTR pszValue, BOOL bLoading) OVERRIDE
	Sets an attribute using ANSI strings.

HRESULT	SetAttribute (LPCWSTR pszAttr, LPCWSTR pszValue, BOOL bLoading) OVERRIDE
	Sets an attribute using wide strings.

virtual HRESULT	SetAttribute (const SStringW &strAttr, const SStringW &strValue, BOOL bLoading)
	Sets an attribute using wide strings.

HRESULT	ISetAttribute (const IStringW strAttr, const IStringW strValue, BOOL bLoading) OVERRIDE
	Sets an attribute using IStringW objects.

LPCWSTR	GetObjectClass () SCONST OVERRIDE
	Retrieves the object's class name.

int	GetObjectType () SCONST OVERRIDE
	Retrieves the object's type.

BOOL	IsClass (LPCWSTR lpszName) SCONST OVERRIDE
	Checks if the object is of a specific class.

BOOL	GetAttribute (LPCWSTR strAttr, IStringW *pValue) SCONST OVERRIDE
	Retrieves an attribute value.

void	OnInitFinished (IXmlNode *xmlNode) OVERRIDE
	Handles initialization completion.

void	SetAttrHandler (FunAttrHandler attrHandler) OVERRIDE
	Sets the attribute handler.

virtual HRESULT	DefAttributeProc (const SStringW &strAttr, const SStringW &strValue, BOOL bLoading)
	Default attribute processing.

Protected Member Functions
void	applyTransformation (float interpolatedTime, ITransformation *t) OVERRIDE
	Applies the transformation at a specific interpolated time.

Protected Member Functions inherited from SAnimation
bool	isCanceled ()
	Checks whether the animation is canceled.

void	fireAnimationStart ()
	Notifies the animation listener that the animation has started.

void	fireAnimationRepeat ()
	Notifies the animation listener that the animation has repeated.

void	fireAnimationEnd ()
	Notifies the animation listener that the animation has ended.

int	resolveSize (const SValueDescription &value, int size, int parentSize, int nScale)
	Converts the information in the description of a size to an actual dimension.

void	ensureInterpolator ()
	Ensures that this animation has an interpolator. Will use an AccelerateDecelerateInterpolator if nothing else was specified.

float	getScaleFactor ()
	Gets the scale factor that should be applied to pre-scaled values in an Animation. Such as the pivot points in `ScaleAnimation` and `RotateAnimation`.

Protected Attributes
SValueDescription	mFromXValue
	Description of the starting X value.

SValueDescription	mToXValue
	Description of the ending X value.

SValueDescription	mFromYValue
	Description of the starting Y value.

SValueDescription	mToYValue
	Description of the ending Y value.

float	mFromXDelta
	The starting X delta value.

float	mToXDelta
	The ending X delta value.

float	mFromYDelta
	The starting Y delta value.

float	mToYDelta
	The ending Y delta value.

Protected Attributes inherited from SAnimation
bool	mEnded
	Set by `getTransformation(long, STransformation)` when the animation ends.

bool	mStarted
	Set by `getTransformation(long, STransformation)` when the animation starts.

bool	mCycleFlip
	Set by `getTransformation(long, STransformation)` when the animation repeats in REVERSE mode.

uint64_t	mStartTime
	The time in milliseconds at which the animation must start.

long	mStartOffset
	The delay in milliseconds after which the animation must start. When the start offset is > 0, the start time of the animation is startTime + startOffset.

long	mDuration
	The duration of one animation cycle in milliseconds.

int	mRepeatCount
	The number of times the animation must repeat. By default, an animation repeats indefinitely.

int	mRepeated
	Indicates how many times the animation was repeated.

RepeatMode	mRepeatMode
	The behavior of the animation when it repeats. The repeat mode is either `RESTART` or `REVERSE`.

SAutoRefPtr< IInterpolator >	mInterpolator
	The interpolator used by the animation to smooth the movement.

IAnimationListener *	mListener
	The animation listener to be notified when the animation starts, ends, or repeats.

ZAdjustment	mZAdjustment
	Desired Z order mode during animation.

float	mScaleFactor
	Scale factor to apply to pivot points, etc. during animation. Subclasses retrieve the value via getScaleFactor().

BOOL	mFillBefore
	Indicates whether the animation transformation should be applied before the animation starts. The value of this variable is only relevant if mFillEnabled is true; otherwise, it is assumed to be true.

BOOL	mFillAfter
	Indicates whether the animation transformation should be applied after the animation ends.

BOOL	mFillEnabled
	Indicates whether fillBefore should be taken into account.

ULONG_PTR	mUserData
	User data associated with the animation.

bool	mPaused
	Indicates whether the animation is paused.

uint64_t	mPauseTime
	The time at which the animation was paused.

Protected Attributes inherited from TObjRefImpl< SObjectImpl< IAnimation > >
LONG	m_cRef
	Reference count.

Protected Attributes inherited from SObjectImpl< IAnimation >
SStringW	m_strName

int	m_nID

FunAttrHandler	m_attrHandler

Additional Inherited Members
Static Public Member Functions inherited from SObjectImpl< IAnimation >
static int	GetClassType ()
	Retrieves the class type.

static LPCWSTR	GetClassName ()
	Retrieves the class name.

static LPCWSTR	GetClassAlias ()
	Retrieves the class alias.

static void	MarkAttributeHandled (SXmlAttr xmlAttr, bool bHandled)
	Marks an attribute as handled.

static bool	IsAttributeHandled (SXmlAttr xmlAttr)
	Checks if an attribute is handled.

Detailed Description

An animation that controls the position of an object.

See the full package description for details and sample code.

Definition at line 14 of file STranslateAnimation.h.

Constructor & Destructor Documentation

◆ STranslateAnimation()

STranslateAnimation::STranslateAnimation ( )

Default constructor for STranslateAnimation.

Definition at line 38 of file STranslateAnimation.cpp.

Member Function Documentation

◆ applyTransformation()

void STranslateAnimation::applyTransformation	(	float	interpolatedTime,
		ITransformation *	t )

protected

Applies the transformation at a specific interpolated time.

Parameters

interpolatedTime	Interpolated time between 0 and 1.
t	Pointer to the transformation to apply.

Definition at line 14 of file STranslateAnimation.cpp.

◆ init()

void STranslateAnimation::init	(	const SValueDescription &	fromX,
		const SValueDescription &	toX,
		const SValueDescription &	fromY,
		const SValueDescription &	toY )

Constructor to use when building a TranslateAnimation from code.

Parameters

fromX	Description of the starting X value. This value can either be an absolute number if fromXType is ABSOLUTE, or a percentage (where 1.0 is 100%) otherwise.
toX	Description of the ending X value. This value can either be an absolute number if toXType is ABSOLUTE, or a percentage (where 1.0 is 100%) otherwise.
fromY	Description of the starting Y value. This value can either be an absolute number if fromYType is ABSOLUTE, or a percentage (where 1.0 is 100%) otherwise.
toY	Description of the ending Y value. This value can either be an absolute number if toYType is ABSOLUTE, or a percentage (where 1.0 is 100%) otherwise.

Definition at line 30 of file STranslateAnimation.cpp.

◆ initialize()

SNSBEGIN void STranslateAnimation::initialize	(	int	width,
		int	height,
		int	parentWidth,
		int	parentHeight,
		int	nScale )

Initializes the animation with the dimensions of the object and its parent.

Parameters

width	Width of the object being animated.
height	Height of the object being animated.
parentWidth	Width of the parent of the object being animated.
parentHeight	Height of the parent of the object being animated.
nScale	Scale factor.

Definition at line 6 of file STranslateAnimation.cpp.

◆ SetAttribute()

virtual HRESULT STranslateAnimation::SetAttribute	(	const SNS::SStringW &amp;amp;amp;	strAttribName,
		const SNS::SStringW &amp;amp;amp;	strValue,
		BOOL	bLoading = FALSE )

inlinevirtual

Attributes for STranslateAnimation.

< Description of the starting X value.

< Description of the ending X value.

< Description of the starting Y value.

< Description of the ending Y value.

Reimplemented from SAnimation.

Definition at line 72 of file STranslateAnimation.h.

Member Data Documentation

◆ mFromXDelta

float STranslateAnimation::mFromXDelta

protected

The starting X delta value.

Definition at line 23 of file STranslateAnimation.h.

◆ mFromXValue

SValueDescription STranslateAnimation::mFromXValue

protected

Description of the starting X value.

Definition at line 18 of file STranslateAnimation.h.

◆ mFromYDelta

float STranslateAnimation::mFromYDelta

protected

The starting Y delta value.

Definition at line 25 of file STranslateAnimation.h.

◆ mFromYValue

SValueDescription STranslateAnimation::mFromYValue

protected

Description of the starting Y value.

Definition at line 20 of file STranslateAnimation.h.

◆ mToXDelta

float STranslateAnimation::mToXDelta

protected

The ending X delta value.

Definition at line 24 of file STranslateAnimation.h.

◆ mToXValue

SValueDescription STranslateAnimation::mToXValue

protected

Description of the ending X value.

Definition at line 19 of file STranslateAnimation.h.

◆ mToYDelta

float STranslateAnimation::mToYDelta

protected

The ending Y delta value.

Definition at line 26 of file STranslateAnimation.h.

◆ mToYValue

SValueDescription STranslateAnimation::mToYValue

protected

Description of the ending Y value.

Definition at line 21 of file STranslateAnimation.h.

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

SOUI/include/animation/STranslateAnimation.h
SOUI/src/animation/STranslateAnimation.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ STranslateAnimation()

Member Function Documentation

◆ applyTransformation()

◆ init()

◆ initialize()

◆ SetAttribute()

Member Data Documentation

◆ mFromXDelta

◆ mFromXValue

◆ mFromYDelta

◆ mFromYValue

◆ mToXDelta

◆ mToXValue

◆ mToYDelta

◆ mToYValue