首页 > 代码库 > SDL2源代码分析4：纹理（SDL_Texture）

SDL2源代码分析4：纹理（SDL_Texture）

2024-07-31 12:24:28   226人阅读

SDL播放视频的代码流程如下所示。
初始化: 

SDL_Init(): 初始化SDL。 
SDL_CreateWindow(): 创建窗口（Window）。 
SDL_CreateRenderer(): 基于窗口创建渲染器（Render）。 
SDL_CreateTexture(): 创建纹理（Texture）。 

循环渲染数据: 

SDL_UpdateTexture(): 设置纹理的数据。 
SDL_RenderCopy(): 纹理复制给渲染器。 

SDL_RenderPresent(): 显示。

上篇文章分析了该流程中的第3个函数SDL_CreateRenderer()。本文继续分析该流程中的第4个函数SDL_CreateTexture()。


SDL_Texture

SDL_Texture结构定义了一个SDL中的纹理。如果直接使用SDL2编译好的SDK的话，是看不到SDL_Texture的内部结构的。有关它的定义在头文件中只有一行代码，如下所示。

[cpp] view plaincopy在CODE上查看代码片派生到我的代码片
  1. /** 
  2.  *  \brief An efficient driver-specific representation of pixel data 
  3.  */  
  4. struct SDL_Texture;  
  5. typedef struct SDL_Texture SDL_Texture;  

 

在源代码工程中可以看到SDL_Texture的定义，位于render\SDL_sysrender.h文件中。它的定义如下。

[cpp] view plaincopy在CODE上查看代码片派生到我的代码片
  1. /* Define the SDL texture structure */  
  2. struct SDL_Texture  
  3. {  
  4.     const void *magic;  
  5.     Uint32 format;              /**< The pixel format of the texture */  
  6.     int access;                 /**< SDL_TextureAccess */  
  7.     int w;                      /**< The width of the texture */  
  8.     int h;                      /**< The height of the texture */  
  9.     int modMode;                /**< The texture modulation mode */  
  10.     SDL_BlendMode blendMode;    /**< The texture blend mode */  
  11.     Uint8 r, g, b, a;           /**< Texture modulation values */  
  12.   
  13.   
  14.     SDL_Renderer *renderer;  
  15.   
  16.   
  17.     /* Support for formats not supported directly by the renderer */  
  18.     SDL_Texture *native;  
  19.     SDL_SW_YUVTexture *yuv;  
  20.     void *pixels;  
  21.     int pitch;  
  22.     SDL_Rect locked_rect;  
  23.   
  24.   
  25.     void *driverdata;           /**< Driver specific texture representation */  
  26.   
  27.   
  28.     SDL_Texture *prev;  
  29.     SDL_Texture *next;  
  30. };  


可以看出其中包含了一个“纹理”所具备的各种属性。下面来看看如何创建这个SDL_Texture。

SDL_CreateTexture()

函数简介

使用SDL_CreateTexture()基于渲染器创建一个纹理。SDL_CreateTexture()的定义如下。

[cpp] view plaincopy在CODE上查看代码片派生到我的代码片
  1. SDL_Texture * SDLCALL SDL_CreateTexture(SDL_Renderer * renderer,  
  2.                                                         Uint32 format,  
  3.                                                         int access, int w,  
  4.                                                         int h);  

 

参数的含义如下。

renderer：目标渲染器。

format ：纹理的格式。后面会详述。

access ：可以取以下值（定义位于SDL_TextureAccess中）

    SDL_TEXTUREACCESS_STATIC ：变化极少
    SDL_TEXTUREACCESS_STREAMING ：变化频繁

    SDL_TEXTUREACCESS_TARGET ：暂时没有理解

w ：纹理的宽

h ：纹理的高

创建成功则返回纹理的ID，失败返回0。


函数调用关系图

SDL_ CreateTexture ()关键函数的调用关系可以用下图表示。

 

上面的图片不太清晰，更清晰的图片上传到了相册里面：

