NAME¶

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

HEADER FILE¶

Defined in SDL3/SDL_render.h

SYNOPSIS¶

#include "SDL3/SDL.h"

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

DESCRIPTION¶

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.

FUNCTION PARAMETERS¶

texture

the texture to update.

rect

a pointer to the rectangle of pixels to update, or NULL to update the entire texture.

Yplane

the raw pixel data for the Y plane.

Ypitch

the number of bytes between rows of pixel data for the Y plane.

UVplane

the raw pixel data for the UV plane.

UVpitch

the number of bytes between rows of pixel data for the UV plane.

RETURN VALUE¶

Returns true on success or false on failure; call

SDL_GetError () for more information.

THREAD SAFETY¶

You may only call this function from the main thread.

AVAILABILITY¶

This function is available since SDL 3.1.3.

SEE ALSO¶

•(3), SDL_UpdateTexture(3), •(3), SDL_UpdateYUVTexture(3)