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

# SDL_RenderReadPixels

現在のレンダーターゲットのピクセルデータを読み込む

## 構文

`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 | ピクセルデータの水平方向のバイト数

## 戻り値

成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()で詳細を知ることができる.

## 詳細

注意: この関数は非常に遅いので, 周期的な処理で使ってはならない.

## SDL Wikiへのリンク

SDL_RenderReadPixels - SDL Wiki