Magic_Game/src/kiwano/2d/action/ActionTween.h

// Copyright (c) 2016-2018 Kiwano - Nomango
// 
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
// 
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
// 
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.

#pragma once
#include <kiwano/2d/action/Action.h>
#include <kiwano/core/Logger.h>

namespace kiwano
{
	/// \~chinese
	/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	using EaseFunc = Function<float(float)>;

	/// \~chinese
	/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ö<EFBFBD><C3B6>
	/// @details <20>鿴 https://easings.net <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϣ
	struct Ease
	{
		static KGE_API EaseFunc Linear;			///< <20><><EFBFBD><EFBFBD>
		static KGE_API EaseFunc EaseIn;			///< <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		static KGE_API EaseFunc EaseOut;		///< <20>ɿ<EFBFBD><C9BF><EFBFBD><EFBFBD><EFBFBD>
		static KGE_API EaseFunc EaseInOut;		///< <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>, <20><><EFBFBD>ɿ<EFBFBD><C9BF><EFBFBD><EFBFBD><EFBFBD>
		static KGE_API EaseFunc ExpoIn;			///< <20><><EFBFBD><EFBFBD><EFBFBD>伫<EFBFBD><E4BCAB>
		static KGE_API EaseFunc ExpoOut;		///< <20>ɼ<EFBFBD><C9BC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		static KGE_API EaseFunc ExpoInOut;		///< <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>, <20><><EFBFBD>ɼ<EFBFBD><C9BC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		static KGE_API EaseFunc ElasticIn;		///< <20><><EFBFBD><EFBFBD><EFBFBD>㸳<EFBFBD>赯<EFBFBD><E8B5AF>
		static KGE_API EaseFunc ElasticOut;		///< <20><><EFBFBD>յ㸳<D5B5>赯<EFBFBD><E8B5AF>
		static KGE_API EaseFunc ElasticInOut;	///< <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>յ㸳<D5B5>赯<EFBFBD><E8B5AF>
		static KGE_API EaseFunc BounceIn;		///< <20><><EFBFBD><EFBFBD><EFBFBD>㸳<EFBFBD>跴<EFBFBD><E8B7B4><EFBFBD><EFBFBD>
		static KGE_API EaseFunc BounceOut;		///< <20><><EFBFBD>յ㸳<D5B5>跴<EFBFBD><E8B7B4><EFBFBD><EFBFBD>
		static KGE_API EaseFunc BounceInOut;	///< <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>յ㸳<D5B5>跴<EFBFBD><E8B7B4><EFBFBD><EFBFBD>
		static KGE_API EaseFunc BackIn;
		static KGE_API EaseFunc BackOut;
		static KGE_API EaseFunc BackInOut;
		static KGE_API EaseFunc QuadIn;
		static KGE_API EaseFunc QuadOut;
		static KGE_API EaseFunc QuadInOut;
		static KGE_API EaseFunc CubicIn;
		static KGE_API EaseFunc CubicOut;
		static KGE_API EaseFunc CubicInOut;
		static KGE_API EaseFunc QuartIn;
		static KGE_API EaseFunc QuartOut;
		static KGE_API EaseFunc QuartInOut;
		static KGE_API EaseFunc QuintIn;
		static KGE_API EaseFunc QuintOut;
		static KGE_API EaseFunc QuintInOut;
		static KGE_API EaseFunc SineIn;
		static KGE_API EaseFunc SineOut;
		static KGE_API EaseFunc SineInOut;
	};


	KGE_DECLARE_SMART_PTR(ActionTween);
	KGE_DECLARE_SMART_PTR(ActionMoveBy);
	KGE_DECLARE_SMART_PTR(ActionMoveTo);
	KGE_DECLARE_SMART_PTR(ActionJumpBy);
	KGE_DECLARE_SMART_PTR(ActionJumpTo);
	KGE_DECLARE_SMART_PTR(ActionScaleBy);
	KGE_DECLARE_SMART_PTR(ActionScaleTo);
	KGE_DECLARE_SMART_PTR(ActionFadeTo);
	KGE_DECLARE_SMART_PTR(ActionFadeIn);
	KGE_DECLARE_SMART_PTR(ActionFadeOut);
	KGE_DECLARE_SMART_PTR(ActionRotateBy);
	KGE_DECLARE_SMART_PTR(ActionRotateTo);
	KGE_DECLARE_SMART_PTR(ActionCustom);


	/**
	* \addtogroup Actions
	* @{
	*/

