Magic_Game/src/kiwano/2d/Actor.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/math/Math.h>
#include <kiwano/core/ObjectBase.h>
#include <kiwano/core/Time.h>
#include <kiwano/core/EventDispatcher.h>
#include <kiwano/utils/TaskManager.h>
#include <kiwano/2d/action/ActionManager.h>
#include <kiwano/2d/Component.h>

namespace kiwano
{
class Stage;
class Director;
class RenderContext;

namespace physics
{
class PhysicBody;
}

KGE_DECLARE_SMART_PTR(Actor);

/// \~chinese
/// @brief <20><>ɫ<EFBFBD>б<EFBFBD>
typedef IntrusiveList<ActorPtr> ActorList;

/**
 * \~chinese
 * \defgroup Actors <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɫ
 */

/**
 * \addtogroup Actors
 * @{
 */

/**
 * \~chinese
 * @brief <EFBFBD><EFBFBD>ɫ
 * @details
 * <EFBFBD><EFBFBD>ɫ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>̨<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ԫ<EFBFBD>أ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ⱦ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>¡<EFBFBD><EFBFBD>¼<EFBFBD><EFBFBD>ַ<EFBFBD><EFBFBD>ȹ<EFBFBD><EFBFBD>ܵ<EFBFBD><EFBFBD><EFBFBD>С<EFBFBD><EFBFBD>λ<EFBFBD><EFBFBD>Ҳ<EFBFBD>Ƕ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>¼<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȹ<EFBFBD><EFBFBD>ܵ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
 */
class KGE_API Actor
    : public ObjectBase
    , public TaskManager
    , public ActionManager
    , public EventDispatcher
    , protected IntrusiveListValue<ActorPtr>
{
    friend class Director;
    friend class Transition;
    friend IntrusiveList<ActorPtr>;

public:
    /// \~chinese
    /// @brief <20><>ɫ<EFBFBD><C9AB><EFBFBD>»ص<C2BB><D8B5><EFBFBD><EFBFBD><EFBFBD>
    typedef Function<void(Duration)> UpdateCallback;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɫ
    static ActorPtr Create();

    Actor();

    virtual ~Actor();

    /// \~chinese
    /// @brief <20><><EFBFBD>½<EFBFBD>ɫ
    /// @details ÿ֡<C3BF><D6A1><EFBFBD><EFBFBD>ˢ<EFBFBD><CBA2>ǰ<EFBFBD><C7B0><EFBFBD>øú<C3B8><C3BA><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ظú<D8B8><C3BA><EFBFBD><EFBFBD><EFBFBD>ʵ<EFBFBD>ֽ<EFBFBD>ɫ<EFBFBD>ĸ<EFBFBD><C4B8>´<EFBFBD><C2B4><EFBFBD>
    /// @param dt <20><><EFBFBD><EFBFBD>һ<EFBFBD>θ<EFBFBD><CEB8>µ<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    virtual void OnUpdate(Duration dt);

    /// \~chinese
    /// @brief <20><>Ⱦ<EFBFBD><C8BE>ɫ
    /// @details
    /// ÿ֡<C3BF><D6A1><EFBFBD><EFBFBD>ˢ<EFBFBD><CBA2>ʱ<EFBFBD><CAB1><EFBFBD>øú<C3B8><C3BA><EFBFBD><EFBFBD><EFBFBD>Ĭ<EFBFBD>ϲ<EFBFBD><CFB2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ⱦ<EFBFBD><C8BE><EFBFBD><EFBFBD><EFBFBD>ظú<D8B8><C3BA><EFBFBD><EFBFBD><EFBFBD>ʵ<EFBFBD>־<EFBFBD><D6BE><EFBFBD><EFBFBD><EFBFBD>Ⱦ<EFBFBD><C8BE><EFBFBD><EFBFBD>
    /// @param ctx <20><>Ⱦ<EFBFBD><C8BE><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    virtual void OnRender(RenderContext& ctx);

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>ʾ״̬
    bool IsVisible() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>Ӧ״̬
    bool IsResponsible() const;

    /// \~chinese
    /// @brief <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD>ü<EFBFBD><C3BC><EFBFBD>͸<EFBFBD><CDB8><EFBFBD><EFBFBD>
    bool IsCascadeOpacityEnabled() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD>Ƶ<EFBFBD> Hash ֵ
    size_t GetHashName() const;

    /// \~chinese
    /// @brief <20><>ȡ Z <20><>˳<EFBFBD><CBB3>
    int GetZOrder() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>
    virtual Point GetPosition() const;

    /// \~chinese
    /// @brief <20><>ȡ x <20><><EFBFBD><EFBFBD>
    float GetPositionX() const;

    /// \~chinese
    /// @brief <20><>ȡ y <20><><EFBFBD><EFBFBD>
    float GetPositionY() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>С
    virtual Size GetSize() const;

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

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

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD>ź<EFBFBD><C5BA>Ŀ<EFBFBD><C4BF><EFBFBD>
    float GetScaledWidth() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD>ź<EFBFBD><C5BA>ĸ߶<C4B8>
    float GetScaledHeight() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD>ź<EFBFBD><C5BA>Ĵ<EFBFBD>С
    Size GetScaledSize() const;

    /// \~chinese
    /// @brief <20><>ȡê<C8A1><C3AA>
    virtual Point GetAnchor() const;

    /// \~chinese
    /// @brief <20><>ȡ x <20><><EFBFBD><EFBFBD>ê<EFBFBD><C3AA>
    float GetAnchorX() const;

    /// \~chinese
    /// @brief <20><>ȡ y <20><><EFBFBD><EFBFBD>ê<EFBFBD><C3AA>
    float GetAnchorY() const;

    /// \~chinese
    /// @brief <20><>ȡ͸<C8A1><CDB8><EFBFBD><EFBFBD>
    virtual float GetOpacity() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>ʾ͸<CABE><CDB8><EFBFBD><EFBFBD>
    float GetDisplayedOpacity() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>ת<EFBFBD>Ƕ<EFBFBD>
    virtual float GetRotation() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD>ű<EFBFBD><C5B1><EFBFBD>
    virtual Point GetScale() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ű<EFBFBD><C5B1><EFBFBD>
    float GetScaleX() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ű<EFBFBD><C5B1><EFBFBD>
    float GetScaleY() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD>нǶ<D0BD>
    virtual Point GetSkew() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>нǶ<D0BD>
    float GetSkewX() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>нǶ<D0BD>
    float GetSkewY() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>任
    Transform GetTransform() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>ɫ
    Actor* GetParent() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>̨
    Stage* GetStage() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>߿<EFBFBD>
    virtual Rect GetBounds() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD>а<EFBFBD>Χ<EFBFBD><CEA7>
    virtual Rect GetBoundingBox() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>ά<EFBFBD>任<EFBFBD><E4BBBB><EFBFBD><EFBFBD>
    const Matrix3x2& GetTransformMatrix() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1>ά<EFBFBD>任<EFBFBD><E4BBBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    const Matrix3x2& GetTransformInverseMatrix() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD>任<EFBFBD><E4BBBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɫ<EFBFBD>Ķ<EFBFBD>ά<EFBFBD>任<EFBFBD><E4BBBB><EFBFBD><EFBFBD>
    const Matrix3x2& GetTransformMatrixToParent() const;

    /// \~chinese
    /// @brief <20><><EFBFBD>ý<EFBFBD>ɫ<EFBFBD>Ƿ<EFBFBD><C7B7>ɼ<EFBFBD>
    void SetVisible(bool val);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void SetName(const String& name);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    virtual void SetPosition(const Point& point);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void SetPosition(float x, float y);

    /// \~chinese
    /// @brief <20><><EFBFBD>ú<EFBFBD><C3BA><EFBFBD><EFBFBD><EFBFBD>
    void SetPositionX(float x);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void SetPositionY(float y);

    /// \~chinese
    /// @brief <20>ƶ<EFBFBD><C6B6><EFBFBD><EFBFBD><EFBFBD>
    void Move(const Vec2& v);

    /// \~chinese
    /// @brief <20>ƶ<EFBFBD><C6B6><EFBFBD><EFBFBD><EFBFBD>
    void Move(float vx, float vy);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ű<EFBFBD><C5B1><EFBFBD><EFBFBD><EFBFBD>Ĭ<EFBFBD><C4AC>Ϊ (1.0, 1.0)
    virtual void SetScale(const Vec2& scale);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ű<EFBFBD><C5B1><EFBFBD><EFBFBD><EFBFBD>Ĭ<EFBFBD><C4AC>Ϊ (1.0, 1.0)
    void SetScale(float scalex, float scaley);

    /// \~chinese
    /// @brief <20><><EFBFBD>ô<EFBFBD><C3B4>нǶȣ<C7B6>Ĭ<EFBFBD><C4AC>Ϊ (0, 0)
    virtual void SetSkew(const Vec2& skew);

    /// \~chinese
    /// @brief <20><><EFBFBD>ô<EFBFBD><C3B4>нǶȣ<C7B6>Ĭ<EFBFBD><C4AC>Ϊ (0, 0)
    void SetSkew(float skewx, float skewy);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ת<EFBFBD>Ƕȣ<C7B6>Ĭ<EFBFBD><C4AC>Ϊ 0
    virtual void SetRotation(float rotation);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>ê<EFBFBD><C3AA>λ<EFBFBD>ã<EFBFBD>Ĭ<EFBFBD><C4AC>Ϊ (0, 0), <20><>Χ [0, 1]
    virtual void SetAnchor(const Vec2& anchor);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>ê<EFBFBD><C3AA>λ<EFBFBD>ã<EFBFBD>Ĭ<EFBFBD><C4AC>Ϊ (0, 0), <20><>Χ [0, 1]
    void SetAnchor(float anchorx, float anchory);

    /// \~chinese
    /// @brief <20>޸Ĵ<DEB8>С
    virtual void SetSize(const Size& size);

    /// \~chinese
    /// @brief <20>޸Ĵ<DEB8>С
    void SetSize(float width, float height);

    /// \~chinese
    /// @brief <20>޸Ŀ<DEB8><C4BF><EFBFBD>
    void SetWidth(float width);

    /// \~chinese
    /// @brief <20>޸ĸ߶<C4B8>
    void SetHeight(float height);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>͸<EFBFBD><CDB8><EFBFBD>ȣ<EFBFBD>Ĭ<EFBFBD><C4AC>Ϊ 1.0, <20><>Χ [0, 1]
    virtual void SetOpacity(float opacity);

    /// \~chinese
    /// @brief <20><><EFBFBD>û<EFBFBD><C3BB><EFBFBD><EFBFBD>ü<EFBFBD><C3BC><EFBFBD>͸<EFBFBD><CDB8><EFBFBD><EFBFBD>
    void SetCascadeOpacityEnabled(bool enabled);

    /// \~chinese
    /// @brief <20><><EFBFBD>ö<EFBFBD>ά<EFBFBD><CEAC><EFBFBD><EFBFBD><EFBFBD>任
    void SetTransform(const Transform& transform);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD> Z <20><>˳<EFBFBD><CBB3><EFBFBD><EFBFBD>Ĭ<EFBFBD><C4AC>Ϊ 0
    void SetZOrder(int zorder);

    /// \~chinese
    /// @brief <20><><EFBFBD>ý<EFBFBD>ɫ<EFBFBD>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>Ӧ<EFBFBD><D3A6>Ĭ<EFBFBD><C4AC>Ϊ false
    /// @details <20><><EFBFBD><EFBFBD>Ӧ<EFBFBD>Ľ<EFBFBD>ɫ<EFBFBD><C9AB><EFBFBD>յ<EFBFBD><D5B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> Hover | Out | Click <20><>Ϣ
    void SetResponsible(bool enable);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD>ӽ<EFBFBD>ɫ
    void AddChild(ActorPtr child, int zorder = 0);

    /// \~chinese
    /// @brief <20><><EFBFBD>Ӷ<EFBFBD><D3B6><EFBFBD><EFBFBD>ӽ<EFBFBD>ɫ
    void AddChildren(const Vector<ActorPtr>& children);

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͬ<EFBFBD><CDAC><EFBFBD>ӽ<EFBFBD>ɫ
    ActorPtr GetChild(const String& name) const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͬ<EFBFBD><CDAC><EFBFBD>ӽ<EFBFBD>ɫ
    Vector<ActorPtr> GetChildren(const String& name) const;

    /// \~chinese
    /// @brief <20><>ȡȫ<C8A1><C8AB><EFBFBD>ӽ<EFBFBD>ɫ
    ActorList& GetAllChildren();

    /// \~chinese
    /// @brief <20><>ȡȫ<C8A1><C8AB><EFBFBD>ӽ<EFBFBD>ɫ
    const ActorList& GetAllChildren() const;

    /// \~chinese
    /// @brief <20>Ƴ<EFBFBD><C6B3>ӽ<EFBFBD>ɫ
    void RemoveChild(ActorPtr child);

    /// \~chinese
    /// @brief <20>Ƴ<EFBFBD><C6B3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͬ<EFBFBD><CDAC><EFBFBD>ӽ<EFBFBD>ɫ
    void RemoveChildren(const String& child_name);

    /// \~chinese
    /// @brief <20>Ƴ<EFBFBD><C6B3><EFBFBD><EFBFBD>н<EFBFBD>ɫ
    void RemoveAllChildren();

    /// \~chinese
    /// @brief <20>Ӹ<EFBFBD><D3B8><EFBFBD>ɫ<EFBFBD>Ƴ<EFBFBD>
    void RemoveFromParent();

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    /// @param component <20><><EFBFBD><EFBFBD>
    Component* AddComponent(ComponentPtr component);

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    ComponentList& GetAllComponents();

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    const ComponentList& GetAllComponents() const;

    /// \~chinese
    /// @brief <20>Ƴ<EFBFBD><C6B3><EFBFBD><EFBFBD><EFBFBD>
    void RemoveComponent(ComponentPtr component);

    /// \~chinese
    /// @brief <20>Ƴ<EFBFBD><C6B3><EFBFBD><EFBFBD><EFBFBD>
    /// @param name <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void RemoveComponents(const String& name);

    /// \~chinese
    /// @brief <20>Ƴ<EFBFBD><C6B3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void RemoveAllComponents();

    /// \~chinese
    /// @brief <20><>ͣ<EFBFBD><CDA3>ɫ<EFBFBD><C9AB><EFBFBD><EFBFBD>
    void PauseUpdating();

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɫ<EFBFBD><C9AB><EFBFBD><EFBFBD>
    void ResumeUpdating();

    /// \~chinese
    /// @brief <20><>ɫ<EFBFBD><C9AB><EFBFBD><EFBFBD><EFBFBD>Ƿ<EFBFBD><C7B7><EFBFBD>ͣ
    bool IsUpdatePausing() const;

    /// \~chinese
    /// @brief <20><><EFBFBD>ø<EFBFBD><C3B8><EFBFBD>ʱ<EFBFBD>Ļص<C4BB><D8B5><EFBFBD><EFBFBD><EFBFBD>
    void SetCallbackOnUpdate(const UpdateCallback& cb);

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>ʱ<EFBFBD>Ļص<C4BB><D8B5><EFBFBD><EFBFBD><EFBFBD>
    UpdateCallback GetCallbackOnUpdate() const;

    /// \~chinese
    /// @brief <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>壬<EFBFBD><E5A3AC><EFBFBD><EFBFBD>kiwano-physics<63><73><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>Ч
    physics::PhysicBody* GetPhysicBody() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>壬<EFBFBD><E5A3AC><EFBFBD><EFBFBD>kiwano-physics<63><73><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>Ч
    void SetPhysicBody(physics::PhysicBody* body);

    /// \~chinese
    /// @brief <20>жϵ<D0B6><CFB5>Ƿ<EFBFBD><C7B7>ڽ<EFBFBD>ɫ<EFBFBD><C9AB>
    virtual bool ContainsPoint(const Point& point) const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϵ<EFBFBD><CFB5>ת<EFBFBD><D7AA>Ϊ<EFBFBD>ֲ<EFBFBD><D6B2><EFBFBD><EFBFBD><EFBFBD>ϵ<EFBFBD><CFB5>
    Point ConvertToLocal(const Point& point) const;

    /// \~chinese
    /// @brief <20><><EFBFBD>ֲ<EFBFBD><D6B2><EFBFBD><EFBFBD><EFBFBD>ϵ<EFBFBD><CFB5>ת<EFBFBD><D7AA>Ϊ<EFBFBD><CEAA><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϵ<EFBFBD><CFB5>
    Point ConvertToWorld(const Point& point) const;

    /// \~chinese
    /// @brief <20><>Ⱦ<EFBFBD><C8BE>ɫ<EFBFBD>߽<EFBFBD>
    void ShowBorder(bool show);

    /// \~chinese
    /// @brief <20>ַ<EFBFBD><D6B7>¼<EFBFBD>
    /// @param evt <20>¼<EFBFBD>
    /// @return <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD><D6B7><EFBFBD><EFBFBD>¼<EFBFBD>
    virtual bool DispatchEvent(Event* evt);

    /// \~chinese
    /// @brief <20><><EFBFBD>л<EFBFBD>
    void DoSerialize(Serializer* serializer) const override;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD>л<EFBFBD>
    void DoDeserialize(Deserializer* deserializer) override;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD>Ĭ<EFBFBD><C4AC>ê<EFBFBD><C3AA>
    static void SetDefaultAnchor(float anchor_x, float anchor_y);

protected:
    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ӽ<EFBFBD>ɫ
    virtual void Update(Duration dt);

    /// \~chinese
    /// @brief <20><>Ⱦ<EFBFBD><C8BE><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ӽ<EFBFBD>ɫ
    virtual void Render(RenderContext& ctx);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ӽ<EFBFBD>ɫ<EFBFBD>ı߽<C4B1>
    virtual void RenderBorder(RenderContext& ctx);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>Ⱦ<EFBFBD><C8BE><EFBFBD><EFBFBD><EFBFBD>ĵ<EFBFBD><C4B5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    virtual bool CheckVisibility(RenderContext& ctx) const;

    /// \~chinese
    /// @brief <20><>Ⱦǰ<C8BE><C7B0>ʼ<EFBFBD><CABC><EFBFBD><EFBFBD>Ⱦ<EFBFBD><C8BE><EFBFBD><EFBFBD><EFBFBD><EFBFBD>״̬<D7B4><CCAC><EFBFBD><EFBFBD><EFBFBD><EFBFBD> CheckVisibility <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD>øú<C3B8><C3BA><EFBFBD>
    virtual void PrepareToRender(RenderContext& ctx);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD>Լ<EFBFBD><D4BC>Ķ<EFBFBD>ά<EFBFBD>任<EFBFBD><E4BBBB><EFBFBD><EFBFBD>֪ͨ<CDA8><D6AA><EFBFBD><EFBFBD><EFBFBD>ӽ<EFBFBD>ɫ
    void UpdateTransform() const;

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD>Լ<EFBFBD><D4BC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ӽ<EFBFBD>ɫ<EFBFBD><C9AB>͸<EFBFBD><CDB8><EFBFBD><EFBFBD>
    void UpdateOpacity();

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ӽ<EFBFBD>ɫ<EFBFBD><C9AB>Z<EFBFBD><5A>˳<EFBFBD><CBB3><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void Reorder();

    /// \~chinese
    /// @brief <20><><EFBFBD>ýڵ<C3BD><DAB5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>̨
    void SetStage(Stage* stage);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD>¼<EFBFBD>
    bool HandleEvent(Event* evt);

    /// \~chinese
    /// @brief <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
    void UpdateComponents(Duration dt);

    /// \~chinese
    /// @brief <20><>Ⱦ<EFBFBD><C8BE><EFBFBD><EFBFBD>
    void RenderComponents(RenderContext& ctx);

private:
    bool           visible_;
    bool           update_pausing_;
    bool           cascade_opacity_;
    bool           show_border_;
    bool           hover_;
    bool           pressed_;
    bool           responsible_;
    int            z_order_;
    float          opacity_;
    float          displayed_opacity_;
    Actor*         parent_;
    Stage*         stage_;
    size_t         hash_name_;
    Point          anchor_;
    Size           size_;
    ActorList      children_;
    ComponentList  components_;
    UpdateCallback cb_update_;
    Transform      transform_;

    bool              is_fast_transform_;
    mutable bool      visible_in_rt_;
    mutable bool      dirty_visibility_;
    mutable bool      dirty_transform_;
    mutable bool      dirty_transform_inverse_;
    mutable Matrix3x2 transform_matrix_;
    mutable Matrix3x2 transform_matrix_inverse_;
    mutable Matrix3x2 transform_matrix_to_parent_;

    physics::PhysicBody* physic_body_;
};

/** @} */

inline void Actor::OnUpdate(Duration dt)
{
    KGE_NOT_USED(dt);
}

inline void Actor::OnRender(RenderContext& ctx)
{
    KGE_NOT_USED(ctx);
}

inline bool Actor::IsVisible() const
{
    return visible_;
}

inline bool Actor::IsResponsible() const
{
    return responsible_;
}

inline bool Actor::IsCascadeOpacityEnabled() const
{
    return cascade_opacity_;
}

inline size_t Actor::GetHashName() const
{
    return hash_name_;
}

inline int Actor::GetZOrder() const
{
    return z_order_;
}

inline Point Actor::GetPosition() const
{
    return transform_.position;
}

inline float Actor::GetPositionX() const
{
    return GetPosition().x;
}

inline float Actor::GetPositionY() const
{
    return GetPosition().y;
}

inline Point Actor::GetScale() const
{
    return transform_.scale;
}

inline float Actor::GetScaleX() const
{
    return GetScale().x;
}

inline float Actor::GetScaleY() const
{
    return GetScale().y;
}

inline Point Actor::GetSkew() const
{
    return transform_.skew;
}

inline float Actor::GetSkewX() const
{
    return GetSkew().x;
}

inline float Actor::GetSkewY() const
{
    return GetSkew().y;
}

inline float Actor::GetRotation() const
{
    return transform_.rotation;
}

inline float Actor::GetWidth() const
{
    return GetSize().x;
}

inline float Actor::GetHeight() const
{
    return GetSize().y;
}

inline Size Actor::GetSize() const
{
    return size_;
}

inline float Actor::GetScaledWidth() const
{
    return GetWidth() * GetScaleX();
}

inline float Actor::GetScaledHeight() const
{
    return GetHeight() * GetScaleY();
}

inline Size Actor::GetScaledSize() const
{
    return Size{ GetScaledWidth(), GetScaledHeight() };
}

inline Point Actor::GetAnchor() const
{
    return anchor_;
}

inline float Actor::GetAnchorX() const
{
    return GetAnchor().x;
}

inline float Actor::GetAnchorY() const
{
    return GetAnchor().y;
}

inline float Actor::GetOpacity() const
{
    return opacity_;
}

inline float Actor::GetDisplayedOpacity() const
{
    return displayed_opacity_;
}

inline Transform Actor::GetTransform() const
{
    return transform_;
}

inline Actor* Actor::GetParent() const
{
    return parent_;
}

inline Stage* Actor::GetStage() const
{
    return stage_;
}

inline void Actor::PauseUpdating()
{
    update_pausing_ = true;
}

inline void Actor::ResumeUpdating()
{
    update_pausing_ = false;
}

inline bool Actor::IsUpdatePausing() const
{
    return update_pausing_;
}

inline void Actor::SetCallbackOnUpdate(const UpdateCallback& cb)
{
    cb_update_ = cb;
}

inline Actor::UpdateCallback Actor::GetCallbackOnUpdate() const
{
    return cb_update_;
}

inline physics::PhysicBody* Actor::GetPhysicBody() const
{
    return physic_body_;
}

inline void Actor::SetPhysicBody(physics::PhysicBody* body)
{
    physic_body_ = body;
}

inline void Actor::ShowBorder(bool show)
{
    show_border_ = show;
}

inline void Actor::SetPosition(float x, float y)
{
    this->SetPosition(Point(x, y));
}

inline void Actor::SetPositionX(float x)
{
    this->SetPosition(Point(x, transform_.position.y));
}

inline void Actor::SetPositionY(float y)
{
    this->SetPosition(Point(transform_.position.x, y));
}

inline void Actor::Move(const Vec2& v)
{
    this->SetPosition(transform_.position.x + v.x, transform_.position.y + v.y);
}

inline void Actor::Move(float vx, float vy)
{
    this->Move(Vec2(vx, vy));
}

inline void Actor::SetScale(float scalex, float scaley)
{
    this->SetScale(Vec2(scalex, scaley));
}

inline void Actor::SetAnchor(float anchorx, float anchory)
{
    this->SetAnchor(Vec2(anchorx, anchory));
}

inline void Actor::SetSize(float width, float height)
{
    this->SetSize(Size(width, height));
}

inline void Actor::SetWidth(float width)
{
    this->SetSize(Size(width, size_.y));
}

inline void Actor::SetHeight(float height)
{
    this->SetSize(Size(size_.x, height));
}

inline void Actor::SetSkew(float skewx, float skewy)
{
    this->SetSkew(Vec2(skewx, skewy));
}

}  // namespace kiwano