SDL3 for Dart
Requirement
- ffi ^2.2.0
This library is limited to 64bit.
Since ffi is used, a dynamic library suitable for various environments is required.
image, mixer, net, and ttf are optional. Please include it if necessary.
Since sdl3gfx is included in the source, a dynamic library is not required.
For OpenGL, call require separately.
import 'package:sdl3/sdl3.dart'; // SDL3, SDL3_image, SDL3_mixer, SDL3_net, SDL3_ttf, SDL3_shadercross
import 'package:sdl3/sdl3gfx.dart'; // SDL3_gfx
import 'package:sdl3/sdl3opengl.dart'; // OpenGL
Windows requires dll files.
SDL3.dll
SDL3_image.dll
SDL3_mixer.dll
SDL3_net.dll
SDL3_ttf.dll
SDL3_shadercross.dll
Linux requires so files.
libSDL3.so.0
libSDL3_image.so.0
libSDL3_mixer.so.0
libSDL3_net.so.0
libSDL3_ttf.so.0
libSDL3_shadercross.so.0
Android, Fuchsia requires so files.
libSDL3.so
libSDL3_image.so
libSDL3_mixer.so
libSDL3_net.so
libSDL3_ttf.so
libSDL3_shadercross.so
MacOS (or iOS) requires dylib files.
libSDL3.dylib
libSDL3_image.dylib
libSDL3_mixer.dylib
libSDL3_net.dylib
libSDL3_ttf.dylib
libSDL3_shadercross.dylib
And more.
If you want to set a library under special circumstances (example: dylib), do the following:
SdlDynamicLibraryService().set('sdl', 'YOUR_SDL3_ENVIONMENT.dylib');
SdlDynamicLibraryService().set('image', 'YOUR_SDL3_image_ENVIONMENT.dylib');
SdlDynamicLibraryService().set('mixer', 'YOUR_SDL3_mixer_ENVIONMENT.dylib');
SdlDynamicLibraryService().set('net', 'YOUR_SDL3_net_ENVIONMENT.dylib');
SdlDynamicLibraryService().set('ttf', 'YOUR_SDL3_ttf_ENVIONMENT.dylib');
SdlDynamicLibraryService().set('shadercross', 'YOUR_SDL3_shadercross_ENVIONMENT.dylib');
if (sdlInit(SDL_INIT_VIDEO)) {
// success
}
Note
A Dart library for accessing SDL 3 APIs using, FFI.
Windows 64bit & Linux (Tested under Windows 11 WSL2 environment)
Currently, we are providing it on an experimental basis using the dll compiled below.
https://github.com/sansuido/build-sdl3
Examples
learnopengl.com for Dart
https://github.com/sansuido/sdl3_learnopengl/
SDL_gpu_examples for Dart
https://github.com/sansuido/sdl3_gpu_examples/
SDL_projects for Dart
https://github.com/sansuido/sdl3_projects/
Author
yamahara
Tast List (for struct)
sdl
assert
asyncio
atomic
audio
camera
dialog
events
xSdlCommonEventxSdlDisplayEventxSdlWindowEventxSdlKeyboardDeviceEventxSdlKeyboardEventxSdlTextEditingEventxSdlTextEditingCandidatesEventxSdlTextInputEventxSdlMouseDeviceEventxSdlMouseMotionEventxSdlMouseButtonEventxSdlMouseWheelEventxSdlJoyAxisEventxSdlJoyBallEventxSdlJoyHatEventxSdlJoyButtonEventxSdlJoyDeviceEventxSdlJoyBatteryEventxSdlGamepadAxisEventxSdlGamepadButtonEventxSdlGamepadDeviceEventxSdlGamepadTouchpadEventxSdlGamepadSensorEventxSdlGamepadCapSenseEventxSdlAudioDeviceEventxSdlCameraDeviceEventxSdlNotificationEventxSdlRenderEventxSdlTouchFingerEventxSdlPinchFingerEventxSdlPenProximityEventxSdlPenMotionEventxSdlPenTouchEventxSdlPenButtonEventxSdlPenAxisEventxSdlDropEventxSdlClipboardEventxSdlSensorEventxSdlQuitEventxSdlUserEventxSdlEvent
filesystem
gamepad
xSdlGamepadxSdlGamepadBindingInputAxisxSdlGamepadBindingInputHatxSdlGamepadBindingInputxSdlGamepadBindingOutputAxisxSdlGamepadBindingOutputxSdlGamepadBinding
gpu
xSdlGpuDevicexSdlGpuCommandBufferxSdlGpuRenderPassxSdlGpuComputePassxSdlGpuCopyPassxSdlGpuViewportxSdlGpuTextureTransferInfoxSdlGpuTransferBufferLocationxSdlGpuTextureLocationxSdlGpuTextureRegionxSdlGpuBufferLocationxSdlGpuBufferRegionxSdlGpuSamplerCreateInfoxSdlGpuShaderCreateInfoxSdlGpuTextureCreateInfoxSdlGpuBufferCreateInfoxSdlGpuTransferBufferCreateInfoxSdlGpuGraphicsPipelineCreateInfoxSdlGpuComputePipelineCreateInfoxSdlGpuColorTargetInfoxSdlGpuDepthStencilTargetInfoxSdlGpuBlitInfoxSdlGpuBufferBindingxSdlGpuTextureSamplerBindingxSdlGpuStorageBufferReadWriteBindingxSdlGpuStorageTextureReadWriteBinding
guid
haptic
hidapi
iostream
joystick
loadso
locate
main_impl
messagebox
mouse
mutex
notification
openxr
pixels
process
rect
render
sensor
stdinc
storage
surface
system
thread
time
touch
tray
xSdlTrayxSdlTrayMenuxSdlTrayEntry
video
xSdlGlContext
sdl_image
sdl_mixer
xMixMixerxMixAudioxMixTrackxMixGroupxMixStereoGainsxMixPoint3DxMixAudioDecoder
sdl_net
sdl_shadercross
sdl_ttf
Task List (for lib)
xlib_sdl.dartxlib_sdl_assert.dartPlease use Dart assert.xlib_sdl_asyncio.dartxlib_sdl_atomic.dartNot needed. Dart uses an isolate-based concurrency model.xlib_sdl_audio.dartxlib_sdl_blendmode.dartxlib_sdl_camera.dartxlib_sdl_clipboard.dartxlib_sdl_cpuinfo.dartxlib_sdl_dialog.dartxlib_sdl_error.dartxlib_sdl_events.dartxlib_sdl_filesystem.dartxlib_sdl_gamepad.dartxlib_sdl_gpu.dartxlib_sdl_guid.dartxlib_sdl_haptic.dartxlib_sdl_hidapi.dartxlib_sdl_hints.dartxlib_sdl_image.dartxlib_sdl_init.dartxlib_sdl_iostream.dartxlib_sdl_joystick.dartxlib_sdl_keyboard.dartxlib_sdl_loadso.dartPlease use dart:ffi.xlib_sdl_locale.dartxlib_sdl_log.dartxlib_sdl_main.dartNot supported. SDL3 main callbacks (SDL_AppInit) require compiling a C-level entry point.xlib_sdl_messagebox.dartxlib_sdl_metal.dartxlib_sdl_misc.dartxlib_sdl_mixer.dartxlib_sdl_mouse.dartxlib_sdl_mutex.dartPlease use Dart async utilities or Mutex packages.xlib_sdl_net.dartxlib_sdl_notification.dartxlib_sdl_opengl.dartxlib_sdl_opengl_glext.dartxlib_sdl_openxr.dartNot supported. XR rendering pipelines should be handled directly in native C/C++.xlib_sdl_pen.dartxlib_sdl_pixels.dartxlib_sdl_platform.dartxlib_sdl_power.dartxlib_sdl_process.dartxlib_sdl_properties.dartxlib_sdl_rect.dartxlib_sdl_render.dartxlib_sdl_sensor.dartxlib_sdl_shadercross.dartxlib_sdl_stdinc.dartxlib_sdl_storage.dartxlib_sdl_surface.dartxlib_sdl_system.dartxlib_sdl_thread.dartPlease use Dart Isolates.xlib_sdl_time.dartxlib_sdl_timer.dartxlib_sdl_touch.dartxlib_sdl_tray.dartxlib_sdl_ttf.dartxlib_sdl_version.dartxlib_sdl_video.dartxlib_sdl_vulkan.dart