Struct openxr::Session

pub struct Session<G> { /* fields omitted */ }

A rendering session using a particular graphics API G

Convertible into an API-agnostic session using Session::into_any_graphics.

Implementations

impl<G> Session<G>

pub fn as_raw(&self) -> Session

Access the raw session handle

pub fn instance(&self) -> &Instance

Access the Instance self is descended from

pub fn set_name(&mut self, name: &str) -> Result<()>

Set the debug name of this Session, if XR_EXT_debug_utils is loaded

pub fn begin(&self, ty: ViewConfigurationType) -> Result<Result>

Request that the runtime show the application’s rendered output to the user

pub fn begin_with_secondary(
    &self,
    ty: ViewConfigurationType,
    secondary: &[ViewConfigurationType]
) -> Result<Result>

Request that the runtime show the application’s rendered output to the user, if XR_MSFT_secondary_view_configuration is loaded

pub fn request_exit(&self) -> Result<()>

Request a transition to SessionState::STOPPING so that end may be called.

pub fn end(&self) -> Result<Result>

Terminate a session in the SessionState::STOPPING state

See request_exit for active sessions.

pub fn reference_space_bounds_rect(
    &self,
    ty: ReferenceSpaceType
) -> Result<Option<Extent2Df>>

pub fn enumerate_reference_spaces(&self) -> Result<Vec<ReferenceSpaceType>>

Enumerate the set of reference space types supported for this session

Constant for the lifetime of the session.

pub fn create_reference_space(
    &self,
    reference_space_type: ReferenceSpaceType,
    pose_in_reference_space: Posef
) -> Result<Space>

Creates a Space based on a chosen reference space

pub fn locate_views(
    &self,
    view_configuration_type: ViewConfigurationType,
    display_time: Time,
    space: &Space
) -> Result<(ViewStateFlags, Vec<View>)>

Get the view and projection info for a particular display time

When rendering, this should be called as late as possible before the GPU accesses it to provide the most accurate possible poses.

pub fn current_interaction_profile(
    &self,
    top_level_user_path: Path
) -> Result<Path>

Get the suggested interaction profile in use for a top level user path

May be NULL.

pub fn attach_action_sets(&self, sets: &[&ActionSet]) -> Result<()>

Enable use of action sets with a session

Once attached, action sets become immutable.

pub fn sync_actions(&self, action_sets: &[ActiveActionSet<'_>]) -> Result<()>

Designate active input actions and update their states

pub fn input_source_localized_name(
    &self,
    source: Path,
    which_components: InputSourceLocalizedNameFlags
) -> Result<String>

Get a name for the input source in the current system locale

pub fn get_visibility_mask_khr(
    &self,
    view_configuration_type: ViewConfigurationType,
    view_index: u32,
    visibility_mask_type: VisibilityMaskTypeKHR
) -> Result<VisibilityMask>

Get a mesh describing the visible area of a view

Requires KHR_visibility_mask. Useful to skip shading fragments the user can’t see.

See also the VisibilityMaskChangedKHR event.

pub fn create_hand_tracker(&self, hand: Hand) -> Result<HandTracker>

Create a hand tracker

Requires XR_EXT_hand_tracking

pub fn enumerate_color_spaces(&self) -> Result<Vec<ColorSpaceFB>>

Enumerate the list of supported color spaces for [set_color_space]

Requires XR_FB_color_space

pub fn set_color_space(&self, color_space: ColorSpaceFB) -> Result<()>

Specify the color space used in the final rendered frame

Requires XR_FB_color_space

pub fn into_any_graphics(self) -> Session<AnyGraphics>

Convert into a graphics API agnostic session

Useful for applications which support multiple graphics APIs, but don’t want G parameters everywhere.

impl<G: Graphics> Session<G>

pub unsafe fn from_raw(
    instance: Instance,
    handle: Session
) -> (Self, FrameWaiter, FrameStream<G>)

Take ownership of an existing session handle

Safety

handle must be a valid session handle associated with instance which is not currently inside a frame and was created for graphics API G.

pub fn enumerate_swapchain_formats(&self) -> Result<Vec<G::Format>>

Enumerate texture formats supported by the current session

The type of formats returned is dependent on the graphics API for which the session was created.

pub fn create_swapchain(
    &self,
    info: &SwapchainCreateInfo<G>
) -> Result<Swapchain<G>>

Trait Implementations

impl<G> Clone for Session<G>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.