SDL2常用函数结构分析:SDL_TextureSDL_CreateTextureSDL

SDL_Texture

SDL_Texture是计算机图形图像中，如何在屏幕上显示图像的一个数据的抽象。中文也已翻译为纹理。这种概念在OpenGL中也有出现。对于SDL_Texture本身来说，它包含了显示驱动用于显示的特定数据结构。

SDL_Texture的创建一半通过SDL_CreateTexture创建，创建一次后，可以重复使用，通过SDL_UpdateTexture函数更新数据。

SDL_CreateTexture

函数原型：

SDL_Texture* SDL_CreateTexture(SDL_Renderer* renderer,Uint32        format,int           access,int           w,int           h)

函数功能：使用此函数可为渲染器上下文创建纹理。

参数列表：

参数	释义
renderer	渲染器上下文
format	渲染的像素格式，支持的格式，在 SDL_PixelFormatEnum中，详情见渲染器支持的像素格式
access	纹理访问模式，定义在 SDL_TextureAccess中; 详见纹理访问模式
w	纹理的宽度（以像素为单位）
h	纹理的高度（以像素为单位）

返回值：返回渲染器上下文的纹理。

渲染器支持的像素格式：

SDL_PIXELFORMAT_UNKNOWN
SDL_PIXELFORMAT_RGB332
SDL_PIXELFORMAT_RGB444
SDL_PIXELFORMAT_RGB555
SDL_PIXELFORMAT_ARGB1555
SDL_PIXELFORMAT_RGBA5551
SDL_PIXELFORMAT_ABGR1555
SDL_PIXELFORMAT_BGRA5551
SDL_PIXELFORMAT_RGB565
SDL_PIXELFORMAT_RGBA32	当前平台的RGBA字节数组颜色的别名(>= SDL 2.0.5)
SDL_PIXELFORMAT_ARGB32	当前平台的ARGB字节数组颜色数据的别名(>= SDL 2.0.5)
SDL_PIXELFORMAT_YV12	平面模式: Y + V + U (3 planes)
SDL_PIXELFORMAT_IYUV	平面模式: Y + U + V (3 planes)
SDL_PIXELFORMAT_YUY2	打包模式: Y0+U0+Y1+V0 (1 plane)
SDL_PIXELFORMAT_UYVY	打包模式: U0+Y0+V0+Y1 (1 plane)
SDL_PIXELFORMAT_YVYU	打包模式: Y0+V0+Y1+U0 (1 plane)
SDL_PIXELFORMAT_NV12	打包模式: Y + U/V 交错 (2 planes) (>= SDL 2.0.4)
SDL_PIXELFORMAT_NV21	打包模式: Y + V/U 交错 (2 planes) (>= SDL 2.0.4)

纹理访问模式：

访问模式	含义
SDL_TEXTUREACCESS_STATIC	变化很少，不可锁定
SDL_TEXTUREACCESS_STREAMING	经常变化，可锁定
SDL_TEXTUREACCESS_TARGET	可以用作渲染目标

SDL_UpdateTexture

函数原型：

int SDL_UpdateTexture(SDL_Texture*    texture,const SDL_Rect* rect,const void*     pixels,int             pitch)

函数功能：使用新的像素数据更新给定的纹理矩形。也就是说，可以固定刷新纹理的某一分部区域。

参数列表：

参数	含义
texture	the texture to update
rect	用SDL_Rect结构表达纹理中需要更新数据的区域, 如果为NULL则更新整个纹理
pixels	纹理格式的原始像素数据，格式通常在创建纹理的函数中指定
pitch	一行像素数据中的字节数，包括行之间的填充。字节数通常由纹理的格式决定

这里需要解释一下pitch的计算方式，以一帧尺寸为960x540，格式为SDL_PIXELFORMAT_IYUV为例，计算

pitch ：

SDL_PIXELFORMAT_IYUV，也就是IYUV类型，也称为YUV420p、I420，它在内存中的存储格式为三平面存储。

即：第一个平面960个字节的位置存Y分量，第二个平面480个字节存U分量，第三个平面480个字节存V分量。而这个函数中的pitch所说的一行数像素数据中的字节数，其实指的是第一个平面的长度（字节为单位），也就是960字节，虽然和宽度在数学上相等，但它们所表达的意思是不一样的，

另外，这是一个相当慢的函数，旨在用于不经常更改的静态纹理。

如果要经常更新纹理，则最好将纹理创建为流式传输并使用下面SDL_LockTexture锁定函数。虽然此功能适用于流式纹理，但出于优化原因，如果之后锁定纹理，则可能无法获得像素。

SDL_LockTexture：锁定纹理

SDL_UnlockTexture：解锁纹理

返回值：

成功时返回0或失败时返回负错误代码

#include <iostream>#include <SDL.h>
#include <SDL2/SDL_image.h>using namespace  std;const int WIDTH = 960, HEIGHT = 540;
int main() {if (SDL_Init(SDL_INIT_EVERYTHING) < 0) {cout << "SDL could not initialized with error: " << SDL_GetError() << endl;return -1;}SDL_Window *window = SDL_CreateWindow("Hello SDL world!", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED,WIDTH, HEIGHT, SDL_WINDOW_ALLOW_HIGHDPI);if (NULL == window) {cout << "SDL could not create window with error: " << SDL_GetError() << endl;return -1;}if (!(IMG_Init(IMG_INIT_JPG) & IMG_INIT_JPG)) {cout << "SDL_image could not init with error: " << IMG_GetError() << endl;return -1;}FILE* pFile = fopen("little_prince_i420_960x540.yuv", "rb");if (pFile == NULL) {cerr << "little_prince_i420_960x540.yuv open failed" << endl;}unsigned char *m_yuv_data;int frameSize = HEIGHT * WIDTH * 12 / 8;m_yuv_data = (unsigned char*)malloc(frameSize * sizeof(unsigned char));fread(m_yuv_data, 1, frameSize, pFile);fclose(pFile);SDL_Renderer *renderer = SDL_CreateRenderer(window, -1, 0); // 创建渲染器// 创建纹理SDL_Texture *texture = SDL_CreateTexture(renderer, SDL_PIXELFORMAT_IYUV,  SDL_TEXTUREACCESS_STREAMING, WIDTH, HEIGHT);if (texture != NULL) {SDL_Event windowEvent;while (true) {if (SDL_PollEvent(&windowEvent)) {if (SDL_QUIT == windowEvent.type) {cout << "SDL quit!!" << endl;break;}}SDL_UpdateTexture(texture, NULL, m_yuv_data, WIDTH); // 更新纹理SDL_RenderClear(renderer); // 清除渲染器SDL_RenderCopy(renderer, texture, NULL, NULL); // 拷贝纹理到渲染器SDL_RenderPresent(renderer); // 渲染}SDL_DestroyTexture(texture);SDL_DestroyRenderer(renderer);SDL_DestroyWindow(window);SDL_Quit();return 0;}
}