目次 - SDL 3.0 API(機能別) - サーフェイスの生成と単純な描画 - SDL_GetSurfaceImages

SDL_GetSurfaceImages

サーフェイスの全てのバージョンの配列を得る

ヘッダ

SDL3/SDL_surface.h

構文

SDL_Surface ** SDL_GetSurfaceImages(SDL_Surface *surface, int *count);

引数

SDL_Surface *surface問い合わせるSDL_Surface
int *countサーフェイスの数の代入先へのポインタ. NULLも可

戻り値

(SDL_Surface **) NULL終端のSDL_Surfaceポインタの配列を戻す. 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる. 必要がなくなった時点でSDL_free()で解放する必要がある.

詳細

この関数は, 別バージョンを加えられたサーフェイスを先頭に含む全てのバージョンのサーフェイスを戻す.

サーフェイスの配列を解放しても, 配列内のサーフェイスには影響しない. これらのサーフェイスは依然として問い合わせたサーフェイスから参照され, 通常通り処理される.

スレッドセーフ

この関数は別のスレッドから別のサーフェイスに対して呼ぶことができる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_GetSurfaceImages - SDL Wiki