Aspen
2D C++ Class-Based Object Oriented Game Engine
Aspen::Graphics::Animation Class Reference

Animation class Gets all animation frames from child Sprite and UniformSpritesheet Objects. More...

#include <Graphics.hpp>

Inheritance diagram for Aspen::Graphics::Animation:
Aspen::Object::Object

Public Member Functions

 Animation (Object *parent=nullptr, std::string name="Animation")
 Constructor Derived classes should call this in their constructors' initialization list. More...
 
 Animation (UniformSpritesheet *spritesheet, float frameDelay=0.05f, Object *parent=nullptr, std::string name="Animation")
 Constructor Derived classes should call this in their constructors' initialization list. More...
 
 ~Animation ()
 Destructor.
 
void operator() ()
 Draws the sprite to the parent Object's window if parent is of type Graphics.
 
int GetFrameCount ()
 Gets the total number of frames Calculates this by combining the frames of all Sprite and UniformSpritesheet children. More...
 
int GetFrame ()
 Gets the current frame. More...
 
void SetFrame (int frame)
 Sets the current frame. More...
 
float GetFrameDelay ()
 Gets the current frame delay. More...
 
void SetFrameDelay (float delay)
 Sets the frame delay. More...
 
bool Done ()
 True if the animation just looped.
 
void PopulateDebugger ()
 Fills out the Debugger if it exists with this Object's information Derived classes should call their base class's version of this method.
 
- Public Member Functions inherited from Aspen::Object::Object
 Object (Object *parent=nullptr, std::string name="Object")
 Constructor Derived classes should call this in their constructors' initialization list. More...
 
virtual ~Object ()
 Destructor This will End and then delete all child Objects.
 
const ObjectParent () const
 Gets the parent of this Object. More...
 
ObjectParent ()
 Gets the parent of this Object. More...
 
const ObjectRoot () const
 Gets the root Object of the parent/child tree this Object is a part of. More...
 
ObjectRoot ()
 Gets the root Object of the parent/child tree this Object is a part of. More...
 
Transform::TransformGetTransform ()
 Gets the first child Transform::Transform. More...
 
const Transform::TransformGetTransform () const
 Gets the first child Transform::Transform. More...
 
Physics::ColliderGetCollider ()
 Gets the first child Physics::Collider. More...
 
const Physics::ColliderGetCollider () const
 Gets the first child Physics::Collider. More...
 
Physics::RigidbodyGetRigidbody ()
 Gets the first child Physics::Rigidbody. More...
 
const Physics::RigidbodyGetRigidbody () const
 Gets the first child Physics::Rigidbody. More...
 
void AddChild (Object *child)
 Adds child to this Object's list of children This will also set child's _parent to this This will do nothing if child is already in the list of children Useful for adding an already created Object as a child or passing in the return operator new with parameters. More...
 
template<typename T >
T * CreateChild ()
 Creates a new child of type T Useful for creating an object with no constructor parameters and/or modifying it later. More...
 
template<typename T >
T * CreateChild (std::string name)
 Creates a new child of type T Useful for creating an object with no constructor parameters and/or modifying it later. More...
 
void RemoveChild (Object *child)
 Removes child from this Object's list of children This will also set child's _parent to nullptr This will do nothing if child is not in the Object's list of children. More...
 
void RemoveChild (unsigned index)
 Removes the child at index from this Object's list of children This will also set the child's _parent to nullptr This will do nothing if index is out of range of the Object's list of children. More...
 
Objectoperator[] (unsigned index)
 Gets the child at index from this Object's list of children. More...
 
int operator[] (Object *child)
 Gets the index of a given child in this Object's list of children. More...
 
ObjectGetLastChild ()
 Gets the youngest child from this Object's list of children. More...
 
int ParentCount ()
 Determines the generation of this object in the parent/child tree. More...
 
template<typename T >
T * FindAncestorOfType () const
 Finds the closest ancestor Object of a type applicable to that which was requested. More...
 
template<typename T >
const T * FindChildOfType () const
 Finds the first child Object of a type applicable to that which was requested. More...
 
template<typename T >
T * FindChildOfType ()
 Finds the first child Object of a type applicable to that which was requested. More...
 
template<typename T >
const std::vector< T * > FindChildrenOfType () const
 Finds all children Objects of a type applicable to that which was requested. More...
 
template<typename T >
std::vector< T * > FindChildrenOfType ()
 Finds all children Objects of a type applicable to that which was requested. More...
 
template<typename T >
const std::vector< T * > FindDescendentsOfType () const
 Recursively finds all descendent Objects of a type applicable to that which was requested. More...
 
template<typename T >
std::vector< T * > FindDescendentsOfType ()
 Recursively finds all descendent Objects of a type applicable to that which was requested. More...
 
const bool & Valid () const
 Determines if the Object is valid. More...
 
bool Active () const
 Determines if the Object is active. More...
 
void SetActive (bool active)
 Sets active status of the object Triggers OnActivate or OnDeactivate appropriately. More...
 
void Activate ()
 Activates the object Triggers OnActivate appropriately.
 
