Struct CallbackImageSource

pub struct CallbackImageSource<Fa, Fp>
where
    Fa: FnMut() -> OpenXrHostResult<OpenXrImageFrame<FrameToken>> + Send,
    Fp: FnMut(FrameToken) -> OpenXrHostResult<()> + Send,
{ /* private fields */ }

Convenience source helper for custom runtime glue.

Both callbacks are serialized independently. Callback failures are returned to the target; a poisoned callback mutex is converted to the matching host error variant.

Examples

use ailloli_ui_openxr::{CallbackImageSource, OpenXrHostResult, OpenXrImageFrame};
use ailloli_ui_render::render_target::PhysicalExtent;
let _source = CallbackImageSource::new(
    PhysicalExtent::new(1024, 1024),
    wgpu::TextureFormat::Rgba8Unorm,
    || -> OpenXrHostResult<OpenXrImageFrame<u64>> { panic!("provided by host") },
    |_token| Ok(()),
);

Implementations

impl<Fa, Fp> CallbackImageSource<Fa, Fp>

where Fa: FnMut() -> OpenXrHostResult<OpenXrImageFrame<FrameToken>> + Send, Fp: FnMut(FrameToken) -> OpenXrHostResult<()> + Send,

pub fn new( size: PhysicalExtent, format: TextureFormat, acquire: Fa, present: Fp, ) -> Self

Creates a callback source with fixed physical size and texture format.

The callbacks are not invoked by this constructor. acquire must return a texture matching size and format; present receives its token.

Examples

use ailloli_ui_openxr::{CallbackImageSource, OpenXrHostResult, OpenXrImageFrame};
use ailloli_ui_render::render_target::PhysicalExtent;
let source = CallbackImageSource::new(
    PhysicalExtent::new(800, 600),
    wgpu::TextureFormat::Bgra8Unorm,
    || -> OpenXrHostResult<OpenXrImageFrame<u64>> { panic!() },
    |_token| Ok(()),
);
assert_eq!(ailloli_ui_openxr::OpenXrImageSource::size(&source).width, 800);

Trait Implementations

impl<Fa, Fp> OpenXrImageSource for CallbackImageSource<Fa, Fp>

where Fa: FnMut() -> OpenXrHostResult<OpenXrImageFrame<FrameToken>> + Send, Fp: FnMut(FrameToken) -> OpenXrHostResult<()> + Send,

type FrameToken = u64

Token that identifies an acquired image until presentation.

type TextureFormat = TextureFormat

Backend texture-format value returned by Self::format.

fn size(&self) -> PhysicalExtent

Returns the physical pixel extent of future acquired textures.

fn format(&self) -> TextureFormat

Returns the format of future acquired textures.

fn acquire(&self) -> OpenXrHostResult<OpenXrImageFrame<Self::FrameToken>>

Acquires one writable texture and its presentation token.

fn present(&self, token: Self::FrameToken) -> OpenXrHostResult<()>

Presents or releases the image identified by token.

fn pre_present_notify(&self)

Notifies the source immediately before renderer presentation work.