1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
#pragma once
#include <array>
#include "camera/camera.h"
struct OpenXRTrackingInfo {
struct OpenXREyeInfo {
vec3d offset;
matrix orientation;
fov_t zoom; //zoom, not fov! difference of a factor of PROJ_FOV_FACTOR
};
std::array<OpenXREyeInfo, 2> eyes;
};
/**
* @brief Performs required Setup actions for OpenXR before actually trying to initialize the graphics
* @param hudscale Sets the scale at which the HUD is rendered. May need to be tweakable to make the hud visible to players with small FoV
*/
void openxr_prepare(float hudscale = 0.5f);
/**
* @brief Initializes the OpenXR API and opens the XR system
* @param req_ar The aspect ratio as specified by the user resolution
* @param scale Controls the scale of the OpenXR coordinates. This mainly affects eye distance and how far real movement translates to ingame movement
* @returns the expected aspect ratio of the swapchain
*/
float openxr_preinit(float req_ar, float scale = 1.0f);
/**
* @brief Opens an OpenXR session to the point that we can render. As this waits for OpenXR, this may take a while
*/
void openxr_init();
/**
* @brief Shuts down OpenXR and cleans up memory
*/
void openxr_close();
/**
* @brief Polls OpenXR state. Does NOT poll HMD position!
*/
void openxr_poll();
/**
* @brief Grabs the last known HMD position and sets it as the zero-state (whereever the specified eyepoint is in mission / ship), as well as initializing buffers for the mission
*/
void openxr_start_mission();
/**
* @brief Polls whether OpenXR is active and can render
*/
bool openxr_enabled();
/**
* @brief Polls whether OpenXR is requested to start. Required if you need to poll for OpenXR during some initialization where it might not yet be running
*/
bool openxr_requested();
/**
* @brief Polls HMD position and sets up the OpenXR state machine to wait for and accept two frames, one for each eye.
* You must ensure that after calling this, the next two gr_flip() calls correspond to the frames for each eye!
* @returns The HMD tracking data including position and rotation in FSO coordinates.
*/
OpenXRTrackingInfo openxr_start_stereo_frame();
|
