目次 - API(機能別) - 2Dレンダリング - SDL_RenderCopy

SDL_RenderCopy

テクスチャの一部を現在のレンダーターゲットにコピーする

構文

int SDL_RenderCopy(SDL_Renderer* renderer, SDL_Texture* texture, const SDL_Rect* srcrect, const SDL_Rect* dstrect)

引数

rendererレンダリングコンテキスト
textureコピー元テクスチャ (詳細を参照すること)
srcrectコピー元のSDL_Rect. NULLのとき全体
dstrectコピー先のSDL_Rect. NULLのとき全体. テクスチャはこの領域に合うように拡大縮小される.

戻り値

成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()で詳細を知ることができる.

サンプルコード

#include "SDL.h"
#define SHAPE_SIZE 16

int main(int argc, char *argv[])
{
  SDL_Window* Main_Window;
  SDL_Renderer* Main_Renderer;
  SDL_Surface* Loading_Surf;
  SDL_Texture* Background_Tx;
  SDL_Texture* BlueShapes;

  /* レンダリングする(テクスチャ内の)コピー元と(画面の)コピー先の領域 */
  SDL_Rect SrcR;
  SDL_Rect DestR;

  SrcR.x = 0;
  SrcR.y = 0;
  SrcR.w = SHAPE_SIZE;
  SrcR.h = SHAPE_SIZE;

  DestR.x = 640 / 2 - SHAPE_SIZE / 2;
  DestR.y = 580 / 2 - SHAPE_SIZE / 2;
  DestR.w = SHAPE_SIZE;
  DestR.h = SHAPE_SIZE;


  /* レンダリングの前にウィンドウとレンダラーを生成する */
  Main_Window = SDL_CreateWindow("SDL_RenderCopy Example",
  SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, 640, 580, 0);
  Main_Renderer = SDL_CreateRenderer(Main_Window, -1, SDL_RENDERER_ACCELERATED);

  /* 背景画像を読み込む. SDL_LoadBMP()はサーフェイスを戻すので,
  それを高速にコピーできるテクスチャに変換する */
  Loading_Surf = SDL_LoadBMP("Background.bmp");
  Background_Tx = SDL_CreateTextureFromSurface(Main_Renderer, Loading_Surf);
  SDL_FreeSurface(Loading_Surf);  /* テクスチャは得られた -> サーフェイスを解放する */

  /* 追加のテクスチャを読み込む */
  Loading_Surf = SDL_LoadBMP("Blueshapes.bmp");
  BlueShapes = SDL_CreateTextureFromSurface(Main_Renderer, Loading_Surf);
  SDL_FreeSurface(Loading_Surf);

  /* ここが最も関心のある部分である.
  Blueshapes.bmpの選択された部分を画面の中央にレンダリングする */
  int i;
  int n;
  for(i=0;i<2;i++)
  {
    for(n=0;n<4;n++)
    {
      SrcR.x = SHAPE_SIZE * (n % 2);
      if(n > 1)
      {
        SrcR.y = SHAPE_SIZE;
      }
      else
      {
        SrcR.y = 0;
      }

      /* 背景をレンダリングする. NULLはコピー元とコピー先がデフォルトであることを意味する */
      SDL_RenderCopy(Main_Renderer, Background_Tx, NULL, NULL);

      /* 図形をレンダリングしてアニメーションにする */
      SDL_RenderCopy(Main_Renderer, BlueShapes, &SrcR, &DestR);  
      SDL_RenderPresent(Main_Renderer);
      SDL_Delay(500);
    }
  }


  /* このレンダラーは大きなキャンバスのようなものである:
  RenderCopy()で画像を加えると, その度に上書きされる.
  新しいデータがどのようにブレンドされるかは変更できる.
  あなたの「絵」が完成すれば, それをSDL_RenderPresent()を使って見せることができる */

  /* SDL 1.2ユーザへのヒント: レンダラーが理解しづらいならば, 1.2のサーフェイスとコピーに置き換えて,
  レンダラーはメインサーフェイス, SDL_RenderCopy()はメインサーフェイスへのコピー,
  SDL_RenderPresent()は旧バージョンのSDL_Flip()関数と考えればよいかもしれない */

  SDL_DestroyTexture(BlueShapes);
  SDL_DestroyTexture(Background_Tx);
  SDL_DestroyRenderer(Main_Renderer);
  SDL_DestroyWindow(Main_Window);
  SDL_Quit();


  return 0;
}

詳細

テクスチャはSDL_SetTextureBlendMode()で設定したブレンドモードでコピー先のテクスチャとブレンドされる.

テクスチャの色はSDL_SetTextureColorMod()で設定した色の影響を受ける.

テクスチャのα値はSDL_SetTextureAlphaMod()で設定したα値の影響を受ける.

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_RenderCopyEx
SDL_SetTextureAlphaMod
SDL_SetTextureBlendMode
SDL_SetTextureColorMod

SDL Wikiへのリンク

SDL_RenderCopy - SDL Wiki