sdlGetRenderDriver function

String? sdlGetRenderDriver(int index)

Use this function to get the name of a built in 2D rendering driver.

The list of rendering drivers is given in the order that they are normally initialized by default; the drivers that seem more reasonable to choose first (as far as the SDL developers believe) are earlier in the list.

The names of drivers are all simple, low-ASCII identifiers, like "opengl", "direct3d12" or "metal". These never have Unicode characters, and are not meant to be proper names.

\param index the index of the rendering driver; the value ranges from 0 to SDL_GetNumRenderDrivers() - 1. \returns the name of the rendering driver at the requested index, or NULL if an invalid index was specified.

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

\since This function is available since SDL 3.1.3.

\sa SDL_GetNumRenderDrivers

extern SDL_DECLSPEC const char * SDLCALL SDL_GetRenderDriver(int index)

Implementation

String? sdlGetRenderDriver(int index) {
  final sdlGetRenderDriverLookupFunction = libSdl3.lookupFunction<
      Pointer<Utf8> Function(Int32 index),
      Pointer<Utf8> Function(int index)>('SDL_GetRenderDriver');
  final result = sdlGetRenderDriverLookupFunction(index);
  if (result == nullptr) {
    return null;
  }
  return result.toDartString();
}