Create interface classes for stereo displays and head mounted displays, see #43

This commit is contained in:
kaetemi 2013-06-28 23:19:32 +02:00
parent 3a4204e091
commit b04d278a27
8 changed files with 423 additions and 64 deletions

View file

@ -0,0 +1,139 @@
/**
* \file stereo_display.h
* \brief IStereoDisplay
* \date 2013-06-27 16:29GMT
* \author Jan Boon (Kaetemi)
* IStereoDisplay
*/
/*
* Copyright (C) 2013 by authors
*
* This file is part of NL3D.
* NL3D is free software: you can redistribute it and/or modify it
* under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* NL3D is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General
* Public License for more details.
*
* You should have received a copy of the GNU Affero General Public
* License along with NL3D. If not, see
* <http://www.gnu.org/licenses/>.
*/
#ifndef NL3D_STEREO_DISPLAY_H
#define NL3D_STEREO_DISPLAY_H
#include <nel/misc/types_nl.h>
// STL includes
// NeL includes
#include <nel/misc/smart_ptr.h>
// Project includes
namespace NL3D {
class UCamera;
class CViewport;
class CFrustum;
class IStereoDisplay;
class IStereoDeviceFactory : public NLMISC::CRefCount
{
public:
IStereoDeviceFactory() { }
virtual ~IStereoDeviceFactory() { }
virtual IStereoDisplay *createDevice() const = 0;
};
struct CStereoDeviceInfo
{
public:
enum TStereoDeviceClass
{
StereoDisplay,
StereoHMD,
};
enum TStereoDeviceLibrary
{
NeL3D,
OVR,
LibVR,
OpenHMD,
};
NLMISC::CSmartPtr<IStereoDeviceFactory> Factory;
TStereoDeviceLibrary Library;
TStereoDeviceClass Class;
std::string Manufacturer;
std::string ProductName;
std::string Serial; // A unique device identifier
};
/**
* \brief IStereoDisplay
* \date 2013-06-27 16:29GMT
* \author Jan Boon (Kaetemi)
* IStereoDisplay
*/
class IStereoDisplay
{
public:
IStereoDisplay();
virtual ~IStereoDisplay();
/// Gets the required screen resolution for this device
virtual void getScreenResolution(uint &width, uint &height) = 0;
/// Set latest camera position etcetera
virtual void updateCamera(uint cid, const NL3D::UCamera *camera) = 0;
/// Get the frustum to use for clipping
virtual void getClippingFrustum(uint cid, NL3D::UCamera *camera) const = 0;
/// Is there a next pass
virtual bool nextPass() = 0;
/// Gets the current viewport
virtual const NL3D::CViewport &getCurrentViewport() const = 0;
/// Gets the current camera frustum
virtual const NL3D::CFrustum &getCurrentFrustum(uint cid) const = 0;
/// Gets the current camera frustum
virtual void getCurrentFrustum(uint cid, NL3D::UCamera *camera) const = 0;
/// Gets the current camera matrix
virtual void getCurrentMatrix(uint cid, NL3D::UCamera *camera) const = 0;
/// At the start of a new render target
virtual bool beginClear() = 0;
// virtual void *getRenderTarget() const;
virtual void endClear() = 0;
/// The 3D scene
virtual bool beginScene() = 0;
virtual void endScene() = 0;
/// Interface within the 3D scene
virtual bool beginInterface3D() = 0;
virtual void endInterface3D() = 0;
/// 2D Interface
virtual bool beginInterface2D() = 0;
virtual void endInterface2D() = 0;
static const char *getLibraryName(CStereoDeviceInfo::TStereoDeviceLibrary library);
static void listDevices(std::vector<CStereoDeviceInfo> &devicesOut);
static IStereoDisplay *createDevice(const CStereoDeviceInfo &deviceInfo);
static void releaseUnusedLibraries();
static void releaseAllLibraries();
}; /* class IStereoDisplay */
} /* namespace NL3D */
#endif /* #ifndef NL3D_STEREO_DISPLAY_H */
/* end of file */

