int SDL_RenderReadPixels(SDL_Renderer* renderer, const SDL_Rect* rect, Uint32 format, void* pixels, int pitch)
| renderer | レンダリングコンテキスト |
| rect | 読み込む領域のSDL_Rect. NULLのときレンダリング対象全体 |
| format | ピクセルデータのSDL_PixelFormat. 0のときレンダリング対象と同じ形式 |
| pixels | ピクセルデータを代入するポインタ |
| pitch | 引数pixelsの水平方向のバイト数. 詳細を参照すること |
注意: この関数は非常に遅いので, 周期的な処理で使ってはならない. この関数をメインレンダーターゲットで使う場合は, レンダリングの後, SDL_RenderPresent()の前に呼ぶべきである.
pitchでpixelsの1行あたりのバイト数を指定する. これにより, より大きなpixels配列の一部の領域を利用したり, ピクセルデータの行をパッディングすることができる. 一般的には, これはピクセルデータの1行あたりのピクセル数に, 1ピクセルあたりのバイト数を掛けたものと等しくなければならない.