Expand description
Portable semantic UI documents and explicit per-view presentation routing. Portable semantic UI documents and per-view presentation routing.
This module describes what an assistant or scene wants to present. Platform
adapters own pixels, graphics handles, eye textures, input devices, and room
tracking implementations. A PresentationPlan makes every target view
explicit so a stereo adapter cannot accidentally present one monoscopic
dialog for both eyes.
Structs§
- Presentation
Context - Adapter-owned resolved spatial state needed to construct a presentation plan.
- Presentation
Plan - Validated mapping of one semantic document onto every view of a target.
- Resolved
Room Anchor - A room anchor resolved by a presentation adapter before plan construction.
- Room
Anchor Id - Identifier for a tracked room anchor supplied by an adapter.
- UiAction
Id - Opaque application action identifier carried by UI events.
- UiDocument
- One semantic UI document, independent of a device’s view or graphics APIs.
- UiDocument
Id - Owned identifier for a semantic UI document.
- UiEvent
- Input reported by a platform adapter for a specific document revision.
- UiNode
- A typed node in a flat semantic UI document.
- UiNode
Id - Owned identifier for a node within a UI document.
- UiResource
Id - Opaque identifier for an adapter-resolved image resource.
- Validated
UiEvent - Event proven to target an enabled node in the displayed document revision.
- View
Route - A centrally produced routing instruction for one adapter view.
- Viewport
- A positive, half-open rectangular region in adapter-defined logical pixels.
Enums§
- Device
Target - Adapter-declared presentation topology.
- Presentation
Error - Rejection reason for presentation documents, topology, or input.
- Resolved
UiPlacement - Placement ready for a renderer after all required room anchors are resolved.
- UiEvent
Action - Typed user input accepted only by a matching node role.
- UiNavigation
- Direction for deterministic focus navigation.
- UiNode
Kind - Semantic role and typed values of a UI node.
- UiPlacement
- Placement requested by a semantic UI document.
- View
Identity - A named target view; it has no platform graphics handle.
Constants§
- MAX_
UI_ ID_ BYTES - Maximum UTF-8 byte length of a UI identifier, action, or resource name.
- MAX_
UI_ NODES - Maximum nodes accepted in one portable UI document.
- MAX_
UI_ TEXT_ BYTES - Maximum UTF-8 byte length of visible UI text or text input value.