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

SDL_LoadPNG_IO

シーク可能なSDLデータストリームからPNG画像をサーフェイスに読み込む

ヘッダ

SDL3/SDL_surface.h

構文

SDL_Surface * SDL_LoadPNG_IO(SDL_IOStream *src, bool closeio);

引数

SDL_IOStream *srcデータストリーム
boolcloseio真のときエラーであっても戻る前にsrcに対してSDL_CloseIO()を呼ぶ

戻り値

(SDL_Surface *) 成功のとき生成されたSDL_Surface, 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

これは信用できる画像ファイルの読み込みを意図した便利のための関数である. 不特定の画像を読み込みたい場合は, セキュリティに配慮したlibpngや他の画像読み込みライブラリを使用すべきである.

生成されたサーフェイスはSDL_DestroySurface()で解放する必要がある. そうしないとメモリリークを引き起こすだろう.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.4.0以降

関連項目

SDL Wikiへのリンク

SDL_LoadPNG_IO - SDL Wiki