Wiki Page Content

Differences between revisions 1 and 2
Revision 1 as of 2013-11-02 13:53:41
Size: 2300
Comment: Added page for SDL_UpdateYUVTexture( ) using content from header.
Revision 2 as of 2013-11-02 13:55:32
Size: 2300
Comment: Fixed version.
Deletions are marked like this. Additions are marked like this.
Line 56: Line 56:
This function is available since SDL 2.0.0. This function is available since SDL 2.0.1.

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