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

# SDL_UpdateTexture

指定のテクスチャの領域を新しいピクセルデータで更新する

## 構文

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

## 引数

texture | 更新するテクスチャ
rect | テクスチャを更新する領域のSDL_Rect. NULLのときテクスチャ全体
pixels | テクスチャの形式の生のピクセルデータ
pitch | ピクセルデータの水平方向のバイト数. ライン間のパッディングを含む

## 戻り値

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

## 詳細

ピクセルデータはテクスチャのピクセル形式でなければならない. テクスチャのピクセル形式はSDL_QueryTexture()で得ることができる.

この関数はやや遅いので, あまり変更のない静的なテクスチャでの使用に向いている.

もしテクスチャを頻繁に更新するならば, ストリーミングとしてテクスチャを生成し, 下の関連項目のロック関数を使うほうがよい. この関数はストリーミングテクスチャを扱えるが, 最適化の観点からはもし後でロックするならばピクセルを戻さない方がよい.

## バージョン

SDL 2.0.0以降

## 関連項目(関数)

SDL_CreateTexture
SDL_LockTexture
SDL_UnlockTexture

## SDL Wikiへのリンク

SDL_UpdateTexture - SDL Wiki