http://my.csdn.net/leixiaohua1020/album/detail/1793543

把相册里面的图片保存下来就可以得到清晰的图片了。


源代码分析

SDL_CreateTexture()的源代码位于render\SDL_render.c中。如下所示。

[cpp] view plaincopy在CODE上查看代码片派生到我的代码片
  1. SDL_Texture * SDL_CreateTexture(SDL_Renderer * renderer, Uint32 format, int access, int w, int h)  
  2. {  
  3.     SDL_Texture *texture;  
  4.   
  5.   
  6.     CHECK_RENDERER_MAGIC(renderer, NULL);  
  7.   
  8.   
  9.     if (!format) {  
  10.         format = renderer->info.texture_formats[0];  
  11.     }  
  12.     if (SDL_ISPIXELFORMAT_INDEXED(format)) {  
  13.         SDL_SetError("Palettized textures are not supported");  
  14.         return NULL;  
  15.     }  
  16.     if (w <= 0 || h <= 0) {  
  17.         SDL_SetError("Texture dimensions can‘t be 0");  
  18.         return NULL;  
  19.     }  
  20.     if ((renderer->info.max_texture_width && w > renderer->info.max_texture_width) ||  
  21.         (renderer->info.max_texture_height && h > renderer->info.max_texture_height)) {  
  22.         SDL_SetError("Texture dimensions are limited to %dx%d", renderer->info.max_texture_width, renderer->info.max_texture_height);  
  23.         return NULL;  
  24.     }  
  25.     texture = (SDL_Texture *) SDL_calloc(1, sizeof(*texture));  
  26.     if (!texture) {  
  27.         SDL_OutOfMemory();  
  28.         return NULL;  
  29.     }  
  30.     texture->magic = &texture_magic;  
  31.     texture->format = format;  
  32.     texture->access = access;  
  33.     texture->w = w;  
  34.     texture->h = h;  
  35.     texture->r = 255;  
  36.     texture->g = 255;  
  37.     texture->b = 255;  
  38.     texture->a = 255;  
  39.     texture->renderer = renderer;  
  40.     texture->next = renderer->textures;  
  41.     if (renderer->textures) {  
  42.         renderer->textures->prev = texture;  
  43.     }  
  44.     renderer->textures = texture;  
  45.   
  46.   
  47.     if (IsSupportedFormat(renderer, format)) {  
  48.         if (renderer->CreateTexture(renderer, texture) < 0) {  
  49.             SDL_DestroyTexture(texture);  
  50.             return 0;  
  51.         }  
  52.     } else {  
  53.         texture->native = SDL_CreateTexture(renderer,  
  54.                                 GetClosestSupportedFormat(renderer, format),  
  55.                                 access, w, h);  
  56.         if (!texture->native) {  
  57.             SDL_DestroyTexture(texture);  
  58.             return NULL;  
  59.         }  
  60.   
  61.   
  62.         /* Swap textures to have texture before texture->native in the list */  
  63.         texture->native->next = texture->next;  
  64.         if (texture->native->next) {  
  65.             texture->native->next->prev = texture->native;  
  66.         }  
  67.         texture->prev = texture->native->prev;  
  68.         if (texture->prev) {  
  69.             texture->prev->next = texture;  
  70.         }  
  71.         texture->native->prev = texture;  
  72.         texture->next = texture->native;  
  73.         renderer->textures = texture;  
  74.   
  75.   
  76.         if (SDL_ISPIXELFORMAT_FOURCC(texture->format)) {  
  77.             texture->yuv = SDL_SW_CreateYUVTexture(format, w, h);  
  78.             if (!texture->yuv) {  
  79.                 SDL_DestroyTexture(texture);  
  80.                 return NULL;  
  81.             }  
  82.         } else if (access == SDL_TEXTUREACCESS_STREAMING) {  
  83.             /* The pitch is 4 byte aligned */  
  84.             texture->pitch = (((w * SDL_BYTESPERPIXEL(format)) + 3) & ~3);  
  85.             texture->pixels = SDL_calloc(1, texture->pitch * h);  
  86.             if (!texture->pixels) {  
  87.                 SDL_DestroyTexture(texture);  
  88.                 return NULL;  
  89.             }  
  90.         }  
  91.     }  
  92.     return texture;  
  93. }  


