SpriteManager 2
 All Classes Functions Variables Enumerations Enumerator Properties
UVAnimation_Auto Class Reference
Inheritance diagram for UVAnimation_Auto:
UVAnimation

Public Types

enum  ANIM_END_ACTION {
  ANIM_END_ACTION.Do_Nothing, ANIM_END_ACTION.Revert_To_Static, ANIM_END_ACTION.Play_Default_Anim, ANIM_END_ACTION.Hide,
  ANIM_END_ACTION.Deactivate, ANIM_END_ACTION.Destroy
}
 

Public Member Functions

SPRITE_FRAME[] BuildUVAnim (SpriteRoot s)
 Uses the information stored in this class to build a UV animation for the specified sprite. More...
 
void Reset ()
 Resets all the animation state vars to ready the object for playing anew. More...
 
SPRITE_FRAME GetCurrentFrame ()
 Returns the current frame info without advancing to the next frame. More...
 
SPRITE_FRAME GetFrame (int frame)
 Returns the specified frame. More...
 
SPRITE_FRAME[] BuildUVAnim (Vector2 start, Vector2 cellSize, int cols, int rows, int totalCells)
 Constructs an array of frames based upon the info supplied. NOTE: When the edge of the texture is reached, this algorithm will "wrap" to the next row down, starting directly below the position of the first animation cell on the row above. More...
 
SPRITE_FRAME[] BuildWrappedUVAnim (Vector2 start, Vector2 cellSize, int cols, int rows, int totalCells)
 Constructs an array of frames based upon the info supplied. NOTE: When the edge of the texture is reached, this algorithm will "wrap" to the extreme left edge of the atlas. More...
 
SPRITE_FRAME[] BuildWrappedUVAnim (Vector2 start, Vector2 cellSize, int totalCells)
 Constructs an array of frames based upon the info supplied. NOTE: When the edge of the texture is reached, this algorithm will "wrap" to the extreme left edge of the atlas. More...
 
void SetAnim (SPRITE_FRAME[] anim)
 Assigns the specified array of frames to the animation, replacing its current contents. More...
 
void SetAnim (TextureAnim anim, int idx)
 Assigns all the various animation info to this animation from the specified TextureAnim, replacing any existing animation data. More...
 
void AppendAnim (SPRITE_FRAME[] anim)
 Appends the specified array of frames to the existing animation. More...
 
void SetCurrentFrame (int f)
 Sets the current frame of animation. More...
 
void SetPosition (float pos)
 Sets the current frame based on a 0-1 value indicating the desired position in the animation. For example, a position of 0.5 would specify a frame half-way into the animation. A position of 0 would specify the starting frame. A position of 1 would specify the last frame in the animation. NOTE: Loop cycles and loop reverse are taken into account. To set the frame without regard to loop cycles etc, use SetClipPosition(). More...
 
void SetClipPosition (float pos)
 Sets the current frame based on a 0-1 value indicating the desired position in the animation. For example, a position of 0.5 would specify a frame half-way into the animation. A position of 0 would specify the starting frame. A position of 1 would specify the last frame in the animation. NOTE: Loop cycles and loop reverse are NOT taken into account. Rather, this method sets the desired frame within the clip, the clip being the series of frames 0-n without regard to loop cycles or loop reversing. To set the frame with regard to loop cycles etc, use SetPosition(). More...
 
float GetLength ()
 Returns the length, in seconds, of the animation. NOTE: This does not take into account looping or reversing. It simply returns the length, in seconds, of the animation, when played once from beginning to end. To get the duration of the animation including looping and reversing, use GetDuration(). More...
 
float GetDuration ()
 Returns the duration, in seconds, of the animation. NOTE: This takes into account loop cycles and loop reverse. Ex: If an animation has a framerate of 30fps, consists of 60 frames, and is set to loop once, the duration will be 4 seconds. To retrieve the length of the animation without regard to the loop cycles and loop reverse settings, use GetLength(). More...
 
int GetFrameCount ()
 Returns the number of frames in the animation. More...
 
