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

SDL_RenderCopyEx

テクスチャの一部を, 指定の点を中心に回転させ, 上下左右を反転を指定して, 現在のレンダーターゲットにコピーする

構文

int SDL_RenderCopyEx(SDL_Renderer* renderer, SDL_Texture* texture, const SDL_Rect* srcrect, const SDL_Rect* dstrect, const double angle, const SDL_Point* center, const SDL_RendererFlip flip)

引数

rendererレンダリングコンテキスト
textureコピー元テクスチャ (詳細を参照すること)
srcrectコピー元のSDL_Rect. NULLのとき全体
dstrectコピー先のSDL_Rect. NULLのとき全体. テクスチャはこの領域に合うように拡大縮小される.
angledstrectにコピーするときの画像の角度(度数法・時計回り)
centerdstrectにコピーするときの画像の回転の中心を表すSDL_Pointのポインタ (NULLのときdstrect.w/2, dstrect.h/2)
flipテクスチャの上下左右反転を表すSDL_RendererFlip

戻り値

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

詳細

テクスチャの一部を現在のレンダリングターゲットにコピーする. 指定の点を中心に回転させ, 上下かつ/または左右を反転させることもできる.

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

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

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

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_RenderCopy
SDL_SetTextureAlphaMod
SDL_SetTextureBlendMode
SDL_SetTextureColorMod

SDL Wikiへのリンク

SDL_RenderCopyEx - SDL Wiki