Holds input related functions. More...

#include "util/u_debug.h"
#include "util/u_time.h"
#include "util/u_misc.h"
#include "math/m_vec2.h"
#include "xrt/xrt_compiler.h"
#include "oxr_input.h"
#include "oxr_binding.h"
#include "oxr_pair_hashset.h"
#include "oxr_subaction.h"
#include "oxr_dpad_state.h"
#include "oxr_input_transform.h"
#include "oxr_generated_bindings.h"
#include "../oxr_objects.h"
#include "../oxr_logger.h"
#include "../oxr_handle.h"
#include "../oxr_two_call.h"
#include "../oxr_conversions.h"
#include "../oxr_xret.h"
#include "../oxr_roles.h"
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>

Include dependency graph for oxr_input.c:

Data Structures
struct	oxr_profiles_per_subaction

Macros
#define	PROFILE_MEMBER(X) struct oxr_interaction_profile *X;

#define	PRINT_PROFILE(X) print_profile_to_slog(&slog, store, profiles->X, #X);

#define	ACCUMULATE_SUBACTION_PATHS(X) subaction_paths->X \|= new_subaction_paths->X;

#define	CACHE_TEARDOWN(X) oxr_action_cache_teardown(&(act_attached->X));

#define	IDENTIFY_PATH(X)

#define	GET_POSE_INPUT(X)

#define	PATH_CASE(NAME, NAMECAPS, PATH)

#define	FIND_PROFILE(X)

#define	BIND_SUBACTION(NAME, NAME_CAPS, PATH)

#define	RESET_ANY(NAME) act_attached->any_pose_subaction_path.NAME = false;

#define	POSE_ANY(NAME)

#define	ACCUMULATE_PATHS(X)

#define	ACCUMULATE_PATHS(X) relevant_subactionpath \|= (other_act_set_attached->requested_subaction_paths.X && subaction_path->X);

#define	BOOL_CHECK(NAME) oxr_state_update_bool(&active, &value, &timestamp, &act_attached->NAME.current);

#define	VEC1_CHECK(NAME) oxr_state_update_vec1(&active, &value, &timestamp, &act_attached->NAME.current);

#define	VEC2_CHECK(NAME) oxr_state_update_vec2(&active, &x, &y, &distance, &timestamp, &act_attached->NAME.current);

#define	UPDATE_SELECT(X)

#define	POPULATE_PROFILE(X)

#define	ACCUMULATE_REQUESTED(X) any_action_with_subactionpath \|= subaction_paths.X && act_attached->act_ref->subaction_paths.X;

#define	ACCUMULATE_PATHS(X)

Functions
static void	print_profile_to_slog (struct oxr_sink_logger slog, const struct oxr_path_store store, const struct oxr_interaction_profile profile, const char point)

static void	print_profiles (struct oxr_logger log, const struct oxr_path_store store, const struct oxr_profiles_per_subaction *profiles)

static void	oxr_session_get_action_set_attachment (struct oxr_session sess, XrActionSet actionSet, struct oxr_action_set_attachment act_set_attached, struct oxr_action_set *act_set)

static void	oxr_action_cache_update (struct oxr_logger log, struct oxr_session sess, uint32_t countActionSets, const XrActiveActionSet actionSets, struct oxr_action_attachment act_attached, struct oxr_action_cache cache, int64_t time, struct oxr_subaction_paths subaction_path, bool select, const XrActiveActionSetPrioritiesEXT *active_priorities)

static void	oxr_action_attachment_update (struct oxr_logger log, struct oxr_session sess, uint32_t countActionSets, const XrActiveActionSet actionSets, struct oxr_action_attachment act_attached, int64_t time, struct oxr_subaction_paths subaction_paths, const XrActiveActionSetPrioritiesEXT *active_priorities)

static void	oxr_action_bind_io (struct oxr_logger log, struct oxr_sink_logger slog, const struct oxr_path_store store, const struct oxr_roles roles, const struct oxr_action_ref act_ref, const uint32_t act_set_key, struct oxr_action_cache cache, struct oxr_interaction_profile *profile, enum oxr_subaction_path subaction_path)

void	oxr_action_set_attachment_teardown (struct oxr_action_set_attachment *act_set_attached)

static void	oxr_action_set_ref_destroy_cb (struct oxr_refcounted *orc)

static XrResult	oxr_action_set_destroy_cb (struct oxr_logger log, struct oxr_handle_base hb)

