Struct openxr::Instance

pub struct Instance { /* fields omitted */ }

Methods

impl Instance

pub unsafe fn from_raw(
    entry: Entry,
    handle: Instance,
    exts: InstanceExtensions
) -> Result<Self>

Take ownership of an existing instance handle

Safety

handle must be the instance handle that was used to load exts.

pub fn as_raw(&self) -> Instance

pub fn entry(&self) -> &Entry

Access the entry points used to create self

pub fn fp(&self) -> &Instance

Access the core function pointers

pub fn exts(&self) -> &InstanceExtensions

Access the internal extension function pointers

impl Instance

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

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

pub fn properties(&self) -> Result<InstanceProperties>

pub fn result_to_string(&self, result: Result) -> Result<String>

pub fn structure_type_to_string(&self, ty: StructureType) -> Result<String>

pub fn system(&self, form_factor: FormFactor) -> Result<SystemId>

pub fn system_properties(&self, system: SystemId) -> Result<SystemProperties>

pub unsafe fn string_to_path(&self, string: &str) -> Result<Path>

Construct a Path from a string

Safety

A returned Path must not used with any other instance.

pub fn path_to_string(&self, path: Path) -> Result<String>

pub fn vulkan_instance_extensions(&self, system: SystemId) -> Result<String>

Identify the Vulkan instance extensions required by a system

Returns a space-delimited list of Vulkan instance extension names.

pub fn vulkan_device_extensions(&self, system: SystemId) -> Result<String>

Identify the Vulkan device extensions required by a system

Returns a space-delimited list of Vulkan device extension names.

pub fn vulkan_graphics_device(
    &self,
    system: SystemId,
    vk_instance: VkInstance
) -> Result<VkPhysicalDevice>

Identify the Vulkan graphics device to use for a system

pub fn graphics_requirements<G: Graphics>(
    &self,
    system: SystemId
) -> Result<G::Requirements>

Query graphics API version requirements

pub unsafe fn create_session<G: Graphics>(
    &self,
    system: SystemId,
    info: &G::SessionCreateInfo
) -> Result<(Session<G>, FrameStream<G>)>

Create a session for a particular graphics API

Safety

The requirements documented by the graphics API extension must be respected. Among other requirements, info must contain valid handles, and certain operations must be externally synchronized.

pub fn create_session_headless(
    &self,
    system: SystemId
) -> Result<Session<Headless>>

Create a session without graphics support

pub fn poll_event<'a>(
    &self,
    storage: &'a mut EventDataBuffer
) -> Result<Option<Event<'a>>>

Get the next event, if available

Returns immediately regardless of whether an event was available.

pub fn enumerate_view_configurations(
    &self,
    system: SystemId
) -> Result<Vec<ViewConfigurationType>>

Enumerates the supported view configuration types

pub fn view_configuration_properties(
    &self,
    system: SystemId,
    ty: ViewConfigurationType
) -> Result<ViewConfigurationProperties>

Query properties of an individual view configuration

pub fn enumerate_view_configuration_views(
    &self,
    system: SystemId,
    ty: ViewConfigurationType
) -> Result<Vec<ViewConfigurationView>>

pub fn enumerate_environment_blend_modes(
    &self,
    system: SystemId
) -> Result<Vec<EnvironmentBlendMode>>

pub fn now(&self) -> Result<Time>

Obtain the current Time

Requires KHR_convert_timespec_time