SSDL编程全面指南

### SSDL 编程全面指南 #### 1. 图形绘制函数 在 SSDL 中，提供了丰富的图形绘制函数，用于绘制各种基本图形。以下是一些常用的图形绘制函数及其功能： - **矩形绘制**： ```cpp void SSDL_RenderDrawRect(int x, int y, int w, int h); void SSDL_RenderDrawRect(const SDL_Rect& rect); void SSDL_RenderDrawRects(const SDL_Rect* rects, int count); ``` 这些函数用于绘制矩形。第一个函数通过指定矩形左上角的坐标 `(x, y)` 以及宽度 `w` 和高度 `h` 来绘制单个矩形；第二个函数使用 `SDL_Rect` 结构体来指定矩形的位置和大小；第三个函数可以一次性绘制多个矩形。 - **填充矩形绘制**： ```cpp void SSDL_RenderFillRect(int x, int y, int w, int h); void SSDL_RenderFillRect(const SDL_Rect& rect); void SSDL_RenderFillRects(const SDL_Rect* rects, int count); ``` 这些函数用于绘制填充矩形，其参数和使用方式与矩形绘制函数类似。 - **圆形绘制**： ```cpp void SSDL_RenderDrawCircle(int x, int y, int radius); void SSDL_RenderFillCircle(int x, int y, int radius); ``` 这两个函数分别用于绘制空心圆和填充圆，通过指定圆心的坐标 `(x, y)` 和半径 `radius` 来确定圆的位置和大小。 #### 2. 图像加载与显示 SSDL 提供了一系列函数用于图像的加载和显示，以下是相关函数的介绍： - **图像加载**： ```cpp SSDL_Image SSDL_LoadImage(const char* filename); ``` 该函数用于从指定的文件中加载图像，并返回一个 `SSDL_Image` 类型的对象。 - **图像显示**： ```cpp void SSDL_RenderImage(SDL_Image image, int x, int y, int stretchWidth = 0, int stretchHeight = 0); void SSDL_RenderImageEx(SDL_Image image, const SDL_Rect& src, const SDL_Rect& dst, double angleInDegrees = 0.0, SDL_RendererFlip flipValue = SDL_FLIP_NONE); ``` `SSDL_RenderImage` 函数用于在指定的位置 `(x, y)` 显示图像。如果指定了 `stretchWidth` 和 `stretchHeight`，则图像会被拉伸或缩小以填充指定大小的矩形。`SSDL_RenderImageEx` 函数则可以更灵活地显示图像的部分区域，同时支持图像的旋转和翻转。 #### 3. 鼠标、键盘和事件处理 在 SSDL 中，提供了一系列函数用于处理鼠标、键盘事件和其他事件，以下是相关函数的介绍： - **鼠标事件处理**： ```cpp int SSDL_GetMouseX(); int SSDL_GetMouseY(); int SSDL_GetMouseClick(); int SSDL_WaitMouse(); ``` `SSDL_GetMouseX` 和 `SSDL_GetMouseY` 函数分别用于获取鼠标当前的 `X` 和 `Y` 坐标。`SSDL_GetMouseClick` 函数用于检测鼠标是否被点击，并返回点击的按钮类型。`SSDL_WaitMouse` 函数会刷新屏幕并等待鼠标点击，返回点击的按钮类型。 - **键盘事件处理**： ```cpp bool SSDL_IsKeyPressed(SDL_Keycode whichKey); SDL_Keycode SSDL_WaitKey(); ``` `SSDL_IsKeyPressed` 函数用于检测指定的键是否被按下。`SSDL_WaitKey` 函数会刷新屏幕并等待按键事件，返回按下的键的 `SDL_Keycode`。 - **事件处理**： ```cpp int SSDL_PollEvent(SDL_Event& event); void SSDL_WaitEvent(Uint32 eventType, SDL_Event& event); void SSDL_DefaultEventHandler(); ``` `SSDL_PollEvent` 函数用于检查事件队列中是否有事件，并将事件信息存储在 `event` 中。`SSDL_WaitEvent` 函数会刷新屏幕并等待指定类型的事件或退出事件。`SSDL_DefaultEventHandler` 函数用于读取事件队列中的所有事件，并处理退出事件。 #### 4. 音乐处理 SSDL 提供了一系列函数用于音乐的加载、播放、暂停等操作，以下是相关函数的介绍： | 函数名 | 功能 | | ---- | ---- | | `void SSDL_FadeInMusic(SSDL_Music m, int loops, int ms);` | 淡入音乐，在 `ms` 毫秒内逐渐增加音量，并播放指定的次数。`-1` 表示无限循环。 | | `void SSDL_FadeInMusicPos(SSDL_Music m, int loops, int ms, double pos);` | 从指定位置 `pos` 开始淡入音乐，其他参数与 `SSDL_FadeInMusic` 相同。 | | `Mix_Fading SSDL_FadingMusic();` | 返回音乐是否正在淡入或淡出。 | | `void SSDL_FadeOutMusic(int ms);` | 开始音乐淡出，在 `ms` 毫秒内逐渐降低音量。 | | `Mix_MusicType SSDL_GetMusicType(const SSDL_Music music);` | 返回音乐的文件类型。 | | `void SSDL_HaltMusic();` | 停止音乐播放。 | | `SSDL_Music SSDL_LoadMUS(const char* filename);` | 从指定文件中加载音乐。 | | `void SSDL_PauseMusic();` | 暂停音乐播放。 | | `bool SSDL_PausedMusic();` | 检查音乐是否暂停。 | | `void SSDL_PlayMusic(SSDL_Music m, int loops = -1);` | 播放音乐，指定播放次数。`-1` 表示无限循环。 | | `bool SSDL_PlayingMusic();` | 检查音乐是否正在播放。 | | `void SSDL_ResumeMusic();` | 恢复音乐播放。 | | `void SSDL_RewindMusic();` | 倒带音乐，某些文件类型支持此操作。 | | `void SSDL_SetMusicPosition(double position);` | 从指定位置开始播放音乐。 | | `int SSDL_VolumeMusic(int volume = -1);` | 设置音乐音量，范围从 0 到 `MIX_MAX_VOLUME`（128）。如果 `volume` 为 `-1`，则返回当前音量。 | #### 5. 声音处理 除了音乐处理，SSDL 还提供了一系列函数用于声音的加载、播放、暂停等操作，以下是相关函数的介绍： | 函数名 | 功能 | | ---- | ---- | | `int SSDL_ExpireSound(SSDL_Sound snd, int ms);` | 在 `ms` 毫秒后停止指定的声音。 | | `int SSDL_ExpireAllSounds(int ms);` | 在 `ms` 毫秒后停止所有声音。 | | `void SSDL_FadeInSound(SSDL_Sound& sound, int repeats, int ms);` | 淡入声音，在 `ms` 毫秒内逐渐增加音量，并重复指定的次数。`-1` 表示无限重复。 | | `void SSDL_FadeInSoundTimed(SSDL_Sound& sound, int repeats, int ms, int duration);` | 淡入声音，播放最多 `duration` 毫秒。 | | `int SSDL_FadeOutSound(SSDL_Sound snd, int ms);` | 开始声音淡出，在 `ms` 毫秒内逐渐降低音量。 | | `int SSDL_FadeOutAllSounds(int ms);` | 开始所有声音淡出，在 `ms` 毫秒内逐渐降低音量。 | | `Mix_Fading SSDL_FadingChannel(SSD