SDL_CreateYUVOverlay

SDL_CreateYUVOverlay函数用于创建一个YUV格式的视频帧缓冲区，可以用于实时视频显示和编辑。它的函数原型如下：

SDL_Overlay* SDL_CreateYUVOverlay(int width, int height, Uint32 format, SDL_Surface* display);

参数说明：

- width：缓冲区宽度
- height：缓冲区高度
- format：YUV像素格式，可以是以下值之一：
- SDL_YV12_OVERLAY：YV12格式
- SDL_IYUV_OVERLAY：IYUV格式
- SDL_YUY2_OVERLAY：YUY2格式
- SDL_UYVY_OVERLAY：UYVY格式
- SDL_YVYU_OVERLAY：YVYU格式
- display：指向显示表面的指针，通常设为NULL

创建成功后，返回一个指向SDL_Overlay结构体的指针。可以使用SDL_LockYUVOverlay函数锁定缓冲区，然后修改或读取其中的像素数据，最后使用SDL_UnlockYUVOverlay函数解锁缓冲区。可以使用SDL_DisplayYUVOverlay函数将缓冲区中的视频帧渲染到屏幕上。

下面是一个简单的示例程序，创建一个YV12格式的视频帧缓冲区，并将其中的像素设置为随机值，然后将其渲染到屏幕上。

#include <SDL.h>

int main(int argc, char* argv[])
{
    SDL_Init(SDL_INIT_VIDEO);
    SDL_Surface* screen = SDL_SetVideoMode(640, 480, 32, SDL_SWSURFACE);

    // 创建YV12格式的视频帧缓冲区
    SDL_Overlay* overlay = SDL_CreateYUVOverlay(640, 480, SDL_YV12_OVERLAY, NULL);

    // 锁定缓冲区，并设置每个像素的值
    SDL_LockYUVOverlay(overlay);
    Uint8* y = overlay->pixels[0];
    Uint8* u = overlay->pixels[1];
    Uint8* v = overlay->pixels[2];
    int y_pitch = overlay->pitches[0];
    int u_pitch = overlay->pitches[1];
    int v_pitch = overlay->pitches[2];
    for (int i = 0; i < 480; ++i)
    {
        for (int j = 0; j < 640; ++j)
        {
            y[i * y_pitch + j] = rand() % 256;
            u[i / 2 * u_pitch + j / 2] = rand() % 256;
            v[i / 2 * v_pitch + j / 2] = rand() % 256;
        }
    }
    SDL_UnlockYUVOverlay(overlay);

    // 渲染缓冲区到屏幕
    SDL_Rect dst_rect = { 0, 0, 640, 480 };
    SDL_DisplayYUVOverlay(overlay, &dst_rect);

    // 等待退出
    SDL_Event event;
    while (true)
    {
        SDL_WaitEvent(&event);
        if (event.type == SDL_QUIT)
            break;
    }

    // 释放资源
    SDL_FreeYUVOverlay(overlay);
    SDL_Quit();
    return 0;
}