An animation that controls the alpha level of an object. More...

#include <SAlphaAnimation.h>

Inheritance diagram for SAlphaAnimation:

Public Types
typedef SAnimation	__baseCls

Public Member Functions
virtual LPCWSTR WINAPI	GetObjectClass () const

virtual BOOL WINAPI	IsClass (LPCWSTR lpszName) const

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

	SAlphaAnimation ()
	Default constructor.

void	init (float fromAlpha=0.0f, float toAlpha=0.0f)
	Initializes the alpha animation with specified start and end alpha values.

BOOL	hasAlpha ()
	Checks if the animation affects the alpha property.

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.

Static Public Member Functions
static LPCWSTR	GetClassName ()

static int	GetClassType ()

static LPCWSTR	GetClassAlise ()

static LPCWSTR	BaseClassName ()

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 Member Functions
void	applyTransformation (float interpolatedTime, ITransformation *t)
	Changes the alpha property of the supplied `STransformation`.

void	copy (const IAnimation *src)
	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
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 alpha level of an object.

Useful for fading things in and out. This animation ends up changing the alpha property of a STransformation.

Definition at line 14 of file SAlphaAnimation.h.

Member Typedef Documentation

◆ __baseCls

typedef SAnimation SAlphaAnimation::__baseCls

Definition at line 15 of file SAlphaAnimation.h.

Constructor & Destructor Documentation

◆ SAlphaAnimation()

SNSBEGIN SAlphaAnimation::SAlphaAnimation ( )

Default constructor.

Definition at line 7 of file SAlphaAnimation.cpp.

Member Function Documentation

◆ applyTransformation()

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

protected

Changes the alpha property of the supplied STransformation.

Parameters

interpolatedTime	The elapsed fraction of the animation's duration.
t	Pointer to the transformation to apply the animation to.

Definition at line 24 of file SAlphaAnimation.cpp.

◆ BaseClassName()

static LPCWSTR SAlphaAnimation::BaseClassName ( )

inlinestatic

Definition at line 15 of file SAlphaAnimation.h.

◆ copy()

void SAlphaAnimation::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 30 of file SAlphaAnimation.cpp.

◆ GetClassAlise()

static LPCWSTR SAlphaAnimation::GetClassAlise ( )

inlinestatic

Definition at line 15 of file SAlphaAnimation.h.

◆ GetClassName()

static LPCWSTR SAlphaAnimation::GetClassName ( )

inlinestatic

Definition at line 15 of file SAlphaAnimation.h.

◆ GetClassType()

static int SAlphaAnimation::GetClassType ( )

inlinestatic

Definition at line 15 of file SAlphaAnimation.h.

◆ GetObjectClass()

virtual LPCWSTR WINAPI SAlphaAnimation::GetObjectClass ( ) const

inlinevirtual

Definition at line 15 of file SAlphaAnimation.h.

◆ hasAlpha()

BOOL SAlphaAnimation::hasAlpha ( )

Checks if the animation affects the alpha property.

Returns: TRUE if the animation affects the alpha property, FALSE otherwise. @hide

Definition at line 19 of file SAlphaAnimation.cpp.

◆ init()

void SAlphaAnimation::init	(	float	fromAlpha = 0.0f,
		float	toAlpha = 0.0f )

Initializes the alpha animation with specified start and end alpha values.

Parameters

fromAlpha	Starting alpha value for the animation, where 1.0 means fully opaque and 0.0 means fully transparent.
toAlpha	Ending alpha value for the animation.

Definition at line 13 of file SAlphaAnimation.cpp.

◆ IsClass()

virtual BOOL WINAPI SAlphaAnimation::IsClass ( LPCWSTR lpszName ) const

inlinevirtual

Definition at line 15 of file SAlphaAnimation.h.

◆ SetAttribute()

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

inlinevirtual

Attributes for SAlphaAnimation.

< Starting alpha value attribute. Ending alpha value attribute.

Reimplemented from SAnimation.

Definition at line 25 of file SAlphaAnimation.h.

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

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

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ __baseCls

Constructor & Destructor Documentation

◆ SAlphaAnimation()

Member Function Documentation

◆ applyTransformation()

◆ BaseClassName()

◆ copy()

◆ GetClassAlise()

◆ GetClassName()

◆ GetClassType()

◆ GetObjectClass()

◆ hasAlpha()

◆ init()

◆ IsClass()

◆ SetAttribute()