How adsgames/asw works
ASW is a C++ SDL3 wrapper for game developers, with support for browser builds. A game initializes the runtime, handles input and actions, loads assets, and uses display/drawing and audio APIs to present interactive content. The library also provides lighting, particles, scene/game helpers, dialogs, and a widget-based UI. The source index shows several runtime call sites; other capability links below are documented by the README or are left dashed where implementation connections were not sampled.
Main entry points: core.cpp Core lifecycle · root.cpp UI root · input.cpp Input devices · display.cpp Window display
Components 26
Runtime and Configuration
- Core lifecycle
src/modules/core.cpp - Runtime config
src/modules/config.cpp - Browser runtime hooks
web/asw-web.js
Graphics and Assets
- Window display
src/modules/display.cpp - 2D drawing
src/modules/draw.cpp - Asset loading
src/modules/assets.cpp - Camera
src/modules/camera.cpp - Geometry types
src/modules/geometry.cpp - Color utilities
include/asw/modules/color.h - Lighting
src/modules/lighting.cpp
Input and UI
- Input devices
src/modules/input.cpp - Action mapping
src/modules/action.cpp - UI root
src/modules/ui/root.cpp - Focus context
src/modules/ui/context.cpp - Widget base
src/modules/ui/widget.cpp - UI layout
src/modules/ui/layout.cpp - UI theme
src/modules/ui/theme.cpp - UI controls
include/asw/modules/ui
Game Services
- Sound playback
src/modules/sound.cpp - Particles
src/modules/particles.cpp - Scene helpers
include/asw/modules/scene.h - Game helpers
include/asw/modules/game.h - Dialogs
src/modules/dialog.cpp
Other components
- Game developer
- Game application
- Browser
Connections 34
- Game developer → Game application: builds with
- Game application → Core lifecycle: initializes
- Core lifecycle → Runtime config: loads
src/modules/core.cpp - Core lifecycle → Window display: initializes
src/modules/core.cpp - Core lifecycle → Input devices: initializes
src/modules/core.cpp - Core lifecycle → Asset loading: clears
src/modules/core.cpp - Core lifecycle → Sound playback: initializes
src/modules/core.cpp - Game application → Input devices: reads
- Game application → Action mapping: maps
- Input devices → Window display: queries
src/modules/input.cpp - Asset loading → Window display: uses renderer
src/modules/assets.cpp - 2D drawing → Window display: draws through
src/modules/draw.cpp - Lighting → Asset loading: loads assets
src/modules/lighting.cpp - Lighting → 2D drawing: renders with
src/modules/lighting.cpp - Game application → Camera: positions view
- Game application → Lighting: uses
- Game application → Particles: uses
- Game application → Scene helpers: organizes scenes
- Game application → Game helpers: uses
- Game application → Dialogs: opens
- Game application → Sound playback: plays audio
- UI root → Input devices: reads events
src/modules/ui/root.cpp - UI root → 2D drawing: renders with
src/modules/ui/root.cpp - UI root → Sound playback: uses audio
src/modules/ui/root.cpp - UI root → Focus context: manages focus
- UI root → Widget base: traverses tree
- Focus context → UI theme: holds theme
- Focus context → Widget base: focuses
- UI layout → Widget base: lays out
- UI controls → Widget base: extends
src/modules/ui/widget.cpp - Game application → UI root: presents UI
- Game developer → Runtime config: sets options
- Game developer → Browser runtime hooks: configures build
- Browser runtime hooks → Browser: reports status