从源代码中可以看出，SDL_CreateTexture()的大致流程如下。

1. 检查输入参数的合理性。例如像素格式是否支持，宽和高是否小于等于0等等。

2. 新建一个SDL_Texture。调用SDL_calloc()（实际上就是calloc()）为新建的SDL_Texture分配内存。

3. 调用SDL_Render的CreateTexture()方法创建纹理。这一步是整个函数的核心。

下面我们详细看一下几种不同的渲染器的CreateTexture()的方法。

1. Direct3D

Direct3D 渲染器中对应CreateTexture()的函数是D3D_CreateTexture()，它的源代码如下所示（位于render\direct3d\SDL_render_d3d.c）。

[cpp] view plaincopy在CODE上查看代码片派生到我的代码片
  1. static int D3D_CreateTexture(SDL_Renderer * renderer, SDL_Texture * texture)  
  2. {  
  3.     D3D_RenderData *renderdata = (D3D_RenderData *) renderer->driverdata;  
  4.     D3D_TextureData *data;  
  5.     D3DPOOL pool;  
  6.     DWORD usage;  
  7.     HRESULT result;  
  8.   
  9.   
  10.     data = (D3D_TextureData *) SDL_calloc(1, sizeof(*data));  
  11.     if (!data) {  
  12.         return SDL_OutOfMemory();  
  13.     }  
  14.     data->scaleMode = GetScaleQuality();  
  15.   
  16.   
  17.     texture->driverdata = data;  
  18.   
  19.   
  20. #ifdef USE_DYNAMIC_TEXTURE  
  21.     if (texture->access == SDL_TEXTUREACCESS_STREAMING) {  
  22.         pool = D3DPOOL_DEFAULT;  
  23.         usage = D3DUSAGE_DYNAMIC;  
  24.     } else  
  25. #endif  
  26.     if (texture->access == SDL_TEXTUREACCESS_TARGET) {  
  27.         /* D3DPOOL_MANAGED does not work with D3DUSAGE_RENDERTARGET */  
  28.         pool = D3DPOOL_DEFAULT;  
  29.         usage = D3DUSAGE_RENDERTARGET;  
  30.     } else {  
  31.         pool = D3DPOOL_MANAGED;  
  32.         usage = 0;  
  33.     }  
  34.   
  35.   
  36.     result =  
  37.         IDirect3DDevice9_CreateTexture(renderdata->device, texture->w,  
  38.                                        texture->h, 1, usage,  
  39.                                        PixelFormatToD3DFMT(texture->format),  
  40.                                        pool, &data->texture, NULL);  
  41.     if (FAILED(result)) {  
  42.         return D3D_SetError("CreateTexture()", result);  
  43.     }  
  44.   
  45.   
  46.     if (texture->format == SDL_PIXELFORMAT_YV12 ||  
  47.         texture->format == SDL_PIXELFORMAT_IYUV) {  
  48.         data->yuv = SDL_TRUE;  
  49.   
  50.   
  51.         result =  
  52.             IDirect3DDevice9_CreateTexture(renderdata->device, texture->w / 2,  
  53.                                            texture->h / 2, 1, usage,  
  54.                                            PixelFormatToD3DFMT(texture->format),  
  55.                                            pool, &data->utexture, NULL);  
  56.         if (FAILED(result)) {  
  57.             return D3D_SetError("CreateTexture()", result);  
  58.         }  
  59.   
  60.   
  61.         result =  
  62.             IDirect3DDevice9_CreateTexture(renderdata->device, texture->w / 2,  
  63.                                            texture->h / 2, 1, usage,  
  64.                                            PixelFormatToD3DFMT(texture->format),  
  65.                                            pool, &data->vtexture, NULL);  
  66.         if (FAILED(result)) {  
  67.             return D3D_SetError("CreateTexture()", result);  
  68.         }  
  69.     }  
  70.   
  71.   
  72.     return 0;  
  73. }  


