SDL_RenderCopy

Use this function to copy a portion of the texture to the current rendering target.
使用该函数复制材质图像的一部分至当前的渲染目标。

Syntax 语法

  1. int SDL_RenderCopyEx(SDL_Renderer*   renderer,
  2.                      SDL_Texture*    texture,
  3.                      const SDL_Rect* srcrect,
  4.                      const SDL_Rect* dstrect)

Function Parameters 函数参数

rendererthe rendering context
渲染器
texturethe source texture; see Remarks for details
源材质，详细请看注释。
srcrectthe source SDL_Rect structure or NULL for the entire texture
SDL_Rect 结构体指定的要复制的源材质的矩形区域或者 NULL 为整个材质图像。
dstrectthe destination SDL_Rect structure or NULL for the entire rendering target
SDL_Rect 结构体指定的目标矩形区域或者 NULL 为渲染器的整个区域。

Return Value 返回值

Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
成功返回 0, 否则返回一个负数的错误码；调用 SDL_GetError() 获取更多信息。

Code Examples 代码示例

  1. #include "SDL.h"
  2. #define SHAPE_SIZE 16
  4. int main(int argc, char *argv[])
  5. {
  6.   SDL_Window* Main_Window;
  7.   SDL_Renderer* Main_Renderer;
  8.   SDL_Surface* Loading_Surf;
  9.   SDL_Texture* Background_Tx;
  10.   SDL_Texture* BlueShapes;
  12.   /* 指定要渲染的材质矩形区域和目标渲染区域 */
  13.   SDL_Rect SrcR;
  14.   SDL_Rect DestR;
  16.   SrcR.x = 0;
  17.   SrcR.y = 0;
  18.   SrcR.w = SHAPE_SIZE;
  19.   SrcR.h = SHAPE_SIZE;
  21.   DestR.x = 640 / 2 - SHAPE_SIZE / 2;
  22.   DestR.y = 580 / 2 - SHAPE_SIZE / 2;
  23.   DestR.w = SHAPE_SIZE;
  24.   DestR.h = SHAPE_SIZE;
  27.   /* 渲染前创建一个窗口和渲染器 */
  28.   Main_Window = SDL_CreateWindow("SDL_RenderCopy Example",
  29.   SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, 640, 580, 0);
  30.   Main_Renderer = SDL_CreateRenderer(Main_Window, -1, SDL_RENDERER_ACCELERATED);
  32.   /* 加载一幅图像，为了使用硬件加速渲染，把得到的 Surface 格式图像转换成材质图像 */
  33.   Loading_Surf = SDL_LoadBMP("Background.bmp");
  34.   Background_Tx = SDL_CreateTextureFromSurface(Main_Renderer, Loading_Surf);
  35.   SDL_FreeSurface(Loading_Surf); /* we got the texture now -> free surface */
  37.   /* 加载其他图像 */
  38.   Loading_Surf = SDL_LoadBMP("Blueshapes.bmp");
  39.   BlueShapes = SDL_CreateTextureFromSurface(Main_Renderer, Loading_Surf);
  40.   SDL_FreeSurface(Loading_Surf);
  42.   /* 这里是重点。该操作在屏幕中间渲染一个旋转的蓝色图形选中区域 */
  43.   int i;
  44.   int n;
  45.   for (i = 0; i < 2; ++i) {
  46.     for(n = 0; n < 4; ++n) {
  47.       SrcR.x = SHAPE_SIZE * (n % 2);
  48.       if (n > 1) {
  49.         SrcR.y = SHAPE_SIZE;
  50.       } else {
  51.         SrcR.y = 0;
  52.       }
  54.       /* 渲染背景，NULL 为使用默认的值 */
  55.       SDL_RenderCopy(Main_Renderer, Background_Tx, NULL, NULL);
  57.       /* 渲染这个图形的动画 */
  58.       SDL_RenderCopy(Main_Renderer, BlueShapes, &SrcR, &DestR);
  59.       SDL_RenderPresent(Main_Renderer);
  60.       SDL_Delay(500);
  61.     }
  62.   }
  65.   /* 渲染器工作起来跟一个画布很像：
  66.   当你执行 RenderCopy() 的时候你在往上面添加图像，每次绘制在最上方；
  67.   你可以指定新图像的混合模式；
  68.   渲染完成后使用 SDL_RenderPresent() 将画面显示到程序窗口。*/
  70.   /* SDL 1.2 的提示：如果你习惯了 1.2 中的表面和 Blit 而对渲染器不是很明白的话，
  71.   你可以把它当成你的主表面，SDL_RenderCopy() 就相当于把材质图像 Blit 到主表面，
  72.   SDL_RenderPresent() 就相当于以前的 SDL_Flip() 函数。*/
  74.   SDL_DestroyTexture(BlueShapes);
  75.   SDL_DestroyTexture(Background_Tx);
  76.   SDL_DestroyRenderer(Main_Renderer);
  77.   SDL_DestroyWindow(Main_Window);
  78.   SDL_Quit();
  81.   return 0;
  82. }

Remarks 注释

The texture is blended with the destination based on its blend mode set with SDL_SetTextureBlendMode().
渲染后的材质根据 SDL_SetTextureBlendMode() 的设置会带有混合效果。

The texture color is affected based on its color modulation set by SDL_SetTextureColorMod().
材质的颜色是受 SDL_SetTextureColorMod() 影响的。

The texture alpha is affected based on its alpha modulation set by SDL_SetTextureAlphaMod().
材质的透明度是受 SDL_SetTextureAlphaMod() 影响的。

Related Functions 相关函数

SDL_RenderCopyEx
SDL_SetTextureAlphaMod
SDL_SetTextureBlendMode
SDL_SetTextureColorMod

@lxfly2000