Initial commit. Version 0.1.0

.gitignore

@@ -0,0 +1,3 @@
+.vs/
+bin/
+temp/

dev/sdk/include/oculus/Extras/OVR_CAPI_Util.h

@@ -0,0 +1,283 @@
+/********************************************************************************/ /**
+ \file      OVR_CAPI_Util.h
+ \brief     This header provides LibOVR utility function declarations
+ \copyright Copyright 2015-2016 Oculus VR, LLC All Rights reserved.
+ *************************************************************************************/
+
+#ifndef OVR_CAPI_Util_h
+#define OVR_CAPI_Util_h
+
+#include "OVR_CAPI.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/// Enumerates modifications to the projection matrix based on the application's needs.
+///
+/// \see ovrMatrix4f_Projection
+///
+typedef enum ovrProjectionModifier_ {
+  /// Use for generating a default projection matrix that is:
+  /// * Right-handed.
+  /// * Near depth values stored in the depth buffer are smaller than far depth values.
+  /// * Both near and far are explicitly defined.
+  /// * With a clipping range that is (0 to w).
+  ovrProjection_None = 0x00,
+
+  /// Enable if using left-handed transformations in your application.
+  ovrProjection_LeftHanded = 0x01,
+
+  /// After the projection transform is applied, far values stored in the depth buffer will be less
+  /// than closer depth values.
+  /// NOTE: Enable only if the application is using a floating-point depth buffer for proper
+  /// precision.
+  ovrProjection_FarLessThanNear = 0x02,
+
+  /// When this flag is used, the zfar value pushed into ovrMatrix4f_Projection() will be ignored
+  /// NOTE: Enable only if ovrProjection_FarLessThanNear is also enabled where the far clipping
+  /// plane will be pushed to infinity.
+  ovrProjection_FarClipAtInfinity = 0x04,
+
+  /// Enable if the application is rendering with OpenGL and expects a projection matrix with a
+  /// clipping range of (-w to w).
+  /// Ignore this flag if your application already handles the conversion from D3D range (0 to w) to
+  /// OpenGL.
+  ovrProjection_ClipRangeOpenGL = 0x08,
+} ovrProjectionModifier;
+
+/// Return values for ovr_Detect.
+///
+/// \see ovr_Detect
+///
+typedef struct OVR_ALIGNAS(8) ovrDetectResult_ {
+  /// Is ovrFalse when the Oculus Service is not running.
+  ///   This means that the Oculus Service is either uninstalled or stopped.
+  ///   IsOculusHMDConnected will be ovrFalse in this case.
+  /// Is ovrTrue when the Oculus Service is running.
+  ///   This means that the Oculus Service is installed and running.
+  ///   IsOculusHMDConnected will reflect the state of the HMD.
+  ovrBool IsOculusServiceRunning;
+
+  /// Is ovrFalse when an Oculus HMD is not detected.
+  ///   If the Oculus Service is not running, this will be ovrFalse.
+  /// Is ovrTrue when an Oculus HMD is detected.
+  ///   This implies that the Oculus Service is also installed and running.
+  ovrBool IsOculusHMDConnected;
+
+  OVR_UNUSED_STRUCT_PAD(pad0, 6) ///< \internal struct padding
+
+} ovrDetectResult;
+
+OVR_STATIC_ASSERT(sizeof(ovrDetectResult) == 8, "ovrDetectResult size mismatch");
+
+/// Modes used to generate Touch Haptics from audio PCM buffer.
+///
+typedef enum ovrHapticsGenMode_ {
+  /// Point sample original signal at Haptics frequency
+  ovrHapticsGenMode_PointSample,
+  ovrHapticsGenMode_Count
+} ovrHapticsGenMode;
+
+/// Store audio PCM data (as 32b float samples) for an audio channel.
+/// Note: needs to be released with ovr_ReleaseAudioChannelData to avoid memory leak.
+///
+typedef struct ovrAudioChannelData_ {
+  /// Samples stored as floats [-1.0f, 1.0f].
+  const float* Samples;
+
+  /// Number of samples
+  int SamplesCount;
+
+  /// Frequency (e.g. 44100)
+  int Frequency;
+} ovrAudioChannelData;
+
+/// Store a full Haptics clip, which can be used as data source for multiple ovrHapticsBuffers.
+///
+typedef struct ovrHapticsClip_ {
+  /// Samples stored in opaque format
+  const void* Samples;
+
+  /// Number of samples
+  int SamplesCount;
+} ovrHapticsClip;
+
+/// Detects Oculus Runtime and Device Status
+///
+/// Checks for Oculus Runtime and Oculus HMD device status without loading the LibOVRRT
+/// shared library.  This may be called before ovr_Initialize() to help decide whether or
+/// not to initialize LibOVR.
+///
+/// \param[in] timeoutMilliseconds Specifies a timeout to wait for HMD to be attached or 0 to poll.
+///
+/// \return Returns an ovrDetectResult object indicating the result of detection.
+///
+/// \see ovrDetectResult
+///
+OVR_PUBLIC_FUNCTION(ovrDetectResult) ovr_Detect(int timeoutMilliseconds);
+
+// On the Windows platform,
+#ifdef _WIN32
+/// This is the Windows Named Event name that is used to check for HMD connected state.
+#define OVR_HMD_CONNECTED_EVENT_NAME L"OculusHMDConnected"
+#endif // _WIN32
+
+/// Used to generate projection from ovrEyeDesc::Fov.
+///
+/// \param[in] fov Specifies the ovrFovPort to use.
+/// \param[in] znear Distance to near Z limit.
+/// \param[in] zfar Distance to far Z limit.
+/// \param[in] projectionModFlags A combination of the ovrProjectionModifier flags.
+///
+/// \return Returns the calculated projection matrix.
+///
+/// \see ovrProjectionModifier
+///
+OVR_PUBLIC_FUNCTION(ovrMatrix4f)
+ovrMatrix4f_Projection(ovrFovPort fov, float znear, float zfar, unsigned int projectionModFlags);
+
+/// Extracts the required data from the result of ovrMatrix4f_Projection.
+///
+/// \param[in] projection Specifies the project matrix from which to
+///            extract ovrTimewarpProjectionDesc.
+/// \param[in] projectionModFlags A combination of the ovrProjectionModifier flags.
+/// \return Returns the extracted ovrTimewarpProjectionDesc.
+/// \see ovrTimewarpProjectionDesc
+///
+OVR_PUBLIC_FUNCTION(ovrTimewarpProjectionDesc)
+ovrTimewarpProjectionDesc_FromProjection(ovrMatrix4f projection, unsigned int projectionModFlags);
+
+/// Generates an orthographic sub-projection.
+///
+/// Used for 2D rendering, Y is down.
+///
+/// \param[in] projection The perspective matrix that the orthographic matrix is derived from.
+/// \param[in] orthoScale Equal to 1.0f / pixelsPerTanAngleAtCenter.
+/// \param[in] orthoDistance Equal to the distance from the camera in meters, such as 0.8m.
+/// \param[in] HmdToEyeOffsetX Specifies the offset of the eye from the center.
+///
+/// \return Returns the calculated projection matrix.
+///
+OVR_PUBLIC_FUNCTION(ovrMatrix4f)
+ovrMatrix4f_OrthoSubProjection(
+    ovrMatrix4f projection,
+    ovrVector2f orthoScale,
+    float orthoDistance,
+    float HmdToEyeOffsetX);
+
+/// Computes offset eye poses based on headPose returned by ovrTrackingState.
+///
+/// \param[in] headPose Indicates the HMD position and orientation to use for the calculation.
+/// \param[in] hmdToEyePose Can be ovrEyeRenderDesc.HmdToEyePose returned from
+///            ovr_GetRenderDesc. For monoscopic rendering, use a position vector that is average
+///            of the two position vectors for each eyes.
+/// \param[out] outEyePoses If outEyePoses are used for rendering, they should be passed to
+///             ovr_SubmitFrame in ovrLayerEyeFov::RenderPose or ovrLayerEyeFovDepth::RenderPose.
+///
+#undef ovr_CalcEyePoses
+OVR_PUBLIC_FUNCTION(void)
+ovr_CalcEyePoses(ovrPosef headPose, const ovrVector3f hmdToEyeOffset[2], ovrPosef outEyePoses[2]);
+OVR_PRIVATE_FUNCTION(void)
+ovr_CalcEyePoses2(ovrPosef headPose, const ovrPosef HmdToEyePose[2], ovrPosef outEyePoses[2]);
+#define ovr_CalcEyePoses ovr_CalcEyePoses2
+
+/// Returns the predicted head pose in outHmdTrackingState and offset eye poses in outEyePoses.
+///
+/// This is a thread-safe function where caller should increment frameIndex with every frame
+/// and pass that index where applicable to functions called on the rendering thread.
+/// Assuming outEyePoses are used for rendering, it should be passed as a part of ovrLayerEyeFov.
+/// The caller does not need to worry about applying HmdToEyePose to the returned outEyePoses
+/// variables.
+///
+/// \param[in]  hmd Specifies an ovrSession previously returned by ovr_Create.
+/// \param[in]  frameIndex Specifies the targeted frame index, or 0 to refer to one frame after
+///             the last time ovr_SubmitFrame was called.
+/// \param[in]  latencyMarker Specifies that this call is the point in time where
+///             the "App-to-Mid-Photon" latency timer starts from. If a given ovrLayer
+///             provides "SensorSampleTimestamp", that will override the value stored here.
+/// \param[in]  hmdToEyePose Can be ovrEyeRenderDesc.HmdToEyePose returned from
+///             ovr_GetRenderDesc. For monoscopic rendering, use a position vector that is average
+///             of the two position vectors for each eyes.
+/// \param[out] outEyePoses The predicted eye poses.
+/// \param[out] outSensorSampleTime The time when this function was called. May be NULL, in which
+/// case it is ignored.
+///
+#undef ovr_GetEyePoses
+OVR_PUBLIC_FUNCTION(void)
+ovr_GetEyePoses(
+    ovrSession session,
+    long long frameIndex,
+    ovrBool latencyMarker,
+    const ovrVector3f hmdToEyeOffset[2],
+    ovrPosef outEyePoses[2],
+    double* outSensorSampleTime);
+OVR_PRIVATE_FUNCTION(void)
+ovr_GetEyePoses2(
+    ovrSession session,
+    long long frameIndex,
+    ovrBool latencyMarker,
+    const ovrPosef HmdToEyePose[2],
+    ovrPosef outEyePoses[2],
+    double* outSensorSampleTime);
+#define ovr_GetEyePoses ovr_GetEyePoses2
+
+/// Tracking poses provided by the SDK come in a right-handed coordinate system. If an application
+/// is passing in ovrProjection_LeftHanded into ovrMatrix4f_Projection, then it should also use
+/// this function to flip the HMD tracking poses to be left-handed.
+///
+/// While this utility function is intended to convert a left-handed ovrPosef into a right-handed
+/// coordinate system, it will also work for converting right-handed to left-handed since the
+/// flip operation is the same for both cases.
+///
+/// \param[in]  inPose that is right-handed
+/// \param[out] outPose that is requested to be left-handed (can be the same pointer to inPose)
+///
+OVR_PUBLIC_FUNCTION(void) ovrPosef_FlipHandedness(const ovrPosef* inPose, ovrPosef* outPose);
+
+/// Reads an audio channel from Wav (Waveform Audio File) data.
+/// Input must be a byte buffer representing a valid Wav file. Audio samples from the specified
+/// channel are read,
+/// converted to float [-1.0f, 1.0f] and returned through ovrAudioChannelData.
+///
+/// Supported formats: PCM 8b, 16b, 32b and IEEE float (little-endian only).
+///
+/// \param[out] outAudioChannel output audio channel data.
+/// \param[in] inputData a binary buffer representing a valid Wav file data.
+/// \param[in] dataSizeInBytes size of the buffer in bytes.
+/// \param[in] stereoChannelToUse audio channel index to extract (0 for mono).
+///
+OVR_PUBLIC_FUNCTION(ovrResult)
+ovr_ReadWavFromBuffer(
+    ovrAudioChannelData* outAudioChannel,
+    const void* inputData,
+    int dataSizeInBytes,
+    int stereoChannelToUse);
+
+/// Generates playable Touch Haptics data from an audio channel.
+///
+/// \param[out] outHapticsClip generated Haptics clip.
+/// \param[in] audioChannel input audio channel data.
+/// \param[in] genMode mode used to convert and audio channel data to Haptics data.
+///
+OVR_PUBLIC_FUNCTION(ovrResult)
+ovr_GenHapticsFromAudioData(
+    ovrHapticsClip* outHapticsClip,
+    const ovrAudioChannelData* audioChannel,
+    ovrHapticsGenMode genMode);
+
+/// Releases memory allocated for ovrAudioChannelData. Must be called to avoid memory leak.
+/// \param[in] audioChannel pointer to an audio channel
+///
+OVR_PUBLIC_FUNCTION(void) ovr_ReleaseAudioChannelData(ovrAudioChannelData* audioChannel);
+
+/// Releases memory allocated for ovrHapticsClip. Must be called to avoid memory leak.
+/// \param[in] hapticsClip pointer to a haptics clip
+///
+OVR_PUBLIC_FUNCTION(void) ovr_ReleaseHapticsClip(ovrHapticsClip* hapticsClip);
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+
+#endif // Header include guard