SDL3 display, input, and filesystem integration
Repository: github.com/dekiengine/deki-sdl3-integration · Latest release: 0.19.0 · Needs engine 0.19.0+ · Requires: deki-input
Install with DekiEditor --packages-add deki-sdl3-integration <project>, or from the Package Manager. The engine's own components and C++ API are in the Deki docs.
Shown in the editor as SDL3 Integration.
Components
| Component | Category | Description |
|---|---|---|
| SDL3DisplaySetup | SDL3 | Opens the desktop window the game renders into. |
| SDL3InputSetup | SDL3 | Feeds desktop keyboard and mouse input to the engine. |
Feature flags
Parts you can leave out of a build. A feature with a define is switched there; the rest are stripped with their components.
| Feature | Define | Default |
|---|---|---|
| Display | — | on |
| Input | — | on |
Component reference
SDL3DisplaySetup
Opens the desktop window the game renders into.
Inspector name: SDL3 Display Setup · Category: SDL3 · Type: DekiSdl3::SDL3DisplaySetup
| Property | Type | Default | Constraints | Description |
|---|---|---|---|---|
| windowScale | int32 | 2 | 1 to 8 | How many window pixels show one screen pixel. The screen's size is the target platform's. |
SDL3InputSetup
Feeds desktop keyboard and mouse input to the engine.
Inspector name: SDL3 Input Setup · Category: SDL3 · Type: DekiSdl3::SDL3InputSetup
| Property | Type | Default | Description |
|---|---|---|---|
| enableKeyboard | bool | true | Enable keyboard input |
| enableMouse | bool | true | Enable mouse/pointer input |
Changelog
0.19.0
Changed
- minEngine 0.19.0: built against engine 0.19.0, whose component metadata records the package each class is in. A build of this package from before does not load and is rebuilt.
Added
- Japanese, Simplified Chinese and Korean: editor/lang/ja.json, zh.json and ko.json translate the names, tooltips and enum values this package's components show in the Inspector.
0.18.0
Changed
- minEngine 0.18.0. Reflection ABI 21: the package must be rebuilt.
- Names follow the code style (deki-engine/docs/codestyle): types, functions and enum values are PascalCase, constants kPascalCase, members m_PascalCase, locals and parameters camelCase. The code is formatted with clang-format 22.
- The functions the editor finds by name are PascalCase: DekiSDL3RegisterComponents, DekiSDL3GetAutoComponentCount, DekiSDL3EnsureRegistered and the rest. Built against engine ABI 21; a build of this package from before does not load and is rebuilt.
Removed
- The former names from before 0.16.0 (bare class names, and deki-gpio's DekiEsp32::ESP32PinSetup). A scene that old is upgraded with 0.17 first.
Earlier releases: CHANGELOG.md.
Generated from the package's reflection data (engine 0.19.0). Property names are the keys used in scene files. Renames keep an alias (compatibility).
