Wiki Page Content

Differences between revisions 2 and 3
Revision 2 as of 2013-11-02 13:55:32
Size: 2300
Comment: Fixed version.
Revision 3 as of 2016-03-24 23:17:43
Size: 2300
Comment: Fixed pointer style in Syntax section, see SGFunctions.
Deletions are marked like this. Additions are marked like this.
Line 20: Line 20:
                         const Uint8 * Yplane,                          const Uint8* Yplane,

DRAFT

SDL_UpdateYUVTexture

Use this function to update a rectangle within a planar YV12 or IYUV texture with new pixel data.

Syntax

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

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

Uplane

the raw pixel data for the U plane

Upitch

the number of bytes between rows of pixel data for the U plane

Vplane

the raw pixel data for the V plane

Vpitch

the number of bytes between rows of pixel data for the V plane

Return Value

Returns 0 on success or -1 if the texture is not valid; call SDL_GetError() for more information.

Code Examples

You can add your code example here

Remarks

You can use SDL_UpdateTexture() as long as your pixel data is a contiguous block of Y and U/V 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.1.


CategoryAPI, CategoryRender

None: SDL_UpdateYUVTexture (last edited 2016-03-24 23:17:43 by PhilippWiesemann)

Feedback
Please include your contact information if you'd like to receive a reply.
Submit