SDL_GPUTexture * IMG_LoadGPUTexture(SDL_GPUDevice *device, SDL_GPUCopyPass *copy_pass, const char *file, int *width, int *height);
| SDL_GPUDevice * | device | GPUテクスチャの生成で使用するSDL_GPUDevice |
| SDL_GPUCopyPass * | copy_pass | 読み込んだ画像をGPUテクスチャにアップロードするために使用するSDL_GPUCopyPass |
| const char * | file | 画像ファイルのパス名 |
| int * | height | GPUテクスチャの高さの代入先へのポインタ. NULLも可 |
SDL_GPUTextureはGPUメモリ内の画像で, SDLのGPU APIで使用できる. 元の画像の形式に関わらず, この関数はGPUテクスチャをMIPレベルのないSDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM形式で生成する. これはサンプリングされたテクスチャとしてグラフィックまたはコンピュートパイプラインから, またはコンピュートパイプラインで読み込み専用ストレージテクスチャとしてバインドされる.
ファイルではなく抽象I/Oを使用する必要があるならば, SDL_IOStreamからファイルを読み込む別の関数IMG_LoadGPUTexture_IO()も存在する.
テクスチャを使用し終えたならば, アプリケーションはSDL_ReleaseGPUTexture()を呼んで破棄しなければならない.