libgoatvr

annotate src/vr.h @ 32:7eea82cea9d2

added preliminary support for quad-buffer stereo fallback drawing
author John Tsiombikas <nuclear@member.fsf.org>
date Fri, 30 Oct 2015 06:12:48 +0200
parents 437fe32ac633
children 1102327fe85f
rev   line source
nuclear@0 1 #ifndef VR_H_
nuclear@0 2 #define VR_H_
nuclear@0 3
nuclear@8 4 /* unit: pixels */
nuclear@11 5 #define VR_DISPLAY_WIDTH "display-xres"
nuclear@11 6 #define VR_DISPLAY_HEIGHT "display-yres"
nuclear@11 7 #define VR_LEYE_XRES "left-eye-xres"
nuclear@11 8 #define VR_LEYE_YRES "left-eye-yres"
nuclear@11 9 #define VR_REYE_XRES "right-eye-xres"
nuclear@11 10 #define VR_REYE_YRES "right-eye-yres"
nuclear@16 11 #define VR_RENDER_XRES "render-xres" /* VR_LEYE_XRES + VR_REYE_XRES */
nuclear@16 12 #define VR_RENDER_YRES "render-yres" /* max(VR_LEYE_YRES, VR_REYE_YRES) */
nuclear@11 13 #define VR_WIN_XOFFS "win-xoffset"
nuclear@11 14 #define VR_WIN_YOFFS "win-yoffset"
nuclear@16 15 #define VR_RENDER_RES_SCALE "render-res-scale" /* default 1 */
nuclear@8 16 /* unit: meters */
nuclear@11 17 #define VR_EYE_HEIGHT "eye-height"
nuclear@11 18 #define VR_IPD "ipd"
nuclear@19 19 #define VR_LEYE_OFFSET "left-eye-offset" /* stereo offset from center of the head */
nuclear@19 20 #define VR_REYE_OFFSET "right-eye-offset" /* stereo offset from center of the head */
nuclear@17 21 /* misc options */
nuclear@32 22 #define VR_NULL_STEREO_SBS "null-stereo-sbs" /* bool, default 0: draw side-by-side */
nuclear@32 23 #define VR_NULL_STEREO_GL "null-stereo-gl" /* bool, default 0: use quad-buffer stereo */
nuclear@0 24
nuclear@0 25 enum {
nuclear@0 26 VR_EYE_LEFT,
nuclear@0 27 VR_EYE_RIGHT
nuclear@0 28 };
nuclear@0 29
nuclear@0 30 #ifdef __cplusplus
nuclear@0 31 extern "C" {
nuclear@0 32 #endif
nuclear@0 33
nuclear@0 34 int vr_init(void);
nuclear@0 35 void vr_shutdown(void);
nuclear@0 36
nuclear@0 37 int vr_module_count(void);
nuclear@0 38 const char *vr_module_name(int idx);
nuclear@0 39
nuclear@0 40 int vr_use_module(int idx);
nuclear@0 41 int vr_use_module_named(const char *name);
nuclear@0 42
nuclear@11 43 void vr_seti(const char *optname, int val);
nuclear@11 44 void vr_setf(const char *optname, float val);
nuclear@11 45 int vr_geti(const char *optname);
nuclear@11 46 float vr_getf(const char *optname);
nuclear@19 47 float *vr_getfv(const char *optname, float *res);
nuclear@12 48 /* variants of the get functions, with an additional "default value"
nuclear@12 49 * argument, which is returned if the requested option is missing
nuclear@12 50 */
nuclear@12 51 int vr_geti_def(const char *optname, int def_val);
nuclear@12 52 float vr_getf_def(const char *optname, float def_val);
nuclear@0 53
nuclear@0 54 int vr_view_translation(int eye, float *vec);
nuclear@0 55 int vr_view_rotation(int eye, float *quat);
nuclear@0 56
nuclear@0 57 /* returns non-zero if the active vr module provides this kind of matrix
nuclear@0 58 * information, otherwise it returns zero, and sets mat to identity
nuclear@0 59 */
nuclear@0 60 int vr_view_matrix(int eye, float *mat);
nuclear@0 61 int vr_proj_matrix(int eye, float znear, float zfar, float *mat);
nuclear@0 62
nuclear@0 63 void vr_begin(int eye);
nuclear@0 64 void vr_end(void);
nuclear@0 65 int vr_swap_buffers(void);
nuclear@0 66
nuclear@0 67 /* set the output texture or separate textures for each eye */
nuclear@0 68 void vr_output_texture(unsigned int tex, float umin, float vmin, float umax, float vmax);
nuclear@0 69 void vr_output_texture_eye(int eye, unsigned int tex, float umin, float vmin, float umax, float vmax);
nuclear@0 70
nuclear@0 71 void vr_recenter(void);
nuclear@0 72
nuclear@0 73 #ifdef __cplusplus
nuclear@0 74 }
nuclear@0 75 #endif
nuclear@0 76
nuclear@0 77 #endif /* VR_H_ */