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/utils/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(ActionTweenEntity);
KGE_DECLARE_SMART_PTR(ActionMoveByEntity);
KGE_DECLARE_SMART_PTR(ActionMoveToEntity);
KGE_DECLARE_SMART_PTR(ActionJumpByEntity);
KGE_DECLARE_SMART_PTR(ActionJumpToEntity);
KGE_DECLARE_SMART_PTR(ActionScaleByEntity);
KGE_DECLARE_SMART_PTR(ActionScaleToEntity);
KGE_DECLARE_SMART_PTR(ActionFadeToEntity);
KGE_DECLARE_SMART_PTR(ActionRotateByEntity);
KGE_DECLARE_SMART_PTR(ActionRotateToEntity);
KGE_DECLARE_SMART_PTR(ActionCustomEntity);

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

/// \~chinese
/// @brief <20><><EFBFBD>䶯<EFBFBD><E4B6AF>ʵ<EFBFBD><CAB5>
class KGE_API ActionTweenEntity : public ActionEntity
{
public:
    ActionTweenEntity();

    /// \~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>
    ActionTweenEntity(Duration duration, EaseFunc ease);

    /// \~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>
    const EaseFunc& GetEaseFunc() const;

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

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

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

    ActionEntityPtr DoClone(ActionTweenEntityPtr to) const;

private:
    Duration dur_;
    EaseFunc ease_func_;
};

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

    inline ActionTween(ActionTweenEntityPtr ptr)
        : Action(ptr.Get())
    {
    }

    /// \~chinese
    /// @brief <20><><EFBFBD>û<EFBFBD><C3BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    inline ActionTween& Ease(EaseFunc ease)
    {
        auto tween_ptr = Get();
        if (tween_ptr)
            tween_ptr->SetEaseFunc(ease);
        return (*this);
    }

    /// \~chinese
    /// @brief <20><>ȡָ<C8A1><D6B8>
    inline ActionTweenEntity* Get() const
    {
        return const_cast<ActionTweenEntity*>(static_cast<const ActionTweenEntity*>(ptr.Get()));
    }

    /// \~chinese
    /// @brief <20><><EFBFBD>ö<EFBFBD><C3B6><EFBFBD>ʵ<EFBFBD><CAB5>
    inline void SetEntity(ActionTweenEntityPtr tween_ptr)
    {
        this->ptr = static_cast<ActionEntity*>(tween_ptr.Get());
    }

    inline ActionTweenEntity* operator->() const
    {
        return Get();
    }
};

/// \~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 displacement λ<><CEBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    ActionMoveBy(Duration duration, const Vec2& displacement);
};

/// \~chinese
/// @brief <20><><EFBFBD><EFBFBD>λ<EFBFBD>ƶ<EFBFBD><C6B6><EFBFBD>ʵ<EFBFBD><CAB5>
class KGE_API ActionMoveByEntity : public ActionTweenEntity
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>λ<EFBFBD>ƶ<EFBFBD><C6B6><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param displacement λ<><CEBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    static ActionMoveByEntityPtr Create(Duration duration, const Vec2& displacement);

    ActionMoveByEntity();

    /// \~chinese
    /// @brief <20><>ȡλ<C8A1><CEBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    Vec2 GetDisplacement() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>λ<EFBFBD><CEBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void SetDisplacement(const Vec2& displacement);

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

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

protected:
    void Init(Actor* target) override;

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

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

/// \~chinese
/// @brief λ<>ƶ<EFBFBD><C6B6><EFBFBD>
class KGE_API ActionMoveTo : public ActionTween
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>λ<EFBFBD>ƶ<EFBFBD><C6B6><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param distination Ŀ<><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    ActionMoveTo(Duration duration, const Point& distination);
};

/// \~chinese
/// @brief λ<>ƶ<EFBFBD><C6B6><EFBFBD>ʵ<EFBFBD><CAB5>
class KGE_API ActionMoveToEntity : public ActionMoveByEntity
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>λ<EFBFBD>ƶ<EFBFBD><C6B6><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param distination Ŀ<><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    static ActionMoveToEntityPtr Create(Duration duration, const Point& distination);

    ActionMoveToEntity();

    /// \~chinese
    /// @brief <20><>ȡĿ<C8A1><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    Point GetDistination() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void SetDistination(const Point& distination);

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

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