void Deactivate ()
 Deactivates the object Triggers OnDeactivate appropriately.
 
 operator bool () const
 Converts Object to bool by calling Valid Example: ``` Object o; while (o) o(); ```.
 
virtual void End ()
 Shuts down and invalidates Object and all of its children An invalid child Object will be deleted by their parent after they update.
 
void PrintTree (Log::Log &log) const
 Uses Log::Log to print the parent/children tree of this Object. More...
 
void PrintTree () const
 Uses Log::Log to print the parent/children tree of this Object Uses Log::Debug.
 
std::string Name () const
 Gets the Object's name. More...
 
unsigned ChildrenCount () const
 Determines the number of immediate children the Object has. More...
 
std::vector< Object * > & Children ()
 Gets the list of Objects that are children of this Object. More...
 
bool HasAncestor (const Object *other) const
 Determines if the provided Object is an ancestor of this Object. More...
 
virtual void OnStart ()
 Run when the Object is created.
 
virtual void OnActivate ()
 Run when the Object is activated Run after OnStart.
 
virtual void OnUpdate ()
 Run every frame.
 
virtual void OnEarlyUpdate ()
 Run before OnUpdate.
 
virtual void OnLateUpdate ()
 Run after OnUpdate.
 
virtual void OnDeactivate ()
 Run when the Object is deactivated Run before OnEnd.
 
virtual void OnEnd ()
 Run when the Object is ended/destroyed.
 
virtual void OnCollision (Physics::Collision c)
 Run when a collision occurs. More...
 
virtual void OnMouseEnter ()
 Run when the mouse enters the Object.
 
virtual void OnMouseOver ()
 Run while the mouse is over the Object.
 
virtual void OnMouseExit ()
 Run when the mouse leaves the Object.
 
virtual void OnMouseClick ()
 Run when the mouse is clicked while over the Object.
 
virtual void OnMouseRelease ()
 Run when the mouse is released while over the Object.
 

Private Attributes

int _currentFrame
 Current frame of the animation.
 
float _delay
 Delay in seconds between each frame.
 
float _remainingDelay
 Delay in seconds before the next frame change.
 
bool _done
 True if the animation just looped.
 

Additional Inherited Members

- Protected Member Functions inherited from Aspen::Object::Object
void SetParent (Object *parent)
 Sets _parent to the given Object Used by AddChild, CreateChild, etc.
 
void TriggerOnStart ()
 Runs OnStart if the object is currently active for the first time.
 
void TriggerOnActivate ()
 Runs OnActivate if the object is currently active.
 
void TriggerOnDeactivate ()
 Runs OnDeactivate if the object is currently active (being deactivated)
 
- Protected Attributes inherited from Aspen::Object::Object
const std::string _name
 Name of object.
 
Object_parent
 Parent/owner of this Object.
 
std::vector< Object * > _children
 List of children Objects.
 
bool _valid
 Determines if the Object is valid Derived classes can set this to false in their Constructors if they couldn't be created properly.
 
bool _active
 Determines if the Object is currently updated.
 
bool _started
 Determines if the Object has been started Set to true during the first update.
 
Transform::Transform_transform
 First child Transform::Transform.
 
Physics::Collider_collider
 First child Physics::Collider.
 
Physics::Rigidbody_rigidbody
 First child Physics::Rigidbody.
 
- Static Protected Attributes inherited from Aspen::Object::Object
static int _count
 Total number of Objects in existence.
 

Detailed Description

Animation class Gets all animation frames from child Sprite and UniformSpritesheet Objects.

Constructor & Destructor Documentation

◆ Animation() [1/2]

Aspen::Graphics::Animation::Animation ( Object parent = nullptr,
std::string  name = "Animation" 
)

Constructor Derived classes should call this in their constructors' initialization list.

Parameters
parentParent Object to be passed to Object constructor
nameObject name Set by derived classes to a string representation of their type

◆ Animation() [2/2]

Aspen::Graphics::Animation::Animation ( UniformSpritesheet spritesheet,
float  frameDelay = 0.05f,
Object parent = nullptr,
std::string  name = "Animation" 
)

Constructor Derived classes should call this in their constructors' initialization list.

Parameters
spritesheetUniformSpritesheet to use as a child and from which to get frames
frameDelayDelay in seconds between each frame
parentParent Object to be passed to Object constructor
nameObject name Set by derived classes to a string representation of their type

Member Function Documentation

◆ GetFrame()

int Aspen::Graphics::Animation::GetFrame ( )

Gets the current frame.

Returns
Current frame

◆ GetFrameCount()

int Aspen::Graphics::Animation::GetFrameCount ( )

Gets the total number of frames Calculates this by combining the frames of all Sprite and UniformSpritesheet children.

Returns
Total number of frames

◆ GetFrameDelay()

float Aspen::Graphics::Animation::GetFrameDelay ( )

Gets the current frame delay.

Returns
Current frame delay

◆ SetFrame()

void Aspen::Graphics::Animation::SetFrame ( int  frame)

Sets the current frame.

Parameters
frameNew frame

◆ SetFrameDelay()

void Aspen::Graphics::Animation::SetFrameDelay ( float  delay)

Sets the frame delay.

Parameters
frameNew frame delay

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