SDL_CreateSurface

sdl3_sys::surface

Function SDL_CreateSurface 

Source 
pub unsafe extern "C" fn SDL_CreateSurface(
    width: c_int,
    height: c_int,
    format: SDL_PixelFormat,
) -> *mut SDL_Surface
Expand description

Allocate a new surface with a specific pixel format.

The pixels of the new surface are initialized to zero.

§Parameters

  • width: the width of the surface.
  • height: the height of the surface.
  • format: the SDL_PixelFormat for the new surface’s pixel format.

§Return value

Returns the new SDL_Surface structure that is created or NULL on failure; call SDL_GetError() for more information.

§Thread safety

It is safe to call this function from any thread.

§Availability

This function is available since SDL 3.2.0.

§See also