sdl3-main 0.5.1

Tools for using SDL's main and callback APIs
Documentation
sdl3-main-0.5.1 has been yanked.

sdl3-main

This crate provides tools for using SDL 3's main and callback APIs.

SDL main

To provide your own main but call it through SDL, use the main attribute macro. See the documentation for that for more information.

Callback API

To use the SDL callback API, you can use either the app_impl attribute macro, or all four of the app_init, app_iterate, app_event and app_quit attribute macros. Don't use the main attribute macro in this mode. See the documentation for more information.

Features

Feature Description
alloc Enable features that require allocation (enabled by default)
std Enable features that require the standard library (enabled by default)
nightly Enable the ? operator to convert Result::Err and Option::None to AppResult*::Failure
use-parking-lot-v0-12 Support parking_lot 0.12 locks in app state accessors

Recent changes

  • 0.5.1:

    • Fix unsoundness in run_async_on_main_thread
    • Don't allocate in run_async_on_main_thread unless it's necessary

  • 0.5.0:

    • Update sdl3-sys to 0.5.0
    • Add optional parking_lot integration
    • Add run_{sync,async}_on_main_thread and MainThreadData::get[_mut]_on_main_thread
    • impl Copy for MainThreadToken
    • impl FromResidual for AppResult* on nightly

See ChangeLog.md for older changes