An animation that controls the scale of an object. You can specify the point to use for the center of scaling. More...

#include <ScaleAnimation.h>

Inheritance diagram for SScaleAnimation:

Public Member Functions
	SScaleAnimation ()
	Default constructor for SScaleAnimation.

void	init (float fromX, float toX, float fromY, float toY, const SValueDescription &pivotX, const SValueDescription &pivotY)
	Constructor to use when building a ScaleAnimation 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 SScaleAnimation.

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.

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

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

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.

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

Detailed Description

An animation that controls the scale of an object. You can specify the point to use for the center of scaling.

Definition at line 12 of file ScaleAnimation.h.

Constructor & Destructor Documentation

◆ SScaleAnimation()

SScaleAnimation::SScaleAnimation ( )

Default constructor for SScaleAnimation.

Definition at line 65 of file ScaleAnimation.cpp.

Member Function Documentation

◆ applyTransformation()

void SScaleAnimation::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 13 of file ScaleAnimation.cpp.

◆ copy()

void SScaleAnimation::copy ( const IAnimation * src )

protected

Copies the properties of another animation to this animation.

Parameters

src	Pointer to the source animation to copy from.

Definition at line 39 of file ScaleAnimation.cpp.

◆ init()

void SScaleAnimation::init	(	float	fromX,
		float	toX,
		float	fromY,
		float	toY,
		const SValueDescription &	pivotX,
		const SValueDescription &	pivotY )

Constructor to use when building a ScaleAnimation from code.

Parameters

fromX	Horizontal scaling factor to apply at the start of the animation.
toX	Horizontal scaling factor to apply at the end of the animation.
fromY	Vertical scaling factor to apply at the start of the animation.
toY	Vertical scaling factor to apply at the end of the animation.
pivotXType	Specifies how pivotXValue should be interpreted. One of Animation.ABSOLUTE, Animation.RELATIVE_TO_SELF, or Animation.RELATIVE_TO_PARENT.
pivotXValue	The X coordinate of the point about which the object is being scaled, specified as an absolute number where 0 is the left edge. (This point remains fixed while the object changes size.) This value can either be an absolute number if pivotXType is ABSOLUTE, or a percentage (where 1.0 is 100%) otherwise.
pivotYType	Specifies how pivotYValue should be interpreted. One of Animation.ABSOLUTE, Animation.RELATIVE_TO_SELF, or Animation.RELATIVE_TO_PARENT.
pivotYValue	The Y coordinate of the point about which the object is being scaled, specified as an absolute number where 0 is the top edge. (This point remains fixed while the object changes size.) This value can either be an absolute number if pivotYType is ABSOLUTE, or a percentage (where 1.0 is 100%) otherwise.

Definition at line 54 of file ScaleAnimation.cpp.

◆ initialize()

SNSBEGIN void SScaleAnimation::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 7 of file ScaleAnimation.cpp.

◆ SetAttribute()

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

inlinevirtual

Attributes for SScaleAnimation.

< Horizontal scaling factor to apply at the start of the animation. Horizontal scaling factor to apply at the end of the animation. Vertical scaling factor to apply at the start of the animation. Vertical scaling factor to apply at the end of the animation.

< Description of the pivot X value. Description of the pivot Y value.

Reimplemented from SAnimation.

Definition at line 81 of file ScaleAnimation.h.

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

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

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SScaleAnimation()

Member Function Documentation

◆ applyTransformation()

◆ copy()

◆ init()

◆ initialize()

◆ SetAttribute()