Expand description
winit integration for Ailloli UI: event loop, windows, input, GPU bootstrap, capture.
This crate wires [ailloli_ui_runtime] to [winit] and [ailloli_ui_render_wgpu]. Application code
typically uses ailloli_ui::App; lower-level integrations can use
WinitHost around UiApp, or run_app with a specialized custom
[winit::application::ApplicationHandler].
§Modules
| Module | Role |
|---|---|
ui_app | Retained multi-window UI state (layout → paint → render) |
host | Sole high-level ApplicationHandler and provider-neutral driver bridge |
window | WindowOptions and window creation helpers |
event_loop / application | Event loop construction and run_app |
capture | WGPU readback hooks for tests and tooling |
resize | Surface resize coalescing before redraw |
wgpu_bootstrap | Create [ailloli_ui_render_wgpu::Renderer] from a winit window |
Re-exports§
pub use application::run_app;pub use capture::crop_captured_frame;pub use capture::strip_png_if_disabled;pub use capture::CaptureError;pub use capture::CaptureHandle;pub use capture::CaptureRequest;pub use capture::CaptureRequestId;pub use capture::CaptureResult;pub use capture::CaptureTarget;pub use capture::FrameCaptureHook;pub use capture::FrameCaptureResult;pub use event_loop::new_event_loop;pub use event_loop::new_event_loop_allow_any_thread;pub use event_loop::run_app_on_event_loop;pub use external_url::SystemExternalUrlOpener;pub use host::run_winit_host;pub use host::HostDriver;pub use host::HostOutcome;pub use host::NoopHostDriver;pub use host::WinitHost;pub use native_overlay::NativeCalibrationMarkerGuard;pub use native_overlay::NativeCalibrationMarkerPixel;pub use native_overlay::NativeCalibrationMarkerSpec;pub use native_overlay::NativeOutputDescriptor;pub use native_overlay::NativeOutputProbeService;pub use native_overlay::NativeOutputScale;pub use native_overlay::NativeOutputTransform;pub use native_overlay::NativeOverlayBackend;pub use native_overlay::NativeOverlayCapabilities;pub use native_overlay::NativeOverlayError;pub use native_overlay::NativeOverlayInputMode;pub use native_overlay::NativeOverlayOptions;pub use native_overlay::NativeOverlayRect;pub use native_overlay::NativeOverlayTarget;pub use ui_app::PresentationTestFault;pub use ui_app::PresentationTestState;pub use ui_app::UiApp;pub use ui_app::UiAppError;pub use wgpu_bootstrap::detach_renderer_surface;pub use wgpu_bootstrap::reattach_renderer_to_window;pub use wgpu_bootstrap::renderer_from_window;pub use wgpu_bootstrap::renderer_from_window_with_options;pub use window::create_window;pub use window::create_window_before_run;pub use window::window_attributes;pub use window::WindowOptions;
Modules§
- application
- Shared application entry: builds an event loop and runs the handler. Shared winit application loop entry for binaries and examples.
- capture
- Frame capture for visual tests and agent tooling. Low-level one-shot renderer hook and thread-safe declarative capture queue.
- clipboard
- Native clipboard (
arboard) for the runtime. Native system clipboard for the Ailloli UI runtime. - cursor
- System cursor mapping (future
CursorStylebridge). System cursor: future mapping from runtimeCursorStyletowinit::window::CursorIcon. - devtools
- Optional inspector window and loopback JSONL command service. In-process developer-tools overlay and loopback JSONL remote bridge.
- dpi
- DPI and physical size helpers.
DPI and physical size helpers aligned with
ailloli_ui_core. - event_
loop - Event loop helpers and Linux Ctrl+C shutdown.
winit event loop construction and
ApplicationHandlerexecution. - external_
url - Native browser handoff for validated external URLs. Platform browser handoff for already validated HTTP(S) URLs.
- host
- Provider-neutral application logic hosted by winit. Provider-neutral application driver hosted by the winit event loop.
- native_
overlay - Native overlay surfaces and output calibration on supported platforms. Portable native_overlay contracts and Linux backend selection.
- platform
- OS-specific winit extensions.
Platform-specific winit glue. Low-level windowing without winit stays in
windowing::platform. - resize
- Deferred GPU surface resize before redraw. Coalesces wgpu surface resize before redraw (handles defer/retry).
- ui_app
- Retained multi-window UI state owned by the host adapter. Retained multi-window UI state serviced by the winit host adapter.
- wgpu_
bootstrap - GPU renderer construction from a window.
Create a [
ailloli_ui_render_wgpu::Renderer] from a winit window. - window
- Window attributes and creation.
Window creation: all paths go through
window_attributes/create_window. - window_
chrome_ resize - Client-side resize edges when OS decorations are off.
Interactive resize without OS decorations: logical border +
Window::drag_resize_window.
Structs§
- Completed
Run - Successfully published benchmark artifact.
Enums§
- Bench
Init Error - Failure while creating a benchmark session.
- Bench
Write Error - Failure while recording or finalizing a benchmark run.
Functions§
- init_
ailloli_ ui_ bench_ from_ env Deprecated - Historical append-only benchmark initialization.
- popup_
backend_ capabilities - Popup backends available from the current winit adapter.
- try_
init_ ailloli_ ui_ bench_ from_ env - Starts a reliable JSONL benchmark session when
AILLOLI_UI_BENCH=1.