XrResult	oxr_action_set_create (struct oxr_logger log, struct oxr_instance inst, struct oxr_instance_action_context inst_context, const XrActionSetCreateInfo createInfo, struct oxr_action_set **out_act_set)

static void	oxr_action_ref_destroy_cb (struct oxr_refcounted *orc)

static XrResult	oxr_action_destroy_cb (struct oxr_logger log, struct oxr_handle_base hb)

XrResult	oxr_action_create (struct oxr_logger log, struct oxr_action_set act_set, const XrActionCreateInfo createInfo, struct oxr_action *out_act)

bool	oxr_classify_subaction_paths (struct oxr_logger log, const struct oxr_instance inst, uint32_t subaction_path_count, const XrPath subaction_paths, struct oxr_subaction_paths subaction_paths_out)

XrResult	oxr_action_get_pose_input (struct oxr_session sess, uint32_t act_key, const struct oxr_subaction_paths subaction_paths_ptr, struct oxr_action_input **out_input)

static bool	find_xdev_name_from_pairs (const struct xrt_device xdev, const struct xrt_binding_profile xbp, enum xrt_input_name from_name, enum xrt_input_name *out_name)

static bool	do_inputs (struct oxr_binding binding_point, struct xrt_device xdev, struct xrt_binding_profile xbp, XrPath matched_path, struct oxr_action_input inputs[32], uint32_t input_count)

static bool	do_outputs (struct oxr_binding binding_point, struct xrt_device xdev, struct xrt_binding_profile xbp, XrPath matched_path, struct oxr_action_output outputs[32], uint32_t output_count)

static bool	do_io_bindings (struct oxr_binding binding_point, const struct oxr_action_ref act_ref, struct xrt_device xdev, struct xrt_binding_profile xbp, XrPath matched_path, struct oxr_action_input inputs[32], uint32_t input_count, struct oxr_action_output outputs[32], uint32_t output_count)
	Delegate to do_outputs or do_inputs depending on whether the action is output or input.

static struct xrt_binding_profile *	get_matching_binding_profile (struct oxr_interaction_profile profile, struct xrt_device xdev)

static XrPath	get_matched_xrpath (struct oxr_binding b, const struct oxr_action_ref act)

static void	get_binding (struct oxr_logger log, struct oxr_sink_logger slog, const struct oxr_path_store store, const struct oxr_roles roles, const struct oxr_action_ref act_ref, struct oxr_interaction_profile profile, enum oxr_subaction_path subaction_path, struct oxr_action_input inputs[32], uint32_t input_count, struct oxr_action_output outputs[32], uint32_t output_count)

static bool	get_by_name (const struct oxr_interaction_profile_array array, const struct oxr_instance_path_cache cache, enum xrt_device_name name, struct oxr_interaction_profile **out_p)

static bool	get_by_device (const struct oxr_interaction_profile_array array, const struct oxr_instance_path_cache cache, struct xrt_device xdev, struct oxr_interaction_profile *out_p)

static void	find_profiles_from_roles (const struct oxr_instance_path_cache cache, const struct oxr_interaction_profile_array array, const struct oxr_roles roles, struct oxr_profiles_per_subaction out_profiles)

void	oxr_action_cache_stop_output (struct oxr_logger log, struct oxr_session sess, struct oxr_action_cache *cache)

static bool	oxr_input_is_input_for_cache (struct oxr_action_input action_input, struct oxr_action_cache cache)

static bool	oxr_input_is_bound_in_act_set (struct oxr_action_input action_input, struct oxr_action_set_attachment act_set_attached)

static uint32_t	oxr_get_action_set_priority (const struct oxr_action_set_ref act_set_ref, const XrActiveActionSetPrioritiesEXT active_priorities)

static bool	oxr_input_supressed (struct oxr_session sess, uint32_t countActionSets, const XrActiveActionSet actionSets, struct oxr_subaction_paths subaction_path, struct oxr_action_attachment act_attached, struct oxr_action_input action_input, const XrActiveActionSetPrioritiesEXT active_priorities)

static bool	oxr_input_combine_input (struct oxr_session sess, uint32_t countActionSets, const XrActiveActionSet actionSets, struct oxr_action_attachment act_attached, struct oxr_subaction_paths subaction_path, struct oxr_action_cache cache, struct oxr_input_value_tagged out_input, int64_t out_timestamp, bool out_is_active, const XrActiveActionSetPrioritiesEXT *active_priorities)

