###### (This is the legacy documentation for SDL2, the previous stable version; [SDL3](https://wiki.libsdl.org/SDL3/) is the current stable version.)
# SDL_LoadBMP_RW

Load a BMP image from a seekable SDL data stream.

## Header File

Defined in [SDL_surface.h](https://github.com/libsdl-org/SDL/blob/SDL2/include/SDL_surface.h)

## Syntax

```c
SDL_Surface* SDL_LoadBMP_RW(SDL_RWops * src,
                            int freesrc);
```

## Function Parameters

|                          |             |                                                |
| ------------------------ | ----------- | ---------------------------------------------- |
| [SDL_RWops](SDL_RWops) * | **src**     | the data stream for the surface.               |
| int                      | **freesrc** | non-zero to close the stream after being read. |

## Return Value

([SDL_Surface](SDL_Surface) *) Returns a pointer to a new
[SDL_Surface](SDL_Surface) structure or NULL if there was an error; call
[SDL_GetError](SDL_GetError)() for more information.

## Remarks

The new surface should be freed with [SDL_FreeSurface](SDL_FreeSurface)().
Not doing so will result in a memory leak.

src is an open [SDL_RWops](SDL_RWops) buffer, typically loaded with
[SDL_RWFromFile](SDL_RWFromFile). Alternitavely, you might also use the
macro [SDL_LoadBMP](SDL_LoadBMP) to load a bitmap from a file, convert it
to an [SDL_Surface](SDL_Surface) and then close the file.

## Version

This function is available since SDL 2.0.0.

## See Also

- [SDL_FreeSurface](SDL_FreeSurface)
- [SDL_RWFromFile](SDL_RWFromFile)
- [SDL_LoadBMP](SDL_LoadBMP)
- [SDL_SaveBMP_RW](SDL_SaveBMP_RW)

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategorySurface](CategorySurface)