SDL_RenderFillRect - C 编程语言

介绍

SDL_RenderFillRect 是一个用于绘制填充矩形的函数，它是 SDL（Simple DirectMedia Layer）库提供的一部分。SDL 是一个跨平台的多媒体库，主要用于开发游戏、仿真器、多媒体应用程序等。SDL_RenderFillRect 函数允许程序员在 SDL 窗口上绘制一个填充矩形，使其变为可见。

语法

int SDL_RenderFillRect(SDL_Renderer* renderer, const SDL_Rect* rect);

参数

• renderer ：指向要绘制矩形的渲染器的指针。
• rect ：指向 SDL_Rect 结构的指针，表示要绘制矩形的位置和大小。

返回值

• 如果函数成功绘制了矩形，则返回 0。
• 如果函数出现错误，则返回 -1。

示例

下面是一个示例程序，演示如何使用 SDL_RenderFillRect 函数绘制一个填充矩形：

#include <SDL2/SDL.h>

int main() {
    SDL_Window* window = NULL;
    SDL_Renderer* renderer = NULL;

    SDL_Init(SDL_INIT_VIDEO);

    // 创建窗口和渲染器
    window = SDL_CreateWindow("SDL_RenderFillRect", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, 640, 480, 0);
    renderer = SDL_CreateRenderer(window, -1, 0);

    // 设置绘制颜色
    SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);

    // 创建矩形区域
    SDL_Rect rect = { 100, 100, 200, 200 };

    // 清空渲染器
    SDL_RenderClear(renderer);

    // 绘制填充矩形
    SDL_RenderFillRect(renderer, &rect);

    // 更新屏幕显示
    SDL_RenderPresent(renderer);

    // 等待退出事件
    SDL_Delay(2000);

    // 清理资源
    SDL_DestroyRenderer(renderer);
    SDL_DestroyWindow(window);
    SDL_Quit();

    return 0;
}

这个程序通过填充一个红色矩形并在屏幕上显示它来演示了 SDL_RenderFillRect 的使用。程序中首先初始化 SDL，然后创建一个窗口和渲染器。我们将绘制颜色设置为红色（R = 255，G = 0，B = 0，Alpha = 255）。然后，我们创建一个矩形区域，并在渲染器上绘制这个填充矩形。最后，我们更新屏幕显示，等待2秒后退出程序。

结论

SDL_RenderFillRect 函数是 SDL 库中用于绘制填充矩形的重要函数之一。通过使用它，程序员可以在 SDL 窗口上创建各种填充矩形，为游戏和多媒体应用程序添加视觉效果。