|
Monado OpenXR Runtime
|
A rift HMD device. More...
#include <rift/rift_internal.h>


Data Fields | ||
| struct xrt_device | base | |
| enum u_logging_level | log_level | |
| struct m_relation_history * | relation_hist | |
| struct os_hid_device * | hmd_dev | |
| struct os_hid_device * | radio_dev | |
| struct os_thread_helper | sensor_thread | |
| bool | processed_sample_packet | |
| uint32_t | last_remote_sample_time_us | |
| timepoint_ns | last_remote_sample_time_ns | |
| timepoint_ns | last_sample_local_timestamp_ns | |
| struct m_imu_3dof | fusion | |
| struct m_clock_windowed_skew_tracker * | clock_tracker | |
| timepoint_ns | last_keepalive_time | |
| enum rift_variant | variant | |
| struct rift_config_report | config | |
| struct rift_display_info_report | display_info | |
| const struct rift_lens_distortion * | lens_distortions | |
| uint16_t | num_lens_distortions | |
| uint16_t | distortion_in_use | |
| struct rift_extra_display_info | extra_display_info | |
| float | icd_override_m | |
| bool | presence | |
| bool | imu_needs_calibration | |
| struct rift_imu_calibration | imu_calibration | |
| uint8_t | radio_address [5] | |
| struct os_mutex | device_mutex | |
| Mutex to protect access to the device array, device count == -1 means uninitialized. | ||
| int | device_count | |
| int | added_devices | |
| struct xrt_device * | devices [4] | |
| struct { | ||
| struct os_thread_helper thread | ||
| struct rift_touch_controller * touch_controllers [3] | ||
| struct rift_remote * remote | ||
| enum rift_radio_command current_command | ||
| union rift_radio_command_data command_data | ||
| } | radio_state | |
| Generic state for the radio state machine. | ||
Data Fields inherited from xrt_device | ||
| enum xrt_device_name | name | |
| Enum identifier of the device. | ||
| enum xrt_device_type | device_type | |
| char | str [256] | |
| A string describing the device. | ||
| char | serial [256] | |
| A unique identifier. Persistent across configurations, if possible. | ||
| struct xrt_hmd_parts * | hmd | |
| Null if this device does not interface with the users head. | ||
| struct xrt_tracking_origin * | tracking_origin | |
| Always set, pointing to the tracking system for this device. | ||
| size_t | binding_profile_count | |
| Number of bindings in xrt_device::binding_profiles. | ||
| struct xrt_binding_profile * | binding_profiles | |
| size_t | input_count | |
| Number of inputs. | ||
| struct xrt_input * | inputs | |
| Array of input structs. | ||
| size_t | output_count | |
| Number of outputs. | ||
| struct xrt_output * | outputs | |
| Array of output structs. | ||
| struct xrt_device_supported | supported | |
| What features/functions/things does this device supports? | ||
| xrt_result_t(* | update_inputs )(struct xrt_device *xdev) | |
| Update any attached inputs. | ||
| xrt_result_t(* | get_tracked_pose )(struct xrt_device *xdev, enum xrt_input_name name, int64_t at_timestamp_ns, struct xrt_space_relation *out_relation) | |
| Get relationship of a tracked device to the tracking origin space as the base space. | ||
| xrt_result_t(* | get_hand_tracking )(struct xrt_device *xdev, enum xrt_input_name name, int64_t desired_timestamp_ns, struct xrt_hand_joint_set *out_value, int64_t *out_timestamp_ns) | |
| Get relationship of hand joints to the tracking origin space as the base space. | ||
| xrt_result_t(* | get_face_tracking )(struct xrt_device *xdev, enum xrt_input_name facial_expression_type, int64_t at_timestamp_ns, struct xrt_facial_expression_set *out_value) | |
| Get the requested blend shape properties & weights for a face tracker. | ||
| xrt_result_t(* | get_face_calibration_state_android )(struct xrt_device *xdev, bool *out_face_is_calibrated) | |
| Gets the face tracking calibration state. | ||
| xrt_result_t(* | get_body_skeleton )(struct xrt_device *xdev, enum xrt_input_name body_tracking_type, struct xrt_body_skeleton *out_value) | |
| Get the body skeleton in T-pose, used to query the skeleton hierarchy, scale, proportions etc. | ||
| xrt_result_t(* | get_body_joints )(struct xrt_device *xdev, enum xrt_input_name body_tracking_type, int64_t desired_timestamp_ns, struct xrt_body_joint_set *out_value) | |
| Get the joint locations for a body tracker. | ||
| xrt_result_t(* | reset_body_tracking_calibration_meta )(struct xrt_device *xdev) | |
| XR_META_body_tracking_calibration - body tracking extension to reset the body tracking calibration. | ||
| xrt_result_t(* | set_body_tracking_calibration_override_meta )(struct xrt_device *xdev, float new_body_height) | |
| XR_META_body_tracking_calibration - body tracking extension to suggest a body tracking calibration override. | ||
| xrt_result_t(* | set_output )(struct xrt_device *xdev, enum xrt_output_name name, const struct xrt_output_value *value) | |
| Set a output value. | ||
| xrt_result_t(* | get_output_limits )(struct xrt_device *xdev, struct xrt_output_limits *limits) | |
| Gets limits of this devices outputs. | ||
| xrt_result_t(* | get_presence )(struct xrt_device *xdev, bool *presence) | |
| Get current presence status of the device. | ||
| xrt_result_t(* | begin_plane_detection_ext )(struct xrt_device *xdev, const struct xrt_plane_detector_begin_info_ext *begin_info, uint64_t plane_detection_id, uint64_t *out_plane_detection_id) | |
| Begin a plane detection request. | ||
| xrt_result_t(* | destroy_plane_detection_ext )(struct xrt_device *xdev, uint64_t plane_detection_id) | |
| Destroy internal resources associated with plane_detector_id. | ||
| xrt_result_t(* | get_plane_detection_state_ext )(struct xrt_device *xdev, uint64_t plane_detection_id, enum xrt_plane_detector_state_ext *out_state) | |
| Get the state of a plane detection request. | ||
| xrt_result_t(* | get_plane_detections_ext )(struct xrt_device *xdev, uint64_t plane_detection_id, struct xrt_plane_detections_ext *out_detections) | |
| Get results of a plane detection request. | ||
| xrt_result_t(* | get_view_poses )(struct xrt_device *xdev, const struct xrt_vec3 *default_eye_relation, int64_t at_timestamp_ns, enum xrt_view_type view_type, uint32_t view_count, struct xrt_space_relation *out_head_relation, struct xrt_fov *out_fovs, struct xrt_pose *out_poses) | |
| Get the per-view pose in relation to the view space. | ||
| xrt_result_t(* | compute_distortion )(struct xrt_device *xdev, uint32_t view, float u, float v, struct xrt_uv_triplet *out_result) | |
| Compute the distortion at a single point. | ||
| xrt_result_t(* | get_visibility_mask )(struct xrt_device *xdev, enum xrt_visibility_mask_type type, uint32_t view_index, struct xrt_visibility_mask **out_mask) | |
| Get the visibility mask for this device. | ||
| xrt_result_t(* | ref_space_usage )(struct xrt_device *xdev, enum xrt_reference_space_type type, enum xrt_input_name name, bool used) | |
| Called by the xrt_space_overseer when a reference space that is implemented by this device is first used, or when the last usage of the reference space stops. | ||
| bool(* | is_form_factor_available )(struct xrt_device *xdev, enum xrt_form_factor form_factor) | |
| Check if given form factor is available or not. | ||
| xrt_result_t(* | get_battery_status )(struct xrt_device *xdev, bool *out_present, bool *out_charging, float *out_charge) | |
| Get battery status information. | ||
| xrt_result_t(* | get_brightness )(struct xrt_device *xdev, float *out_brightness) | |
| Get the current display brightness. | ||
| xrt_result_t(* | set_brightness )(struct xrt_device *xdev, float brightness, bool relative) | |
| Set the display brightness. | ||
| xrt_result_t(* | get_compositor_info )(struct xrt_device *xdev, const struct xrt_device_compositor_mode *mode, struct xrt_device_compositor_info *out_info) | |
| Gets the compositor info for a device for the given mode. | ||
| xrt_result_t(* | begin_feature )(struct xrt_device *xdev, enum xrt_device_feature_type type) | |
| Enable the feature for this device. | ||
| xrt_result_t(* | end_feature )(struct xrt_device *xdev, enum xrt_device_feature_type type) | |
| Disable the feature for this device. | ||
| void(* | destroy )(struct xrt_device *xdev) | |
| Destroy device. | ||
Additional Inherited Members | |
Static Public Member Functions inherited from xrt_device | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_update_inputs (struct xrt_device *xdev) |
| Helper function for xrt_device::update_inputs. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_tracked_pose (struct xrt_device *xdev, enum xrt_input_name name, int64_t at_timestamp_ns, struct xrt_space_relation *out_relation) |
| Helper function for xrt_device::get_tracked_pose. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_hand_tracking (struct xrt_device *xdev, enum xrt_input_name name, int64_t desired_timestamp_ns, struct xrt_hand_joint_set *out_value, int64_t *out_timestamp_ns) |
| Helper function for xrt_device::get_hand_tracking. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_face_tracking (struct xrt_device *xdev, enum xrt_input_name facial_expression_type, int64_t at_timestamp_ns, struct xrt_facial_expression_set *out_value) |
| Helper function for xrt_device::get_face_tracking. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_face_calibration_state_android (struct xrt_device *xdev, bool *out_face_is_calibrated) |
| Helper function for xrt_device::get_face_calibration_state_android. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_body_skeleton (struct xrt_device *xdev, enum xrt_input_name body_tracking_type, struct xrt_body_skeleton *out_value) |
| Helper function for xrt_device::get_body_skeleton. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_body_joints (struct xrt_device *xdev, enum xrt_input_name body_tracking_type, int64_t desired_timestamp_ns, struct xrt_body_joint_set *out_value) |
| Helper function for xrt_device::get_body_joints. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_reset_body_tracking_calibration_meta (struct xrt_device *xdev) |
| Helper function for xrt_device::reset_body_tracking_calibration_meta. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_set_body_tracking_calibration_override_meta (struct xrt_device *xdev, float new_body_height) |
| Helper function for xrt_device::set_body_tracking_calibration_override_meta. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_set_output (struct xrt_device *xdev, enum xrt_output_name name, const struct xrt_output_value *value) |
| Helper function for xrt_device::set_output. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_presence (struct xrt_device *xdev, bool *presence) |
| Helper function for xrt_device::get_presence. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_begin_plane_detection_ext (struct xrt_device *xdev, const struct xrt_plane_detector_begin_info_ext *begin_info, uint64_t plane_detection_id, uint64_t *out_plane_detection_id) |
| Helper function for xrt_device::begin_plane_detection_ext. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_destroy_plane_detection_ext (struct xrt_device *xdev, uint64_t plane_detection_id) |
| Helper function for xrt_device::destroy_plane_detection_ext. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_plane_detection_state_ext (struct xrt_device *xdev, uint64_t plane_detection_id, enum xrt_plane_detector_state_ext *out_state) |
| Helper function for xrt_device::get_plane_detections_ext. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_plane_detections_ext (struct xrt_device *xdev, uint64_t plane_detection_id, struct xrt_plane_detections_ext *out_detections) |
| Helper function for xrt_device::get_plane_detections_ext. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_view_poses (struct xrt_device *xdev, const struct xrt_vec3 *default_eye_relation, int64_t at_timestamp_ns, enum xrt_view_type view_type, uint32_t view_count, struct xrt_space_relation *out_head_relation, struct xrt_fov *out_fovs, struct xrt_pose *out_poses) |
| Helper function for xrt_device::get_view_poses. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_compute_distortion (struct xrt_device *xdev, uint32_t view, float u, float v, struct xrt_uv_triplet *out_result) |
| Helper function for xrt_device::compute_distortion. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_visibility_mask (struct xrt_device *xdev, enum xrt_visibility_mask_type type, uint32_t view_index, struct xrt_visibility_mask **out_mask) |
| Helper function for xrt_device::get_visibility_mask. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_ref_space_usage (struct xrt_device *xdev, enum xrt_reference_space_type type, enum xrt_input_name name, bool used) |
| Helper function for xrt_device::ref_space_usage. | |
| static XRT_NONNULL_ALL bool | xrt_device_is_form_factor_available (struct xrt_device *xdev, enum xrt_form_factor form_factor) |
| Helper function for xrt_device::is_form_factor_available. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_battery_status (struct xrt_device *xdev, bool *out_present, bool *out_charging, float *out_charge) |
| Helper function for xrt_device::get_battery_status. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_brightness (struct xrt_device *xdev, float *out_brightness) |
| Helper function for xrt_device::get_brightness. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_set_brightness (struct xrt_device *xdev, float brightness, bool relative) |
| Helper function for xrt_device::set_brightness. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_get_compositor_info (struct xrt_device *xdev, const struct xrt_device_compositor_mode *mode, struct xrt_device_compositor_info *out_info) |
| Helper function for xrt_device::get_compositor_info. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_begin_feature (struct xrt_device *xdev, enum xrt_device_feature_type type) |
| Helper function for xrt_device::begin_feature. | |
| static XRT_NONNULL_ALL xrt_result_t | xrt_device_end_feature (struct xrt_device *xdev, enum xrt_device_feature_type type) |
| Helper function for xrt_device::end_feature. | |
| static XRT_NONNULL_ALL void | xrt_device_destroy (struct xrt_device **xdev_ptr) |
| Helper function for xrt_device::destroy. | |
| static xrt_result_t | ipc_client_xdev_get_plane_detection_state_ext (struct xrt_device *xdev, uint64_t plane_detection_id, enum xrt_plane_detector_state_ext *out_state) |
| Helper function for xrt_device::get_plane_detection_state_ext. | |
| static xrt_result_t | ipc_client_xdev_get_plane_detections_ext (struct xrt_device *xdev, uint64_t plane_detection_id, struct xrt_plane_detections_ext *out_detections) |
| Helper function for xrt_device::get_plane_detections_ext. | |
Related Symbols inherited from xrt_device | |
| void | u_distortion_mesh_fill_in_compute (struct xrt_device *xdev) |
Given a xrt_device generates meshes by calling xdev->compute_distortion(), populates xdev->hmd_parts.distortion.mesh & xdev->hmd_parts.distortion.models. | |
| void | u_distortion_mesh_fill_in_none (struct xrt_device *xdev) |
Given a xrt_device generates a no distortion mesh, populates xdev->hmd_parts.distortion.mesh & xdev->hmd_parts.distortion.models. | |
| void | u_distortion_mesh_set_none (struct xrt_device *xdev) |
Given a xrt_device generates a no distortion mesh, also sets xdev->compute_distortion() and populates xdev->hmd_parts.distortion.mesh & xdev->hmd_parts.distortion.models. | |
A rift HMD device.
| struct os_mutex rift_hmd::device_mutex |
Mutex to protect access to the device array, device count == -1 means uninitialized.
| struct { ... } rift_hmd::radio_state |
Generic state for the radio state machine.