sdlLoadBmp function surface

Pointer<SdlSurface> sdlLoadBmp(
  1. String? file
)

Load a BMP image from a file.

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

\param file the BMP file to load. \returns a pointer to a new SDL_Surface structure or NULL on failure; call SDL_GetError() for more information.

\threadsafety It is safe to call this function from any thread.

\since This function is available since SDL 3.2.0.

\sa SDL_DestroySurface \sa SDL_LoadBMP_IO \sa SDL_SaveBMP

extern SDL_DECLSPEC SDL_Surface * SDLCALL SDL_LoadBMP(const char *file)

Implementation

Pointer<SdlSurface> sdlLoadBmp(String? file) {
  final sdlLoadBmpLookupFunction = _libSdl
      .lookupFunction<
        Pointer<SdlSurface> Function(Pointer<Utf8> file),
        Pointer<SdlSurface> Function(Pointer<Utf8> file)
      >('SDL_LoadBMP');
  final filePointer = file != null ? file.toNativeUtf8() : nullptr;
  final result = sdlLoadBmpLookupFunction(filePointer);
  calloc.free(filePointer);
  return result;
}