如何使用无main()函数的SDL3新回调结构替代传统主循环模式

SDL3引入的新回调机制允许你无需编写main()函数，转而由SDL框架接管程序入口和主循环调度，通过注册回调函数来处理事件、更新逻辑和渲染帧。以下是具体实现方式：

核心思路 #

SDL3会自动处理程序的初始化入口（替代传统main()），你只需要注册三个核心回调：

• 初始化回调：程序启动时执行一次，用于初始化SDL子系统、创建窗口/渲染器等
• 事件处理回调：处理键盘、鼠标等输入事件
• 帧更新回调：每帧执行，用于更新游戏逻辑和渲染画面

实现步骤 #

1. 注册初始化回调 #

使用SDL_SetAppInitCallback()注册程序启动时的初始化逻辑，完成SDL子系统初始化、窗口创建等操作。

2. 注册事件回调 #

使用SDL_SetEventCallback()注册事件处理函数，捕获并处理各类SDL事件（如窗口关闭、按键输入）。

3. 注册帧更新回调 #

使用SDL_SetUpdateCallback()注册每帧执行的更新函数，在这里处理逻辑计算和渲染操作。

4. 让SDL接管主循环 #

完成回调注册后，SDL会自动启动主循环，直到程序退出。

完整代码示例 #

#include <SDL3/SDL.h>

SDL_Window* window = NULL;
SDL_Renderer* renderer = NULL;

// 初始化回调：程序启动时执行
int app_init(void* userdata) {
    if (SDL_Init(SDL_INIT_VIDEO) != 0) {
        SDL_LogError(SDL_LOG_CATEGORY_APP, "SDL初始化失败: %s", SDL_GetError());
        return -1;
    }

    window = SDL_CreateWindow("SDL3无main示例", 800, 600, 0);
    renderer = SDL_CreateRenderer(window, NULL);
    if (!window || !renderer) {
        SDL_LogError(SDL_LOG_CATEGORY_APP, "窗口/渲染器创建失败: %s", SDL_GetError());
        return -1;
    }

    SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255);
    return 0;
}

// 事件处理回调
void handle_event(void* userdata, const SDL_Event* event) {
    if (event->type == SDL_EVENT_QUIT) {
        SDL_Quit();
    }
}

// 帧更新回调
void update_frame(void* userdata, float delta_time) {
    SDL_RenderClear(renderer);

    // 在这里添加渲染逻辑，例如绘制图形
    SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);
    SDL_Rect rect = { 300, 200, 200, 200 };
    SDL_RenderFillRect(renderer, &rect);

    SDL_RenderPresent(renderer);
}

// 无需编写main()，SDL会自动调用注册的回调
SDL_MAIN_APP
{
    SDL_SetAppInitCallback(app_init, NULL);
    SDL_SetEventCallback(handle_event, NULL);
    SDL_SetUpdateCallback(update_frame, NULL);

    // SDL启动主循环，直到程序退出
    SDL_RunApp();
}

关键注意点 #

• 必须使用SDL_MAIN_APP宏包裹回调注册和启动逻辑，这是SDL3标记程序入口的方式，替代传统main()函数。
• SDL_RunApp()会启动SDL的内置主循环，自动调度注册的回调函数，无需你手动编写while循环。
• 回调函数的userdata参数可以传递自定义数据，方便在回调间共享状态。
• 如果需要退出程序，在事件回调中调用SDL_Quit()即可终止主循环。

内容的提问来源于stack exchange，提问作者ahcox