protected:
    void Init(Actor* target) override;

private:
    Point distination_;
};

/// \~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 displacement <20><>Ծλ<D4BE><CEBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    /// @param height <20><>Ծ<EFBFBD>߶<EFBFBD>
    /// @param count <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    ActionJumpBy(Duration duration, const Vec2& displacement, float height, int count = 1);
};

/// \~chinese
/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>ʵ<EFBFBD><CAB5>
class KGE_API ActionJumpByEntity : public ActionTweenEntity
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param displacement <20><>Ծλ<D4BE><CEBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    /// @param height <20><>Ծ<EFBFBD>߶<EFBFBD>
    /// @param count <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    static ActionJumpByEntityPtr Create(Duration duration, const Vec2& displacement, float height, int count = 1);

    ActionJumpByEntity();

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>Ծλ<D4BE><CEBB>
    Vec2 GetDisplacement() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>Ծ<EFBFBD>߶<EFBFBD>
    float GetJumpHeight() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    int GetJumpCount() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծλ<D4BE><CEBB>
    void SetDisplacement(const Vec2& displacement);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD>߶<EFBFBD>
    void SetJumpHeight(float height);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    void SetJumpCount(int count);

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

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

protected:
    void Init(Actor* target) override;

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

protected:
    float height_;
    int   jump_count_;
    Point start_pos_;
    Point displacement_;
    Point prev_pos_;
};

/// \~chinese
/// @brief <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
class KGE_API ActionJumpTo : public ActionTween
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param distination Ŀ<><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    /// @param height <20><>Ծ<EFBFBD>߶<EFBFBD>
    /// @param count <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    ActionJumpTo(Duration duration, const Point& distination, float height, int count = 1);
};

/// \~chinese
/// @brief <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>ʵ<EFBFBD><CAB5>
class KGE_API ActionJumpToEntity : public ActionJumpByEntity
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param distination Ŀ<><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    /// @param height <20><>Ծ<EFBFBD>߶<EFBFBD>
    /// @param count <20><>Ծ<EFBFBD><D4BE><EFBFBD><EFBFBD>
    static ActionJumpToEntityPtr Create(Duration duration, const Point& distination, float height, int count = 1);

    ActionJumpToEntity();

    /// \~chinese
    /// @brief <20><>ȡĿ<C8A1><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    Point GetDistination() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void SetDistination(const Point& distination);

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

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

protected:
    void Init(Actor* target) override;

private:
    Point distination_;
};

/// \~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>Ա仯ֵ
    ActionScaleBy(Duration duration, float scale_x, float scale_y);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param scale <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ա仯ֵ
    ActionScaleBy(Duration duration, Vec2 scale);
};

/// \~chinese
/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>ʵ<EFBFBD><CAB5>
class KGE_API ActionScaleByEntity : public ActionTweenEntity
{
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>Ա仯ֵ
    static ActionScaleByEntityPtr Create(Duration duration, float scale_x, float scale_y);

    ActionScaleByEntity();

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ա仯ֵ
    float GetScaleX() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ա仯ֵ
    float GetScaleY() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ա仯ֵ
    void SetScaleX(float scale_x);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ա仯ֵ
    void SetScaleY(float scale_y);

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

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
    ActionEntityPtr 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 ActionTween
{
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>ֵ
    ActionScaleTo(Duration duration, float scale_x, float scale_y);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param scale <20><><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF>ֵ
    ActionScaleTo(Duration duration, Vec2 scale);
};

/// \~chinese
/// @brief <20><><EFBFBD>Ŷ<EFBFBD><C5B6><EFBFBD>ʵ<EFBFBD><CAB5>
class KGE_API ActionScaleToEntity : public ActionScaleByEntity
{
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>ֵ
    static ActionScaleToEntityPtr Create(Duration duration, float scale_x, float scale_y);