int GetFramesDisplayed ()
 Returns the number of frames displayed by the animation according to its current loop cycles and loop reverse settings. More...
 
int GetCurPosition ()
 Returns the (zero-based) index of the current frame. More...
 

Public Attributes

Vector2 start
 The pixel coordinates of the lower-left corner of the first frame in the animation sequence. More...
 
Vector2 pixelsToNextColumnAndRow
 The number of pixels from the left edge of one sprite frame to the left edge of the next one, and the number of pixels from the top of one sprite frame to the top of the one in the next row. You may also want to think of this as the size (width and height) of each animation cell. More...
 
int cols
 The number of columns in the animation. More...
 
int rows
 The number of rows in the animation. More...
 
int totalCells
 The total number of frames (cells) of animation. More...
 
string name
 The name of the animation. More...
 
int loopCycles = 0
 How many times to loop the animation IN ADDITION to the initial play-through. -1 indicates to loop infinitely. 0 indicates to place the animation once then stop. 1 indicates to repeat the animation once before stopping, and so on. More...
 
bool loopReverse = false
 Reverse the play direction when the end of the animation is reached? (Ping-pong) If true, a loop iteration isn't counted until the animation returns to the beginning. More...
 
float framerate = 15f
 The rate in frames per second at which to play the animation More...
 
int index = -1
 The index of this animation in the sprite's animation list. This value is only populated by and used for sprites derived from AutoSpriteBase. i.e. SM2 PackedSprites and EZ GUI controls. More...
 
ANIM_END_ACTION onAnimEnd = ANIM_END_ACTION.Do_Nothing
 What the sprite should do when the animation is done playing. The options are to: 1) Do nothing, 2) return to the static image, 3) play the default animation. More...
 

Properties

int StepDirection [get, set]
 The direction in which the animation is currently set to advance. 1 for forwards, -1 for backwards. More...
 

Detailed Description

This derived class allows you to specify parameters in-editor that will build an animation for you.

Definition at line 625 of file SpriteBase.cs.

Member Enumeration Documentation

The action to take when an animation ends.

Enumerator
Do_Nothing 

Do nothing when the animation ends.

Revert_To_Static 

Revert to the static image when the animation ends.

Play_Default_Anim 

Play the default animation when the animation ends.

Hide 

Hide the sprite when the animation ends.

Deactivate 

