(This is the legacy documentation for SDL2, the previous stable version; SDL3 is the current stable version.)

SDL_UpdateNVTexture

Update a rectangle within a planar NV12 or NV21 texture with new pixels.

Header File

Defined in SDL_render.h

Syntax

int SDL_UpdateNVTexture(SDL_Texture * texture,
                         const SDL_Rect * rect,
                         const Uint8 *Yplane, int Ypitch,
                         const Uint8 *UVplane, int UVpitch);

Function Parameters

SDL_Texture *	texture	the texture to update.
const SDL_Rect *	rect	a pointer to the rectangle of pixels to update, or NULL to update the entire texture.
const Uint8 *	Yplane	the raw pixel data for the Y plane.
int	Ypitch	the number of bytes between rows of pixel data for the Y plane.
const Uint8 *	UVplane	the raw pixel data for the UV plane.
int	UVpitch	the number of bytes between rows of pixel data for the UV plane.

Return Value

(int) Return 0 on success, or -1 if the texture is not valid.

Remarks

You can use SDL_UpdateTexture() as long as your pixel data is a contiguous block of NV12/21 planes in the proper order, but this function is available if your pixel data is not contiguous.

Version

This function is available since SDL 2.0.16.

---

CategoryAPI, CategoryAPIFunction, CategoryRender

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.