Newer
Older
This library is intended to allow for testing different HMD SDKs for C, C++ and Python applications.
The so called bridge is a high-level wrapper, that abstract the implementation of each of the supported SDKs.
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
Building Requirements
---------------------
* CMake
* Oculus
* Oculus SDK 0.7
* Oculus Run-Time
* Windows
Code Structure
--------------
```
//build [-]
//cmake
//examples
|--> c
|--> cpp
|--> python
|--> ...
//extern
|--> glew
|--> ...
//python
|-->bridge
|-->__init__.py
//source
|--> HMD_Bridge_API.h
|--> *.cpp
|--> *.h
//tests (automatic tests)
CMakeLists.txt
INSTALL
LICENSE
README
```
`[-]` (hmd_sdk_bridge_build.git)
Build Structure
---------------
hmd_sdk_bridge_build.git
```
//include
|--> HMD_Bridge_API.h [+]
//lib/x64
|--> BridgeLib.dll
|--> BridgeLib.lib
|--> BridgeLib.so
|--> BridgeLib.dylib
//lib/x86
|--> BridgeLib.dll
|--> BridgeLib.lib
|--> Bridge.so
//bridge [+]
__init__.py [+]
README
```
``[+]`` (files copied/duplicated from hmd_sdk_bridge.git)
1. Run CMake
2. Set OCULUS_SDK_DIR
[C:\OculusSDK\LibOVR]
3. Build (make)
4. Install (make install)
Install
-------
The installation routine populates the //build folder with the API,
include, the Python wrapper code and the built library.
//build/lib/x86
|--> BridgeLib.dll (from: Win32/Release/BridgeLib.dll)
|--> BridgeLib.lib (from: Win32/Release/BridgeLib.dll)
//build/lib/x64
|--> BridgeLib.dll (from: x64/Release/BridgeLib.dll)
|--> BridgeLib.lib (from: x64/Release/BridgeLib.dll)
Besides that, for legacy reasons, the Oculus SDK 0.5 library is to be found there already:
//build/lib/x84
|--> libOculusVR.dylib
|--> libOculusVR.so
|--> OculusVR.dll
//build/lib/x64
|--> libOculusVR.dylib
|--> libOculusVR.so
|--> OculusVR.dll
After building for the different platforms, the `build` folder can be pushed upstream, and its
submodule hash should be updated in the main repository.
No automated tests are setup at this moment. But they will live in `tests`.
Source Installation
-------------------
```
$ git clone https://github.com/dfelinto/hmd_sdk_bridge.git
$ cd hmd_sdk_bridge
$ git submodule update --init --recursive --remote
```
Source Update
-------------
```
$ git pull origin
$ git submodule update --recursive --remote
```