sdlLoadSurface function surface

Pointer<SdlSurface> sdlLoadSurface(String? file)

Load a BMP or PNG 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 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.4.0.

\sa SDL_DestroySurface \sa SDL_LoadSurface_IO

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

Implementation

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