SDL2源代码分析7：显示（SDL_RenderPresent()）

迈不过友情╰ 2022-08-20 05:23 224阅读 0赞

=====================================================

SDL源代码分析系列文章列表：

[SDL2源代码分析1：初始化（SDL\_Init()）][SDL2_1_SDL_Init]

[SDL2源代码分析2：窗口（SDL\_Window）][SDL2_2_SDL_Window]

[SDL2源代码分析3：渲染器（SDL\_Renderer）][SDL2_3_SDL_Renderer]

[SDL2源代码分析4：纹理（SDL\_Texture）][SDL2_4_SDL_Texture]

[SDL2源代码分析5：更新纹理（SDL\_UpdateTexture()）][SDL2_5_SDL_UpdateTexture]

[SDL2源代码分析6：复制到渲染器（SDL\_RenderCopy()）][SDL2_6_SDL_RenderCopy]

[SDL2源代码分析7：显示（SDL\_RenderPresent()）][SDL2_7_SDL_RenderPresent]

[SDL2源代码分析8：视频显示总结][SDL2_8]

=====================================================

上一篇文章分析了SDL纹理赋值给渲染目标的函数SDL\_RenderCopy()。这篇文章分析SDL显示视频最后的一个函数：SDL\_RenderPresent()。

![20141107171722706][]

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

> SDL\_Init(): 初始化SDL。  
> SDL\_CreateWindow(): 创建窗口（Window）。  
> SDL\_CreateRenderer(): 基于窗口创建渲染器（Render）。  
> SDL\_CreateTexture(): 创建纹理（Texture）。

循环渲染数据:

> SDL\_UpdateTexture(): 设置纹理的数据。  
> SDL\_RenderCopy(): 纹理复制给渲染器。  
> SDL\_RenderPresent(): 显示。

上篇文章分析了该流程中的第6个函数SDL\_RenderCopy()。本文继续分析该流程中的最后一个函数SDL\_RenderPresent()。

## SDL\_RenderPresent() ##

### 函数简介 ###

SDL使用SDL\_RenderPresent()显示画面。SDL\_RenderPresent()的原型如下。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **void** SDLCALL SDL\_RenderPresent(SDL\_Renderer \* renderer);

参数renderer用于指定渲染器。

### 函数调用关系图 ###

SDL\_RenderPresent()关键函数的调用关系可以用下图表示。

[![SouthEast][]][SouthEast 1]

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

