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

SDL_RenderTexture9GridTiled

テクスチャの一部を現在のレンダーターゲットに9-grid algorithmを使用して拡大縮小してサブピクセルの精度でコピーする

ヘッダ

SDL3/SDL_render.h

構文

bool SDL_RenderTexture9GridTiled(SDL_Renderer *renderer, SDL_Texture *texture, const SDL_FRect *srcrect, float left_width, float right_width, float top_height, float bottom_height, float scale, const SDL_FRect *dstrect, float tileScale);

引数

SDL_Renderer *rendererテクスチャの一部がコピーされるレンダラ
SDL_Texture *textureコピー元のテクスチャ
const SDL_FRect *srcrectコピー元の領域. NULLのときテクスチャ全体
intleft_widthsrcrectの左側の上下隅の幅ピクセル数
intright_widthsrcrectの右側の上下隅の幅ピクセル数
inttop_heightsrcrectの上側の左右隅の高さピクセル数
intbottom_heightsrcrectの下側の左右隅の高さピクセル数
floatscalesrcrectの隅のdstrectの隅への転送時の拡大率. 0.0fのとき拡大縮小せずに転送する
const SDL_FRect *dstrectコピー先の領域. NULLのときレンダーターゲット全体
floattileScalesrcrectの縁と中央nのdstrectの縁と中央への転送時の拡大率. 1.0のとき拡大縮小せずに転送する

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

コピー元サーフェイスのピクセルは, それぞれのサイズの異なる4つの隅と, 上下左右と中央を残りのピクセルとした3×3の格子に区切られる. 4つの隅はscaleに従って拡大縮小され, コピー先の領域の隅に配置する. 上下左右と中央は, コピー先の残りの領域に合うように拡大縮小して配置する.

スレッドセーフ

この関数を呼べるのはメインスレッドのみである.

バージョン

SDL 3.4.0以降

関連項目

SDL Wikiへのリンク

SDL_RenderTexture9GridTiled - SDL Wiki