Magic_Game/core/base/Node.h

// Copyright (c) 2016-2018 Easy2D - 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 "base.hpp"
#include "time.h"
#include "Unit.h"
#include "TaskManager.h"
#include "ActionManager.h"
#include "EventDispatcher.h"
#include "intrusive/List.hpp"

namespace easy2d
{
    class Game;

	// <20>ڵ<EFBFBD>
	class Node
		: public Unit
		, public TaskManager
		, public ActionManager
		, public EventDispatcher
		, protected intrusive::ListItem<spNode>
	{
		friend class Game;
		friend class Scene;
		friend class Transition;
		friend class intrusive::List<spNode>;

		using Nodes = std::vector<spNode>;
		using Children = intrusive::List<spNode>;

	public:
		Node();

		// <20><>ʼ<EFBFBD><CABC><EFBFBD>ڵ<EFBFBD>
		virtual void Init();

		// <20><><EFBFBD>½ڵ<C2BD>
		virtual void Update(Duration const& dt);

		// <20><>Ⱦ<EFBFBD>ڵ<EFBFBD>
		virtual void OnRender();

		// <20><><EFBFBD><EFBFBD><EFBFBD>¼<EFBFBD>
		virtual void HandleEvent(Event* e);

		// <20><>ȡ<EFBFBD><C8A1>ʾ״̬
		bool IsVisible() const { return visible_; }

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>
		String const& GetName() const { return name_; }

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD>Ƶ<EFBFBD> Hash ֵ
		size_t GetHashName() const { return hash_name_; }

		// <20><>ȡ Z <20><>˳<EFBFBD><CBB3>
		int GetZOrder() const { return z_order_; }

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>
		virtual float GetWidth() const { return size_.width * transform_.scale.x; }

		// <20><>ȡ<EFBFBD>߶<EFBFBD>
		virtual float GetHeight() const { return size_.height * transform_.scale.y; }

		// <20><>ȡ<EFBFBD><C8A1>С
		Size GetSize() const { return Size{ GetWidth(), GetHeight() }; }

		// <20><>ȡ x <20><><EFBFBD><EFBFBD>֧<EFBFBD><D6A7>
		virtual float GetPivotX() const { return pivot_.x; }

		// <20><>ȡ y <20><><EFBFBD><EFBFBD>֧<EFBFBD><D6A7>
		virtual float GetPivotY() const { return pivot_.y; }

		// <20><>ȡ͸<C8A1><CDB8><EFBFBD><EFBFBD>
		virtual float GetOpacity() const { return opacity_; }

		// <20><>ȡ<EFBFBD><C8A1>Χ<EFBFBD><CEA7>
		virtual Rect GetBounds();

		// <20><>ȡ<EFBFBD><C8A1>ά<EFBFBD>任<EFBFBD><E4BBBB><EFBFBD><EFBFBD>
		virtual math::Matrix const& GetTransformMatrix() override;

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD>ڵ<EFBFBD>
		spNode GetParent() const;

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD>ڳ<EFBFBD><DAB3><EFBFBD>
		spScene GetScene() const;

		// <20><><EFBFBD><EFBFBD><EFBFBD>Ƿ<EFBFBD><C7B7><EFBFBD>ʾ
		void SetVisible(
			bool val
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		void SetName(
			String const& name
		);

		// <20><><EFBFBD><EFBFBD>֧<EFBFBD><D6A7><EFBFBD>ĺ<EFBFBD><C4BA><EFBFBD>λ<EFBFBD><CEBB>
		// Ĭ<><C4AC>Ϊ 0, <20><>Χ [0, 1]
		void SetPivotX(
			float pivot_x
		);

		// <20><><EFBFBD><EFBFBD>֧<EFBFBD><D6A7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>λ<EFBFBD><CEBB>
		// Ĭ<><C4AC>Ϊ 0, <20><>Χ [0, 1]
		void SetPivotY(
			float pivot_y
		);

		// <20><><EFBFBD><EFBFBD>֧<EFBFBD><D6A7>λ<EFBFBD><CEBB>
		// Ĭ<><C4AC>Ϊ (0, 0), <20><>Χ [0, 1]
		virtual void SetPivot(
			float pivot_x,
			float pivot_y
		);

		// <20>޸Ŀ<DEB8><C4BF><EFBFBD>
		void SetWidth(
			float width
		);

		// <20>޸ĸ߶<C4B8>
		void SetHeight(
			float height
		);

		// <20>޸Ĵ<DEB8>С
		void SetSize(
			float width,
			float height
		);

		// <20>޸Ĵ<DEB8>С
		void SetSize(
			const Size & size
		);

		virtual void SetTransform(
			Transform const& transform
		) override;

		// <20><><EFBFBD><EFBFBD>͸<EFBFBD><CDB8><EFBFBD><EFBFBD>
		// Ĭ<><C4AC>Ϊ 1.0, <20><>Χ [0, 1]
		void SetOpacity(
			float opacity
		);

		// <20><><EFBFBD><EFBFBD> Z <20><>˳<EFBFBD><CBB3>
		// Ĭ<><C4AC>Ϊ 0
		void SetZOrder(
			int order
		);

		// <20><><EFBFBD>ñ߿<C3B1><DFBF><EFBFBD>ɫ
		void SetBorderColor(
			const Color& color
		);

		// <20>жϵ<D0B6><CFB5>Ƿ<EFBFBD><C7B7>ڽڵ<DABD><DAB5><EFBFBD>
		bool ContainsPoint(
			const Point& point
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD>ӽڵ<D3BD>
		void AddChild(
			spNode const& child,
			int z_order = 0		/* Z <20><>˳<EFBFBD><CBB3> */
		);

		// <20><><EFBFBD>Ӷ<EFBFBD><D3B6><EFBFBD><EFBFBD>ӽڵ<D3BD>
		void AddChild(
			const Nodes& nodes,	/* <20>ڵ<EFBFBD><DAB5><EFBFBD><EFBFBD><EFBFBD> */
			int z_order = 0		/* Z <20><>˳<EFBFBD><CBB3> */
		);

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͬ<EFBFBD><CDAC><EFBFBD>ӽڵ<D3BD>
		Nodes GetChildren(
			String const& name
		) const;

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͬ<EFBFBD><CDAC><EFBFBD>ӽڵ<D3BD>
		spNode GetChild(
			String const& name
		) const;

		// <20><>ȡȫ<C8A1><C8AB><EFBFBD>ӽڵ<D3BD>
		Children const& GetChildren() const;

		// <20>Ƴ<EFBFBD><C6B3>ӽڵ<D3BD>
		bool RemoveChild(
			spNode const& child
		);

		// <20>Ƴ<EFBFBD><C6B3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͬ<EFBFBD><CDAC><EFBFBD>ӽڵ<D3BD>
		void RemoveChildren(
			String const& child_name
		);

		// <20>Ƴ<EFBFBD><C6B3><EFBFBD><EFBFBD>нڵ<D0BD>
		void RemoveAllChildren();

		// <20>Ӹ<EFBFBD><D3B8>ڵ<EFBFBD><DAB5>Ƴ<EFBFBD>
		void RemoveFromParent();

		virtual void DispatchEvent(Event* e) override;

		// <20><><EFBFBD><EFBFBD>Ĭ<EFBFBD><C4AC>֧<EFBFBD><D6A7>
		static void SetDefaultPivot(
			float pivot_x,
			float pivot_y
		);

		// <20><><EFBFBD>ñ߿<C3B1><DFBF>Զ<EFBFBD><D4B6><EFBFBD><EFBFBD><EFBFBD>
		static void EnableBorder();

		// <20><><EFBFBD>ñ߿<C3B1><DFBF>Զ<EFBFBD><D4B6><EFBFBD><EFBFBD><EFBFBD>
		static void DisableBorder();

	protected:
		void Render();

		void DrawBorder();

		void SortChildren();

		void UpdateBorder();

		void UpdateTransform();

		void UpdateOpacity();

		void SetScene(Scene* scene);

	protected:
		bool			inited_;
		bool			visible_;
		bool			dirty_sort_;
		int				z_order_;
		float			opacity_;
		float			display_opacity_;
		String			name_;
		size_t			hash_name_;
		Node*			parent_;
		Scene*			scene_;
		Color			border_color_;
		Children		children_;
		cpGeometry		border_;
		Point			pivot_;
		Size			size_;
		math::Matrix	initial_matrix_;
		math::Matrix	final_matrix_;
	};
}