Magic_Game/core/etools.h

#pragma once
#include "ebase.h"
#include <random>

namespace e2d
{

class ETimerManager;
class EAction;

// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
class ERandom
{
public:
	// ȡ<><C8A1><EFBFBD><EFBFBD><EFBFBD>ͷ<EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	template<typename T>
	static inline T range(T min, T max) { return e2d::ERandom::randomInt(min, max); }

	// ȡ<>ø<EFBFBD><C3B8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static inline float range(float min, float max) { return e2d::ERandom::randomReal(min, max); }

	// ȡ<>ø<EFBFBD><C3B8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static inline double range(double min, double max) { return e2d::ERandom::randomReal(min, max); }

	// ȡ<>ø<EFBFBD><C3B8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static inline long double range(long double min, long double max) { return e2d::ERandom::randomReal(min, max); }

	// ȡ<><C8A1><EFBFBD><EFBFBD><EFBFBD>ͷ<EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	template<typename T>
	static T randomInt(
		T min,
		T max)
	{
		std::uniform_int_distribution<T> dist(min, max);
		return dist(getEngine());
	}

	// ȡ<>ø<EFBFBD><C3B8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͷ<EFBFBD>Χ<EFBFBD>ڵ<EFBFBD>һ<EFBFBD><D2BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	template<typename T>
	static T randomReal(
		T min,
		T max)
	{
		std::uniform_real_distribution<T> dist(min, max);
		return dist(getEngine());
	}

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


// <20><>ʱ<EFBFBD><CAB1>
class ETimer :
	public EObject
{
	friend ETimerManager;

public:
	ETimer();

	ETimer(
		const TimerCallback &callback,	/* <20><>ʱ<EFBFBD><CAB1><EFBFBD>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD> */
		int repeatTimes = -1,			/* <20><>ʱ<EFBFBD><CAB1>ִ<EFBFBD>д<EFBFBD><D0B4><EFBFBD> */
		float interval = 0LL,			/* ʱ<><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>룩 */
		bool atOnce = false				/* <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>ִ<EFBFBD><D6B4> */
	);

	ETimer(
		const EString &name,			/* <20><>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
		const TimerCallback &callback,	/* <20><>ʱ<EFBFBD><CAB1><EFBFBD>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD> */
		int repeatTimes = -1,			/* <20><>ʱ<EFBFBD><CAB1>ִ<EFBFBD>д<EFBFBD><D0B4><EFBFBD> */
		float interval = 0,				/* ʱ<><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>룩 */
		bool atOnce = false				/* <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>ִ<EFBFBD><D6B4> */
	);

	// <20><>ȡ<EFBFBD><C8A1>ʱ<EFBFBD><CAB1>״̬
	bool isRunning() const;

	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD><CAB1>
	void start();

	// ֹͣ<CDA3><D6B9>ʱ<EFBFBD><CAB1>
	void stop();

	// <20><>ȡ<EFBFBD><C8A1>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	EString getName() const;

	// <20><>ȡ<EFBFBD><C8A1>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD>ڽڵ<DABD>
	ENode * getParentNode() const;

	// <20><><EFBFBD>ö<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	void setName(
		const EString &name
	);

	// <20><><EFBFBD>ö<EFBFBD>ʱ<EFBFBD><CAB1>ִ<EFBFBD>м<EFBFBD><D0BC><EFBFBD><EFBFBD><EFBFBD><EFBFBD>룩
	void setInterval(
		float interval
	);

	// <20><><EFBFBD>ö<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD>ص<EFBFBD><D8B5><EFBFBD><EFBFBD><EFBFBD>
	void setCallback(
		const TimerCallback & callback
	);

	// <20><><EFBFBD>ö<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD>ظ<EFBFBD>ִ<EFBFBD>д<EFBFBD><D0B4><EFBFBD>
	void setRepeatTimes(
		int nRepeatTimes
	);

	// <20><><EFBFBD>ö<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD>ڰ󶨺<DAB0><F3B6A8BA><EFBFBD><EFBFBD><EFBFBD>ִ<EFBFBD><D6B4>һ<EFBFBD><D2BB>
	virtual void setRunAtOnce(
		bool bAtOnce
	);

	// <20>󶨶<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	virtual void bindWith(
		EScene * pParentScene
	);

	// <20>󶨶<EFBFBD>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD>ڵ<EFBFBD>
	virtual void bindWith(
		ENode * pParentNode
	);

protected:
	// ִ<>лص<D0BB><D8B5><EFBFBD><EFBFBD><EFBFBD>
	virtual void _callOn();

	// <20>ж<EFBFBD><D0B6>Ƿ<EFBFBD><C7B7>ﵽִ<EFB5BD><D6B4>״̬
	bool _isReady();

protected:
	EString			m_sName;
	bool			m_bRunning;
	bool			m_bAtOnce;
	int				m_nRunTimes;
	int				m_nRepeatTimes;
	float			m_fInterval;
	float			m_fLast;
	ENode *			m_pParentNode;
	TimerCallback	m_Callback;
};


