/* * Copyright (C) 2021 Christopher J. Howard * * This file is part of Antkeeper source code. * * Antkeeper source code is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Antkeeper source code is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with Antkeeper source code. If not, see . */ #ifndef ANTKEEPER_TWEEN_HPP #define ANTKEEPER_TWEEN_HPP #include #include #include /** * Container which stores two states along with an interpolator, for quick and easy tweening. * * @tparam T Value type. */ template class tween { public: //typedef typename std::remove_pointer::type value_type; typedef T value_type; typedef typename std::decay>::type interpolator_type; /** * Creates a tween. * * @param state0 Initial value of state 0. * @param state1 Initial value of state 1. * @param interpolator Function used to interpolate between states 0 and 1. */ tween(const T& state0, const T& state1, interpolator_type interpolator = nullptr); /** * Creates a tween. * * @param value Initial value of states 0 and 1. * @param interpolator Function used to interpolate between states 0 and 1. */ explicit tween(const T& value, interpolator_type interpolator = nullptr); /** * Creates a tween. * * @param interpolator Function that will be used to interpolate between states 0 and 1. */ tween(); /** * Returns a reference to the specified tween state. * * @param state Index of a tween state. Should be either `0` or `1`. * @return Reference to the specified tween state. */ const T& operator[](int state) const; /// @copydoc tween::operator[](int) const T& operator[](int state); /** * Returns an interpolated state between state 0 and state 1. If no interpolator is set, state 1 will be returned. * * @param a Interpolation factor on `[0.0, 1.0]`. * @return Interpolated state, or state 1 if no interpolator is set. */ value_type interpolate(double a) const; /** * Sets the function used to interpolate between states 0 and 1. * * @param interpolator Interpolator function. */ void set_interpolator(const interpolator_type& interpolator); /** * Returns the function used to interpolate between states 0 and 1. */ const interpolator_type& get_interpolator() const; /** * Sets state 0 = state 1. */ void update(); /** * Swaps state 0 and state 1. */ void swap(); private: T state0; T state1; interpolator_type interpolator; }; template tween::tween(const T& value, interpolator_type interpolator): state0(value), state1(value), interpolator(interpolator) {} template tween::tween(const T& state0, const T& state1, interpolator_type interpolator): state0(state0), state1(state1), interpolator(interpolator) {} template tween::tween(): interpolator(nullptr) {} template inline const T& tween::operator[](int state) const { return (state <= 0) ? state0 : state1; } template inline T& tween::operator[](int state) { return (state <= 0) ? state0 : state1; } template inline typename tween::value_type tween::interpolate(double a) const { return (interpolator) ? interpolator(state0, state1, a) : state1; } template inline void tween::set_interpolator(const interpolator_type& interpolator) { this->interpolator = interpolator; } template inline const typename tween::interpolator_type& tween::get_interpolator() const { return interpolator; } template inline void tween::update() { state0 = state1; } template inline void tween::swap() { std::swap(state0, state1); } #endif // ANTKEEPER_TWEEN_HPP