[http://my.csdn.net/leixiaohua1020/album/detail/1794103][SouthEast 1]

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

### 源代码分析 ###

SDL\_RenderPresent()的源代码位于render\\SDL\_render.c中。如下所示。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **void** SDL\_RenderPresent(SDL\_Renderer \* renderer) 
2.  \{ 
3.   CHECK\_RENDERER\_MAGIC(renderer, ); 
4.  
5.  
6.  /\* Don't draw while we're hidden \*/
7.  **if** (renderer->hidden) \{ 
8.  **return**; 
9.   \} 
10.  renderer->RenderPresent(renderer); 
11. \}

从源代码中可以看出，SDL\_RenderPresent()调用了SDL\_Render的RenderPresent()方法显示图像。

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

#### 1.Direct3D ####

Direct3D 渲染器中对应RenderPresent()的函数是D3D\_RenderPresent()，它的源代码如下所示（位于render\\direct3d\\SDL\_render\_d3d.c）。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **static****void** D3D\_RenderPresent(SDL\_Renderer \* renderer) 
2.  \{ 
3.   D3D\_RenderData \*data = (D3D\_RenderData \*) renderer->driverdata; 
4.  **HRESULT** result; 
5.  
6.  
7.  **if** (!data->beginScene) \{ 
8.   IDirect3DDevice9\_EndScene(data->device); 
9.   data->beginScene = SDL\_TRUE; 
10.  \} 
11. 
12. 
13.  result = IDirect3DDevice9\_TestCooperativeLevel(data->device); 
14. **if** (result == D3DERR\_DEVICELOST) \{ 
15. /\* We'll reset later \*/
16. **return**; 
17.  \} 
18. **if** (result == D3DERR\_DEVICENOTRESET) \{ 
19.  D3D\_Reset(renderer); 
20.  \} 
21.  result = IDirect3DDevice9\_Present(data->device, NULL, NULL, NULL, NULL); 
22. **if** (FAILED(result)) \{ 
23.  D3D\_SetError("Present()", result); 
24.  \} 
25. \}

从代码中可以看出，该函数调用了2个最关键Direct3D的API：  
IDirect3DDevice9\_EndScene()：结束一个场景。  
IDirect3DDevice9\_Present()：显示。

#### 2.OpenGL ####

OpenGL渲染器中对应RenderPresent()的函数是GL\_RenderPresent()，它的源代码如下所示（位于render\\opengl\\SDL\_render\_gl.c）。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **static****void** GL\_RenderPresent(SDL\_Renderer \* renderer) 
2.  \{ 
3.  GL\_ActivateRenderer(renderer); 
4.  
5.  
6.   SDL\_GL\_SwapWindow(renderer->window); 
7.  \}

代码比较简单，只有两行。关键的显示函数位于SDL\_GL\_SwapWindow()函数中。下面看一下SDL\_GL\_SwapWindow()的代码（位于video\\SDL\_video.c。感觉这里调用关系稍微有点乱…）。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **void** SDL\_GL\_SwapWindow(SDL\_Window \* window) 
2.  \{ 
3.   CHECK\_WINDOW\_MAGIC(window, ); 
4.  
5.  
6.  **if** (!(window->flags & SDL\_WINDOW\_OPENGL)) \{ 
7.   SDL\_SetError("The specified window isn't an OpenGL window"); 
8.  **return**; 
9.   \} 
10. 
11. 
12. **if** (SDL\_GL\_GetCurrentWindow() != window) \{ 
13.  SDL\_SetError("The specified window has not been made current"); 
14. **return**; 
15.  \} 
16. 
17. 
18.  \_this->GL\_SwapWindow(\_this, window); 
19. \}

从上述代码中可以看出，SDL\_GL\_SwapWindow()调用了SDL\_VideoDevice的GL\_SwapWindow()函数。我们看一下在“Windows视频驱动”的情况下，该函数的代码。在“Windows视频驱动”的情况下，调用GL\_SwapWindow()实际上是调用了WIN\_GL\_SwapWindow()函数。看一下WIN\_GL\_SwapWindow()函数的代码（位于video\\windows\\SDL\_windowsopengl.c）。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **void** WIN\_GL\_SwapWindow(\_THIS, SDL\_Window \* window) 
2.  \{ 
3.  **HDC** hdc = ((SDL\_WindowData \*) window->driverdata)->hdc; 
4.  
5.  
6.   SwapBuffers(hdc); 
7.  \}

代码中调用了简单的一个函数SwapBuffers()，完成了显示功能。

#### 3.Software ####

Software渲染器中对应RenderPresent()的函数是SW\_RenderPresent()，它的源代码如下所示（位于render\\software\\SDL\_render\_sw.c）。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **static****void** SW\_RenderPresent(SDL\_Renderer \* renderer) 
2.  \{ 
3.   SDL\_Window \*window = renderer->window; 
4.  
5.  
6.  **if** (window) \{ 
7.   SDL\_UpdateWindowSurface(window); 
8.   \} 
9.  \}

从代码中可以看出，SW\_RenderPresent()调用了一个函数SDL\_UpdateWindowSurface()。我们看一下SDL\_UpdateWindowSurface()的代码（位于video\\SDL\_video.c）。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **int** SDL\_UpdateWindowSurface(SDL\_Window \* window) 
2.  \{ 
3.   SDL\_Rect full\_rect; 
4.  
5.  
6.   CHECK\_WINDOW\_MAGIC(window, -1); 
7.  
8.  
9.   full\_rect.x = 0; 
10.  full\_rect.y = 0; 
11.  full\_rect.w = window->w; 
12.  full\_rect.h = window->h; 
13. **return** SDL\_UpdateWindowSurfaceRects(window, &full\_rect, 1); 
14. \}

SDL\_UpdateWindowSurface()又调用了另一个函数SDL\_UpdateWindowSurfaceRects()。继续看SDL\_UpdateWindowSurfaceRects()的代码。

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **int** SDL\_UpdateWindowSurfaceRects(SDL\_Window \* window, **const** SDL\_Rect \* rects, 
2.  **int** numrects) 
3.  \{ 
4.   CHECK\_WINDOW\_MAGIC(window, -1); 
5.  
6.  
7.  **if** (!window->surface\_valid) \{ 
8.  **return** SDL\_SetError("Window surface is invalid, please call SDL\_GetWindowSurface() to get a new surface"); 
9.   \} 
10. 
11. 
12. **return** \_this->UpdateWindowFramebuffer(\_this, window, rects, numrects); 
13. \}

SDL\_UpdateWindowSurfaceRects()调用了SDL\_VideoDevice的UpdateWindowFramebuffer()函数。在“Windows视频驱动”的情况下，相当于调用了WIN\_UpdateWindowFramebuffer()。我们看一下该函数的代码（位于video\\windows\\SDL\_windowsframebuffer.c）

**\[cpp\]** [view plain][] [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **int** WIN\_UpdateWindowFramebuffer(\_THIS, SDL\_Window \* window, **const** SDL\_Rect \* rects, **int** numrects) 
2.  \{ 
3.   SDL\_WindowData \*data = (SDL\_WindowData \*) window->driverdata; 
4.  
5.  
6.   BitBlt(data->hdc, 0, 0, window->w, window->h, data->mdc, 0, 0, SRCCOPY); 
7.  **return** 0; 
8.  \}

经过一系列的寻找之后，终于找到了Software渲染器显示视频的“源头”：BitBlt()函数。

[SDL2_1_SDL_Init]: http://blog.csdn.net/leixiaohua1020/article/details/40680907
[SDL2_2_SDL_Window]: http://blog.csdn.net/leixiaohua1020/article/details/40701203
[SDL2_3_SDL_Renderer]: http://blog.csdn.net/leixiaohua1020/article/details/40723085
[SDL2_4_SDL_Texture]: http://blog.csdn.net/leixiaohua1020/article/details/40743061
[SDL2_5_SDL_UpdateTexture]: http://blog.csdn.net/leixiaohua1020/article/details/40876089
[SDL2_6_SDL_RenderCopy]: http://blog.csdn.net/leixiaohua1020/article/details/40895593
[SDL2_7_SDL_RenderPresent]: http://blog.csdn.net/leixiaohua1020/article/details/40895797
[SDL2_8]: http://blog.csdn.net/leixiaohua1020/article/details/41207787
[20141107171722706]: /images/20220731/f67112bab38f4dfc8ee09c3dc781fe67.png
[view plain]: http://blog.csdn.net/leixiaohua1020/article/details/40895797#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/512935
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/512935/fork
[SouthEast]: /images/20220731/d8f81d0a8228453f8f6a50581355c71b.png
[SouthEast 1]: http://my.csdn.net/leixiaohua1020/album/detail/1794103