SDL_LockTexture

ピクセルを書き込み専用にするためにテクスチャの一部をロックする

構文

int SDL_LockTexture(SDL_Texture* texture, const SDL_Rect* rect, void** pixels, int* pitch)

texture	アクセスのためにロックするテクスチャ. SDL_TEXTUREACCESS_STREAMINGで生成されている必要がある
rect	アクセスのためロックする領域のSDL_Rect. NULLのとき全体をロックする
pixels	ロックされた領域のピクセルのオフセットへのポインタを代入するポインタ
pitch	ロックされたpixelsの水平方向のバイト数を代入するポインタ

成功のとき0を戻す. テクスチャが使えない, またはSDL_TEXTUREACCESS_STREAMINGで生成されていないとき負の数のエラーコードを戻す. SDL_GetError()で詳細を知ることができる.

最適化のため, 編集のために作られたピクセルには古いテクスチャのデータが含まれているとは限らない. これは書き込み専用の操作である. そして, テクスチャデータのコピーを保持したいならば, アプリケーションレベルで行う必要がある.

ピクセルはSDL_UnlockTexture()でアンロックする必要がある.