static bool	oxr_state_equal_bool (const struct oxr_action_state a, const struct oxr_action_state b)

static bool	oxr_state_equal_vec1 (const struct oxr_action_state a, const struct oxr_action_state b)

static bool	oxr_state_equal_vec2 (const struct oxr_action_state a, const struct oxr_action_state b)

static void	oxr_state_update_bool (bool active, bool value, XrTime timestamp, const struct oxr_action_state new_state)

static void	oxr_state_update_vec1 (bool active, float value, XrTime timestamp, const struct oxr_action_state new_state)

static void	oxr_state_update_vec2 (bool active, float x, float y, float distance, XrTime timestamp, const struct oxr_action_state new_state)

static bool	oxr_action_populate_input_transform (struct oxr_logger log, struct oxr_sink_logger slog, const struct oxr_path_store store, const struct oxr_action_ref act_ref, struct oxr_action_input *action_input)
	Try to produce a transform chain to convert the available input into the desired input type.

static bool	find_matching_dpad (const struct oxr_path_store store, struct oxr_dpad_entry dpad_entry, const char bound_path_string, struct oxr_dpad_binding_modification *out_dpad_binding)
	Find dpad settings in `dpad_entry` whose binding path is a prefix of `bound_path_string`.

static bool	oxr_action_populate_input_transform_dpad (struct oxr_logger log, struct oxr_sink_logger slog, const struct oxr_path_store store, const struct oxr_action_ref act_ref, struct oxr_dpad_entry dpad_entry, enum oxr_dpad_region dpad_region, struct oxr_interaction_profile profile, struct oxr_action_input *action_inputs, uint32_t action_input_count, uint32_t selected_input)
	Try to produce a transform chain to create a dpad button from the selected input (potentially using other inputs like `/force` in the process).

static bool	is_dpad_region_for_emulation (const char start, const char end)

static bool	get_dpad_region_from_path (const struct oxr_path_store store, XrPath path, enum oxr_dpad_region out_dpad_region)

void	oxr_session_get_action_attachment (struct oxr_session sess, uint32_t act_key, struct oxr_action_attachment *out_act_attached)

static size_t	oxr_handle_base_get_num_children (struct oxr_handle_base *hb)

XrResult	oxr_session_attach_action_sets (struct oxr_logger log, struct oxr_session sess, const XrSessionActionSetsAttachInfo *bindInfo)

static XrResult	session_update_action_bindings (struct oxr_logger log, struct oxr_instance inst, struct oxr_session sess, const struct oxr_roles roles)

XrResult	oxr_action_sync_data (struct oxr_logger log, struct oxr_session sess, uint32_t countActionSets, const XrActiveActionSet actionSets, const XrActiveActionSetPrioritiesEXT activePriorities)

static void	add_path_to_set (XrPath path_set[32], XrPath new_path, uint32_t *inout_path_count)

XrResult	oxr_action_enumerate_bound_sources (struct oxr_logger log, struct oxr_session sess, uint32_t act_key, uint32_t sourceCapacityInput, uint32_t sourceCountOutput, XrPath sources)

Detailed Description

Holds input related functions.

Author: Jakob Bornecrantz jakob.nosp@m.@col.nosp@m.labor.nosp@m.a.co.nosp@m.m; Korcan Hussein korca.nosp@m.n.hu.nosp@m.ssein.nosp@m.@col.nosp@m.labor.nosp@m.a.co.nosp@m.m

Macro Definition Documentation

◆ ACCUMULATE_PATHS [1/2]

#define ACCUMULATE_PATHS ( X )

Value:

        if (oxr_input_is_input_for_cache(action_input, &act_attached->X)) {                                            \
                return true;                                                                                           \
        }

◆ ACCUMULATE_PATHS [2/2]

#define ACCUMULATE_PATHS ( X )

Value:

        if (act_attached->X.input_count > 0) {                                                                         \
                for (uint32_t i = 0; i < act_attached->X.input_count; i++) {                                           \
                        add_path_to_set(temp, act_attached->X.inputs[i].bound_path, &path_count);                      \
                }                                                                                                      \
        }                                                                                                              \
        if (act_attached->X.output_count > 0) {                                                                        \
                for (uint32_t i = 0; i < act_attached->X.output_count; i++) {                                          \
                        add_path_to_set(temp, act_attached->X.outputs[i].bound_path, &path_count);                     \
                }                                                                                                      \
        }

◆ BIND_SUBACTION

