Class FrameSequence

utilities/olcUTIL_Animate2D.h:109–176

	};

	class FrameSequence
	{
	public:
		// Constructs a sequence of frames with a duration and a traversal style
		inline FrameSequence(const float fFrameDuration = 0.1f, const Style nStyle = Style::Repeat)
		{
			SetFrameDuration(fFrameDuration);
			m_nStyle = nStyle;
		}

		inline void SetFrameDuration(const float fFrameDuration = 0.1f)
		{
			m_fFrameDuration = fFrameDuration;
			m_fFrameRate = 1.0f / m_fFrameDuration;
		}

		// Adds a frame to this sequence
		inline void AddFrame(const Frame& frame)
		{
			m_vFrames.emplace_back(frame);
		}

		// Returns a Frame Object for a given time into an animation
		inline const Frame& GetFrame(const float fTime) const
		{
			size_t frame = ConvertTimeToFrame(fTime);
			return m_vFrames[frame];
		}

		inline const bool Complete(const float fTime) const
		{
			return std::abs(fTime - (m_vFrames.size() * m_fFrameDuration)) < 0.01f;
		}
		
	private:
		Style m_nStyle;
		std::vector<Frame> m_vFrames;
		float m_fFrameDuration = 0.1f;
		float m_fFrameRate = 10.0f;

		inline const size_t ConvertTimeToFrame(const float fTime) const
		{
			switch (m_nStyle)
			{
			case Style::Repeat:
				return size_t(fTime * m_fFrameRate) % m_vFrames.size();
				break;
			case Style::OneShot:
				{
					size_t frame = std::clamp(size_t(fTime * m_fFrameRate), size_t(0), m_vFrames.size() - 1);
					return frame;
				}
				break;
			case Style::PingPong:
				{
					// Thanks @sigonasr2 (discord)
					size_t frame = size_t(m_fFrameRate * fTime) % (m_vFrames.size() * 2 - 1);
					return frame >= m_vFrames.size() ? m_vFrames.size() - frame % m_vFrames.size() - 1 : frame;