Нема описа

Philipp Zabel c1e63f35f1 travis: enable building the OpenGL example пре 7 година
cmake 5af90501df Fix typos пре 7 година
examples b3d67932da Fix OpenGL example autotools build for Mac OS X (#143) пре 7 година
include b3480c14ac Update library soname version to 0.1.0, package version to 0.3.0 (#123) пре 7 година
pkg-config b3480c14ac Update library soname version to 0.1.0, package version to 0.3.0 (#123) пре 7 година
src a626be2f83 Use LOG macros to log messages in drivers (#144) пре 7 година
tests 2a3b34b612 Final controller API changes, with NOLO controllers implemented as functional example (#113) пре 7 година
.gitignore ea2491cf8b Add autotools generated files to the .gitignore. пре 9 година
.travis.yml c1e63f35f1 travis: enable building the OpenGL example пре 7 година
CMakeLists.txt 4146069f0b Fix cmake build for Windows Mixed Reality support пре 7 година
Doxyfile 8b09a0756e Improve documentation пре 9 година
LICENSE a1662d7816 Initial Commit пре 12 година
Makefile.am 8cb31c5953 Moved examples from test/ to example/ subdirectory and updated README.md. пре 12 година
README.md 572bea67a3 Meson (#122) пре 7 година
autogen.sh a1662d7816 Initial Commit пре 12 година
configure.ac b3d67932da Fix OpenGL example autotools build for Mac OS X (#143) пре 7 година
meson.build 3101dec8a7 Meson: add missing gl dependency to OpenGL example пре 7 година
meson_options.txt 572bea67a3 Meson (#122) пре 7 година

README.md

OpenHMD

This project aims to provide a Free and Open Source API and drivers for immersive technology, such as head mounted displays with built in head tracking.

License

OpenHMD is released under the permissive Boost Software License (see LICENSE for more information), to make sure it can be linked and distributed with both free and non-free software. While it doesn't require contribution from the users, it is still very appreciated.

Supported Devices

For a full list of supported devices please check https://github.com/OpenHMD/OpenHMD/wiki/Support-List

Supported Platforms

  • Linux
  • Windows
  • OS X
  • Android
  • FreeBSD

Requirements

Language Bindings

Other FOSS HMD Drivers

Compiling and Installing

Using Meson:

With Meson, you can enable and disable drivers to compile OpenHMD with. Current available drivers are: rift, deepon, psvr, vive, nolo, wmr, external, and android. These can be enabled or disabled by adding -Ddrivers=... with a comma separated list after the meson command (or using meson configure ./build -Ddrivers=...). By default all drivers except android are enabled.

meson ./build [-Dexamples=simple,opengl]
ninja -C ./build
sudo ninja -C ./build install

Using make:

./autogen.sh # (if you're building from the git repository)
./configure [--enable-openglexample]
make
sudo make install

Using CMake:

With CMake, you can enable and disable drivers to compile OpenHMD with. Current Available drivers are: OPENHMD_DRIVER_OCULUS_RIFT, OPENHMD_DRIVER_DEEPOON, OPENHMD_DRIVER_WMR, OPENHMD_DRIVER_PSVR, OPENHMD_DRIVER_HTC_VIVE, OPENHMD_DRIVER_NOLO, OPENHMD_DRIVER_EXTERNAL and OPENHMD_DRIVER_ANDROID. These can be enabled or disabled adding -DDRIVER_OF_CHOICE=ON after the cmake command (or using cmake-gui).

cmake .
make

Configuring udev on Linux

To avoid having to run your applications as root to access USB devices you have to add a udev rule (this will be included in .deb packages, etc).

A full list of known usb devices and instructions on how to add them can be found on: https://github.com/OpenHMD/OpenHMD/wiki/Udev-rules-list

After this you have to unplug your device and plug it back in. You should now be able to access the HMD as a normal user.

Compiling on Windows

CMake has a lot of generators available for IDE's and build systems. The easiest way to find one that fits your system is by checking the supported generators for you CMake version online. Example using VC2013.

cmake . -G "Visual Studio 12 2013 Win64"

This will generate a project file for Visual Studio 2013 for 64 bit systems. Open the project file and compile as you usually would do.

Cross compiling for windows using mingw

Using Make:

export PREFIX=/usr/i686-w64-mingw32/ (or whatever your mingw path is)
PKG_CONFIG_LIBDIR=$PREFIX/lib/pkgconfig ./configure --build=`gcc -dumpmachine` --host=i686-w64-mingw32 --prefix=$PREFIX
make

the library will end up in the .lib directory, you can use microsoft's lib.exe to make a .lib file for it

Using CMake:

For MinGW cross compiling, toolchain files tend to be the best solution. Please check the CMake documentation on how to do this. A starting point might be the CMake wiki: http://www.vtk.org/Wiki/CmakeMingw

Static linking on windows

If you're linking statically with OpenHMD using windows/mingw you have to make sure the macro OHMD_STATIC is set before including openhmd.h. In GCC this can be done by adding the compiler flag -DOHMD_STATIC, and with msvc it can be done using /DOHMD_STATIC.

Note that this is only if you're linking statically! If you're using the DLL then you must not define OHMD_STATIC. (If you're not sure then you're probably linking dynamically and won't have to worry about this).

Pre-built packages

A list of pre-built backages can be found on http://www.openhmd.net/index.php/download/

Using OpenHMD

See the examples/ subdirectory for usage examples. The OpenGL example is not built by default, to build it use the --enable-openglexample option for the configure script. It requires SDL2, glew and OpenGL.

An API reference can be generated using doxygen and is also available here: http://openhmd.net/doxygen/0.1.0/openhmd_8h.html