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

# 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()でアンロックする必要がある.

## 関連項目(関数)

SDL_UnlockTexture

## SDL Wikiへのリンク

SDL_LockTexture - SDL Wiki