#define BIND_SUBACTION	(	NAME,
		NAME_CAPS,
		PATH
	)

Value:

        if (act_ref->subaction_paths.NAME || act_ref->subaction_paths.any) {                                           \
                oxr_action_bind_io(log, &slog, &inst->path_store, roles, act_ref, act_set_key, &act_attached->NAME,    \
                                   profiles->NAME, OXR_SUB_ACTION_PATH_##NAME_CAPS);                                   \
        }

◆ FIND_PROFILE

#define FIND_PROFILE ( X )

Value:

        if (!get_by_name(array, cache, GET_PROFILE_NAME_BY_ROLE(roles, X), &out_profiles->X)) {                        \
                struct xrt_device *xdev = GET_XDEV_BY_ROLE(roles, X);                                                  \
                if (xdev != NULL) {                                                                                    \
                        get_by_device(array, cache, xdev, &out_profiles->X);                                           \
                }                                                                                                      \
        }

◆ GET_POSE_INPUT

#define GET_POSE_INPUT ( X )

Value:

        if (act_attached->X.current.active && subaction_paths.X) {                                                     \
                *out_input = act_attached->X.inputs;                                                                   \
                return XR_SUCCESS;                                                                                     \
        }

◆ IDENTIFY_PATH

#define IDENTIFY_PATH ( X )

Value:

        else if (path == cache->X)                                                                                     \
        {                                                                                                              \
                subaction_paths_out->X = true;                                                                         \
        }

◆ PATH_CASE

#define PATH_CASE	(	NAME,
		NAMECAPS,
		PATH
	)

Value:

        case OXR_SUB_ACTION_PATH_##NAMECAPS:                                                                           \
                user_path_str = PATH;                                                                                  \
                xdev = GET_XDEV_BY_ROLE(roles, NAME);                                                                  \
                break;

◆ POPULATE_PROFILE

#define POPULATE_PROFILE ( X )

Value:

        do {                                                                                                           \
                XrPath path = profiles.X != NULL ? profiles.X->path : XR_NULL_PATH;                                    \
                if (path == XR_NULL_PATH) {                                                                            \
                        break; /* Only update on "active" interaction profiles per sub-action path. */                 \
                }                                                                                                      \
                if (sess->X != path) {                                                                                 \
                        sess->X = path;                                                                                \
                        oxr_event_push_XrEventDataInteractionProfileChanged(log, sess);                                \
                }                                                                                                      \
        } while (false);

◆ POSE_ANY

#define POSE_ANY ( NAME )