View file

@ -0,0 +1,69 @@
/**
* \file stereo_hmd.h
* \brief IStereoHMD
* \date 2013-06-27 16:30GMT
* \author Jan Boon (Kaetemi)
* IStereoHMD
*/
/*
* Copyright (C) 2013 by authors
*
* This file is part of NL3D.
* NL3D is free software: you can redistribute it and/or modify it
* under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* NL3D is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General
* Public License for more details.
*
* You should have received a copy of the GNU Affero General Public
* License along with NL3D. If not, see
* <http://www.gnu.org/licenses/>.
*/
#ifndef NL3D_STEREO_HMD_H
#define NL3D_STEREO_HMD_H
#include <nel/misc/types_nl.h>
// STL includes
// NeL includes
// Project includes
#include <nel/3d/stereo_display.h>
namespace NL3D {
/**
* \brief IStereoHMD
* \date 2013-06-27 16:30GMT
* \author Jan Boon (Kaetemi)
* IStereoHMD
*/
class IStereoHMD : public IStereoDisplay
{
public:
IStereoHMD();
virtual ~IStereoHMD();
/// Get the HMD orientation
virtual NLMISC::CQuat getOrientation() const = 0;
/// Set the head model, eye position relative to orientation point
// virtual void setEyePosition(const NLMISC::CVector &v) = 0;
/// Get the head model, eye position relative to orientation point
// virtual const NLMISC::CVector &getEyePosition() const = 0;
/// Get GUI center (1 = width, 1 = height, 0 = center)
virtual void getInterface2DShift(uint cid, float &x, float &y, float distance) const = 0;
}; /* class IStereoHMD */
} /* namespace NL3D */
#endif /* #ifndef NL3D_STEREO_HMD_H */
/* end of file */

View file

