SDL_Surface * SDL_RenderReadPixels(SDL_Renderer *renderer, const SDL_Rect *rect);
| SDL_Renderer * | renderer | レンダリングコンテキスト |
| const SDL_Rect * | rect | 読み込む領域のSDL_Rect. 表示領域内でクリップされる. NULLのとき表示領域全体 |
(SDL_Surface *) 成功のとき生成されたサーフェイス, 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.
戻されたサーフェイスのピクセルは表示領域でクリップされたものである. また, このサーフェイスはSDL_DestroySurface()で解放する必要がある.
戻されるのは画面の実際のピクセルで, 論理表示を使用している場合はSDL_GetRenderLogicalPresentationRect()で必要な領域を求める必要がある.
注意: この処理は非常に遅いため, 繰り返し使用するべきではない. レンダーターゲットがウィンドウの場合, レンダリングの後のSDL_RenderPresent()の前にこの関数を呼ぶ必要がある.
この関数を呼べるのはメインスレッドのみである.