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

Time management class. More...

#include <Time.hpp>

Inheritance diagram for Aspen::Time::Time:
Aspen::Object::Object

Public Member Functions

 Time (Object *parent=nullptr, std::string name="Time")
 Constructor Derived classes should call this in their constructors' initialization list. More...
 
 Time (unsigned targetFramerate, Object *parent=nullptr, std::string name="Time")
 Constructor Derived classes should call this in their constructors' initialization list. More...
 
 ~Time ()
 Destructor.
 
void operator() ()
 Updates this object and all of its children Derived classes should call or reimplement this at some point in their operator() This won't run if the Object isn't Active.
 
double StartTime ()
 Start time of the application in seconds. More...
 
double LastTime ()
 Start time of the last frame in seconds. More...
 
double CurrentTime ()
 Start time of the current frame in seconds. More...
 
double DeltaTime ()
 Time since the last frame in seconds. More...
 
double FPS ()
 Current framerate of the application. More...
 
void Sleep (double time)
 Sleeps for a set amount of time. More...
 
void Sleep (float time)
 Sleeps for a set amount of time. More...
 
unsigned TargetFramerate ()
 Gets the target framerate. More...
 
void TargetFramerate (unsigned targetFramerate)
 Sets the target framerate. More...
 
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.
 

Static Public Member Functions

static TimeGet ()
 Gets the main time object. More...
 

Private Attributes

std::chrono::microseconds _startTime
 Time the object was created.
 
std::chrono::microseconds _lastTime
 Time the last frame started.
 
std::chrono::microseconds _currentTime
 Time the current frame started.
 
std::chrono::microseconds _deltaTime
 Time between the last frame and now Max: 1 / _targetFramerate.
 
unsigned _targetFramerate
 Target framerate Typically refresh rate of memory.
 

Static Private Attributes

static Time_main
 First created Time object.
 

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

Time management class.

Constructor & Destructor Documentation

◆ Time() [1/2]

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

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

◆ Time() [2/2]

Aspen::Time::Time::Time ( unsigned  targetFramerate,
Object parent = nullptr,
std::string  name = "Time" 
)

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

Parameters
targetFramerateTarget framerate Typically refresh rate of memory
parentParent Object to be passed to Object constructor
nameObject name Set by derived classes to a string representation of their type

Member Function Documentation

◆ CurrentTime()

double Aspen::Time::Time::CurrentTime ( )

Start time of the current frame in seconds.

Returns
Start time of the current frame

◆ DeltaTime()

double Aspen::Time::Time::DeltaTime ( )

Time since the last frame in seconds.

Returns
Time since the last frame

◆ FPS()

double Aspen::Time::Time::FPS ( )

Current framerate of the application.

Returns
Current framerate of the application

◆ Get()

static Time* Aspen::Time::Time::Get ( )
static

Gets the main time object.

Returns
_main

◆ LastTime()

double Aspen::Time::Time::LastTime ( )

Start time of the last frame in seconds.

Returns
Start time of the last frame

◆ Sleep() [1/2]

void Aspen::Time::Time::Sleep ( double  time)

Sleeps for a set amount of time.

Parameters
timeTime to sleep in seconds

◆ Sleep() [2/2]

void Aspen::Time::Time::Sleep ( float  time)

Sleeps for a set amount of time.

Parameters
timeTime to sleep in seconds

◆ StartTime()

double Aspen::Time::Time::StartTime ( )

Start time of the application in seconds.

Returns
Start time of the application

◆ TargetFramerate() [1/2]

unsigned Aspen::Time::Time::TargetFramerate ( )

Gets the target framerate.

Returns
_targetFramerate

◆ TargetFramerate() [2/2]

void Aspen::Time::Time::TargetFramerate ( unsigned  targetFramerate)

Sets the target framerate.

Parameters
targetFramerateNew target framerate

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