Value:

        if ((act_ref->subaction_paths.NAME || act_ref->subaction_paths.any) && act_attached->NAME.input_count > 0) {   \
                act_attached->any_pose_subaction_path.NAME = true;                                                     \
                oxr_slog(&slog, "\tFor: <any>\n\t\tBinding any pose to " #NAME ".\n");                                 \
        } else

◆ UPDATE_SELECT

#define UPDATE_SELECT ( X )

Value:

        struct oxr_subaction_paths subaction_paths_##X = {0};                                                          \
        subaction_paths_##X.X = true;                                                                                  \
        bool select_##X = subaction_paths.X || subaction_paths.any;                                                    \
        oxr_action_cache_update(log, sess, countActionSets, actionSets, act_attached, &act_attached->X, time,          \
                                &subaction_paths_##X, select_##X, active_priorities);

Function Documentation

◆ do_io_bindings()

static bool do_io_bindings	(	struct oxr_binding *	binding_point,
		const struct oxr_action_ref *	act_ref,
		struct xrt_device *	xdev,
		struct xrt_binding_profile *	xbp,
		XrPath	matched_path,
		struct oxr_action_input	inputs[32],
		uint32_t *	input_count,
		struct oxr_action_output	outputs[32],
		uint32_t *	output_count
	)

static

Delegate to do_outputs or do_inputs depending on whether the action is output or input.

References oxr_action_ref::action_type.

Referenced by get_binding().

◆ find_matching_dpad()

static bool find_matching_dpad	(	const struct oxr_path_store *	store,
		struct oxr_dpad_entry *	dpad_entry,
		const char *	bound_path_string,
		struct oxr_dpad_binding_modification **	out_dpad_binding
	)

static

Find dpad settings in dpad_entry whose binding path is a prefix of bound_path_string.

Returns: true if settings were found and written to out_dpad_settings

Referenced by oxr_action_populate_input_transform_dpad().

◆ get_binding()

static void get_binding	(	struct oxr_logger *	log,
		struct oxr_sink_logger *	slog,
		const struct oxr_path_store *	store,
		const struct oxr_roles *	roles,
		const struct oxr_action_ref *	act_ref,
		struct oxr_interaction_profile *	profile,
		enum oxr_subaction_path	subaction_path,
		struct oxr_action_input	inputs[32],
		uint32_t *	input_count,
		struct oxr_action_output	outputs[32],
		uint32_t *	output_count
	)

static

Todo:: This probably falls on its head if the application doesn't use sub action paths.

Lookup device binding that matches the interactive profile, this is used as a fallback should the device not match the interactive profile. This allows the device to provide a mapping from one device to itself.

References oxr_action_ref::act_key, ARRAY_SIZE, do_io_bindings(), xrt_device::name, oxr_binding_find_bindings_from_act_key(), OXR_FOR_EACH_VALID_SUBACTION_PATH_DETAILED, xrt_device::str, and oxr_interaction_profile::xname.

◆ oxr_action_populate_input_transform()

static bool oxr_action_populate_input_transform	(	struct oxr_logger *	log,
		struct oxr_sink_logger *	slog,
		const struct oxr_path_store *	store,
		const struct oxr_action_ref *	act_ref,
		struct oxr_action_input *	action_input
	)

static

Try to produce a transform chain to convert the available input into the desired input type.

Populates action_input->transforms and action_input->transform_count on success.

Returns: false if it could not, true if it could

References oxr_action_ref::action_type, oxr_action_ref::name, and XRT_GET_INPUT_TYPE.

◆ oxr_action_populate_input_transform_dpad()

static bool oxr_action_populate_input_transform_dpad	(	struct oxr_logger *	log,
		struct oxr_sink_logger *	slog,
		const struct oxr_path_store *	store,
		const struct oxr_action_ref *	act_ref,
		struct oxr_dpad_entry *	dpad_entry,
		enum oxr_dpad_region	dpad_region,
		struct oxr_interaction_profile *	profile,
		struct oxr_action_input *	action_inputs,
		uint32_t	action_input_count,
		uint32_t	selected_input
	)

static

Try to produce a transform chain to create a dpad button from the selected input (potentially using other inputs like /force in the process).

Populates action_input->transforms and action_input->transform_count on success.

Returns: false if it could not, true if it could

References oxr_action_ref::action_type, find_matching_dpad(), and XRT_GET_INPUT_TYPE.

◆ oxr_action_sync_data()

XrResult oxr_action_sync_data	(	struct oxr_logger *	log,
		struct oxr_session *	sess,
		uint32_t	countActionSets,
		const XrActiveActionSet *	actionSets,
		const XrActiveActionSetPrioritiesEXT *	activePriorities
	)

Todo:: can be listed more than once with different paths!

todo This validation is not allowed here, must done above.

References oxr_action_set_attachment::act_attachments, oxr_action_attachment::act_set_attached, oxr_session::act_set_attachments, oxr_action_set_attachment::action_attachment_count, oxr_session::action_set_attachment_count, oxr_action_set::data, oxr_session::dynamic_roles_generation_id, oxr_action_set_ref::name, oxr_action_sync_data(), OXR_CHECK_XRET, oxr_error(), OXR_FOR_EACH_SUBACTION_PATH, oxr_roles_init_on_stack(), oxr_action_set_attachment::requested_subaction_paths, oxr_roles::roles, oxr_action_set_attachment::sess, oxr_action_attachment::sess, oxr_session::sync_actions_mutex, U_ZERO, xrt_system_devices::xdev_count, xrt_system_devices::xdevs, XRT_STRUCT_INIT, and oxr_system::xsysd.

Referenced by oxr_action_sync_data(), and oxr_xrSyncActions().

Data Structures

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ ACCUMULATE_PATHS [1/2]

◆ ACCUMULATE_PATHS [2/2]

◆ BIND_SUBACTION

◆ FIND_PROFILE

◆ GET_POSE_INPUT

◆ IDENTIFY_PATH

◆ PATH_CASE

◆ POPULATE_PROFILE

◆ POSE_ANY

◆ UPDATE_SELECT

Function Documentation

◆ do_io_bindings()

◆ find_matching_dpad()

◆ get_binding()

◆ oxr_action_populate_input_transform()

◆ oxr_action_populate_input_transform_dpad()

◆ oxr_action_sync_data()