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

SDL_UpdateNVTexture

Planar YV12またはIYUVテクスチャの領域を新しいピクセルデータで更新する

ヘッダ

SDL3/SDL_render.h

構文

bool SDL_UpdateYUVTexture(SDL_Texture *texture, const SDL_Rect *rect, const Uint8 *Yplane, int Ypitch, const Uint8 *Uplane, int Upitch, const Uint8 *Vplane, int Vpitch);

引数

SDL_Texture *texture更新するテクスチャ
const SDL_Rect *rectテクスチャを更新する領域のSDL_Rect. NULLのときテクスチャ全体
const Uint8 *YplaneYプレーンの生のピクセルデータ
intYpitchYプレーンのピクセルデータの幅のバイト数
const Uint8 *UplaneUプレーンの生のピクセルデータ
intUpitchUプレーンのピクセルデータの幅のバイト数
const Uint8 *VplaneVプレーンの生のピクセルデータ
intVpitchVプレーンのピクセルデータの幅のバイト数

戻り値

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

YとU/Vプレーンのブロックが正しい順序で連続したピクセルデータならばSDL_UpdateTexture()を使用することができるが, この関数はピクセルデータが連続していなくてもよい.

スレッドセーフ

この関数を呼べるのはメインスレッドのみである.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_UpdateNVTexture - SDL Wiki