Struct OpenXrUiLayer

pub struct OpenXrUiLayer<A> { /* private fields */ }

Headless Ailloli runtime and lazy Vulkan renderer for an OpenXR UI layer.

The renderer is allocated on the first frame, while runtime reconciliation is performed during construction. Actions accumulate until Self::take_actions.

Examples

use ailloli_ui_openxr::OpenXrUiLayer;
fn clear<A: 'static>(layer: &mut OpenXrUiLayer<A>) { layer.clear_input(); }

Implementations

impl<A: 'static> OpenXrUiLayer<A>

pub fn new( runtime_handle: RuntimeHandle<A>, root: impl IntoView<A>, options: OpenXrUiLayerOptions, ) -> Result<Self, OpenXrRuntimeError>

Reconciles the root view and prepares a lazy renderer.

Errors

The current constructor performs no fallible Vulkan work, but returns the runtime error type so initialization can remain uniform with future setup.

Examples

use ailloli_ui_openxr::{OpenXrRuntimeError, OpenXrUiLayer, OpenXrUiLayerOptions};
use ailloli_ui_runtime::{app::RuntimeHandle, component::IntoView};
fn create<A: 'static>(handle: RuntimeHandle<A>, root: impl IntoView<A>) -> Result<OpenXrUiLayer<A>, OpenXrRuntimeError> { OpenXrUiLayer::new(handle, root, OpenXrUiLayerOptions::default()) }

pub fn layout_paint_render( &mut self, frame: OpenXrExternalHostFrame<'_>, ) -> Result<VulkanRendererStats, OpenXrRuntimeError>

Lays out, routes optional input, paints, and renders one Vulkan frame.

Layout is tight to Self::logical_size. The first call allocates the renderer. Pointer events are routed before paint; None retains existing pointer/focus state. Text face blobs are refreshed before rendering.

Errors

Returns Vulkan renderer initialization or frame-render errors.

Panics

Panics only if successful renderer initialization fails to populate the layer’s internal renderer slot.

Examples

use ailloli_ui_openxr::{OpenXrExternalHostFrame, OpenXrRuntimeError, OpenXrUiLayer};
use ailloli_ui_render_vulkan::VulkanRendererStats;
fn render<A: 'static>(layer: &mut OpenXrUiLayer<A>, frame: OpenXrExternalHostFrame<'_>) -> Result<VulkanRendererStats, OpenXrRuntimeError> { layer.layout_paint_render(frame) }

pub fn clear_input(&mut self)

Cancels captured pointer gestures, then clears mapper and keyboard focus.

Examples

use ailloli_ui_openxr::OpenXrUiLayer;
fn clear<A: 'static>(layer: &mut OpenXrUiLayer<A>) { layer.clear_input(); }

pub fn take_actions(&self) -> Vec<A>

Drains and returns actions queued by the reconciled runtime.

An empty vector means no action was dispatched since the previous drain.

Examples

use ailloli_ui_openxr::OpenXrUiLayer;
fn actions<A: 'static>(layer: &OpenXrUiLayer<A>) -> Vec<A> { layer.take_actions() }

pub fn renderer_stats(&self) -> VulkanRendererStats

Returns the latest renderer counters or zeroed defaults before first frame.

Examples

use ailloli_ui_openxr::OpenXrUiLayer;
use ailloli_ui_render_vulkan::VulkanRendererStats;
fn stats<A: 'static>(layer: &OpenXrUiLayer<A>) -> VulkanRendererStats { layer.renderer_stats() }

pub fn logical_size(&self) -> Size

Returns physical pixels divided by DPR as logical dimensions.

DPR is clamped to at least 0.0001; pixel axes are otherwise unmodified, so zero pixels produce zero logical extent.

Examples

use ailloli_ui_core::Size;
use ailloli_ui_openxr::OpenXrUiLayer;
fn size<A: 'static>(layer: &OpenXrUiLayer<A>) -> Size { layer.logical_size() }