SDL_Texture * IMG_LoadTexture(SDL_Renderer *renderer, const char *file);
| SDL_Renderer * | renderer | テクスチャを生成するために使用するSDL_Renderer |
| const char * | file | 画像ファイルのパス名 |
SDL_TextureはGPUメモリ内の画像で, SDLの2DレンダリングAPIで使用できる. これは読み込んだ後に画像を直接編集するのでなければ, CPUを使用するSDL_Surfaceよりもはるかに効率的である.
読み込んだ画像に透明色またはカラーキーがある場合ば, テクスチャにはαチャネルが生成される. そうでない場合は, 画像データを表すのに最も合理的な形式でSDL_Textureを生成しようとする(しかしほとんどの場合は32ビットRGBまたは32ビットRGBAとなる).
ファイルではなく抽象I/Oを使用する必要があるならば, SDL_IOStreamからファイルを読み込む別の関数IMG_LoadTexture_IO()も存在する.
SDL_Surface(CPUメモリ内のピクセルバッファ)に読み込みたいならば, 代わりにIMG_Load()を使用すること.
テクスチャを使用し終えたならば, アプリケーションはSDL_DestroyTexture()を呼んで破棄しなければならない.