Magic_Game/core/e2dtool.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 "e2dutil.h"
#include "e2dimpl.h"

namespace e2d
{


	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	class Random
	{
	public:
		// ȡ<>÷<EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		template<typename T>
		static inline T Range(T min, T max)
		{
			return e2d::Random::RandomInt(min, max);
		}

		// ȡ<>÷<EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		static inline float Range(float min, float max)
		{
			return e2d::Random::RandomReal(min, max);
		}

		// ȡ<>÷<EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		static inline double Range(double min, double max)
		{
			return e2d::Random::RandomReal(min, max);
		}

	private:
		template<typename T>
		static T RandomInt(T min, T max)
		{
			std::uniform_int_distribution<T> dist(min, max);
			return dist(Random::GetEngine());
		}

		template<typename T>
		static T RandomReal(T min, T max)
		{
			std::uniform_real_distribution<T> dist(min, max);
			return dist(Random::GetEngine());
		}

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		static std::default_random_engine &GetEngine();
	};


	// <20><><EFBFBD><EFBFBD>
	class Music
		: public IMFAsyncCallback
	{
	public:
		Music();

		explicit Music(
			const e2d::String& file_path	/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
		);

		explicit Music(
			const Resource& res		/* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ */
		);

		virtual ~Music();

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>
		bool Load(
			const e2d::String& file_path	/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ
		bool Load(
			const Resource& res
		);

		// <20><><EFBFBD><EFBFBD>
		bool Play(
			int loop_count = 0
		);

		// <20><>ͣ
		void Pause();

		// ֹͣ
		void Stop();

		// <20>رղ<D8B1><D5B2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ
		void Close();

		// <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD>ڲ<EFBFBD><DAB2><EFBFBD>
		bool IsPlaying() const;

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		bool SetVolume(
			float volume	/* <20><>Χ: 0.0 ~ 1.0 */
		);

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>
		float GetVolume() const;

		// IUnknown methods
		STDMETHODIMP QueryInterface(REFIID iid, void** ppv) override;
		STDMETHODIMP_(ULONG) AddRef() override;
		STDMETHODIMP_(ULONG) Release() override;

		// IMFAsyncCallback methods
		STDMETHODIMP  GetParameters(DWORD*, DWORD*) override;
		STDMETHODIMP  Invoke(IMFAsyncResult* pAsyncResult) override;

	protected:
		enum class State : int
		{
			Closed = 0,
			Loaded,
			Started,
			Paused,
			Stopped,
			Closing
		};

		E2D_DISABLE_COPY(Music);

		// Media event handlers
		HRESULT OnNewPresentation(IMFMediaEvent *pEvent);

		HRESULT StartPlayback();
		HRESULT CreateMediaSource(PCWSTR sURL, IMFMediaSource **ppSource);
		HRESULT HandleEvent(UINT_PTR pUnkPtr);

		// Add a source node to a topology.
		HRESULT AddSourceNode(
			IMFTopology *pTopology,           // Topology.
			IMFMediaSource *pSource,          // Media source.
			IMFPresentationDescriptor *pPD,   // Presentation descriptor.
			IMFStreamDescriptor *pSD,         // Stream descriptor.
			IMFTopologyNode **ppNode         // Receives the node pointer.
		);

		// Add an output node to a topology.
		HRESULT AddOutputNode(
			IMFTopology *pTopology,     // Topology.
			IMFActivate *pActivate,     // Media sink activation object.
			DWORD dwId,                 // Identifier of the stream sink.
			IMFTopologyNode **ppNode   // Receives the node pointer.
		);

		HRESULT AddBranchToPartialTopology(
			IMFTopology *pTopology,         // Topology.
			IMFMediaSource *pSource,        // Media source.
			IMFPresentationDescriptor *pPD, // Presentation descriptor.
			DWORD iStream                  // Stream index.
		);

		//  Create a playback topology from a media source.
		HRESULT CreatePlaybackTopology(
			IMFMediaSource *pSource,          // Media source.
			IMFPresentationDescriptor *pPD,   // Presentation descriptor.
			IMFTopology **ppTopology          // Receives a pointer to the topology.
		);

		//  Create an activation object for a renderer, based on the stream media type.
		HRESULT CreateMediaSinkActivate(
			IMFStreamDescriptor *pSourceSD,     // Pointer to the stream descriptor.
			IMFActivate **ppActivate
		);

		HRESULT GetSimpleAudioVolume(
			IMFSimpleAudioVolume** ppAudioVolume
		) const;

		static LRESULT CALLBACK MediaProc(
			HWND hWnd,
			UINT Msg,
			WPARAM wParam,
			LPARAM lParam
		);

	protected:
		long					m_nRefCount;
		int						m_nTimes;
		IMFMediaSession *		m_pSession;
		IMFMediaSource          *m_pSource;
		HWND                    m_hwndEvent;
		State					m_state;
		HANDLE                  m_hCloseEvent;
	};


	// <20><><EFBFBD>ֲ<EFBFBD><D6B2><EFBFBD><EFBFBD><EFBFBD>
	class Player
	{
	public:
		Player();

		~Player();

		// Ԥ<><D4A4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ
		bool Load(
			const String& file_path	/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		bool Play(
			const String& file_path,	/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
			int loop_count = 0		/* <20>ظ<EFBFBD><D8B8><EFBFBD><EFBFBD>Ŵ<EFBFBD><C5B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> -1 Ϊѭ<CEAA><D1AD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
		);

		// <20><>ͣ<EFBFBD><CDA3><EFBFBD><EFBFBD>
		void Pause(
			const String& file_path	/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		void Resume(
			const String& file_path	/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
		);

		// ֹͣ<CDA3><D6B9><EFBFBD><EFBFBD>
		void Stop(
			const String& file_path	/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
		);

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD>ֲ<EFBFBD><D6B2><EFBFBD>״̬
		bool IsPlaying(
			const String& file_path	/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
		);

		// Ԥ<><D4A4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ
		bool Load(
			const Resource& res		/* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		bool Play(
			const Resource& res,	/* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ */
			int loop_count = 0		/* <20>ظ<EFBFBD><D8B8><EFBFBD><EFBFBD>Ŵ<EFBFBD><C5B4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> -1 Ϊѭ<CEAA><D1AD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
		);

		// <20><>ͣ<EFBFBD><CDA3><EFBFBD><EFBFBD>
		void Pause(
			const Resource& res		/* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		void Resume(
			const Resource& res		/* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ */
		);

		// ֹͣ<CDA3><D6B9><EFBFBD><EFBFBD>
		void Stop(
			const Resource& res		/* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ */
		);

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD>ֲ<EFBFBD><D6B2><EFBFBD>״̬
		bool IsPlaying(
			const Resource& res		/* <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ */
		);

		// <20><>ȡ<EFBFBD><C8A1><EFBFBD><EFBFBD>
		float GetVolume();

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		void SetVolume(
			float volume			/* <20><>Χ: 0.0 ~ 1.0 */
		);

		// <20><>ͣ<EFBFBD><CDA3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		void PauseAll();

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		void ResumeAll();

		// ֹͣ<CDA3><D6B9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		void StopAll();

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
		static void ClearCache();

	protected:
		E2D_DISABLE_COPY(Player);

	protected:
		float volume_;

		static std::map<size_t, Music*> musics_;
	};


	// <20><><EFBFBD>ݹ<EFBFBD><DDB9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	class Data
	{
	public:
		Data(
			const String& key,					/* <20><>ֵ */
			const String& field = L"Defalut"	/* <20>ֶ<EFBFBD><D6B6><EFBFBD><EFBFBD><EFBFBD> */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>
		bool Exists() const;

		// <20><><EFBFBD><EFBFBD> int <20><><EFBFBD>͵<EFBFBD>ֵ
		bool SaveInt(
			int value
		);

		// <20><><EFBFBD><EFBFBD> float <20><><EFBFBD>͵<EFBFBD>ֵ
		bool SaveFloat(
			float value
		);

		// <20><><EFBFBD><EFBFBD> double <20><><EFBFBD>͵<EFBFBD>ֵ
		bool SaveDouble(
			double value
		);

		// <20><><EFBFBD><EFBFBD> bool <20><><EFBFBD>͵<EFBFBD>ֵ
		bool SaveBool(
			bool value
		);

		// <20><><EFBFBD><EFBFBD> String <20><><EFBFBD>͵<EFBFBD>ֵ
		bool SaveString(
			const String& value
		);

		// <20><>ȡ int <20><><EFBFBD>͵<EFBFBD>ֵ
		int GetInt() const;

		// <20><>ȡ float <20><><EFBFBD>͵<EFBFBD>ֵ
		float GetFloat() const;

		// <20><>ȡ double <20><><EFBFBD>͵<EFBFBD>ֵ
		double GetDouble() const;

		// <20><>ȡ bool <20><><EFBFBD>͵<EFBFBD>ֵ
		bool GetBool() const;

		// <20><>ȡ <20>ַ<EFBFBD><D6B7><EFBFBD> <20><><EFBFBD>͵<EFBFBD>ֵ
		String GetString();

	protected:
		String key_;
		String field_;
		const String& data_path_;
	};


	// <20>ļ<EFBFBD>
	class File
	{
	public:
		File();

		File(
			const String& file_name
		);

		virtual ~File();

		// <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>
		bool Open(
			const String& file_name
		);

		// <20>ļ<EFBFBD><C4BC><EFBFBD><EFBFBD>ļ<EFBFBD><C4BC><EFBFBD><EFBFBD>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>
		bool Exists() const;

		// <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD>ļ<EFBFBD><C4BC><EFBFBD>
		bool IsFolder() const;

		// ɾ<><C9BE><EFBFBD>ļ<EFBFBD>
		bool Delete();

		// <20><>ȡ<EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7>
		const String& GetPath() const;

		// <20><>ȡ<EFBFBD>ļ<EFBFBD><C4BC><EFBFBD>չ<EFBFBD><D5B9>
		String GetExtension() const;

		// <20>ͷ<EFBFBD><CDB7><EFBFBD>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD>ʱ<EFBFBD>ļ<EFBFBD>Ŀ¼
		static File Extract(
			int resource_name,				/* <20><>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD> */
			const String& resource_type,	/* <20><>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD> */
			const String& dest_file_name	/* Ŀ<><C4BF><EFBFBD>ļ<EFBFBD><C4BC><EFBFBD> */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD><C4BC><EFBFBD><EFBFBD><EFBFBD>·<EFBFBD><C2B7>
		static void AddSearchPath(
			const String& path
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD><C4BC><EFBFBD>
		static bool CreateFolder(
			const String& dir_path	/* <20>ļ<EFBFBD><C4BC><EFBFBD>·<EFBFBD><C2B7> */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD><C4BC>Ի<EFBFBD><D4BB><EFBFBD>
		static File ShowOpenDialog(
			const String& title = L"<EFBFBD><EFBFBD><EFBFBD><EFBFBD>",	/* <20>Ի<EFBFBD><D4BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
			const String& filter = L""		/* ɸѡ<C9B8><D1A1>չ<EFBFBD><D5B9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> "*.jpg;*.jpeg" */
		);

		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD><C4BC>Ի<EFBFBD><D4BB><EFBFBD>
		static File ShowSaveDialog(
			const String& title = L"<EFBFBD><EFBFBD><EFBFBD><EFBFBD>",	/* <20>Ի<EFBFBD><D4BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
			const String& def_file = L"",	/* Ĭ<>ϱ<EFBFBD><CFB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD><C4BC><EFBFBD> */
			const String& def_ext = L""		/* Ĭ<><C4AC>׷<EFBFBD>ӵ<EFBFBD><D3B5><EFBFBD>չ<EFBFBD><D5B9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> "txt" */
		);

	protected:
		DWORD attributes_;
		String file_path_;

		static std::list<String> search_paths_;
	};


	// ·<><C2B7>
	class Path
	{
	public:
		// <20><>ȡ<EFBFBD><C8A1><EFBFBD>ݵ<EFBFBD>Ĭ<EFBFBD>ϱ<EFBFBD><CFB1><EFBFBD>·<EFBFBD><C2B7>
		static const String& GetDataPath();

		// <20><>ȡ<EFBFBD><C8A1>ʱ<EFBFBD>ļ<EFBFBD>Ŀ¼
		static const String& GetTemporaryPath();

		// <20><>ȡ LocalAppData Ŀ¼
		static const String& GetLocalAppDataPath();

		// <20><>ȡ<EFBFBD><C8A1>ǰ<EFBFBD><C7B0><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>·<EFBFBD><C2B7>
		static const String& GetExeFilePath();
	};

}