从代码中可以看出，该函数调用了Direct3D的API函数IDirect3DDevice9_CreateTexture()创建了一个纹理。

2. OpenGL

OpenGL渲染器中对应CreateTexture()的函数是GL_CreateTexture ()，它的源代码如下所示（位于render\opengl\SDL_render_gl.c）。

[cpp] view plaincopy在CODE上查看代码片派生到我的代码片
  1. static int GL_CreateTexture(SDL_Renderer * renderer, SDL_Texture * texture)  
  2. {  
  3.     GL_RenderData *renderdata = (GL_RenderData *) renderer->driverdata;  
  4.     GL_TextureData *data;  
  5.     GLint internalFormat;  
  6.     GLenum format, type;  
  7.     int texture_w, texture_h;  
  8.     GLenum scaleMode;  
  9.   
  10.   
  11.     GL_ActivateRenderer(renderer);  
  12.   
  13.   
  14.     if (!convert_format(renderdata, texture->format, &internalFormat,  
  15.                         &format, &type)) {  
  16.         return SDL_SetError("Texture format %s not supported by OpenGL",  
  17.                             SDL_GetPixelFormatName(texture->format));  
  18.     }  
  19.   
  20.   
  21.     data = (GL_TextureData *) SDL_calloc(1, sizeof(*data));  
  22.     if (!data) {  
  23.         return SDL_OutOfMemory();  
  24.     }  
  25.   
  26.   
  27.     if (texture->access == SDL_TEXTUREACCESS_STREAMING) {  
  28.         size_t size;  
  29.         data->pitch = texture->w * SDL_BYTESPERPIXEL(texture->format);  
  30.         size = texture->h * data->pitch;  
  31.         if (texture->format == SDL_PIXELFORMAT_YV12 ||  
  32.             texture->format == SDL_PIXELFORMAT_IYUV) {  
  33.             /* Need to add size for the U and V planes */  
  34.             size += (2 * (texture->h * data->pitch) / 4);  
  35.         }  
  36.         data->pixels = SDL_calloc(1, size);  
  37.         if (!data->pixels) {  
  38.             SDL_free(data);  
  39.             return SDL_OutOfMemory();  
  40.         }  
  41.     }  
  42.   
  43.   
  44.     if (texture->access == SDL_TEXTUREACCESS_TARGET) {  
  45.         data->fbo = GL_GetFBO(renderdata, texture->w, texture->h);  
  46.     } else {  
  47.         data->fbo = NULL;  
  48.     }  
  49.   
  50.   
  51.     GL_CheckError("", renderer);  
  52.     renderdata->glGenTextures(1, &data->texture);  
  53.     if (GL_CheckError("glGenTexures()", renderer) < 0) {  
  54.         SDL_free(data);  
  55.         return -1;  
  56.     }  
  57.     texture->driverdata = data;  
  58.   
  59.   
  60.     if ((renderdata->GL_ARB_texture_rectangle_supported)  
  61.         /* && texture->access != SDL_TEXTUREACCESS_TARGET */){  
  62.         data->type = GL_TEXTURE_RECTANGLE_ARB;  
  63.         texture_w = texture->w;  
  64.         texture_h = texture->h;  
  65.         data->texw = (GLfloat) texture_w;  
  66.         data->texh = (GLfloat) texture_h;  
  67.     } else {  
  68.         data->type = GL_TEXTURE_2D;  
  69.         texture_w = power_of_2(texture->w);  
  70.         texture_h = power_of_2(texture->h);  
  71.         data->texw = (GLfloat) (texture->w) / texture_w;  
  72.         data->texh = (GLfloat) texture->h / texture_h;  
  73.     }  
  74.   
  75.   
  76.     data->format = format;  
  77.     data->formattype = type;  
  78.     scaleMode = GetScaleQuality();  
  79.     renderdata->glEnable(data->type);  
  80.     renderdata->glBindTexture(data->type, data->texture);  
  81.     renderdata->glTexParameteri(data->type, GL_TEXTURE_MIN_FILTER, scaleMode);  
  82.     renderdata->glTexParameteri(data->type, GL_TEXTURE_MAG_FILTER, scaleMode);  
  83.     /* According to the spec, CLAMP_TO_EDGE is the default for TEXTURE_RECTANGLE 
  84.        and setting it causes an INVALID_ENUM error in the latest NVidia drivers. 
  85.     */  
  86.     if (data->type != GL_TEXTURE_RECTANGLE_ARB) {  
  87.         renderdata->glTexParameteri(data->type, GL_TEXTURE_WRAP_S,  
  88.                                     GL_CLAMP_TO_EDGE);  
  89.         renderdata->glTexParameteri(data->type, GL_TEXTURE_WRAP_T,  
  90.                                     GL_CLAMP_TO_EDGE);  
  91.     }  
  92. #ifdef __MACOSX__  
  93. #ifndef GL_TEXTURE_STORAGE_HINT_APPLE  
  94. #define GL_TEXTURE_STORAGE_HINT_APPLE       0x85BC  
  95. #endif  
  96. #ifndef STORAGE_CACHED_APPLE  
  97. #define STORAGE_CACHED_APPLE                0x85BE  
  98. #endif  
  99. #ifndef STORAGE_SHARED_APPLE  
  100. #define STORAGE_SHARED_APPLE                0x85BF  
  101. #endif  
  102.     if (texture->access == SDL_TEXTUREACCESS_STREAMING) {  
  103.         renderdata->glTexParameteri(data->type, GL_TEXTURE_STORAGE_HINT_APPLE,  
  104.                                     GL_STORAGE_SHARED_APPLE);  
  105.     } else {  
  106.         renderdata->glTexParameteri(data->type, GL_TEXTURE_STORAGE_HINT_APPLE,  
  107.                                     GL_STORAGE_CACHED_APPLE);  
  108.     }  
  109.     if (texture->access == SDL_TEXTUREACCESS_STREAMING  
  110.         && texture->format == SDL_PIXELFORMAT_ARGB8888  
  111.         && (texture->w % 8) == 0) {  
  112.         renderdata->glPixelStorei(GL_UNPACK_CLIENT_STORAGE_APPLE, GL_TRUE);  
  113.         renderdata->glPixelStorei(GL_UNPACK_ALIGNMENT, 1);  
  114.         renderdata->glPixelStorei(GL_UNPACK_ROW_LENGTH,  
  115.                           (data->pitch / SDL_BYTESPERPIXEL(texture->format)));  
  116.         renderdata->glTexImage2D(data->type, 0, internalFormat, texture_w,  
  117.                                  texture_h, 0, format, type, data->pixels);  
  118.         renderdata->glPixelStorei(GL_UNPACK_CLIENT_STORAGE_APPLE, GL_FALSE);  
  119.     }  
  120.     else  
  121. #endif  
  122.     {  
  123.         renderdata->glTexImage2D(data->type, 0, internalFormat, texture_w,  
  124.                                  texture_h, 0, format, type, NULL);  
  125.     }  
  126.     renderdata->glDisable(data->type);  
  127.     if (GL_CheckError("glTexImage2D()", renderer) < 0) {  
  128.         return -1;  
  129.     }  
  130.   
  131.   
  132.     if (texture->format == SDL_PIXELFORMAT_YV12 ||  
  133.         texture->format == SDL_PIXELFORMAT_IYUV) {  
  134.         data->yuv = SDL_TRUE;  
  135.   
  136.   
  137.         renderdata->glGenTextures(1, &data->utexture);  
  138.         renderdata->glGenTextures(1, &data->vtexture);  
  139.         renderdata->glEnable(data->type);  
  140.   
  141.   
  142.         renderdata->glBindTexture(data->type, data->utexture);  
  143.         renderdata->glTexParameteri(data->type, GL_TEXTURE_MIN_FILTER,  
  144.                                     scaleMode);  
  145.         renderdata->glTexParameteri(data->type, GL_TEXTURE_MAG_FILTER,  
  146.                                     scaleMode);  
  147.         renderdata->glTexParameteri(data->type, GL_TEXTURE_WRAP_S,  
  148.                                     GL_CLAMP_TO_EDGE);  
  149.         renderdata->glTexParameteri(data->type, GL_TEXTURE_WRAP_T,  
  150.                                     GL_CLAMP_TO_EDGE);  
  151.         renderdata->glTexImage2D(data->type, 0, internalFormat, texture_w/2,  
  152.                                  texture_h/2, 0, format, type, NULL);  
  153.   
  154.   
  155.         renderdata->glBindTexture(data->type, data->vtexture);  
  156.         renderdata->glTexParameteri(data->type, GL_TEXTURE_MIN_FILTER,  
  157.                                     scaleMode);  
  158.         renderdata->glTexParameteri(data->type, GL_TEXTURE_MAG_FILTER,  
  159.                                     scaleMode);  
  160.         renderdata->glTexParameteri(data->type, GL_TEXTURE_WRAP_S,  
  161.                                     GL_CLAMP_TO_EDGE);  
  162.         renderdata->glTexParameteri(data->type, GL_TEXTURE_WRAP_T,  
  163.                                     GL_CLAMP_TO_EDGE);  
  164.         renderdata->glTexImage2D(data->type, 0, internalFormat, texture_w/2,  
  165.                                  texture_h/2, 0, format, type, NULL);  
  166.   
  167.   
  168.         renderdata->glDisable(data->type);  
  169.     }  
  170.   
  171.   
  172.     return GL_CheckError("", renderer);  
  173. }  


