518 lines
8.8 KiB
C++
518 lines
8.8 KiB
C++
#pragma once
|
||
#include "e2dbase.h"
|
||
|
||
namespace e2d
|
||
{
|
||
|
||
|
||
// 随机数产生器
|
||
class Random
|
||
{
|
||
public:
|
||
// 取得范围内的一个整型随机数
|
||
template<typename T>
|
||
static inline T range(T min, T max)
|
||
{
|
||
return e2d::Random::__randomInt(min, max);
|
||
}
|
||
|
||
// 取得范围内的一个浮点数随机数
|
||
static inline double range(float min, float max)
|
||
{
|
||
return e2d::Random::__randomReal(min, max);
|
||
}
|
||
|
||
// 取得范围内的一个浮点数随机数
|
||
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());
|
||
}
|
||
|
||
// 获取随机数产生器
|
||
static std::default_random_engine &__getEngine();
|
||
};
|
||
|
||
|
||
// 音乐
|
||
class Music :
|
||
public Object
|
||
{
|
||
friend class VoiceCallback;
|
||
|
||
public:
|
||
Music();
|
||
|
||
explicit Music(
|
||
const e2d::String& filePath /* 音乐文件路径 */
|
||
);
|
||
|
||
explicit Music(
|
||
int resNameId, /* 音乐资源名称 */
|
||
const String& resType /* 音乐资源类型 */
|
||
);
|
||
|
||
virtual ~Music();
|
||
|
||
// 打开音乐文件
|
||
bool open(
|
||
const e2d::String& filePath /* 音乐文件路径 */
|
||
);
|
||
|
||
// 打开音乐资源
|
||
bool open(
|
||
int resNameId, /* 音乐资源名称 */
|
||
const String& resType /* 音乐资源类型 */
|
||
);
|
||
|
||
// 播放
|
||
bool play(
|
||
int nLoopCount = 0
|
||
);
|
||
|
||
// 暂停
|
||
void pause();
|
||
|
||
// 继续
|
||
void resume();
|
||
|
||
// 停止
|
||
void stop();
|
||
|
||
// 关闭并回收资源
|
||
void close();
|
||
|
||
// 是否正在播放
|
||
bool isPlaying() const;
|
||
|
||
// 设置音量
|
||
bool setVolume(
|
||
double volume
|
||
);
|
||
|
||
// 设置播放结束时的执行函数
|
||
void setFuncOnEnd(
|
||
const Function& func
|
||
);
|
||
|
||
// 设置循环播放中每一次播放结束时的执行函数
|
||
void setFuncOnLoopEnd(
|
||
const Function& func
|
||
);
|
||
|
||
// 获取 IXAudio2SourceVoice 对象
|
||
IXAudio2SourceVoice * getIXAudio2SourceVoice() const;
|
||
|
||
protected:
|
||
bool _readMMIO();
|
||
|
||
bool _resetFile();
|
||
|
||
bool _read(
|
||
BYTE* pBuffer,
|
||
DWORD dwSizeToRead
|
||
);
|
||
|
||
bool _findMediaFileCch(
|
||
wchar_t* strDestPath,
|
||
int cchDest,
|
||
const wchar_t * strFilename
|
||
);
|
||
|
||
protected:
|
||
bool _opened;
|
||
bool _playing;
|
||
DWORD _dwSize;
|
||
CHAR* _resBuffer;
|
||
BYTE* _waveData;
|
||
HMMIO _hmmio;
|
||
MMCKINFO _ck;
|
||
MMCKINFO _ckRiff;
|
||
WAVEFORMATEX* _wfx;
|
||
VoiceCallback _voiceCallback;
|
||
IXAudio2SourceVoice* _voice;
|
||
};
|
||
|
||
|
||
// 音乐播放器
|
||
class Player
|
||
{
|
||
friend class Game;
|
||
typedef std::map<UINT, Music*> MusicMap;
|
||
|
||
public:
|
||
// 获取播放器实例
|
||
static Player * getInstance();
|
||
|
||
// 销毁实例
|
||
static void destroyInstance();
|
||
|
||
// 预加载音乐资源
|
||
bool preload(
|
||
const String& filePath /* 音乐文件路径 */
|
||
);
|
||
|
||
// 播放音乐
|
||
bool play(
|
||
const String& filePath, /* 音乐文件路径 */
|
||
int nLoopCount = 0 /* 重复播放次数，设置 -1 为循环播放 */
|
||
);
|
||
|
||
// 暂停音乐
|
||
void pause(
|
||
const String& filePath /* 音乐文件路径 */
|
||
);
|
||
|
||
// 继续播放音乐
|
||
void resume(
|
||
const String& filePath /* 音乐文件路径 */
|
||
);
|
||
|
||
// 停止音乐
|
||
void stop(
|
||
const String& filePath /* 音乐文件路径 */
|
||
);
|
||
|
||
// 获取音乐播放状态
|
||
bool isPlaying(
|
||
const String& filePath /* 音乐文件路径 */
|
||
);
|
||
|
||
// 预加载音乐资源
|
||
bool preload(
|
||
int resNameId, /* 音乐资源名称 */
|
||
const String& resType /* 音乐资源类型 */
|
||
);
|
||
|
||
// 播放音乐
|
||
bool play(
|
||
int resNameId, /* 音乐资源名称 */
|
||
const String& resType, /* 音乐资源类型 */
|
||
int nLoopCount = 0 /* 重复播放次数，设置 -1 为循环播放 */
|
||
);
|
||
|
||
// 暂停音乐
|
||
void pause(
|
||
int resNameId, /* 音乐资源名称 */
|
||
const String& resType /* 音乐资源类型 */
|
||
);
|
||
|
||
// 继续播放音乐
|
||
void resume(
|
||
int resNameId, /* 音乐资源名称 */
|
||
const String& resType /* 音乐资源类型 */
|
||
);
|
||
|
||
// 停止音乐
|
||
void stop(
|
||
int resNameId, /* 音乐资源名称 */
|
||
const String& resType /* 音乐资源类型 */
|
||
);
|
||
|
||
// 获取音乐播放状态
|
||
bool isPlaying(
|
||
int resNameId, /* 音乐资源名称 */
|
||
const String& resType /* 音乐资源类型 */
|
||
);
|
||
|
||
// 获取音量
|
||
double getVolume();
|
||
|
||
// 设置音量
|
||
void setVolume(
|
||
double volume /* 音量范围为 -224 ~ 224，0 是静音，1 是正常音量 */
|
||
);
|
||
|
||
// 暂停所有音乐
|
||
void pauseAll();
|
||
|
||
// 继续播放所有音乐
|
||
void resumeAll();
|
||
|
||
// 停止所有音乐
|
||
void stopAll();
|
||
|
||
// 获取 IXAudio2 对象
|
||
IXAudio2 * getIXAudio2();
|
||
|
||
private:
|
||
Player();
|
||
|
||
~Player();
|
||
|
||
E2D_DISABLE_COPY(Player);
|
||
|
||
private:
|
||
float _volume;
|
||
MusicMap _fileList;
|
||
MusicMap _resList;
|
||
IXAudio2* _xAudio2;
|
||
IXAudio2MasteringVoice* _masteringVoice;
|
||
|
||
static Player * _instance;
|
||
};
|
||
|
||
|
||
// 定时器
|
||
class Timer
|
||
{
|
||
friend class Game;
|
||
|
||
public:
|
||
// 添加定时器（每帧执行一次）
|
||
static void add(
|
||
const Function& func, /* 执行函数 */
|
||
const String& name = L"" /* 定时器名称 */
|
||
);
|
||
|
||
// 添加定时器
|
||
static void add(
|
||
const Function& func, /* 执行函数 */
|
||
double delay, /* 时间间隔（秒） */
|
||
int times = -1, /* 执行次数（设 -1 为永久执行） */
|
||
bool paused = false, /* 是否暂停 */
|
||
const String& name = L"" /* 定时器名称 */
|
||
);
|
||
|
||
// 在足够延迟后执行指定函数
|
||
static void start(
|
||
double timeout, /* 等待的时长（秒） */
|
||
const Function& func /* 执行的函数 */
|
||
);
|
||
|
||
// 启动具有相同名称的定时器
|
||
static void start(
|
||
const String& name
|
||
);
|
||
|
||
// 停止具有相同名称的定时器
|
||
static void stop(
|
||
const String& name
|
||
);
|
||
|
||
// 移除具有相同名称的定时器
|
||
static void remove(
|
||
const String& name
|
||
);
|
||
|
||
// 启动所有定时器
|
||
static void startAll();
|
||
|
||
// 停止所有定时器
|
||
static void stopAll();
|
||
|
||
// 移除所有定时器
|
||
static void removeAll();
|
||
|
||
private:
|
||
// 更新定时器
|
||
static void __update();
|
||
|
||
// 重置定时器状态
|
||
static void __resetAll();
|
||
|
||
// 清空定时器
|
||
static void __uninit();
|
||
};
|
||
|
||
|
||
class Collision;
|
||
|
||
// 监听器
|
||
class Listener
|
||
: public Object
|
||
{
|
||
friend class Input;
|
||
friend class Collision;
|
||
|
||
public:
|
||
Listener();
|
||
|
||
explicit Listener(
|
||
const Function& func,
|
||
const String& name,
|
||
bool paused
|
||
);
|
||
|
||
// 启动监听
|
||
void start();
|
||
|
||
// 停止监听
|
||
void stop();
|
||
|
||
// 获取监听器运行状态
|
||
bool isRunning() const;
|
||
|
||
// 获取名称
|
||
String getName() const;
|
||
|
||
// 设置名称
|
||
void setName(
|
||
const String& name
|
||
);
|
||
|
||
// 设置监听回调函数
|
||
void setFunc(
|
||
const Function& func
|
||
);
|
||
|
||
protected:
|
||
// 更新监听器状态
|
||
virtual void _update();
|
||
|
||
protected:
|
||
bool _running;
|
||
bool _stopped;
|
||
String _name;
|
||
Function _callback;
|
||
};
|
||
|
||
|
||
// 数据管理工具
|
||
class Data
|
||
{
|
||
public:
|
||
// 保存 int 类型的值
|
||
static void saveInt(
|
||
const String& key, /* 键值 */
|
||
int value, /* 数据 */
|
||
const String& field = L"Defalut" /* 字段名称 */
|
||
);
|
||
|
||
// 保存 double 类型的值
|
||
static void saveDouble(
|
||
const String& key, /* 键值 */
|
||
double value, /* 数据 */
|
||
const String& field = L"Defalut" /* 字段名称 */
|
||
);
|
||
|
||
// 保存 bool 类型的值
|
||
static void saveBool(
|
||
const String& key, /* 键值 */
|
||
bool value, /* 数据 */
|
||
const String& field = L"Defalut" /* 字段名称 */
|
||
);
|
||
|
||
// 保存 字符串 类型的值
|
||
static void saveString(
|
||
const String& key, /* 键值 */
|
||
const String& value, /* 数据 */
|
||
const String& field = L"Defalut" /* 字段名称 */
|
||
);
|
||
|
||
// 获取 int 类型的值
|
||
// （若不存在则返回 defaultValue 参数的值）
|
||
static int getInt(
|
||
const String& key, /* 键值 */
|
||
int defaultValue, /* 默认值 */
|
||
const String& field = L"Defalut" /* 字段名称 */
|
||
);
|
||
|
||
// 获取 double 类型的值
|
||
// （若不存在则返回 defaultValue 参数的值）
|
||
static double getDouble(
|
||
const String& key, /* 键值 */
|
||
double defaultValue, /* 默认值 */
|
||
const String& field = L"Defalut" /* 字段名称 */
|
||
);
|
||
|
||
// 获取 bool 类型的值
|
||
// （若不存在则返回 defaultValue 参数的值）
|
||
static bool getBool(
|
||
const String& key, /* 键值 */
|
||
bool defaultValue, /* 默认值 */
|
||
const String& field = L"Defalut" /* 字段名称 */
|
||
);
|
||
|
||
// 获取 字符串 类型的值
|
||
// （若不存在则返回 defaultValue 参数的值）
|
||
static String getString(
|
||
const String& key, /* 键值 */
|
||
const String& defaultValue, /* 默认值 */
|
||
const String& field = L"Defalut" /* 字段名称 */
|
||
);
|
||
};
|
||
|
||
|
||
// 路径工具
|
||
class Path
|
||
{
|
||
friend class Game;
|
||
|
||
public:
|
||
// 设置游戏数据和临时文件保存路径名称
|
||
static void setGameFolderName(
|
||
const String& name
|
||
);
|
||
|
||
// 添加资源搜索路径
|
||
static void addSearchPath(
|
||
String path
|
||
);
|
||
|
||
// 检索文件路径
|
||
static String findFile(
|
||
const String& path
|
||
);
|
||
|
||
// 提取资源文件，返回提取后的文件路径
|
||
static String extractResource(
|
||
int resNameId, /* 资源名称 */
|
||
const String& resType, /* 资源类型 */
|
||
const String& destFileName /* 目标文件名 */
|
||
);
|
||
|
||
// 获取数据的默认保存路径
|
||
static String getDataPath();
|
||
|
||
// 获取临时文件目录
|
||
static String getTempPath();
|
||
|
||
// 获取 LocalAppData 目录
|
||
static String getLocalAppDataPath();
|
||
|
||
// 获取当前程序的运行路径
|
||
static String getCurrentFilePath();
|
||
|
||
// 获取文件扩展名
|
||
static String getFileExtension(
|
||
const String& filePath
|
||
);
|
||
|
||
// 打开保存文件对话框
|
||
static String getSaveFilePath(
|
||
const String& title = L"保存到", /* 对话框标题 */
|
||
const String& defExt = L"" /* 默认扩展名 */
|
||
);
|
||
|
||
// 创建文件夹
|
||
static bool createFolder(
|
||
const String& dirPath /* 文件夹路径 */
|
||
);
|
||
|
||
// 判断文件或文件夹是否存在
|
||
static bool exists(
|
||
const String& dirPath /* 文件夹路径 */
|
||
);
|
||
|
||
private:
|
||
static String _tempPath;
|
||
static String _dataPath;
|
||
static std::list<String> _paths;
|
||
};
|
||
|
||
} |