	/// \~chinese
	/// @brief <20><><EFBFBD>䶯<EFBFBD><E4B6AF>
	class KGE_API ActionTween
		: public Action
	{
	public:
		ActionTween();

		/// \~chinese
		/// @brief <20><><EFBFBD>䶯<EFBFBD><E4B6AF>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionTween(Duration duration, EaseFunc func);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		Duration GetDuration() const;

		/// \~chinese
		/// @brief <20><><EFBFBD>ö<EFBFBD><C3B6><EFBFBD>ʱ<EFBFBD><CAB1>
		void SetDuration(Duration duration);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		EaseFunc const& GetEaseFunc() const;

		/// \~chinese
		/// @brief <20><><EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		void SetEaseFunc(EaseFunc const& func);

	protected:
		void Update(Actor* target, Duration dt) override;

		virtual void UpdateTween(Actor* target, float percent) = 0;

	private:
		Duration dur_;
		EaseFunc ease_func_;
	};


	/// \~chinese
	/// @brief <20><><EFBFBD><EFBFBD>λ<EFBFBD>ƶ<EFBFBD><C6B6><EFBFBD>
	class KGE_API ActionMoveBy
		: public ActionTween
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>λ<EFBFBD>ƶ<EFBFBD><C6B6><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param vector <20>ƶ<EFBFBD><C6B6><EFBFBD><EFBFBD><EFBFBD>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionMoveBy(Duration duration, Vec2 const& vector, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		ActionPtr Reverse() const override;

	protected:
		void Init(Actor* target) override;

		void UpdateTween(Actor* target, float percent) override;

	protected:
		Point	start_pos_;
		Point	prev_pos_;
		Vec2	delta_pos_;
	};


	/// \~chinese
	/// @brief λ<>ƶ<EFBFBD><C6B6><EFBFBD>
	class KGE_API ActionMoveTo
		: public ActionMoveBy
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD>λ<EFBFBD>ƶ<EFBFBD><C6B6><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param pos Ŀ<><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionMoveTo(Duration duration, Point const& pos, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		virtual ActionPtr Reverse() const override
		{
			KGE_ERROR(L"Reverse() not supported in ActionMoveTo");
			return nullptr;
		}

	protected:
		void Init(Actor* target) override;

	private:
		Point end_pos_;
	};


	/// \~chinese
	/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
	class KGE_API ActionJumpBy
		: public ActionTween
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param vec <20><>Ծλ<D4BE><CEBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		/// @param height <20><>Ծ<EFBFBD>߶<EFBFBD>
		/// @param jumps <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionJumpBy(Duration duration, Vec2 const& vec, float height, int jumps = 1, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		ActionPtr Reverse() const override;

	protected:
		void Init(Actor* target) override;

		void UpdateTween(Actor* target, float percent) override;

