SDL_UpdateTexture

Use this function to update the given texture rectangle with new pixel data.

Syntax

int SDL_UpdateTexture(SDL_Texture*    texture,
                      const SDL_Rect* rect,
                      const void*     pixels,
                      int             pitch)

Function Parameters

texture

the texture to update

rect

an SDL_Rect structure representing the area to update, or NULL to update the entire texture

pixels

the raw pixel data

pitch

the number of bytes between rows of pixel data

Return Value

Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.

Code Examples

You can add your code example here

Remarks

This is a fairly slow function, intended for use with static textures.

This function will work with streaming textures, but for optimization reasons you may not get the pixels back if you lock the texture afterward.


CategoryAPI, CategoryRender

SDL_UpdateTexture (last edited 2011-02-15 19:27:34 by SheenaSmith)

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