bool SDL_LockTexture(SDL_Texture *texture, const SDL_Rect *rect, void **pixels, int *pitch);
| SDL_Texture * | texture | アクセスのためにロックするテクスチャ. SDL_TEXTUREACCESS_STREAMINGで生成されている必要がある |
| const SDL_Rect * | rect | アクセスのためロックする領域のSDL_Rect. NULLのとき全体をロックする |
| void ** | pixels | ロックされたピクセルのポインタの代入先へのポインタ. ピクセルはロックされた領域に適切にオフセットされている |
| int * | pitch | ロックされたピクセルの幅の代入先へのポインタ. 幅は1行のバイト数である |
(bool) 成功のとき真, テクスチャが無効またはSDL_TEXTUREACCESS_STREAMINGなしで生成されているとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.
最適化のため, 編集用のピクセル領域には編集前のテクスチャデータが書き込まれているとは限らない. これは書き込み専用の操作であり, テクスチャデータのコピーを保持したいならば, アプリケーション側が行う必要がある.
SDL_UnlockTexture()でピクセル領域をロック解除して変更を適用する必要がある.
この関数を呼べるのはメインスレッドのみである.