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

SDL_CreateGPURenderer

2D GPUレンダリングコンテキストを生成する

ヘッダ

SDL3/SDL_render.h

構文

SDL_Renderer * SDL_CreateGPURenderer(SDL_GPUDevice *device, SDL_Window *window);

引数

SDL_GPUDevice *deviceレンダラで使用するGPUデバイス. NULLのとき生成する
SDL_Window *windowレンダリングを表示するウィンドウ

戻り値

(SDL_Renderer *) 成功のときレンダリングコンテキスト, 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

使用するGPUデバイスを引数として渡す. これがNULLの場合, デバイスが生成され, それはSDL_GetGPURendererDevice()で回収することができる.

使用するウィンドウを引数として渡す. これがNULLの場合, 画面外のレンダラとなる. この場合, テクスチャのレンダリングのためにSDL_SetRenderTarget()を呼び, その後はフレームの描画を完了させるためにSDL_RenderPresent()を呼ぶ必要がある.

スレッドセーフ

この関数を有効なGPUデバイスを指定して呼ぶ場合, デバイスを生成したスレッドと同じスレッドである必要がある. ウィンドウを指定して呼ぶ場合, ウィンドウを生成したスレッドと同じスレッドである必要がある.

バージョン

SDL 3.4.0以降

関連項目

SDL Wikiへのリンク

SDL_CreateGPURenderer - SDL Wiki