SDL_surface.h

Función SDL_CreateRGBSurfaceFrom

Sintaxis

SDL_Surface* SDL_CreateRGBSurfaceFrom(void *pixels,
                                      int width,
                                      int height,
                                      int depth,
                                      int pitch,
                                      Uint32 Rmask,
                                      Uint32 Gmask,
                                      Uint32 Bmask,
                                      Uint32 Amask);

Descripción

Asigna una nueva superficie RGB con los datos de píxeles existentes.

Parámetros

pixels
Un puntero a los datos de píxeles existentes.
width
La anchura de la superficie.
height
La altura de la superficie.
depth
La profundidad de la superficie en bits.
pitch
El paso de la superficie en bytes.
Rmask
La máscara roja para los píxeles.
Gmask
La máscara verde para los píxeles.
Bmask
La máscara axul para los píxeles.
Amask
La máscara alfa para los píxeles.

Valor de retorno

Devuelve la nueva estructura SDL_Surface creada o NULL si falla. Ver SDL_GetError.

Observaciones

Esta función opera mayormente como SDL_CreateRGBSurface(), excepto que no asigna memoria para los datos de píxeles, en su lugar el proceso que llama proporciona un buffer de datos existente para que la superficie lo utilice.

No se realiza ninguna copia de los datos de píxeles. Los datos de píxel no se gestionan automáticamente; se debe liberar la superficie antes de liberar los datos de píxel.