Deactivate the sprite when the animation ends (sets the GameObject's .active property to false).

Destroy 

Destroys the sprite when the animation ends.

Definition at line 21 of file SpriteBase.cs.

Member Function Documentation

void UVAnimation.AppendAnim ( SPRITE_FRAME[]  anim)
inherited

Appends the specified array of frames to the existing animation.

Parameters
animArray of ANIM_FRAMEs which hold the UV coordinates defining the animation.

Definition at line 432 of file SpriteBase.cs.

SPRITE_FRAME [] UVAnimation.BuildUVAnim ( Vector2  start,
Vector2  cellSize,
int  cols,
int  rows,
int  totalCells 
)
inherited

Constructs an array of frames based upon the info supplied. NOTE: When the edge of the texture is reached, this algorithm will "wrap" to the next row down, starting directly below the position of the first animation cell on the row above.

Parameters
startThe UV of the lower-left corner of the first cell
cellSizewidth and height, in UV space, of each cell
colsNumber of columns in the grid
rowsNumber of rows in the grid
totalCellsTotal number of cells in the grid (left-to-right, top-to-bottom ordering is assumed, just like reading English).
Returns
Array of SPRITE_FRAME objects that contain the UVs of each frame of animation.

Definition at line 281 of file SpriteBase.cs.

SPRITE_FRAME [] UVAnimation_Auto.BuildUVAnim ( SpriteRoot  s)

Uses the information stored in this class to build a UV animation for the specified sprite.

Parameters
sThe sprite for which the animation will be built.
Returns
An array of ANIM_FRAMEs that define the animation.

Definition at line 681 of file SpriteBase.cs.

SPRITE_FRAME [] UVAnimation.BuildWrappedUVAnim ( Vector2  start,
Vector2  cellSize,
int  cols,
int  rows,
int  totalCells 
)
inherited

Constructs an array of frames based upon the info supplied. NOTE: When the edge of the texture is reached, this algorithm will "wrap" to the extreme left edge of the atlas.

Parameters
startThe UV of the lower-left corner of the first cell
cellSizewidth and height, in UV space, of each cell
colsThis argument is ignored but retained for compatibility.
rowsThis argument is ignored but retained for compatibility.
totalCellsTotal number of cells in the in the animation.
Returns
Array of SPRITE_FRAME objects that contain the UVs of each frame of animation.

Definition at line 325 of file SpriteBase.cs.

SPRITE_FRAME [] UVAnimation.BuildWrappedUVAnim ( Vector2  start,
Vector2  cellSize,
int  totalCells 
)
inherited

Constructs an array of frames based upon the info supplied. NOTE: When the edge of the texture is reached, this algorithm will "wrap" to the extreme left edge of the atlas.

Parameters
startThe UV of the lower-left corner of the first cell
cellSizewidth and height, in UV space, of each cell
totalCellsTotal number of cells in the in the animation.
Returns
Array of SPRITE_FRAME objects that contain the UVs of each frame of animation.

Definition at line 341 of file SpriteBase.cs.

int UVAnimation.GetCurPosition ( )
inherited

Returns the (zero-based) index of the current frame.

Returns
Zero-based index of the current frame.

Definition at line 613 of file SpriteBase.cs.

SPRITE_FRAME UVAnimation.GetCurrentFrame ( )
inherited

Returns the current frame info without advancing to the next frame.

Returns
A Rect containing the UV coordinates of the current frame.

Definition at line 251 of file SpriteBase.cs.

float UVAnimation.GetDuration ( )
inherited

Returns the duration, in seconds, of the animation. NOTE: This takes into account loop cycles and loop reverse. Ex: If an animation has a framerate of 30fps, consists of 60 frames, and is set to loop once, the duration will be 4 seconds. To retrieve the length of the animation without regard to the loop cycles and loop reverse settings, use GetLength().

Returns
The duration of the animation in seconds. -1 if the animation loops infinitely.

Definition at line 567 of file SpriteBase.cs.

SPRITE_FRAME UVAnimation.GetFrame ( int  frame)
inherited

Returns the specified frame.

Parameters
frameThe zero-based index of the frame.
Returns
The frame having the specified index.

Definition at line 262 of file SpriteBase.cs.

int UVAnimation.GetFrameCount ( )
inherited

Returns the number of frames in the animation.

Returns
The number of frames in the animation.

Definition at line 585 of file SpriteBase.cs.

int UVAnimation.GetFramesDisplayed ( )
inherited

Returns the number of frames displayed by the animation according to its current loop cycles and loop reverse settings.

Returns
The number of frames displayed, -1 if set to loop infinitely.

Definition at line 596 of file SpriteBase.cs.

float UVAnimation.GetLength ( )
inherited

Returns the length, in seconds, of the animation. NOTE: This does not take into account looping or reversing. It simply returns the length, in seconds, of the animation, when played once from beginning to end. To get the duration of the animation including looping and reversing, use GetDuration().

Returns
The length of the animation in seconds.

Definition at line 553 of file SpriteBase.cs.

void UVAnimation.Reset ( )
inherited

Resets all the animation state vars to ready the object for playing anew.

Definition at line 159 of file SpriteBase.cs.

void UVAnimation.SetAnim ( SPRITE_FRAME[]  anim)
inherited

Assigns the specified array of frames to the animation, replacing its current contents.

Parameters
animArray of ANIM_FRAMEs which hold the UV coordinates defining the animation.

Definition at line 382 of file SpriteBase.cs.

void UVAnimation.SetAnim ( TextureAnim  anim,
int  idx 
)
inherited

Assigns all the various animation info to this animation from the specified TextureAnim, replacing any existing animation data.

Parameters
animReference to the TextureAnim containing the desired info.
idxThe index of this animation.

Definition at line 395 of file SpriteBase.cs.

void UVAnimation.SetClipPosition ( float  pos)
inherited

Sets the current frame based on a 0-1 value indicating the desired position in the animation. For example, a position of 0.5 would specify a frame half-way into the animation. A position of 0 would specify the starting frame. A position of 1 would specify the last frame in the animation. NOTE: Loop cycles and loop reverse are NOT taken into account. Rather, this method sets the desired frame within the clip, the clip being the series of frames 0-n without regard to loop cycles or loop reversing. To set the frame with regard to loop cycles etc, use SetPosition().

Parameters
posPercentage of the way through the animation (0-1).

Definition at line 533 of file SpriteBase.cs.

void UVAnimation.SetCurrentFrame ( int  f)
inherited

Sets the current frame of animation.

Parameters
fThe number of the frame.

Definition at line 447 of file SpriteBase.cs.

void UVAnimation.SetPosition ( float  pos)
inherited

Sets the current frame based on a 0-1 value indicating the desired position in the animation. For example, a position of 0.5 would specify a frame half-way into the animation. A position of 0 would specify the starting frame. A position of 1 would specify the last frame in the animation. NOTE: Loop cycles and loop reverse are taken into account. To set the frame without regard to loop cycles etc, use SetClipPosition().

Parameters
posPercentage of the way through the animation (0-1).

Definition at line 468 of file SpriteBase.cs.

Member Data Documentation

int UVAnimation_Auto.cols

The number of columns in the animation.

Definition at line 645 of file SpriteBase.cs.

float UVAnimation.framerate = 15f
inherited

The rate in frames per second at which to play the animation

Definition at line 93 of file SpriteBase.cs.

int UVAnimation.index = -1
inherited

The index of this animation in the sprite's animation list. This value is only populated by and used for sprites derived from AutoSpriteBase. i.e. SM2 PackedSprites and EZ GUI controls.

Definition at line 103 of file SpriteBase.cs.

int UVAnimation.loopCycles = 0
inherited

How many times to loop the animation IN ADDITION to the initial play-through. -1 indicates to loop infinitely. 0 indicates to place the animation once then stop. 1 indicates to repeat the animation once before stopping, and so on.

Definition at line 78 of file SpriteBase.cs.

bool UVAnimation.loopReverse = false
inherited

Reverse the play direction when the end of the animation is reached? (Ping-pong) If true, a loop iteration isn't counted until the animation returns to the beginning.

Definition at line 86 of file SpriteBase.cs.

string UVAnimation.name
inherited

The name of the animation.

Definition at line 69 of file SpriteBase.cs.

ANIM_END_ACTION UVAnimation.onAnimEnd = ANIM_END_ACTION.Do_Nothing
inherited

What the sprite should do when the animation is done playing. The options are to: 1) Do nothing, 2) return to the static image, 3) play the default animation.

Definition at line 111 of file SpriteBase.cs.

Vector2 UVAnimation_Auto.pixelsToNextColumnAndRow

The number of pixels from the left edge of one sprite frame to the left edge of the next one, and the number of pixels from the top of one sprite frame to the top of the one in the next row. You may also want to think of this as the size (width and height) of each animation cell.

Definition at line 640 of file SpriteBase.cs.

int UVAnimation_Auto.rows

The number of rows in the animation.

Definition at line 650 of file SpriteBase.cs.

Vector2 UVAnimation_Auto.start

The pixel coordinates of the lower-left corner of the first frame in the animation sequence.

Definition at line 631 of file SpriteBase.cs.

int UVAnimation_Auto.totalCells

The total number of frames (cells) of animation.

Definition at line 655 of file SpriteBase.cs.

Property Documentation

int UVAnimation.StepDirection
getsetinherited

The direction in which the animation is currently set to advance. 1 for forwards, -1 for backwards.

Definition at line 118 of file SpriteBase.cs.


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