mirror of
https://gitlab.freedesktop.org/monado/monado.git
synced 2025-01-11 17:35:27 +00:00
136 lines
3.5 KiB
C
136 lines
3.5 KiB
C
// Copyright 2019-2021, Collabora, Ltd.
|
|
// SPDX-License-Identifier: BSL-1.0
|
|
/*!
|
|
* @file
|
|
* @brief Misc helpers for device drivers.
|
|
* @author Jakob Bornecrantz <jakob@collabora.com>
|
|
* @author Ryan Pavlik <ryan.pavlik@collabora.com>
|
|
* @ingroup aux_util
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "xrt/xrt_compiler.h"
|
|
#include "xrt/xrt_device.h"
|
|
#include "xrt/xrt_tracking.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
extern const struct xrt_matrix_2x2 u_device_rotation_right;
|
|
extern const struct xrt_matrix_2x2 u_device_rotation_left;
|
|
extern const struct xrt_matrix_2x2 u_device_rotation_ident;
|
|
extern const struct xrt_matrix_2x2 u_device_rotation_180;
|
|
|
|
enum u_device_alloc_flags
|
|
{
|
|
// clang-format off
|
|
U_DEVICE_ALLOC_NO_FLAGS = 0,
|
|
U_DEVICE_ALLOC_HMD = 1 << 0,
|
|
U_DEVICE_ALLOC_TRACKING_NONE = 1 << 1,
|
|
// clang-format on
|
|
};
|
|
|
|
struct u_device_simple_info
|
|
{
|
|
struct
|
|
{
|
|
uint32_t w_pixels;
|
|
uint32_t h_pixels;
|
|
float w_meters;
|
|
float h_meters;
|
|
} display;
|
|
|
|
float lens_horizontal_separation_meters;
|
|
float lens_vertical_position_meters;
|
|
|
|
struct
|
|
{
|
|
float fov;
|
|
} views[2];
|
|
};
|
|
|
|
/*!
|
|
* Setup the device information given a very simple info struct.
|
|
*
|
|
* @return true on success.
|
|
* @ingroup aux_util
|
|
*/
|
|
bool
|
|
u_device_setup_split_side_by_side(struct xrt_device *xdev, const struct u_device_simple_info *info);
|
|
|
|
/*!
|
|
* Dump the device config to stderr.
|
|
*
|
|
* @ingroup aux_util
|
|
*/
|
|
void
|
|
u_device_dump_config(struct xrt_device *xdev, const char *prefix, const char *prod);
|
|
|
|
#define U_DEVICE_ALLOCATE(type, flags, num_inputs, num_outputs) \
|
|
((type *)u_device_allocate(flags, sizeof(type), num_inputs, num_outputs))
|
|
|
|
|
|
/*!
|
|
* Helper function to allocate a device plus inputs in the same allocation
|
|
* placed after the device in memory.
|
|
*
|
|
* Will setup any pointers and num values.
|
|
*
|
|
* @ingroup aux_util
|
|
*/
|
|
void *
|
|
u_device_allocate(enum u_device_alloc_flags flags, size_t size, size_t num_inputs, size_t num_outputs);
|
|
|
|
/*!
|
|
* Helper function to free a device and any data hanging of it.
|
|
*
|
|
* @ingroup aux_util
|
|
*/
|
|
void
|
|
u_device_free(struct xrt_device *xdev);
|
|
|
|
|
|
#define XRT_DEVICE_ROLE_UNASSIGNED (-1)
|
|
|
|
/*!
|
|
* Helper function to assign head, left hand and right hand roles.
|
|
*
|
|
* @ingroup aux_util
|
|
*/
|
|
void
|
|
u_device_assign_xdev_roles(struct xrt_device **xdevs, size_t num_xdevs, int *head, int *left, int *right);
|
|
|
|
/*!
|
|
* Helper function for setting up tracking origins. Applies 3dof offsets for devices with XRT_TRACKING_TYPE_NONE.
|
|
*
|
|
* @ingroup aux_util
|
|
*/
|
|
void
|
|
u_device_setup_tracking_origins(struct xrt_device *head,
|
|
struct xrt_device *left,
|
|
struct xrt_device *right,
|
|
struct xrt_vec3 *global_tracking_origin_offset);
|
|
|
|
/*!
|
|
* Helper function for `get_view_pose` in an HMD driver.
|
|
*
|
|
* Takes in a translation from the left to right eye, and returns a center to left or right eye transform that assumes
|
|
* the eye relation is symmetrical around the tracked point ("center eye"). Knowing IPD is a subset of this: If you know
|
|
* IPD better than the overall Monado system, copy @p eye_relation and put your known IPD in @p real_eye_relation->x
|
|
*
|
|
* If you have rotation, apply it after calling this function.
|
|
*
|
|
* @param eye_relation 3D translation from left eye to right eye.
|
|
* @param view_index 0 for left, 1 for right.
|
|
* @param out_pose The output pose to populate. Will receive translation, with an identity rotation.
|
|
*/
|
|
void
|
|
u_device_get_view_pose(const struct xrt_vec3 *eye_relation, uint32_t view_index, struct xrt_pose *out_pose);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|