目次 - 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