Property

MaplibreNativeFfiRenderSessionAttachOptions:driver

Declaration

property driver: MaplibreNativeFfi.RenderDriverKind [ read, write ]

Description [src]

The thread that runs the session’s graphics work, which depends on the target:

  • MAPLIBRE_NATIVE_FFI_RENDER_DRIVER_CALLER_GRAPHICS_THREAD for a shared or dedicated EGL or WGL context, an existing WebGL context, or a browser’s WebGPU device.
  • MAPLIBRE_NATIVE_FFI_RENDER_DRIVER_CORE_WORKER for a transferred WebGL canvas, an Android, OpenHarmony, or Win32 window, a Wayland surface, a ring of Android hardware buffers, dmabufs, DXGI shared textures, or IOSurfaces, or an offscreen session.
  • Either one for another Metal or Vulkan target.

An attach with another driver fails with MAPLIBRE_NATIVE_FFI_ERROR_UNSUPPORTED.

Until it is set, it holds 0, which names no value and which native code rejects, whatever the property’s default says.

Default valueMAPLIBRE_NATIVE_FFI_RENDER_DRIVER_CORE_WORKER
Getter methodmaplibre_native_ffi_render_session_attach_options_get_driver()
Setter methodmaplibre_native_ffi_render_session_attach_options_set_driver()

Flags

Readableyes
Writableyes
Constructno
Construct onlyno