    ActionScaleToEntity();

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF>ֵ
    float GetTargetScaleX() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF>ֵ
    float GetTargetScaleY() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF>ֵ
    void SetTargetScaleX(float scale_x);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF>ֵ
    void SetTargetScaleY(float scale_y);

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

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
    virtual ActionEntityPtr Reverse() const override
    {
        KGE_ERRORF("Reverse() not supported in ActionScaleToEntity");
        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>
    ActionFadeTo(Duration duration, float opacity);
};

/// \~chinese
/// @brief <20><><EFBFBD>붯<EFBFBD><EBB6AF>
class KGE_API ActionFadeIn : public ActionTween
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>붯<EFBFBD><EBB6AF>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    ActionFadeIn(Duration duration);
};

/// \~chinese
/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
class KGE_API ActionFadeOut : public ActionTween
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    ActionFadeOut(Duration duration);
};

/// \~chinese
/// @brief ͸<><CDB8><EFBFBD>Ƚ<EFBFBD><C8BD>䶯<EFBFBD><E4B6AF>ʵ<EFBFBD><CAB5>
class KGE_API ActionFadeToEntity : public ActionTweenEntity
{
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>
    static ActionFadeToEntityPtr Create(Duration duration, float opacity);

    ActionFadeToEntity();

    /// \~chinese
    /// @brief <20><>ȡĿ<C8A1><C4BF>͸<EFBFBD><CDB8><EFBFBD><EFBFBD>
    float GetTargetOpacity() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF>͸<EFBFBD><CDB8><EFBFBD><EFBFBD>
    void SetTargetOpacity(float opacity);

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

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
    virtual ActionEntityPtr Reverse() const override
    {
        KGE_ERRORF("Reverse() not supported in ActionFadeToEntity");
        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><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>Ա仯ֵ
    ActionRotateBy(Duration duration, float rotation);
};

/// \~chinese
/// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ת<EFBFBD><D7AA><EFBFBD><EFBFBD>ʵ<EFBFBD><CAB5>
class KGE_API ActionRotateByEntity : public ActionTweenEntity
{
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>Ա仯ֵ
    static ActionRotateByEntityPtr Create(Duration duration, float rotation);

    ActionRotateByEntity();

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>Ƕ<EFBFBD><C7B6><EFBFBD><EFBFBD>Ա仯ֵ
    float GetRotation() const;

    /// \~chinese
    /// @brief <20><><EFBFBD>ýǶ<C3BD><C7B6><EFBFBD><EFBFBD>Ա仯ֵ
    void SetRotation(float rotation);

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

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
    ActionEntityPtr 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 ActionTween
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ת<EFBFBD><D7AA><EFBFBD><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param rotation Ŀ<><C4BF><EFBFBD>Ƕ<EFBFBD>
    ActionRotateTo(Duration duration, float rotation);
};

/// \~chinese
/// @brief <20><>ת<EFBFBD><D7AA><EFBFBD><EFBFBD>ʵ<EFBFBD><CAB5>
class KGE_API ActionRotateToEntity : public ActionRotateByEntity
{
public:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ת<EFBFBD><D7AA><EFBFBD><EFBFBD>
    /// @param duration <20><><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
    /// @param rotation Ŀ<><C4BF><EFBFBD>Ƕ<EFBFBD>
    static ActionRotateToEntityPtr Create(Duration duration, float rotation);

    ActionRotateToEntity();

    /// \~chinese
    /// @brief <20><>ȡĿ<C8A1><C4BF><EFBFBD>Ƕ<EFBFBD>
    float GetTargetRotation() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD>Ƕ<EFBFBD>
    void SetTargetRotation(float rotation);

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

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ĵ<EFBFBD>ת
    virtual ActionEntityPtr Reverse() const override
    {
        KGE_ERRORF("Reverse() not supported in ActionRotateToEntity");
        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>
    ActionCustom(Duration duration, TweenFunc tween_func);
};

/// \~chinese
/// @brief <20>Զ<EFBFBD><D4B6>嶯<EFBFBD><E5B6AF>ʵ<EFBFBD><CAB5>
class KGE_API ActionCustomEntity : public ActionTweenEntity
{
public:
    /// \~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>
    static ActionCustomEntityPtr Create(Duration duration, ActionCustom::TweenFunc tween_func);