// <20><><EFBFBD>ݹ<EFBFBD><DDB9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
class EData
{
public:
	// <20><><EFBFBD><EFBFBD> int <20><><EFBFBD>͵<EFBFBD>ֵ
	static void saveInt(
		const EString & key,
		int value
	);

	// <20><><EFBFBD><EFBFBD> float <20><><EFBFBD>͵<EFBFBD>ֵ
	static void saveFloat(
		const EString & key,
		float value
	);

	// <20><><EFBFBD><EFBFBD> <20>ַ<EFBFBD><D6B7><EFBFBD> <20><><EFBFBD>͵<EFBFBD>ֵ
	static void saveString(
		const EString & key,
		const EString & value
	);

	// <20><>ȡ int <20><><EFBFBD>͵<EFBFBD>ֵ
	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>򷵻<EFBFBD> defaultValue <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>
	static int getInt(
		const EString & key,
		int defaultValue
	);

	// <20><>ȡ float <20><><EFBFBD>͵<EFBFBD>ֵ
	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>򷵻<EFBFBD> defaultValue <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>
	static float getFloat(
		const EString & key,
		float defaultValue
	);

	// <20><>ȡ <20>ַ<EFBFBD><D6B7><EFBFBD> <20><><EFBFBD>͵<EFBFBD>ֵ
	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>򷵻<EFBFBD> defaultValue <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ֵ<EFBFBD><D6B5>
	static EString getString(
		const EString & key,
		const EString & defaultValue
	);
};


// <20>ļ<EFBFBD><C4BC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
class EFile
{
public:
	// <20><>ȡϵͳ<CFB5><CDB3> AppData Local ·<><C2B7>
	static EString getLocalAppDataPath();

	// <20><>ȡ<EFBFBD><C8A1>ʱ<EFBFBD>ļ<EFBFBD>Ŀ¼
	static EString getTempPath();

	// <20><>ȡĬ<C8A1>ϵı<CFB5><C4B1><EFBFBD>·<EFBFBD><C2B7>
	static EString getDefaultSavePath();

	// <20><>ȡ<EFBFBD>ļ<EFBFBD><C4BC><EFBFBD>չ<EFBFBD><D5B9>
	static EString getFileExtension(
		const EString & filePath
	);

	// <20>򿪱<EFBFBD><F2BFAAB1><EFBFBD><EFBFBD>ļ<EFBFBD><C4BC>Ի<EFBFBD><D4BB><EFBFBD>
	static EString getSaveFilePath(
		const EString & title = L"<EFBFBD><EFBFBD><EFBFBD>浽",	/* <20>Ի<EFBFBD><D4BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> */
		const EString & defExt = L""		/* Ĭ<><C4AC><EFBFBD><EFBFBD>չ<EFBFBD><D5B9> */
	);
};


// <20><><EFBFBD>ֹ<EFBFBD><D6B9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
class EMusic
{
public:
	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static UINT play(
		const EString & musicFilePath,		/* <20><><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>·<EFBFBD><C2B7> */
		int repeatTimes = 1
	);

	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static UINT play(
		const EString & musicResourceName,	/* <20><>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD> */
		const EString & musicResourceType,	/* <20><>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD> */
		const EString & musicExtension,		/* ָ<><D6B8><EFBFBD><EFBFBD>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD>չ<EFBFBD><D5B9> */
		int repeatTimes = 1
	);

	// <20><>ͣ<EFBFBD><CDA3><EFBFBD><EFBFBD>
	static bool pause(
		UINT musicId
	);

	// <20><>ͣ<EFBFBD><CDA3><EFBFBD><EFBFBD>
	static bool pause(
		const EString& musicName
	);

	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static bool resume(
		UINT musicId
	);

	// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static bool resume(
		const EString& musicName
	);

	// ֹͣ<CDA3><D6B9><EFBFBD><EFBFBD>
	static bool stop(
		UINT musicId
	);

	// ֹͣ<CDA3><D6B9><EFBFBD><EFBFBD>
	static bool stop(
		const EString& musicName
	);

	// Ԥ<><D4A4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static UINT preload(
		const EString & musicFilePath
	);

	// Ԥ<><D4A4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static UINT preload(
		const EString & musicResourceName,	/* <20><>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD> */
		const EString & musicResourceType,	/* <20><>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD> */
		const EString & musicExtension		/* ָ<><D6B8><EFBFBD><EFBFBD>Դ<EFBFBD><D4B4><EFBFBD><EFBFBD>չ<EFBFBD><D5B9> */
	);

	// <20><>ͣ<EFBFBD><CDA3><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static void pauseAllMusics();

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

	// ֹͣ<CDA3><D6B9><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
	static void stopAllMusics();
};

}