Load a BMP image from a file.
const char *file); SDL_Surface* SDL_LoadBMP(
file |
the BMP file to load |
Returns a pointer to a new SDL_Surface structure or NULL if there was an error; call SDL_GetError() for more information.
The new surface should be freed with SDL_DestroySurface(). Not doing so will result in a memory leak.
This function is available since SDL 3.0.0.
const char *image_path = "myimage.bmp";
SDL_Surface *image = SDL_LoadBMP(image_path);
/* Let the user know if the file failed to load */
if (!image) {
"Failed to load image at %s: %s\n", image_path, SDL_GetError());
printf(return;
}
/* Do something with image here. */
/* Make sure to eventually release the surface resource */
SDL_DestroySurface(image);