    ActionCustomEntity();

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD>
    ActionCustom::TweenFunc GetTweenFunc() const;

    /// \~chinese
    /// @brief <20><><EFBFBD>ö<EFBFBD><C3B6><EFBFBD><EFBFBD>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD>
    void SetTweenFunc(const ActionCustom::TweenFunc& tween_func);

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

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

protected:
    void Init(Actor* target) override;

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

private:
    ActionCustom::TweenFunc tween_func_;
};

/** @} */

inline const EaseFunc& ActionTweenEntity::GetEaseFunc() const
{
    return ease_func_;
}

inline Duration ActionTweenEntity::GetDuration() const
{
    return dur_;
}

inline void ActionTweenEntity::SetDuration(Duration duration)
{
    dur_ = duration;
}

inline void ActionTweenEntity::SetEaseFunc(const EaseFunc& func)
{
    ease_func_ = func;
}

inline Vec2 ActionMoveByEntity::GetDisplacement() const
{
    return displacement_;
}

inline void ActionMoveByEntity::SetDisplacement(const Vec2& displacement)
{
    displacement_ = displacement;
}

inline Point ActionMoveToEntity::GetDistination() const
{
    return distination_;
}

inline void ActionMoveToEntity::SetDistination(const Point& distination)
{
    distination_ = distination;
}

inline Vec2 ActionJumpByEntity::GetDisplacement() const
{
    return displacement_;
}

inline float ActionJumpByEntity::GetJumpHeight() const
{
    return height_;
}

inline int ActionJumpByEntity::GetJumpCount() const
{
    return jump_count_;
}

inline void ActionJumpByEntity::SetDisplacement(const Vec2& displacement)
{
    displacement_ = displacement;
}

inline void ActionJumpByEntity::SetJumpHeight(float height)
{
    height_ = height;
}

inline void ActionJumpByEntity::SetJumpCount(int count)
{
    jump_count_ = count;
}

inline Point ActionJumpToEntity::GetDistination() const
{
    return distination_;
}

inline void ActionJumpToEntity::SetDistination(const Point& distination)
{
    distination_ = distination;
}

inline float ActionScaleByEntity::GetScaleX() const
{
    return delta_x_;
}

inline float ActionScaleByEntity::GetScaleY() const
{
    return delta_y_;
}

inline void ActionScaleByEntity::SetScaleX(float scale_x)
{
    delta_x_ = scale_x;
}

inline void ActionScaleByEntity::SetScaleY(float scale_y)
{
    delta_y_ = scale_y;
}

inline float ActionScaleToEntity::GetTargetScaleX() const
{
    return end_scale_x_;
}

inline float ActionScaleToEntity::GetTargetScaleY() const
{
    return end_scale_y_;
}

inline void ActionScaleToEntity::SetTargetScaleX(float scale_x)
{
    end_scale_x_ = scale_x;
}

inline void ActionScaleToEntity::SetTargetScaleY(float scale_y)
{
    end_scale_y_ = scale_y;
}

inline float ActionFadeToEntity::GetTargetOpacity() const
{
    return end_val_;
}

inline void ActionFadeToEntity::SetTargetOpacity(float opacity)
{
    end_val_ = opacity;
}

inline float ActionRotateByEntity::GetRotation() const
{
    return delta_val_;
}

inline void ActionRotateByEntity::SetRotation(float rotation)
{
    delta_val_ = rotation;
}

inline float ActionRotateToEntity::GetTargetRotation() const
{
    return end_val_;
}

inline void ActionRotateToEntity::SetTargetRotation(float rotation)
{
    end_val_ = rotation;
}

inline ActionCustom::TweenFunc ActionCustomEntity::GetTweenFunc() const
{
    return tween_func_;
}

inline void ActionCustomEntity::SetTweenFunc(const ActionCustom::TweenFunc& tween_func)
{
    tween_func_ = tween_func;
}

}  // namespace kiwano