OpenXRActionMap (original) (raw)

Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Inherits: Resource < RefCounted < Object

Collection of OpenXRActionSet and OpenXRInteractionProfile resources for the OpenXR module.

Description

OpenXR uses an action system similar to Godots Input map system to bind inputs and outputs on various types of XR controllers to named actions. OpenXR specifies more detail on these inputs and outputs than Godot supports.

Another important distinction is that OpenXR offers no control over these bindings. The bindings we register are suggestions, it is up to the XR runtime to offer users the ability to change these bindings. This allows the XR runtime to fill in the gaps if new hardware becomes available.

The action map therefore needs to be loaded at startup and can't be changed afterwards. This resource is a container for the entire action map.

Properties

Methods

void add_action_set(action_set: OpenXRActionSet)
void add_interaction_profile(interaction_profile: OpenXRInteractionProfile)
void create_default_action_sets()
OpenXRActionSet find_action_set(name: String) const
OpenXRInteractionProfile find_interaction_profile(name: String) const
OpenXRActionSet get_action_set(idx: int) const
int get_action_set_count() const
OpenXRInteractionProfile get_interaction_profile(idx: int) const
int get_interaction_profile_count() const
void remove_action_set(action_set: OpenXRActionSet)
void remove_interaction_profile(interaction_profile: OpenXRInteractionProfile)

Property Descriptions

Array action_sets = [] 🔗

Collection of OpenXRActionSets that are part of this action map.


Array interaction_profiles = [] 🔗

Collection of OpenXRInteractionProfiles that are part of this action map.


Method Descriptions

void add_action_set(action_set: OpenXRActionSet) 🔗

Add an action set.


void add_interaction_profile(interaction_profile: OpenXRInteractionProfile) 🔗

Add an interaction profile.


void create_default_action_sets() 🔗

Setup this action set with our default actions.


OpenXRActionSet find_action_set(name: String) const 🔗

Retrieve an action set by name.


OpenXRInteractionProfile find_interaction_profile(name: String) const 🔗

Find an interaction profile by its name (path).


OpenXRActionSet get_action_set(idx: int) const 🔗

Retrieve the action set at this index.


int get_action_set_count() const 🔗

Retrieve the number of actions sets in our action map.


OpenXRInteractionProfile get_interaction_profile(idx: int) const 🔗

Get the interaction profile at this index.


int get_interaction_profile_count() const 🔗

Retrieve the number of interaction profiles in our action map.


void remove_action_set(action_set: OpenXRActionSet) 🔗

Remove an action set.


void remove_interaction_profile(interaction_profile: OpenXRInteractionProfile) 🔗

Remove an interaction profile.