	protected:
		Point	start_pos_;
		Point	delta_pos_;
		float	height_;
		int		jumps_;
		Point	prev_pos_;
	};


	/// \~chinese
	/// @brief <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
	class KGE_API ActionJumpTo
		: public ActionJumpBy
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param pos Ŀ<><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		/// @param height <20><>Ծ<EFBFBD>߶<EFBFBD>
		/// @param jumps <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionJumpTo(Duration duration, Point const& pos, float height, int jumps = 1, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		virtual ActionPtr Reverse() const override
		{
			KGE_ERROR(L"Reverse() not supported in ActionJumpTo");
			return nullptr;
		}

	protected:
		void Init(Actor* target) override;

	private:
		Point end_pos_;
	};


	/// \~chinese
	/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>
	class KGE_API ActionScaleBy
		: public ActionTween
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param scale_x <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ա仯ֵ
		/// @param scale_y <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ա仯ֵ
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionScaleBy(Duration duration, float scale_x, float scale_y, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		ActionPtr Reverse() const override;

	protected:
		void Init(Actor* target) override;

		void UpdateTween(Actor* target, float percent) override;

	protected:
		float	start_scale_x_;
		float	start_scale_y_;
		float	delta_x_;
		float	delta_y_;
	};


	/// \~chinese
	/// @brief <20><><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>
	class KGE_API ActionScaleTo
		: public ActionScaleBy
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param scale_x <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF>ֵ
		/// @param scale_y <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF>ֵ
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionScaleTo(Duration duration, float scale_x, float scale_y, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		virtual ActionPtr Reverse() const override
		{
			KGE_ERROR(L"Reverse() not supported in ActionScaleTo");
			return nullptr;
		}

	protected:
		void Init(Actor* target) override;

	private:
		float	end_scale_x_;
		float	end_scale_y_;
	};


	/// \~chinese
	/// @brief ͸<><CDB8><EFBFBD>Ƚ<EFBFBD><C8BD>䶯<EFBFBD><E4B6AF>
	class KGE_API ActionFadeTo
		: public ActionTween
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD>͸<EFBFBD><CDB8><EFBFBD>Ƚ<EFBFBD><C8BD>䶯<EFBFBD><E4B6AF>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param opacity Ŀ<><C4BF>͸<EFBFBD><CDB8><EFBFBD><EFBFBD>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionFadeTo(Duration duration, float opacity, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		virtual ActionPtr Reverse() const override
		{
			KGE_ERROR(L"Reverse() not supported in ActionFadeTo");
			return nullptr;
		}

	protected:
		void Init(Actor* target) override;

		void UpdateTween(Actor* target, float percent) override;

	private:
		float start_val_;
		float delta_val_;
		float end_val_;
	};


	/// \~chinese
	/// @brief <20><><EFBFBD>붯<EFBFBD><EBB6AF>
	class KGE_API ActionFadeIn
		: public ActionFadeTo
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD>쵭<EFBFBD>붯<EFBFBD><EBB6AF>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		explicit ActionFadeIn(Duration duration, EaseFunc func = nullptr);
	};


	/// \~chinese
	/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	class KGE_API ActionFadeOut
		: public ActionFadeTo
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD>쵭<EFBFBD><ECB5AD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		explicit ActionFadeOut(Duration duration, EaseFunc func = nullptr);
	};


	/// \~chinese
	/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ת<EFBFBD><D7AA><EFBFBD><EFBFBD>
	class KGE_API ActionRotateBy
		: public ActionTween
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ת<EFBFBD><D7AA><EFBFBD><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param rotation <20>Ƕ<EFBFBD><C7B6><EFBFBD><EFBFBD>Ա仯ֵ
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionRotateBy(Duration duration, float rotation, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		ActionPtr Reverse() const override;

	protected:
		void Init(Actor* target) override;

		void UpdateTween(Actor* target, float percent) override;

	protected:
		float start_val_;
		float delta_val_;
	};


	/// \~chinese
	/// @brief <20><>ת<EFBFBD><D7AA><EFBFBD><EFBFBD>
	class KGE_API ActionRotateTo
		: public ActionRotateBy
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ת<EFBFBD><D7AA><EFBFBD><EFBFBD>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param rotation Ŀ<><C4BF><EFBFBD>Ƕ<EFBFBD>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionRotateTo(Duration duration, float rotation, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		virtual ActionPtr Reverse() const override
		{
			KGE_ERROR(L"Reverse() not supported in ActionRotateTo");
			return nullptr;
		}

	protected:
		void Init(Actor* target) override;

	private:
		float end_val_;
	};


	/// \~chinese
	/// @brief <20>Զ<EFBFBD><D4B6>嶯<EFBFBD><E5B6AF>
	class KGE_API ActionCustom
		: public ActionTween
	{
	public:
		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD>
		/// @details <20>ڶ<EFBFBD><DAB6><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD>ص<EFBFBD><D8B5>ú<EFBFBD><C3BA><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ִ<EFBFBD>ж<EFBFBD><D0B6><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD>꣬<EFBFBD>ڶ<EFBFBD><DAB6><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ƕ<EFBFBD><C7B6><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȣ<EFBFBD>0.0 - 1.0<EFBFBD><EFBFBD>
		using TweenFunc = Function<void(Actor* /* target */, float /* percent */)>;

		/// \~chinese
		/// @brief <20><><EFBFBD><EFBFBD><EFBFBD>Զ<EFBFBD><D4B6>嶯<EFBFBD><E5B6AF>
		/// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
		/// @param tween_func <20><><EFBFBD><EFBFBD><EFBFBD>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD>
		/// @param func <20><><EFBFBD><EFBFBD><EFBFBD>ٶȻ<D9B6><C8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionCustom(Duration duration, TweenFunc tween_func, EaseFunc func = nullptr);

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		ActionPtr Clone() const override;

		/// \~chinese
		/// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
		ActionPtr Reverse() const override
		{
			KGE_ERROR(L"Reverse() not supported in ActionCustom");
			return nullptr;
		}

	protected:
		void Init(Actor* target) override;

		void UpdateTween(Actor* target, float percent) override;

	private:
		TweenFunc tween_func_;
	};

	/** @} */

}