int SDL_LockTextureToSurface(SDL_Texture *texture, const SDL_Rect *rect, SDL_Surface **surface)
| texture | アクセスのためにロックするテクスチャ. SDL_TEXTUREACCESS_STREAMINGで生成されている必要がある |
| rect | アクセスのためロックする領域のSDL_Rect. NULLのとき全体をロックする |
| surface | ロックされた領域のSDLサーフェイスを代入するポインタ |
生のピクセルデータの代わりにSDL_Surfaceを戻すこと以外は, この関数はSDL_LockTexture()と同じである.
最適化のため, 編集のために作られたピクセルには古いテクスチャのデータが含まれているとは限らない. これは書き込み専用の操作である. そして, テクスチャデータのコピーを保持したいならば, アプリケーションレベルで行う必要がある.
ピクセルはSDL_UnlockTexture()でアンロックする必要がある.
戻されたサーフェイスはSDL_UnlockTexture()またはSDL_DestroyTexture()を呼んだとき内部で自動的に解放される. 呼び出し元で解放する必要はない.