从代码中可以看出，该函数调用了OpenGL的API函数glGenTextures()，glBindTexture()创建了一个纹理。并且使用glTexParameteri()设置了有关的一些参数。

在这里有一点需要注意，在OpenGL渲染器中，如果输入像素格式是YV12或者IYUV，就会使用3个纹理。

3. Software

Software渲染器中对应CreateTexture()的函数是SW_CreateTexture ()，它的源代码如下所示（位于render\software\SDL_render_sw.c）。

[cpp] view plaincopy在CODE上查看代码片派生到我的代码片
  1. static int SW_CreateTexture(SDL_Renderer * renderer, SDL_Texture * texture)  
  2. {  
  3.     int bpp;  
  4.     Uint32 Rmask, Gmask, Bmask, Amask;  
  5.   
  6.   
  7.     if (!SDL_PixelFormatEnumToMasks  
  8.         (texture->format, &bpp, &Rmask, &Gmask, &Bmask, &Amask)) {  
  9.         return SDL_SetError("Unknown texture format");  
  10.     }  
  11.   
  12.   
  13.     texture->driverdata =  
  14.         SDL_CreateRGBSurface(0, texture->w, texture->h, bpp, Rmask, Gmask,  
  15.                              Bmask, Amask);  
  16.     SDL_SetSurfaceColorMod(texture->driverdata, texture->r, texture->g,  
  17.                            texture->b);  
  18.     SDL_SetSurfaceAlphaMod(texture->driverdata, texture->a);  
  19.     SDL_SetSurfaceBlendMode(texture->driverdata, texture->blendMode);  
  20.   
  21.   
  22.     if (texture->access == SDL_TEXTUREACCESS_STATIC) {  
  23.         SDL_SetSurfaceRLE(texture->driverdata, 1);  
  24.     }  
  25.   
  26.   
  27.     if (!texture->driverdata) {  
  28.         return -1;  
  29.     }  
  30.     return 0;  
  31. }  


该函数的源代码还没有详细分析。可以看出其中调用了SDL_CreateRGBSurface()创建了“Surface”。

SDL2源代码分析4：纹理（SDL_Texture）


联系
我们