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

SDL_QueryTexture

テクスチャの情報を得る

構文

int SDL_QueryTexture(SDL_Texture* texture, Uint32* format, int* access, int* w, int* h)

引数

texture調査するテクスチャ
formatテクスチャの生の形式を代入するポインタ(SDL_PixelFormat). 実際の形式とは異なることがある. しかし, ピクセルのコピーではこの形式が使われる. この情報が必要なければNULLにできる
access実際のアクセスを代入するポインタ(SDL_TextureAccessの1つ). この情報が必要なければNULLにできる
wテクスチャの幅を代入するポインタ. この情報が必要なければNULLにできる
hテクスチャの高さを代入するポインタ. この情報が必要なければNULLにできる

戻り値

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

サンプルコード

SDL_Texture* source;

// ここで読み込みなどを行う...

int w, h;
SDL_QueryTexture(source, NULL, NULL, &w, &h);

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_CreateTexture

SDL Wikiへのリンク

SDL_QueryTexture - SDL Wiki