Fove SDK
v1.1.0
|
This file contains the entire FOVE API, no other headers are needed. More...
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
Classes | |
struct | Fove_AdapterId |
Struct used to identify a GPU adapter (Windows only) More... | |
struct | Fove_BitmapImage |
A 2D bitmap image. More... | |
struct | Fove_BoundingBox |
A bounding box. More... | |
struct | Fove_Buffer |
A generic memory buffer. More... | |
struct | Fove_CalibrationData |
Provide all the calibration data needed to render the current state of the calibration process. More... | |
struct | Fove_CalibrationOptions |
Parameters specifying how to run a calibration process. More... | |
struct | Fove_CalibrationTarget |
Represent a calibration target of the calibration process. More... | |
struct | Fove_CameraObject |
Represents a camera in a 3D world. More... | |
struct | Fove_ColliderCube |
Define a cube collider shape. More... | |
struct | Fove_ColliderMesh |
Define a mesh collider shape. More... | |
struct | Fove_ColliderSphere |
Define a sphere collider shape. More... | |
struct | Fove_CompositorLayer |
Struct used to store information about an existing compositor layer (after it is created) More... | |
struct | Fove_CompositorLayerCreateInfo |
Struct used to define the settings for a compositor client. More... | |
struct | Fove_CompositorLayerEyeSubmitInfo |
Struct used to conglomerate the texture settings for a single eye, when submitting a given layer. More... | |
struct | Fove_CompositorLayerSubmitInfo |
Struct used to conglomerate the texture settings when submitting a given layer. More... | |
struct | Fove_CompositorTexture |
Base class of API-specific texture classes. More... | |
struct | Fove_DX11Texture |
Struct used to submit a DirectX 11 texture. More... | |
struct | Fove_EyeShape |
Specify the shape of an eye. More... | |
struct | Fove_FrameTimestamp |
A frame timestamp information. More... | |
struct | Fove_GazableObject |
Represents an object in a 3D world. More... | |
struct | Fove_GLTexture |
Struct used to submit an OpenGL texture. More... | |
struct | Fove_HeadsetHardwareInfo |
Struct Contains hardware information for the headset. More... | |
struct | Fove_Matrix44 |
Struct to hold a rectangular array. More... | |
struct | Fove_MetalTexture |
Struct used to submit a texture using the Apple Metal API. More... | |
struct | Fove_ObjectCollider |
Represents a colliding part of a gazable object. More... | |
struct | Fove_ObjectPose |
Represents the pose of an object of the scene. More... | |
struct | Fove_Pose |
Struct to represent a combination of position and orientation of Fove Headset. More... | |
struct | Fove_ProjectionParams |
Struct holding information about projection frustum planes. More... | |
struct | Fove_PupilShape |
Specity the shape of a pupil as an ellipse. More... | |
struct | Fove_Quaternion |
Struct representation on a quaternion. More... | |
struct | Fove_Ray |
Struct to represent a Ray. More... | |
struct | Fove_TextureBounds |
Specify a region of a texture in normalized space. More... | |
struct | Fove_Vec2 |
Struct to represent a 2D-vector. More... | |
struct | Fove_Vec2i |
Struct to represent a 2D-vector of integers. More... | |
struct | Fove_Vec3 |
Struct to represent a 3D-vector. More... | |
struct | Fove_Versions |
Struct to list various version info about the FOVE software. More... | |
struct | Fove_VulkanContext |
Struct to represent a suite of vulkan components to be used for texture submission. More... | |
struct | Fove_VulkanTexture |
struct | Fove_VulkanTextureResources |
Struct to hold handles to resources for a texture. More... | |
Macros | |
#define | FOVE_CALLBACK |
Defines any needed modifiers to function pointers for callbacks, e.g. to use a different calling convention. | |
#define | FOVE_CONSTEXPR const |
Helper for declaring a compile time constant. | |
#define | FOVE_DEFINE_CXX_API 0 |
Macro that controls whether the C++ API will be defined. More... | |
#define | FOVE_DEPRECATED(func, rem) func |
Helper for declaring deprecated functions. | |
#define | FOVE_ENUM(enumName) typedef enum |
Helper to start an API enum. | |
#define | FOVE_ENUM_END(enumName) Fove_ ## enumName |
Helper to finish an API enum. | |
#define | FOVE_ENUM_VAL(enumName, valueName) Fove_ ## enumName ## _ ## valueName |
Helper to add a value to an API enum. | |
#define | FOVE_EXPORT FOVE_EXTERN_C |
Helper for declaring the public visibility of a function. | |
#define | FOVE_EXTERN_C |
Helper for disabling name mangling, etc. | |
#define | FOVE_NOEXCEPT |
Define this to empty to remove noexcept specifiers from the API. | |
#define | FOVE_STRUCT(structName) typedef struct |
Helper to start an API struct. | |
#define | FOVE_STRUCT_END(structName) Fove_ ## structName |
Helper to complete an API struct. | |
#define | FOVE_STRUCT_END_NO_CXX_ALIAS(structName) Fove_ ## structName |
Helper to complete an API struct without aliasing it in C++. | |
#define | FOVE_STRUCT_VAL(memberName, defaultVal) memberName |
Helper to add a member to an API struct. | |
Typedefs | |
typedef struct Fove_Compositor_ * | Fove_Compositor |
Opaque type representing a compositor connection. | |
typedef struct Fove_Headset_ * | Fove_Headset |
Opaque type representing a headset object. | |
typedef struct VkDevice_T * | Fove_VkDevice |
Opaque type representing a vulkan logical device (It must have VK_KHR_external_memory and VK_KHR_external_memory_fd enabled) | |
typedef struct VkDeviceMemory_T * | Fove_VkDeviceMemory |
Opaque type representing a vulkan device memory region. | |
typedef struct VkImage_T * | Fove_VkImage |
Opaque type representing a vulkan image. | |
typedef struct VkImageView_T * | Fove_VkImageView |
Opaque type representing a vulkan image view. | |
typedef struct VkInstance_T * | Fove_VkInstance |
Opaque type representing a vulkan instance. | |
typedef struct VkPhysicalDevice_T * | Fove_VkPhysicalDevice |
Opaque type representing a vulkan physical device. | |
typedef struct VkQueue_T * | Fove_VkQueue |
Opaque type representing a vulkan queue. | |
Functions | |
Fove_ErrorCode | fove_Compositor_createLayer (Fove_Compositor *, const Fove_CompositorLayerCreateInfo *layerInfo, Fove_CompositorLayer *outLayer) |
Creates a new layer within the compositor. More... | |
Fove_ErrorCode | fove_Compositor_destroy (Fove_Compositor *) |
Frees resources used by the compositor object, including memory and sockets. More... | |
Fove_ErrorCode | fove_Compositor_getAdapterId (Fove_Compositor *, Fove_AdapterId *outAdapterId) |
Returns the ID of the GPU currently attached to the headset. More... | |
Fove_ErrorCode | fove_Compositor_getLastRenderPose (Fove_Compositor *, Fove_Pose *outPose) |
Get the last cached pose for rendering purposes. | |
Fove_ErrorCode | fove_Compositor_isReady (Fove_Compositor *, bool *outIsReady) |
Returns true if we are connected to a running compositor and ready to submit frames for compositing. | |
Fove_ErrorCode | fove_Compositor_submit (Fove_Compositor *, const Fove_CompositorLayerSubmitInfo *submitInfo, size_t layerCount) |
Submit a frame to the compositor. More... | |
Fove_ErrorCode | fove_Compositor_waitForRenderPose (Fove_Compositor *, Fove_Pose *outPose) |
Wait for the most recent pose for rendering purposes. More... | |
Fove_ErrorCode | fove_Config_clearValue (const char *key) |
Reset the value of the provided key to its default value. More... | |
Fove_ErrorCode | fove_Config_getValue_bool (const char *key, bool *outValue) |
Get the value of the provided key from the FOVE config. More... | |
Fove_ErrorCode | fove_Config_getValue_float (const char *key, float *outValue) |
Get the value of the provided key from the FOVE config. More... | |
Fove_ErrorCode | fove_Config_getValue_int (const char *key, int *outValue) |
Get the value of the provided key from the FOVE config. More... | |
Fove_ErrorCode | fove_Config_getValue_string (const char *key, void(*callback)(const char *value, void *callbackData), void *callbackData) |
Get the value of the provided key from the FOVE config. More... | |
Fove_ErrorCode | fove_Config_setValue_bool (const char *key, bool value) |
Set the value of the provided key to the FOVE config. More... | |
Fove_ErrorCode | fove_Config_setValue_float (const char *key, float value) |
Set the value of the provided key to the FOVE config. More... | |
Fove_ErrorCode | fove_Config_setValue_int (const char *key, int value) |
Set the value of the provided key to the FOVE config. More... | |
Fove_ErrorCode | fove_Config_setValue_string (const char *key, const char *value) |
Set the value of the provided key to the FOVE config. More... | |
Fove_ErrorCode | fove_createHeadset (Fove_ClientCapabilities capabilities, Fove_Headset **outHeadset) |
Creates and returns an Fove_Headset object, which is the entry point to the entire API. More... | |
Fove_ErrorCode | fove_Headset_checkSoftwareVersions (Fove_Headset *) |
Checks whether the client can run against the installed version of the FOVE SDK. More... | |
Fove_ErrorCode | fove_Headset_createCompositor (Fove_Headset *, Fove_Compositor **outCompositor) |
Returns a compositor interface from the given headset. More... | |
Fove_ErrorCode | fove_Headset_createProfile (Fove_Headset *, const char *newName) |
Creates a new profile. More... | |
Fove_ErrorCode | fove_Headset_deleteProfile (Fove_Headset *, const char *profileName) |
Deletes an existing profile. More... | |
Fove_ErrorCode | fove_Headset_destroy (Fove_Headset *) |
Frees resources used by a headset object, including memory and sockets. More... | |
Fove_ErrorCode | fove_Headset_fetchEyeTrackingData (Fove_Headset *, Fove_FrameTimestamp *outTimestamp) |
Fetch the latest eye tracking related data from runtime service. More... | |
Fove_ErrorCode | fove_Headset_fetchPoseData (Fove_Headset *, Fove_FrameTimestamp *outTimestamp) |
Fetch the latest headset pose related data from runtime service. More... | |
Fove_ErrorCode | fove_Headset_getCombinedGazeDepth (Fove_Headset *, float *outDepth) |
Writes out eyes gaze depth resulting from the two eye gazes combined together. More... | |
Fove_ErrorCode | fove_Headset_getCombinedGazeRay (Fove_Headset *, Fove_Ray *outRay) |
Writes out eyes gaze ray resulting from the two eye gazes combined together. More... | |
Fove_ErrorCode | fove_Headset_getCurrentProfile (Fove_Headset *, void(*callback)(const char *callbackProfileName, void *callbackData), void *callbackData) |
Gets the current profile. More... | |
Fove_ErrorCode | fove_Headset_getEyeballRadius (Fove_Headset *, Fove_Eye eye, float *outRadius) |
Returns the user eyeballs radius, in meters. More... | |
Fove_ErrorCode | fove_Headset_getEyeShape (Fove_Headset *, Fove_Eye eye, Fove_EyeShape *outShape) |
Returns the outline shape of the specified user eye in the Eyes camera image. More... | |
Fove_ErrorCode | fove_Headset_getEyesImage (Fove_Headset *, Fove_BitmapImage *outImage) |
Returns the eyes camera image. More... | |
Fove_ErrorCode | fove_Headset_getEyeState (Fove_Headset *, Fove_Eye eye, Fove_EyeState *outState) |
Writes out the state of an individual eye. More... | |
Fove_ErrorCode | fove_Headset_getEyeToHeadMatrices (Fove_Headset *, Fove_Matrix44 *outLeft, Fove_Matrix44 *outRight) |
Writes out the matrices to convert from eye to head space coordinates. More... | |
Fove_ErrorCode | fove_Headset_getEyeTorsion (Fove_Headset *, Fove_Eye eye, float *outAngle) |
Returns the user eye torsion, in degrees. More... | |
Fove_ErrorCode | fove_Headset_getEyeTrackingCalibrationState (Fove_Headset *, Fove_CalibrationState *outCalibrationState) |
Get the state of the currently running calibration process. | |
Fove_ErrorCode | fove_Headset_getGazeCastPolicy (Fove_Headset *, Fove_GazeCastPolicy *policy) |
Get the current gaze cast policy. More... | |
Fove_ErrorCode | fove_Headset_getGazedObjectId (Fove_Headset *, int *const outObjectId) |
Get the id of the object gazed by the user. More... | |
Fove_ErrorCode | fove_Headset_getGazeScreenPosition (Fove_Headset *, Fove_Eye eye, Fove_Vec2 *outPos) |
Writes out the user's 2D gaze position on the screens seen through the HMD's lenses. More... | |
Fove_ErrorCode | fove_Headset_getGazeVector (Fove_Headset *, Fove_Eye eye, Fove_Vec3 *outVector) |
Writes out the gaze vector of an individual eye. More... | |
Fove_ErrorCode | fove_Headset_getHardwareInfo (Fove_Headset *, Fove_HeadsetHardwareInfo *outHardwareInfo) |
Writes out the hardware information. More... | |
Fove_ErrorCode | fove_Headset_getIrisRadius (Fove_Headset *, Fove_Eye eye, float *outRadius) |
Returns the user iris radius, in meters. More... | |
Fove_ErrorCode | fove_Headset_getPose (Fove_Headset *, Fove_Pose *outPose) |
Writes out the pose of the head-mounted display. More... | |
Fove_ErrorCode | fove_Headset_getPositionImage (Fove_Headset *, Fove_BitmapImage *outImage) |
Returns the position camera image. More... | |
Fove_ErrorCode | fove_Headset_getProfileDataPath (Fove_Headset *, const char *profileName, void(*callback)(const char *callbackProfileName, void *callbackData), void *callbackData) |
Gets the data folder for a given profile. More... | |
Fove_ErrorCode | fove_Headset_getProjectionMatricesLH (Fove_Headset *, float zNear, float zFar, Fove_Matrix44 *outLeftMat, Fove_Matrix44 *outRightMat) |
Writes out the values of passed-in left-handed 4x4 projection matrices. More... | |
Fove_ErrorCode | fove_Headset_getProjectionMatricesRH (Fove_Headset *, float zNear, float zFar, Fove_Matrix44 *outLeftMat, Fove_Matrix44 *outRightMat) |
Writes out the values of passed-in right-handed 4x4 projection matrices. More... | |
Fove_ErrorCode | fove_Headset_getPupilRadius (Fove_Headset *, Fove_Eye eye, float *outRadius) |
Returns the user pupils radius, in meters. More... | |
Fove_ErrorCode | fove_Headset_getPupilShape (Fove_Headset *, Fove_Eye eye, Fove_PupilShape *outShape) |
Returns the pupil shape of the specified user eye in the Eyes camera image. More... | |
Fove_ErrorCode | fove_Headset_getRawProjectionValues (Fove_Headset *, Fove_ProjectionParams *outLeft, Fove_ProjectionParams *outRight) |
Writes out values for the view frustum of the specified eye at 1 unit away. More... | |
Fove_ErrorCode | fove_Headset_getRenderIOD (Fove_Headset *, float *outIOD) |
Interocular distance to use for rendering in meters. More... | |
Fove_ErrorCode | fove_Headset_getSoftwareVersions (Fove_Headset *, Fove_Versions *outSoftwareVersions) |
Writes out the current software versions. More... | |
Fove_ErrorCode | fove_Headset_getUserIOD (Fove_Headset *, float *outIOD) |
Returns the user IOD (Inter Occular Distance), in meters. More... | |
Fove_ErrorCode | fove_Headset_getUserIPD (Fove_Headset *, float *outIPD) |
Returns the user IPD (Inter Pupillary Distance), in meters. More... | |
Fove_ErrorCode | fove_Headset_hasAccessToFeature (Fove_Headset *, const char *inFeatureName, bool *outHasAccess) |
Returns whether the Headset has access to the given feature. More... | |
Fove_ErrorCode | fove_Headset_hasHmdAdjustmentGuiTimeout (Fove_Headset *, bool *outTimeout) |
Writes out whether the GUI that asks the user to adjust their headset was hidden by timeout. More... | |
Fove_ErrorCode | fove_Headset_isEyeTrackingCalibrated (Fove_Headset *, bool *outEyeTrackingCalibrated) |
Writes out whether eye tracking has been calibrated. More... | |
Fove_ErrorCode | fove_Headset_isEyeTrackingCalibratedForGlasses (Fove_Headset *, bool *outGlasses) |
Writes out whether the eye tracking system is currently calibrated for glasses. More... | |
Fove_ErrorCode | fove_Headset_isEyeTrackingCalibrating (Fove_Headset *, bool *outEyeTrackingCalibrating) |
Writes out whether eye tracking is in the process of performing a calibration. More... | |
Fove_ErrorCode | fove_Headset_isEyeTrackingEnabled (Fove_Headset *, bool *outEyeTrackingEnabled) |
Writes out whether the eye tracking hardware has started. More... | |
Fove_ErrorCode | fove_Headset_isEyeTrackingReady (Fove_Headset *, bool *outEyeTrackingReady) |
Writes out whether eye tracking is actively tracking eyes. More... | |
Fove_ErrorCode | fove_Headset_isHardwareConnected (Fove_Headset *, bool *outHardwareConnected) |
Writes out whether an HMD is connected or not. More... | |
Fove_ErrorCode | fove_Headset_isHardwareReady (Fove_Headset *, bool *outIsReady) |
Writes out whether the hardware for the requested capabilities has started. More... | |
Fove_ErrorCode | fove_Headset_isHmdAdjustmentGuiVisible (Fove_Headset *, bool *outHmdAdjustmentGuiVisible) |
Writes out whether or not the GUI that asks the user to adjust their headset is being displayed. More... | |
Fove_ErrorCode | fove_Headset_isMotionReady (Fove_Headset *, bool *outMotionReady) |
Writes out whether motion tracking hardware has started. More... | |
Fove_ErrorCode | fove_Headset_isPositionReady (Fove_Headset *, bool *outPositionReady) |
Writes out whether position tracking hardware has started and returns whether it was successful. More... | |
Fove_ErrorCode | fove_Headset_isUserPresent (Fove_Headset *, bool *outUserPresent) |
Writes out whether the user is wearing the headset or not. More... | |
Fove_ErrorCode | fove_Headset_isUserShiftingAttention (Fove_Headset *, bool *outIsShiftingAttention) |
Writes out whether the user is shifting its attention between objects or looking at something specific (fixation or pursuit). More... | |
Fove_ErrorCode | fove_Headset_listProfiles (Fove_Headset *, void(*callback)(const char *callbackProfileName, void *callbackData), void *callbackData) |
Lists all existing profiles. More... | |
Fove_ErrorCode | fove_Headset_registerCameraObject (Fove_Headset *, const Fove_CameraObject *camera) |
Registers an camera in the 3D world. More... | |
Fove_ErrorCode | fove_Headset_registerCapabilities (Fove_Headset *, Fove_ClientCapabilities caps) |
Registers a client capability, enabling the required hardware as needed. More... | |
Fove_ErrorCode | fove_Headset_registerGazableObject (Fove_Headset *, const Fove_GazableObject *object) |
Registers an object in the 3D world. More... | |
Fove_ErrorCode | fove_Headset_removeCameraObject (Fove_Headset *, int cameraId) |
Removes a previously registered camera from the scene. More... | |
Fove_ErrorCode | fove_Headset_removeGazableObject (Fove_Headset *, int objectId) |
Removes a previously registered 3D object from the scene. More... | |
Fove_ErrorCode | fove_Headset_renameProfile (Fove_Headset *, const char *oldName, const char *newName) |
Renames an existing profile. More... | |
Fove_ErrorCode | fove_Headset_setCurrentProfile (Fove_Headset *, const char *profileName) |
Sets the current profile. More... | |
Fove_ErrorCode | fove_Headset_setGazeCastPolicy (Fove_Headset *, Fove_GazeCastPolicy policy) |
Set the current gaze cast policy. More... | |
Fove_ErrorCode | fove_Headset_startEyeTrackingCalibration (Fove_Headset *, const Fove_CalibrationOptions *options) |
Starts eye tracking calibration. More... | |
Fove_ErrorCode | fove_Headset_stopEyeTrackingCalibration (Fove_Headset *) |
Stops eye tracking calibration if it's running, does nothing if it's not running. | |
Fove_ErrorCode | fove_Headset_tareOrientationSensor (Fove_Headset *) |
Tares the orientation of the headset. More... | |
Fove_ErrorCode | fove_Headset_tarePositionSensors (Fove_Headset *) |
Tares the position of the headset. More... | |
Fove_ErrorCode | fove_Headset_tickEyeTrackingCalibration (Fove_Headset *, float deltaTime, bool isVisible, Fove_CalibrationData *outCalibrationData) |
Tick the current calibration process and retrieve data information to render the current calibration state. More... | |
Fove_ErrorCode | fove_Headset_unregisterCapabilities (Fove_Headset *, Fove_ClientCapabilities caps) |
Unregisters a client capability previously registered. More... | |
Fove_ErrorCode | fove_Headset_updateCameraObject (Fove_Headset *, int cameraId, const Fove_ObjectPose *pose) |
Update the pose of a registered camera. More... | |
Fove_ErrorCode | fove_Headset_updateGazableObject (Fove_Headset *, int objectId, const Fove_ObjectPose *pose) |
Update a previously registered 3D object pose. More... | |
Fove_ErrorCode | fove_Headset_waitAndFetchNextEyeTrackingData (Fove_Headset *, Fove_FrameTimestamp *outTimestamp) |
Waits for next eye camera frame to be processed and fetch the updated eye tracking data. More... | |
Fove_ErrorCode | fove_logText (Fove_LogLevel level, const char *utf8Text) |
Writes some text to the FOVE log. More... | |
Variables | |
const int | fove_ObjectIdInvalid = -1 |
Predefined object ID to signify "no object". | |
This file contains the entire FOVE API, no other headers are needed.
#define FOVE_DEFINE_CXX_API 0 |
Macro that controls whether the C++ API will be defined.
The C API is always defined after including this header, but the C++ API is optional. In C++ mode, the C API is extended (for example, with default values for struct members) automatically.
User can set this macro to 0 or 1, either in code before including this, or via compile-flag to choose.
Defaults to 0 if the compiler is a C compiler, 1 if the compiler is a C++ compiler.
enum Fove_AlphaMode |
Enum to help interpret the alpha of texture.
Determines how to interpret the alpha of a compositor client texture
Indicate the calibration method to use.
Indicate the state of a calibration process.
A calibration process always starts from the NotStarted
state, then it can go back and forth between the WaitingForUser
& CollectingData
states, then it goes to the ProcessingData
state and finishes with the Successful
state.
A failure can happen any time during the process, and stops the process where it was.
From the ProcessingData
state the calibration process do not require any rendering and gameplay can be started if wanted but new calibration won't be effective before reaching the Successful
state.
List of capabilities usable by clients.
Most features require registering for the relevant capability. If a client queries data related to a capability it has not registered API_NotRegistered will be returned. After a new capability registration the Data_NoUpdate error may be returned for a few frames while the service is bootstrapping the new capability.
This enum is designed to be used as a flag set, so items may be binary logic operators like |.
The FOVE runtime will keep any given set of hardware/software running so long as one client is registering a capability.
The registration of a capability does not necessarily mean that the capability is running. For example, if no position tracking camera is attached, no position tracking will occur regardless of how many clients registered for it.
enum Fove_ColliderType |
enum Fove_ErrorCode |
The error codes that the Fove system may return.
enum Fove_Eye |
Indicate whether each eye should be calibrated separately or not.
enum Fove_EyeState |
enum Fove_GazeCastPolicy |
Specify when user gaze casts should be dismissed based on his eyes openness.
enum Fove_GraphicsAPI |
Enum for type of Graphics API.
Type of Graphics API Note: We currently only support DirectX
enum Fove_LogLevel |
Fove_ErrorCode fove_Compositor_createLayer | ( | Fove_Compositor * | , |
const Fove_CompositorLayerCreateInfo * | layerInfo, | ||
Fove_CompositorLayer * | outLayer | ||
) |
Creates a new layer within the compositor.
This function create a layer upon which frames may be submitted to the compositor by this client.
A connection to the compositor must exist for this to pass. This means you need to wait for fove_Compositor_isReady before calling this function. However, if connection to the compositor is lost and regained, this layer will persist. For this reason, you should not recreate your layers upon reconnection, simply create them once.
There is no way to delete a layer once created, other than to destroy the Fove_Compositor object. This is a feature we would like to add in the future.
layerInfo | The settings for the layer to be created |
outLayer | A struct where the defaults of the newly created layer will be written |
Fove_ErrorCode fove_Compositor_destroy | ( | Fove_Compositor * | ) |
Frees resources used by the compositor object, including memory and sockets.
Upon return, this compositor pointer should no longer be used.
Fove_ErrorCode fove_Compositor_getAdapterId | ( | Fove_Compositor * | , |
Fove_AdapterId * | outAdapterId | ||
) |
Returns the ID of the GPU currently attached to the headset.
For systems with multiple GPUs, submitted textures to the compositor must from the same GPU that the compositor is using
Fove_ErrorCode fove_Compositor_submit | ( | Fove_Compositor * | , |
const Fove_CompositorLayerSubmitInfo * | submitInfo, | ||
size_t | layerCount | ||
) |
Submit a frame to the compositor.
This function takes the feed from your game engine to the compositor for output.
submitInfo | An array of layerCount Fove_CompositorLayerSubmitInfo structs, each of which provides texture data for a unique layer |
layerCount | The number of layers you are submitting |
Fove_ErrorCode fove_Compositor_waitForRenderPose | ( | Fove_Compositor * | , |
Fove_Pose * | outPose | ||
) |
Wait for the most recent pose for rendering purposes.
All compositor clients should use this function as the sole means of limiting their frame rate. This allows the client to render at the correct frame rate for the HMD display. Upon this function returning, the client should proceed directly to rendering, to reduce the chance of missing the frame. If outPose is not null, this function will return the latest pose as a convenience to the caller. In general, a client's main loop should look like: { Update(); // Run AI, physics, etc, for the next frame compositor.WaitForRenderPose(&pose); // Wait for the next frame, and get the pose Draw(pose); // Render the scene using the new pose }
outPose | The latest pose of the headset. |
Fove_ErrorCode fove_Config_clearValue | ( | const char * | key | ) |
Reset the value of the provided key to its default value.
key | The key name of the value to reset, null-terminated and in UTF-8 |
Fove_ErrorCode fove_Config_getValue_bool | ( | const char * | key, |
bool * | outValue | ||
) |
Get the value of the provided key from the FOVE config.
key | The key name of the value to retrieve, null-terminated and in UTF-8 |
outValue | The value associated to the key if found. |
Fove_ErrorCode fove_Config_getValue_float | ( | const char * | key, |
float * | outValue | ||
) |
Get the value of the provided key from the FOVE config.
key | The key name of the value to retrieve, null-terminated and in UTF-8 |
outValue | The value associated to the key if found. |
Fove_ErrorCode fove_Config_getValue_int | ( | const char * | key, |
int * | outValue | ||
) |
Get the value of the provided key from the FOVE config.
key | The key name of the value to retrieve, null-terminated and in UTF-8 |
outValue | The value associated to the key if found. |
Fove_ErrorCode fove_Config_getValue_string | ( | const char * | key, |
void(*)(const char *value, void *callbackData) | callback, | ||
void * | callbackData | ||
) |
Get the value of the provided key from the FOVE config.
key | The key name of the value to retrieve, null-terminated and in UTF-8 |
callback | A function pointer to a function that will be called once if the key is present |
callbackData | An arbitrary pointer passed to the callback |
Fove_ErrorCode fove_Config_setValue_bool | ( | const char * | key, |
bool | value | ||
) |
Set the value of the provided key to the FOVE config.
key | The key name of the value to set, null-terminated and in UTF-8 |
value | The new value to set as the key value. |
Fove_ErrorCode fove_Config_setValue_float | ( | const char * | key, |
float | value | ||
) |
Set the value of the provided key to the FOVE config.
key | The key name of the value to set, null-terminated and in UTF-8 |
value | The new value to set as the key value. |
Fove_ErrorCode fove_Config_setValue_int | ( | const char * | key, |
int | value | ||
) |
Set the value of the provided key to the FOVE config.
key | The key name of the value to set, null-terminated and in UTF-8 |
value | The new value to set as the key value. |
Fove_ErrorCode fove_Config_setValue_string | ( | const char * | key, |
const char * | value | ||
) |
Set the value of the provided key to the FOVE config.
key | The key name of the value to set, null-terminated and in UTF-8 |
value | The new value to set as the key value. |
Fove_ErrorCode fove_createHeadset | ( | Fove_ClientCapabilities | capabilities, |
Fove_Headset ** | outHeadset | ||
) |
Creates and returns an Fove_Headset object, which is the entry point to the entire API.
The result headset should be destroyed using fove_Headset_destroy when no longer needed.
capabilities | The desired capabilities (Gaze, Orientation, Position), for multiple capabilities, use bitwise-or input such as Fove_ClientCapabilities::Gaze | Fove_ClientCapabilities::Position |
outHeadset | A pointer where the address of the newly created headset will be written upon success |
Fove_ErrorCode fove_Headset_checkSoftwareVersions | ( | Fove_Headset * | ) |
Checks whether the client can run against the installed version of the FOVE SDK.
Fove_ErrorCode fove_Headset_createCompositor | ( | Fove_Headset * | , |
Fove_Compositor ** | outCompositor | ||
) |
Returns a compositor interface from the given headset.
Each call to this function creates a new object. The object should be destroyed with fove_Compositor_destroy It is fine to call this function multiple times with the same headset, the same pointer will be returned. It is ok for the compositor to outlive the headset passed in.
Fove_ErrorCode fove_Headset_createProfile | ( | Fove_Headset * | , |
const char * | newName | ||
) |
Creates a new profile.
The FOVE system keeps a set of profiles so that different users on the same system can store data, such as calibrations, separately. Profiles persist to disk and survive restart. Third party applications can control the profile system and store data within it.
This function creates a new profile, but does not add any data or switch to it.
newName | Null-terminated UTF-8 unique name of the profile to create |
Fove_ErrorCode fove_Headset_deleteProfile | ( | Fove_Headset * | , |
const char * | profileName | ||
) |
Deletes an existing profile.
This function deletes an existing profile.
If the deleted profile is the current profile, then no current profile is set after this returns. In such a case, it is undefined whether any existing profile data loaded into memory may be kept around.
profileName | Null-terminated UTF-8 name of the profile to be deleted |
Fove_ErrorCode fove_Headset_destroy | ( | Fove_Headset * | ) |
Frees resources used by a headset object, including memory and sockets.
Upon return, this headset pointer should no longer be used.
Fove_ErrorCode fove_Headset_fetchEyeTrackingData | ( | Fove_Headset * | , |
Fove_FrameTimestamp * | outTimestamp | ||
) |
Fetch the latest eye tracking related data from runtime service.
This function is never blocking, if the data is already up-to-date no operation is performed. It outputs the timestamp of the new gaze information. This can be used to know if data has been updated or not.
Eye tracking should be enabled by registering the Fove_ClientCapabilities_EyeTracking
before calling this function.
outTimestamp | A pointer to the timestamp of fetched data. If null, the timestamp is not written. |
Fove_ErrorCode fove_Headset_fetchPoseData | ( | Fove_Headset * | , |
Fove_FrameTimestamp * | outTimestamp | ||
) |
Fetch the latest headset pose related data from runtime service.
This function is never blocking, if the data is already up-to-date no operation is performed. It outputs the timestamp of the new pose data. This can be used to know if data has been updated or not.
At least one of the following capabilities need to be registered to use this function: Fove_ClientCapabilities_PositionTracking
, Fove_ClientCapabilities_OrientationTracking
, Fove_ClientCapabilities_PositionImage
outTimestamp | A pointer to the timestamp of fetched data. If null, the timestamp is not written. |
Fove_ErrorCode fove_Headset_getCombinedGazeDepth | ( | Fove_Headset * | , |
float * | outDepth | ||
) |
Writes out eyes gaze depth resulting from the two eye gazes combined together.
Fove_ClientCapabilities_GazeDepth
should be registered to use this function.
outDepth | A pointer to the gaze depth variable to write to |
outDepth
is nullptr
Fove_ErrorCode fove_Headset_getCombinedGazeRay | ( | Fove_Headset * | , |
Fove_Ray * | outRay | ||
) |
Writes out eyes gaze ray resulting from the two eye gazes combined together.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
To get individual eye rays use fove_Headset_getGazeVector
instead
outRay | A pointer to the gaze ray struct to write to |
outRay
is nullptr
Fove_ErrorCode fove_Headset_getCurrentProfile | ( | Fove_Headset * | , |
void(*)(const char *callbackProfileName, void *callbackData) | callback, | ||
void * | callbackData | ||
) |
Gets the current profile.
The callback is not invoked if there is no current profile.
callbackProfileName is a non-null, null-terminated UTF-8 string with the name of the current profile.
Invoking any other function on this headset from the callback will yield undefined behavior.
callback | A function pointer to a function that will be called up to onces |
callbackData | An arbitrary pointer passed to the callback or an empty string if no profile is set) |
Fove_ErrorCode fove_Headset_getEyeballRadius | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
float * | outRadius | ||
) |
Returns the user eyeballs radius, in meters.
Fove_ClientCapabilities_EyeballRadius
should be registered to use this function.
eye | Specify which eye to get the value for |
outRadius | A pointer to the output variable to write the user eyeball radius to. |
outRadius
is nullptr
Fove_ErrorCode fove_Headset_getEyeShape | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
Fove_EyeShape * | outShape | ||
) |
Returns the outline shape of the specified user eye in the Eyes camera image.
Fove_ClientCapabilities_EyeShape
should be registered to use this function.
eye | Specify which eye to get the value for |
outShape | A pointer to the EyeShape struct to write eye shape to |
outShape
is nullptr
Fove_ErrorCode fove_Headset_getEyesImage | ( | Fove_Headset * | , |
Fove_BitmapImage * | outImage | ||
) |
Returns the eyes camera image.
The eyes image is synchronized with and fetched at the same as the gaze during the call to fove_Headset_fetchEyeTrackingData
.
The image data buffer is invalidated upon the next call to this function. Fove_ClientCapabilities_EyesImage
should be registered to use this function.
outImage | the raw image data buffer to write the eyes image data to. |
outImage
is nullptr
Fove_ErrorCode fove_Headset_getEyeState | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
Fove_EyeState * | outState | ||
) |
Writes out the state of an individual eye.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
eye | Specify which eye to get the value for |
outState | A pointer to the output variable to write the eye state to |
outState
is nullptr
Fove_ErrorCode fove_Headset_getEyeToHeadMatrices | ( | Fove_Headset * | , |
Fove_Matrix44 * | outLeft, | ||
Fove_Matrix44 * | outRight | ||
) |
Writes out the matrices to convert from eye to head space coordinates.
This is simply a translation matrix that returns +/- IOD/2
outLeft | A pointer to the matrix where left-eye transform data will be written |
outRight | A pointer to the matrix where right-eye transform data will be written |
outLeft
and outRight
are nullptr
Fove_ErrorCode fove_Headset_getEyeTorsion | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
float * | outAngle | ||
) |
Returns the user eye torsion, in degrees.
Fove_ClientCapabilities_EyeTorsion
should be registered to use this function.
eye | Specify which eye to get the value for |
outAngle | A pointer to the output variable to write the user eye torsion to. |
outAngle
is nullptr
Fove_ErrorCode fove_Headset_getGazeCastPolicy | ( | Fove_Headset * | , |
Fove_GazeCastPolicy * | policy | ||
) |
Get the current gaze cast policy.
policy | A pointer used to received the current gaze cast policy |
Fove_ErrorCode fove_Headset_getGazedObjectId | ( | Fove_Headset * | , |
int *const | outObjectId | ||
) |
Get the id of the object gazed by the user.
In order to be detected an object first need to be registered using the fove_Headset_registerGazableObject
function. If the user is currently not looking at any specific object the fove_ObjectIdInvalid
value is returned. To use this function, you need to register the Fove_ClientCapabilities_GazedObjectDetection
first.
outObjectId | A pointer to the output id identifying the object the user is currently looking at |
outObjectId
is nullptr
Fove_ErrorCode fove_Headset_getGazeScreenPosition | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
Fove_Vec2 * | outPos | ||
) |
Writes out the user's 2D gaze position on the screens seen through the HMD's lenses.
The use of lenses and distortion correction creates a screen in front of each eye. This function returns 2D vectors representing where on each eye's screen the user is looking. The vectors are normalized in the range [-1, 1] along both X and Y axes such that the following points are true:
Center: (0, 0) Bottom-Left: (-1, -1) Top-Right: (1, 1)
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
eye | Specify which eye to get the value for |
outPos | A pointer to the eye gaze point in the HMD's virtual screen space |
nullptr
Fove_ErrorCode fove_Headset_getGazeVector | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
Fove_Vec3 * | outVector | ||
) |
Writes out the gaze vector of an individual eye.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
eye | Specify which eye to get the value for |
outVector | A pointer to the eye gaze vector to write to |
nullptr
Fove_ErrorCode fove_Headset_getHardwareInfo | ( | Fove_Headset * | , |
Fove_HeadsetHardwareInfo * | outHardwareInfo | ||
) |
Writes out the hardware information.
Allows you to get serial number, manufacturer, and model name of the headset.
Fove_ErrorCode fove_Headset_getIrisRadius | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
float * | outRadius | ||
) |
Returns the user iris radius, in meters.
Fove_ClientCapabilities_IrisRadius
should be registered to use this function.
eye | Specify which eye to get the value for |
outRadius | A pointer to the output variable to write the user iris radius to. |
outRadius
is nullptr
Fove_ErrorCode fove_Headset_getPose | ( | Fove_Headset * | , |
Fove_Pose * | outPose | ||
) |
Writes out the pose of the head-mounted display.
outPose | A pointer to the variable to be written |
outPose
is nullptr
Fove_ErrorCode fove_Headset_getPositionImage | ( | Fove_Headset * | , |
Fove_BitmapImage * | outImage | ||
) |
Returns the position camera image.
The position image is synchronized with and fetched at the same as the pose during the call to fove_Headset_fetchPoseData
.
The image data buffer is invalidated upon the next call to this function. Fove_ClientCapabilities_PositionImage
should be registered to use this function.
outImage | the raw image data buffer to write the position image data to. |
outImage
is nullptr
Fove_ErrorCode fove_Headset_getProfileDataPath | ( | Fove_Headset * | , |
const char * | profileName, | ||
void(*)(const char *callbackProfileName, void *callbackData) | callback, | ||
void * | callbackData | ||
) |
Gets the data folder for a given profile.
Allows you to retrieve a filesytem directory where third party apps can write data associated with this profile. This directory will be created before return.
Since multiple applications may write stuff to a profile, please prefix any files you create with something unique to your application.
There are no special protections on profile data, and it may be accessible to any other app on the system. Do not write sensitive data here.
This is intended for simple uses. For advanced uses that have security concerns, or want to sync to a server, etc, third party applications are encouraged to use their own separate data store keyed by profile name. They will need to test for profile name changes and deletions manually in that case.
Invoking any other function on this headset from the callback will yield undefined behavior.
callbackProfileName is a non-null, null-terminated UTF-8 string with the path.
callback | A function pointer to a function that will be called once if successful. Not invoked in the event of error |
callbackData | An arbitrary pointer passed to the callback |
profileName | A null-terminated UTF-8 string with the name of the profile to be queried, or an empty string if no profile is set |
Fove_ErrorCode fove_Headset_getProjectionMatricesLH | ( | Fove_Headset * | , |
float | zNear, | ||
float | zFar, | ||
Fove_Matrix44 * | outLeftMat, | ||
Fove_Matrix44 * | outRightMat | ||
) |
Writes out the values of passed-in left-handed 4x4 projection matrices.
Writes 4x4 projection matrices for both eyes using near and far planes in a left-handed coordinate system. Either outLeftMat or outRightMat may be nullptr
to only write the other matrix, however setting both to nullptr
is considered invalid and will return Fove_ErrorCode::API_NullOutPointersOnly
.
zNear | The near plane in float, Range: from 0 to zFar |
zFar | The far plane in float, Range: from zNear to infinity |
outLeftMat | A pointer to the matrix you want written |
outRightMat | A pointer to the matrix you want written |
outLeftMat
and outRightMat
are nullptr
Fove_ErrorCode fove_Headset_getProjectionMatricesRH | ( | Fove_Headset * | , |
float | zNear, | ||
float | zFar, | ||
Fove_Matrix44 * | outLeftMat, | ||
Fove_Matrix44 * | outRightMat | ||
) |
Writes out the values of passed-in right-handed 4x4 projection matrices.
Writes 4x4 projection matrices for both eyes using near and far planes in a right-handed coordinate system. Either outLeftMat or outRightMat may be nullptr
to only write the other matrix, however setting both to nullptr
is considered invalid and will return Fove_ErrorCode::API_NullOutPointersOnly
.
zNear | The near plane in float, Range: from 0 to zFar |
zFar | The far plane in float, Range: from zNear to infinity |
outLeftMat | A pointer to the matrix you want written |
outRightMat | A pointer to the matrix you want written |
outLeftMat
and outRightMat
are nullptr
Fove_ErrorCode fove_Headset_getPupilRadius | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
float * | outRadius | ||
) |
Returns the user pupils radius, in meters.
Fove_ClientCapabilities_PupilRadius
should be registered to use this function.
eye | Specify which eye to get the value for |
outRadius | A pointer to the output variable to write the user pupil radius to |
outRadius
is nullptr
Fove_ErrorCode fove_Headset_getPupilShape | ( | Fove_Headset * | , |
Fove_Eye | eye, | ||
Fove_PupilShape * | outShape | ||
) |
Returns the pupil shape of the specified user eye in the Eyes camera image.
Fove_ClientCapabilities_PupilShape
should be registered to use this function.
eye | Specify which eye to get the value for |
outShape | A pointer to the PupilShape struct to write pupil shape to |
outShape
is nullptr
Fove_ErrorCode fove_Headset_getRawProjectionValues | ( | Fove_Headset * | , |
Fove_ProjectionParams * | outLeft, | ||
Fove_ProjectionParams * | outRight | ||
) |
Writes out values for the view frustum of the specified eye at 1 unit away.
Writes out values for the view frustum of the specified eye at 1 unit away. Please multiply them by zNear to convert to your correct frustum near-plane. Either outLeft or outRight may be nullptr
to only write the other struct, however setting both to nullptr
is considered and error and the function will return Fove_ErrorCode::API_NullOutPointersOnly
.
outLeft | A pointer to the struct describing the left camera projection parameters |
outRight | A pointer to the struct describing the right camera projection parameters |
outLeft
and outRight
are nullptr
Fove_ErrorCode fove_Headset_getRenderIOD | ( | Fove_Headset * | , |
float * | outIOD | ||
) |
Interocular distance to use for rendering in meters.
This may or may not reflect the actual IOD of the user (see getUserIOD), but is the value used by the rendering system for the distance to split the left/right cameras for stereoscopic rendering. We recommend calling this each frame when doing stereoscopic rendering.
outIOD | A pointer to the render IOD variable to write to |
outIOD
is nullptr
Fove_ErrorCode fove_Headset_getSoftwareVersions | ( | Fove_Headset * | , |
Fove_Versions * | outSoftwareVersions | ||
) |
Writes out the current software versions.
Allows you to get detailed information about the client and runtime versions. Instead of comparing software versions directly, you should simply call CheckSoftwareVersions
to ensure that the client and runtime are compatible.
Fove_ErrorCode fove_Headset_getUserIOD | ( | Fove_Headset * | , |
float * | outIOD | ||
) |
Returns the user IOD (Inter Occular Distance), in meters.
Fove_ClientCapabilities_UserIOD
should be registered to use this function.
outIOD | A pointer to the output variable to write the user IOD to. |
outIOD
is nullptr
Fove_ErrorCode fove_Headset_getUserIPD | ( | Fove_Headset * | , |
float * | outIPD | ||
) |
Returns the user IPD (Inter Pupillary Distance), in meters.
Fove_ClientCapabilities_UserIPD
should be registered to use this function.
outIPD | A pointer to the output variable to write the user IPD to. |
outIPD
is nullptr
Fove_ErrorCode fove_Headset_hasAccessToFeature | ( | Fove_Headset * | , |
const char * | inFeatureName, | ||
bool * | outHasAccess | ||
) |
Returns whether the Headset has access to the given feature.
If the provided feature name doesn't exist, then false
and Fove_ErrorCode_None
are returned.
inFeatureName | A null-terminated UTF-8 string with the name of the feature to query |
outHasAccess | Output variable set to true if the headset can access the given feature |
Fove_ErrorCode fove_Headset_hasHmdAdjustmentGuiTimeout | ( | Fove_Headset * | , |
bool * | outTimeout | ||
) |
Writes out whether the GUI that asks the user to adjust their headset was hidden by timeout.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
outTimeout | A pointer to the output variable to write the timeout status to |
outTimeout
is nullptr
Fove_ErrorCode fove_Headset_isEyeTrackingCalibrated | ( | Fove_Headset * | , |
bool * | outEyeTrackingCalibrated | ||
) |
Writes out whether eye tracking has been calibrated.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
outEyeTrackingCalibrated | A pointer to the output variable to write the eye tracking calibrated status to |
outEyeTrackingCalibrated
is nullptr
Fove_ErrorCode fove_Headset_isEyeTrackingCalibratedForGlasses | ( | Fove_Headset * | , |
bool * | outGlasses | ||
) |
Writes out whether the eye tracking system is currently calibrated for glasses.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
This basically indicates if the user was wearing glasses during the calibration or not. This function returns 'Data_Uncalibrated' if the eye tracking system has not been calibrated yet
outGlasses | A pointer to the variable to be written |
outGlasses
is nullptr
Fove_ErrorCode fove_Headset_isEyeTrackingCalibrating | ( | Fove_Headset * | , |
bool * | outEyeTrackingCalibrating | ||
) |
Writes out whether eye tracking is in the process of performing a calibration.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
outEyeTrackingCalibrating | A pointer to the output variable to write the eye tracking calibrating status to |
outEyeTrackingCalibrating
is nullptr
Fove_ErrorCode fove_Headset_isEyeTrackingEnabled | ( | Fove_Headset * | , |
bool * | outEyeTrackingEnabled | ||
) |
Writes out whether the eye tracking hardware has started.
outEyeTrackingEnabled | A pointer to the output variable to write the eye tracking status to |
outEyeTrackingEnabled
is nullptr
Fove_ErrorCode fove_Headset_isEyeTrackingReady | ( | Fove_Headset * | , |
bool * | outEyeTrackingReady | ||
) |
Writes out whether eye tracking is actively tracking eyes.
In other words, it returns true
only when the hardware is ready and eye tracking is calibrated.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
outEyeTrackingReady | A pointer to the output variable to write the eye tracking ready status to |
outEyeTrackingReady
is nullptr
Fove_ErrorCode fove_Headset_isHardwareConnected | ( | Fove_Headset * | , |
bool * | outHardwareConnected | ||
) |
Writes out whether an HMD is connected or not.
outHardwareConnected | A pointer to the value to be written |
Fove_ErrorCode fove_Headset_isHardwareReady | ( | Fove_Headset * | , |
bool * | outIsReady | ||
) |
Writes out whether the hardware for the requested capabilities has started.
Fove_ErrorCode fove_Headset_isHmdAdjustmentGuiVisible | ( | Fove_Headset * | , |
bool * | outHmdAdjustmentGuiVisible | ||
) |
Writes out whether or not the GUI that asks the user to adjust their headset is being displayed.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
outHmdAdjustmentGuiVisible | A pointer to the output variable to write the GUI visibility status to |
outHmdAdjustmentGuiVisible
is nullptr
Fove_ErrorCode fove_Headset_isMotionReady | ( | Fove_Headset * | , |
bool * | outMotionReady | ||
) |
Writes out whether motion tracking hardware has started.
outMotionReady | A pointer to the variable to be written |
Fove_ErrorCode fove_Headset_isPositionReady | ( | Fove_Headset * | , |
bool * | outPositionReady | ||
) |
Writes out whether position tracking hardware has started and returns whether it was successful.
Fove_ClientCapabilities_PositionTracking
should be registered to use this function.
outPositionReady | A pointer to the variable to be written |
outPositionReady
is nullptr
Fove_ErrorCode fove_Headset_isUserPresent | ( | Fove_Headset * | , |
bool * | outUserPresent | ||
) |
Writes out whether the user is wearing the headset or not.
When user is not present Eye tracking values shouldn't be used, as invalid.
Fove_ClientCapabilities_UserPresence
should be registered to use this function.
outUserPresent | A pointer to the output variable to write the user presence status to |
outUserPresent
is nullptr
Fove_ErrorCode fove_Headset_isUserShiftingAttention | ( | Fove_Headset * | , |
bool * | outIsShiftingAttention | ||
) |
Writes out whether the user is shifting its attention between objects or looking at something specific (fixation or pursuit).
This can be used to ignore eye data during large eye motions when the user is not looking at anything specific.
Fove_ClientCapabilities_UserAttentionShift
should be registered to use this function.
outIsShiftingAttention | A pointer to a output variable to write the user attention shift status to |
outIsShiftingAttention
is nullptr
Fove_ErrorCode fove_Headset_listProfiles | ( | Fove_Headset * | , |
void(*)(const char *callbackProfileName, void *callbackData) | callback, | ||
void * | callbackData | ||
) |
Lists all existing profiles.
Invoking any other function on this headset from the callback will yield undefined behavior.
callbackProfileName is a non-null, null-terminated UTF-8 string containing the name of a profile.
callback | A function pointer to a function that will be called once for each profile, in no particular order |
callbackData | An arbitrary pointer passed to the callback |
Fove_ErrorCode fove_Headset_registerCameraObject | ( | Fove_Headset * | , |
const Fove_CameraObject * | camera | ||
) |
Registers an camera in the 3D world.
Registering 3D world objects and camera allows FOVE software to identify which objects are being gazed at. We recommend that clients opt-in to this functionality rather than doing it themselves, as our algorithm may improve over time. Clients of course may do their own detection if they have special needs, such as performance needs, or just want to use their own algorithm.
At least 1 camera needs to be registered for automatic object gaze recognition to work. Use the object group mask of the camera to specify which objects the camera is capturing. The camera view pose determine the gaze raycast direction and position. The camera view pose should include any and all offsets from position tracking. No transforms from the headset are added in automatically.
Connection to the service is not required for object registration, thus you can register your world objects at will and not worry about connection or reconnection status.
camera | A description of the camera. Data is copied and no reference is kept to this memory after return. |
Fove_ErrorCode fove_Headset_registerCapabilities | ( | Fove_Headset * | , |
Fove_ClientCapabilities | caps | ||
) |
Registers a client capability, enabling the required hardware as needed.
Usually you provide the required capabilities at the creation of the headset But you can add and remove capabilities anytime while the object is alive.
caps | A set of capabilities to register. Registering an existing capability is a no-op |
Fove_ErrorCode fove_Headset_registerGazableObject | ( | Fove_Headset * | , |
const Fove_GazableObject * | object | ||
) |
Registers an object in the 3D world.
Registering 3D world objects allows FOVE software to identify which objects are being gazed at. We recommend that clients opt-in to this functionality rather than doing it themselves, as our algorithm may improve over time. Clients of course may do their own detection if they have special needs, such as performance needs, or just want to use their own algorithm.
Use fove_Headset_registerCameraObject to set the pose of the corresponding camera in the 3D world.
Connection to the service is not required for object registration, thus you can register your world objects at will and not worry about connection or reconnection status.
object | A description of the object in the 3D world. Data is copied and no reference is kept to this memory after return. |
Fove_ErrorCode fove_Headset_removeCameraObject | ( | Fove_Headset * | , |
int | cameraId | ||
) |
Removes a previously registered camera from the scene.
cameraId | Id of the camera passed to fove_Headset_registerCameraObject() |
Fove_ErrorCode fove_Headset_removeGazableObject | ( | Fove_Headset * | , |
int | objectId | ||
) |
Removes a previously registered 3D object from the scene.
Because of the asynchronous nature of the FOVE system, this object may still be referenced in future frames for a very short period of time.
objectId | Id of the object passed to fove_Headset_registerGazableObject() |
Fove_ErrorCode fove_Headset_renameProfile | ( | Fove_Headset * | , |
const char * | oldName, | ||
const char * | newName | ||
) |
Renames an existing profile.
This function renames an existing profile. This works on the current profile as well.
oldName | Null-terminated UTF-8 name of the profile to be renamed |
newName | Null-terminated UTF-8 unique new name of the profile |
Fove_ErrorCode fove_Headset_setCurrentProfile | ( | Fove_Headset * | , |
const char * | profileName | ||
) |
Sets the current profile.
When changing profile, the FOVE system will load up data, such as calibration data, if it is available. If loading a profile with no calibration data, whether or not the FOVE system keeps old data loaded into memory is undefined.
Please note that no-ops are OK but you should check for Fove_ErrorCode_Profile_NotAvailable.
profileName | Name of the profile to make current, in UTF-8 |
Fove_ErrorCode fove_Headset_setGazeCastPolicy | ( | Fove_Headset * | , |
Fove_GazeCastPolicy | policy | ||
) |
Set the current gaze cast policy.
policy | The new gaze cast policy |
Fove_GazeCastPolicy
value Fove_ErrorCode fove_Headset_startEyeTrackingCalibration | ( | Fove_Headset * | , |
const Fove_CalibrationOptions * | options | ||
) |
Starts eye tracking calibration.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
options | The calibration options to use, or null to use default options |
Fove_ErrorCode fove_Headset_tareOrientationSensor | ( | Fove_Headset * | ) |
Tares the orientation of the headset.
Any or both of Fove_ClientCapabilities_OrientationTracking
and Fove_ClientCapabilities_PositionTracking
should be registered to use this function.
Fove_ErrorCode fove_Headset_tarePositionSensors | ( | Fove_Headset * | ) |
Tares the position of the headset.
Fove_ClientCapabilities_PositionTracking
should be registered to use this function.
Fove_ErrorCode fove_Headset_tickEyeTrackingCalibration | ( | Fove_Headset * | , |
float | deltaTime, | ||
bool | isVisible, | ||
Fove_CalibrationData * | outCalibrationData | ||
) |
Tick the current calibration process and retrieve data information to render the current calibration state.
deltaTime | The time elapsed since the last rendered frame |
isVisible | Indicate to the calibration system that something is being drawn to the screen. This allows the calibration renderer to take as much time as it wants to display success/failure messages and animate away before the calibration processes is marked as completed by the IsEyeTrackingCalibrating function. |
outCalibrationData | The calibration current state information |
This function is how the client declares to the calibration system that is available to render calibration. The calibration system determines which of the available renderers has the highest priority, and returns to that render the information needed to render calibration via the outTarget parameter. Even while ticking this, you may get no result because either no calibration is running, or a calibration is running but some other higher priority renderer is doing the rendering.
Fove_ClientCapabilities_EyeTracking
should be registered to use this function.
Note that it is perfectly fine not to call this function, in which case the Fove service will automatically render the calibration process for you.
Fove_ErrorCode fove_Headset_unregisterCapabilities | ( | Fove_Headset * | , |
Fove_ClientCapabilities | caps | ||
) |
Unregisters a client capability previously registered.
caps | A set of capabilities to unregister. Unregistering an not-existing capability is a no-op |
Fove_ErrorCode fove_Headset_updateCameraObject | ( | Fove_Headset * | , |
int | cameraId, | ||
const Fove_ObjectPose * | pose | ||
) |
Update the pose of a registered camera.
cameraId | Id of the camera passed to fove_Headset_registerCameraObject() |
pose | the updated pose of the camera |
Fove_ErrorCode fove_Headset_updateGazableObject | ( | Fove_Headset * | , |
int | objectId, | ||
const Fove_ObjectPose * | pose | ||
) |
Update a previously registered 3D object pose.
objectId | Id of the object passed to fove_Headset_registerGazableObject() |
pose | the updated pose of the object |
Fove_ErrorCode fove_Headset_waitAndFetchNextEyeTrackingData | ( | Fove_Headset * | , |
Fove_FrameTimestamp * | outTimestamp | ||
) |
Waits for next eye camera frame to be processed and fetch the updated eye tracking data.
Allows you to sync your eye tracking loop to the actual eye-camera loop. On each loop, you would first call this blocking function to wait for a new frame and then read the eye tracking info associated with the frame.
Eye tracking should be enabled by registering the Fove_ClientCapabilities_EyeTracking
before calling this function.
outTimestamp | A pointer to the timestamp of fetched data. If null, the timestamp is not written. |
Fove_ErrorCode fove_logText | ( | Fove_LogLevel | level, |
const char * | utf8Text | ||
) |
Writes some text to the FOVE log.
level | What severity level the log will use |
utf8Text | Null-terminated text string in UTF-8 |