mirror of
https://github.com/TorqueGameEngines/Torque3D.git
synced 2026-01-19 20:24:49 +00:00
188 lines
6.7 KiB
C++
188 lines
6.7 KiB
C++
//-----------------------------------------------------------------------------
|
|
// Copyright (c) 2012 GarageGames, LLC
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
// of this software and associated documentation files (the "Software"), to
|
|
// deal in the Software without restriction, including without limitation the
|
|
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
|
// sell copies of the Software, and to permit persons to whom the Software is
|
|
// furnished to do so, subject to the following conditions:
|
|
//
|
|
// The above copyright notice and this permission notice shall be included in
|
|
// all copies or substantial portions of the Software.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
|
// IN THE SOFTWARE.
|
|
//-----------------------------------------------------------------------------
|
|
|
|
#ifndef _OCULUSVRHMDDEVICE_H_
|
|
#define _OCULUSVRHMDDEVICE_H_
|
|
|
|
#include "core/util/str.h"
|
|
#include "math/mQuat.h"
|
|
#include "math/mPoint2.h"
|
|
#include "math/mPoint3.h"
|
|
#include "math/mPoint4.h"
|
|
#include "platform/input/oculusVR/oculusVRConstants.h"
|
|
#include "platform/types.h"
|
|
#include "OVR.h"
|
|
|
|
class OculusVRHMDDevice
|
|
{
|
|
public:
|
|
enum SimulationTypes {
|
|
ST_RIFT_PREVIEW,
|
|
};
|
|
|
|
protected:
|
|
bool mIsValid;
|
|
|
|
bool mIsSimulation;
|
|
|
|
OVR::HMDDevice* mDevice;
|
|
|
|
// From OVR::DeviceInfo
|
|
String mProductName;
|
|
String mManufacturer;
|
|
U32 mVersion;
|
|
|
|
// Windows display device name used in EnumDisplaySettings/CreateDC
|
|
String mDisplayDeviceName;
|
|
|
|
// Whole screen resolution
|
|
Point2I mResolution;
|
|
|
|
// Physical screen size in meters
|
|
Point2F mScreenSize;
|
|
|
|
// Physical offset from the top of the screen to the center of the
|
|
// eye, in meters. Usually half of the vertical physical screen size
|
|
F32 mVerticalEyeCenter;
|
|
|
|
// Physical distance from the eye to the screen
|
|
F32 mEyeToScreen;
|
|
|
|
// Physical distance between lens centers, in meters
|
|
F32 mLensSeparation;
|
|
|
|
// Physical distance between the user's eye centers
|
|
F32 mInterpupillaryDistance;
|
|
|
|
// The eye IPD as a Point3F
|
|
Point3F mEyeWorldOffset;
|
|
|
|
// Radial distortion correction coefficients used by the barrel distortion shader
|
|
Point4F mKDistortion;
|
|
|
|
// Calculated values of eye x offset from center in normalized (uv) coordinates
|
|
// where each eye is 0..1. Used for the mono to stereo postFX to simulate an
|
|
// eye offset of the camera. The x component is the left eye, the y component
|
|
// is the right eye.
|
|
Point2F mEyeUVOffset;
|
|
|
|
// Used to adjust where an eye's view is rendered to account for the lenses not
|
|
// being in the center of the physical screen half.
|
|
F32 mXCenterOffset;
|
|
|
|
// When calculating the distortion scale to use to increase the size of the input texture
|
|
// this determines how we should attempt to fit the distorted view into the backbuffer.
|
|
Point2F mDistortionFit;
|
|
|
|
// Is the factor by which the input texture size is increased to make post-distortion
|
|
// result distortion fit the viewport. If the input texture is the same size as the
|
|
// backbuffer, then this should be 1.0.
|
|
F32 mDistortionScale;
|
|
|
|
// Aspect ratio for a single eye
|
|
F32 mAspectRatio;
|
|
|
|
// Vertical field of view
|
|
F32 mYFOV;
|
|
|
|
// The amount to offset the projection matrix to account for the eye not being in the
|
|
// center of the screen.
|
|
Point2F mProjectionCenterOffset;
|
|
|
|
protected:
|
|
F32 calcScale(F32 fitRadius);
|
|
|
|
void calculateValues(bool calculateDistortionScale);
|
|
|
|
void createSimulatedPreviewRift(bool calculateDistortionScale);
|
|
|
|
public:
|
|
OculusVRHMDDevice();
|
|
~OculusVRHMDDevice();
|
|
|
|
void cleanUp();
|
|
|
|
// Set the HMD properties based on information from the OVR device
|
|
void set(OVR::HMDDevice* hmd, OVR::HMDInfo& info, bool calculateDistortionScale);
|
|
|
|
// Set the HMD properties based on a simulation of the given type
|
|
void createSimulation(SimulationTypes simulationType, bool calculateDistortionScale);
|
|
|
|
bool isValid() const {return mIsValid;}
|
|
bool isSimulated() const {return mIsSimulation;}
|
|
|
|
const char* getProductName() const { return mProductName.c_str(); }
|
|
const char* getManufacturer() const { return mManufacturer.c_str(); }
|
|
U32 getVersion() const { return mVersion; }
|
|
|
|
// Windows display device name used in EnumDisplaySettings/CreateDC
|
|
const char* getDisplayDeviceName() const { return mDisplayDeviceName.c_str(); }
|
|
|
|
// Whole screen resolution
|
|
const Point2I& getResolution() const { return mResolution; }
|
|
|
|
// Physical screen size in meters
|
|
const Point2F& getScreenSize() const { return mScreenSize; }
|
|
|
|
// Physical offset from the top of the screen to the center of the
|
|
// eye, in meters. Usually half of the vertical physical screen size
|
|
F32 getVerticalEyeCenter() const { return mVerticalEyeCenter; }
|
|
|
|
// Physical distance from the eye to the screen
|
|
F32 getEyeToScreen() const { return mEyeToScreen; }
|
|
|
|
// Physical distance between lens centers, in meters
|
|
F32 getLensSeparation() const { return mLensSeparation; }
|
|
|
|
// Physical distance between the user's eye centers
|
|
F32 getIPD() const { return mInterpupillaryDistance; }
|
|
|
|
// Provides the IPD of one eye as a Point3F
|
|
const Point3F& getEyeWorldOffset() const { return mEyeWorldOffset; }
|
|
|
|
// Radial distortion correction coefficients used by the barrel distortion shader
|
|
const Point4F& getKDistortion() const { return mKDistortion; }
|
|
|
|
// Calculated values of eye x offset from center in normalized (uv) coordinates.
|
|
const Point2F& getEyeUVOffset() const { return mEyeUVOffset; }
|
|
|
|
// Used to adjust where an eye's view is rendered to account for the lenses not
|
|
// being in the center of the physical screen half.
|
|
F32 getCenterOffset() const { return mXCenterOffset; }
|
|
|
|
// Is the factor by which the input texture size is increased to make post-distortion
|
|
// result distortion fit the viewport.
|
|
F32 getDistortionScale() const { return mDistortionScale; }
|
|
|
|
// Aspect ration for a single eye
|
|
F32 getAspectRation() const { return mAspectRatio; }
|
|
|
|
// Vertical field of view
|
|
F32 getYFOV() const { return mYFOV; }
|
|
|
|
// The amount to offset the projection matrix to account for the eye not being in the
|
|
// center of the screen.
|
|
const Point2F& getProjectionCenterOffset() const { return mProjectionCenterOffset; }
|
|
};
|
|
|
|
#endif // _OCULUSVRHMDDEVICE_H_
|