@ -49,28 +49,16 @@
// NeL includes // NeL includes
#include <nel/misc/smart_ptr.h> #include <nel/misc/smart_ptr.h>
// Project includes
#include <nel/3d/stereo_hmd.h>
#include <nel/3d/frustum.h> #include <nel/3d/frustum.h>
#include <nel/3d/viewport.h> #include <nel/3d/viewport.h>
// Project includes
namespace NL3D { namespace NL3D {
class UCamera;
struct CStereoDeviceInfo
{
public:
uint8 Class;
uint8 Identifier;
NLMISC::CSmartPtr<NLMISC::CRefCount> Factory;
std::string Library;
std::string Manufacturer;
std::string ProductName;
};
class CStereoOVRDevicePtr; class CStereoOVRDevicePtr;
class CStereoOVRDeviceHandle;
#define NL_STEREO_MAX_USER_CAMERAS 8 #define NL_STEREO_MAX_USER_CAMERAS 8
@ -80,10 +68,10 @@ class CStereoOVRDevicePtr;
* \author Jan Boon (Kaetemi) * \author Jan Boon (Kaetemi)
* CStereoOVR * CStereoOVR
*/ */
class CStereoOVR class CStereoOVR : public IStereoHMD
{ {
public: public:
CStereoOVR(const CStereoDeviceInfo &deviceInfo); CStereoOVR(const CStereoOVRDeviceHandle *handle);
virtual ~CStereoOVR(); virtual ~CStereoOVR();
@ -126,18 +114,17 @@ public:
/// Get the HMD orientation /// Get the HMD orientation
virtual NLMISC::CQuat getOrientation() const; virtual NLMISC::CQuat getOrientation() const;
/// Get GUI center (1 = width, 1 = height, 0 = center) /// Get GUI center (1 = width, 1 = height, 0 = center)
virtual void getInterface2DShift(uint cid, float &x, float &y, float distance); virtual void getInterface2DShift(uint cid, float &x, float &y, float distance) const;
static void listDevices(std::vector<CStereoDeviceInfo> &devicesOut); static void listDevices(std::vector<CStereoDeviceInfo> &devicesOut);
static CStereoOVR *createDevice(const CStereoDeviceInfo &deviceInfo);
static bool isLibraryInUse(); static bool isLibraryInUse();
static void releaseLibrary(); static void releaseLibrary();
/// Calculates internal camera information based on the reference camera /// Calculates internal camera information based on the reference camera
void initCamera(uint cid, const NL3D::UCamera *camera); void initCamera(uint cid, const NL3D::UCamera *camera);
/// Checks if the device used by this class was actually created
bool isDeviceCreated(); bool isDeviceCreated();
private: private:

View file

@ -0,0 +1,98 @@
/**
* \file stereo_display.cpp
* \brief IStereoDisplay
* \date 2013-06-27 16:29GMT
* \author Jan Boon (Kaetemi)
* IStereoDisplay
*/
/*
* Copyright (C) 2013 by authors
*
* This file is part of NL3D.
* NL3D is free software: you can redistribute it and/or modify it
* under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* NL3D is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General
* Public License for more details.
*
* You should have received a copy of the GNU Affero General Public
* License along with NL3D. If not, see
* <http://www.gnu.org/licenses/>.
*/
#include <nel/misc/types_nl.h>
#include <nel/3d/stereo_display.h>
// STL includes
// NeL includes
// #include <nel/misc/debug.h>
// Project includes
#include <nel/3d/stereo_ovr.h>
using namespace std;
// using namespace NLMISC;
namespace NL3D {
IStereoDisplay::IStereoDisplay()
{
}
IStereoDisplay::~IStereoDisplay()
{
}
const char *IStereoDisplay::getLibraryName(CStereoDeviceInfo::TStereoDeviceLibrary library)
{
static const char *nel3dName = "NeL 3D";
static const char *ovrName = "Oculus SDK";
static const char *libvrName = "LibVR";
static const char *openhmdName = "OpenHMD";
switch (library)
{
case CStereoDeviceInfo::NeL3D:
return nel3dName;
case CStereoDeviceInfo::OVR:
return ovrName;
case CStereoDeviceInfo::LibVR:
return libvrName;
case CStereoDeviceInfo::OpenHMD:
return openhmdName;
}
nlerror("Invalid device library specified");
return "<InvalidDeviceLibrary>";
}
void IStereoDisplay::listDevices(std::vector<CStereoDeviceInfo> &devicesOut)
{
CStereoOVR::listDevices(devicesOut);
}
IStereoDisplay *IStereoDisplay::createDevice(const CStereoDeviceInfo &deviceInfo)
{
return deviceInfo.Factory->createDevice();
}
void IStereoDisplay::releaseUnusedLibraries()
{
if (!CStereoOVR::isLibraryInUse())
CStereoOVR::releaseLibrary();
}
void IStereoDisplay::releaseAllLibraries()
{
CStereoOVR::releaseLibrary();
}
} /* namespace NL3D */
/* end of file */

View file

@ -0,0 +1,55 @@
/**
* \file stereo_hmd.cpp
* \brief IStereoHMD
* \date 2013-06-27 16:30GMT
* \author Jan Boon (Kaetemi)
* IStereoHMD
*/
/*
* Copyright (C) 2013 by authors
*
* This file is part of NL3D.
* NL3D is free software: you can redistribute it and/or modify it
* under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* NL3D is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General
* Public License for more details.
*
* You should have received a copy of the GNU Affero General Public
* License along with NL3D. If not, see
* <http://www.gnu.org/licenses/>.
*/
#include <nel/misc/types_nl.h>
#include <nel/3d/stereo_hmd.h>
// STL includes
// NeL includes
// #include <nel/misc/debug.h>
// Project includes
using namespace std;
// using namespace NLMISC;
namespace NL3D {
IStereoHMD::IStereoHMD()
{
}
IStereoHMD::~IStereoHMD()
{
}
} /* namespace NL3D */
/* end of file */

View file

@ -45,6 +45,7 @@
#include <nel/3d/stereo_ovr.h> #include <nel/3d/stereo_ovr.h>
// STL includes // STL includes
#include <sstream>
// External includes // External includes
#include <OVR.h> #include <OVR.h>
@ -127,16 +128,24 @@ public:
CStereoOVRSystem s_StereoOVRSystem; CStereoOVRSystem s_StereoOVRSystem;
class CStereoOVRDeviceHandle : public NLMISC::CRefCount
{
public:
OVR::DeviceEnumerator<OVR::HMDDevice> DeviceHandle;
};
sint s_DeviceCounter = 0; sint s_DeviceCounter = 0;
} }
class CStereoOVRDeviceHandle : public IStereoDeviceFactory
{
public:
OVR::DeviceEnumerator<OVR::HMDDevice> DeviceHandle;
IStereoDisplay *createDevice() const
{
CStereoOVR *stereo = new CStereoOVR(this);
if (stereo->isDeviceCreated())
return stereo;
delete stereo;
return NULL;
}
};
class CStereoOVRDevicePtr class CStereoOVRDevicePtr
{ {
public: public:
@ -146,12 +155,11 @@ public:
OVR::HMDInfo HMDInfo; OVR::HMDInfo HMDInfo;
}; };
CStereoOVR::CStereoOVR(const CStereoDeviceInfo &deviceInfo) : m_Stage(0), m_OrientationCached(false) CStereoOVR::CStereoOVR(const CStereoOVRDeviceHandle *handle) : m_Stage(0), m_OrientationCached(false)
{ {
++s_DeviceCounter; ++s_DeviceCounter;
m_DevicePtr = new CStereoOVRDevicePtr(); m_DevicePtr = new CStereoOVRDevicePtr();
CStereoOVRDeviceHandle *handle = static_cast<CStereoOVRDeviceHandle *>(deviceInfo.Factory.getPtr());
OVR::DeviceEnumerator<OVR::HMDDevice> dh = handle->DeviceHandle; OVR::DeviceEnumerator<OVR::HMDDevice> dh = handle->DeviceHandle;
m_DevicePtr->HMDDevice = dh.CreateDevice(); m_DevicePtr->HMDDevice = dh.CreateDevice();
@ -406,7 +414,7 @@ NLMISC::CQuat CStereoOVR::getOrientation() const
} }
/// Get GUI shift /// Get GUI shift
void CStereoOVR::getInterface2DShift(uint cid, float &x, float &y, float distance) void CStereoOVR::getInterface2DShift(uint cid, float &x, float &y, float distance) const
{ {
#if 0 #if 0
@ -460,7 +468,7 @@ void CStereoOVR::listDevices(std::vector<CStereoDeviceInfo> &devicesOut)
{ {
s_StereoOVRSystem.Init(); s_StereoOVRSystem.Init();
OVR::DeviceEnumerator<OVR::HMDDevice> devices = s_DeviceManager->EnumerateDevices<OVR::HMDDevice>(); OVR::DeviceEnumerator<OVR::HMDDevice> devices = s_DeviceManager->EnumerateDevices<OVR::HMDDevice>();
uint8 id = 1; uint id = 1;
do do
{ {
CStereoDeviceInfo deviceInfoOut; CStereoDeviceInfo deviceInfoOut;
@ -469,13 +477,15 @@ void CStereoOVR::listDevices(std::vector<CStereoDeviceInfo> &devicesOut)
{ {
devices.GetDeviceInfo(&deviceInfo); devices.GetDeviceInfo(&deviceInfo);
CStereoOVRDeviceHandle *handle = new CStereoOVRDeviceHandle(); CStereoOVRDeviceHandle *handle = new CStereoOVRDeviceHandle();
deviceInfoOut.Factory = static_cast<NLMISC::CRefCount *>(handle); deviceInfoOut.Factory = static_cast<IStereoDeviceFactory *>(handle);
handle->DeviceHandle = devices; handle->DeviceHandle = devices;
deviceInfoOut.Class = 1; // OVR::HMDDevice deviceInfoOut.Class = CStereoDeviceInfo::StereoHMD; // 1; // OVR::HMDDevice
deviceInfoOut.Library = "Oculus SDK"; deviceInfoOut.Library = CStereoDeviceInfo::OVR; // "Oculus SDK";
deviceInfoOut.Identifier = id;
deviceInfoOut.Manufacturer = deviceInfo.Manufacturer; deviceInfoOut.Manufacturer = deviceInfo.Manufacturer;
deviceInfoOut.ProductName = deviceInfo.ProductName; deviceInfoOut.ProductName = deviceInfo.ProductName;
stringstream ser;
ser << id;
deviceInfoOut.Serial = ser.str(); // can't get the real serial from the sdk...
devicesOut.push_back(deviceInfoOut); devicesOut.push_back(deviceInfoOut);
++id; ++id;
} }
@ -483,15 +493,6 @@ void CStereoOVR::listDevices(std::vector<CStereoDeviceInfo> &devicesOut)
} while (devices.Next()); } while (devices.Next());
} }
CStereoOVR *CStereoOVR::createDevice(const CStereoDeviceInfo &deviceInfo)
{
CStereoOVR *stereo = new CStereoOVR(deviceInfo);
if (stereo->isDeviceCreated())
return stereo;
delete stereo;
return NULL;
}
bool CStereoOVR::isLibraryInUse() bool CStereoOVR::isLibraryInUse()
{ {
nlassert(s_DeviceCounter >= 0); nlassert(s_DeviceCounter >= 0);

View file

@ -34,7 +34,7 @@
#include <nel/3d/u_cloud_scape.h> #include <nel/3d/u_cloud_scape.h>
#include <nel/3d/viewport.h> #include <nel/3d/viewport.h>
#include <nel/3d/stereo_ovr.h> #include <nel/3d/stereo_hmd.h>
#include "snowballs_client.h" #include "snowballs_client.h"
#include "entities.h" #include "entities.h"
@ -70,7 +70,8 @@ static UInstance Sky = NULL;
static UCloudScape *Clouds = NULL; static UCloudScape *Clouds = NULL;
CStereoOVR *StereoHMD = NULL; IStereoDisplay *StereoDisplay = NULL;
IStereoHMD *StereoHMD = NULL;
// //
// Functions // Functions
@ -81,12 +82,12 @@ void initCamera()
if (ConfigFile->getVar("HMDEnable").asBool()) if (ConfigFile->getVar("HMDEnable").asBool())
{ {
std::vector<NL3D::CStereoDeviceInfo> devices; std::vector<NL3D::CStereoDeviceInfo> devices;
CStereoOVR::listDevices(devices); IStereoDisplay::listDevices(devices);
for (std::vector<NL3D::CStereoDeviceInfo>::iterator it(devices.begin()), end(devices.end()); it != end; ++it) for (std::vector<NL3D::CStereoDeviceInfo>::iterator it(devices.begin()), end(devices.end()); it != end; ++it)
{ {
std::stringstream name; std::stringstream name;
name << std::string("[") << (uint32)it->Identifier << "] [" << it->Library << " - " << it->Manufacturer << " - " << it->ProductName << "]"; name << std::string("[") << it->Serial << "] [" << IStereoDisplay::getLibraryName(it->Library) << " - " << it->Manufacturer << " - " << it->ProductName << "]";
nlinfo("Stereo Device: %s", name.str().c_str()); nlinfo("Stereo Display: %s", name.str().c_str());
} }
CStereoDeviceInfo *deviceInfo = NULL; CStereoDeviceInfo *deviceInfo = NULL;
std::string hmdDeviceCfg = ConfigFile->getVar("HMDDevice").asString(); std::string hmdDeviceCfg = ConfigFile->getVar("HMDDevice").asString();
@ -97,23 +98,29 @@ void initCamera()
} }
else else
{ {
uint8 hmdDeviceId = (ConfigFile->getVar("HMDDeviceId").asInt() & 0xFF); std::string hmdDeviceId = ConfigFile->getVar("HMDDeviceId").asString();
for (std::vector<NL3D::CStereoDeviceInfo>::iterator it(devices.begin()), end(devices.end()); it != end; ++it) for (std::vector<NL3D::CStereoDeviceInfo>::iterator it(devices.begin()), end(devices.end()); it != end; ++it)
{ {
std::stringstream name; std::stringstream name;
name << it->Library << " - " << it->Manufacturer << " - " << it->ProductName; name << IStereoDisplay::getLibraryName(it->Library) << " - " << it->Manufacturer << " - " << it->ProductName;
if (name.str() == hmdDeviceCfg) if (name.str() == hmdDeviceCfg)
deviceInfo = &(*it); deviceInfo = &(*it);
if (hmdDeviceId == it->Identifier) if (hmdDeviceId == it->Serial)
break; break;
} }
} }
if (deviceInfo) if (deviceInfo)
{ {
nlinfo("Create HMD device!"); nlinfo("Create VR stereo display device");
StereoHMD = CStereoOVR::createDevice(*deviceInfo); StereoDisplay = IStereoDisplay::createDevice(*deviceInfo);
if (deviceInfo->Class == CStereoDeviceInfo::StereoHMD)
{
nlinfo("Stereo display device is a HMD");
StereoHMD = static_cast<IStereoHMD *>(StereoDisplay);
} }
} }
IStereoDisplay::releaseUnusedLibraries();
}
// Set up directly the camera // Set up directly the camera
Camera = Scene->getCam(); Camera = Scene->getCam();
@ -129,11 +136,6 @@ void initCamera()
CamCollisionEntity = VisualCollisionManager->createEntity(); CamCollisionEntity = VisualCollisionManager->createEntity();
CamCollisionEntity->setCeilMode(true); CamCollisionEntity->setCeilMode(true);
if (StereoHMD)
{
StereoHMD->initCamera(0, &Camera);
}
// Create the snowing particle system // Create the snowing particle system
Snow = Scene->createInstance("snow.ps"); Snow = Scene->createInstance("snow.ps");
// And setup it // And setup it
@ -164,9 +166,15 @@ void releaseCamera()
Scene->deleteInstance(Snow); Scene->deleteInstance(Snow);
VisualCollisionManager->deleteEntity(CamCollisionEntity); VisualCollisionManager->deleteEntity(CamCollisionEntity);
if (StereoHMD)
{
delete StereoHMD; delete StereoHMD;
StereoHMD = NULL; StereoHMD = NULL;
CStereoOVR::releaseLibrary(); StereoDisplay = NULL;
}
delete StereoDisplay;
StereoDisplay = NULL;
IStereoDisplay::releaseAllLibraries();
} }
void updateCamera() void updateCamera()

View file

@ -42,7 +42,8 @@ namespace NL3D {
class UScene; class UScene;
class UTextContext; class UTextContext;
class ULandscape; class ULandscape;
class CStereoOVR; class IStereoDisplay;
class IStereoHMD;
} }
namespace SBCLIENT { namespace SBCLIENT {
@ -59,7 +60,8 @@ public:
}; };
extern NL3D::UDriver *Driver; extern NL3D::UDriver *Driver;
extern NL3D::CStereoOVR *StereoHMD; extern NL3D::IStereoDisplay *StereoDisplay;
extern NL3D::IStereoHMD *StereoHMD;
extern NL3D::UScene *Scene; extern NL3D::UScene *Scene;
extern NL3D::UTextContext *TextContext; extern NL3D::UTextContext *TextContext;
extern NLMISC::CConfigFile *ConfigFile; extern NLMISC::CConfigFile *ConfigFile;