Repository files navigation

Maintained athttps://github.com/OSVR/OSVR-Core

For details, seehttp://osvr.github.io

For support, seehttp://support.osvr.com

This is the code and libraries to use when developing with OSVR.

• For developing plugins, you'll use the @ref PluginKit library.
• For developing applications using the framework, you'll use the @ref ClientKit library.

If you're looking at this file in a binary build of OSVR-Core, please seen theBINARY_README file for more targeted information, as this main README file is focused on the source tree.

Seethe HACKING file for some development guidelines for working on this code base itself.

If you're looking at the source tree, not a binary snapshot, you may be interested inbuild docs. You may also be interested in binary snapshots athttp://osvr.github.io .

This project: Licensed under the Apache License, Version 2.0.

Some directories under/vendor are in fact not external libraries vendored-in, but "internally-vendored" - developed as a part of OSVR-Core, and likewise licensed under the Apache License 2.0, but are logically distinct from the Core in their functionality and are thus kept separate in anticipation of potential splitting off into a separate project at some future point. These include/vendor/comutils and/vendor/dummy-sal.

• /cmake - Git subtree fromhttps://github.com/rpavlik/cmake-modules used at compile-time only. Primarily BSL 1.0, some items under the license used by CMake (BSD-style)
• /vendor/catch-single-header-2.8.0 - Header downloaded fromhttps://github.com/catchorg/Catch2/releases/download/v2.8.0/catch.hpp - BSL 1.0 license. Used only for building/running tests.
• /vendor/com_smart_pointer - Header (for integratingboost::intrusive_ptr with MS COM) extracted from the following project and file:https://github.com/rengeln/nyx/blob/master/src/Prefix.h, modified as needed for compatibility. MIT license.
• /vendor/discount-windows-bins - Submodule containing source, build script, and Windows binaries for the "Discount" Markdown processor, used only during the build process on Windows. Upstream athttps://github.com/Orc/discount. 3-clause BSD license.
• /vendor/eigen - Unpacked release fromhttp://eigen.tuxfamily.org/ - header-only library under the MPL2 (a file-level copyleft, compatible with proprietary software), defineEIGEN_MPL2_ONLY to exclude modules with other license from the build (done in OSVR-Core build system).
• /vendor/FloatExceptions - Modified code (original author: Bruce Dawson for development use only, usage should not be committed or merged into master. MIT licensed.
• /vendor/folly - Submodule ofC++11 components originally developed and widely used at Facebook. Apache License, Version 2.0.
• /vendor/jenkins-ctest-plugin - Git submodule fromhttps://github.com/rpavlik/jenkins-ctest-plugin, used only for building/running tests and CI. MIT license.
• /vendor/libcxx-backports - C++11/14 standard library functionality backported into headers using the implementations from the libc++ project athttp://libcxx.llvm.org/. Dual licensed underthe MIT and the "BSD-like" UIUC license.
• /vendor/UIforETWbins - Distributed binary releases of UIforETWhttps://github.com/google/UIforETW extracted to a Git repo (submodule) unmodified. Apache License, Version 2.0.
• /vendor/util-headers - Subset of headers installed fromhttps://github.com/rpavlik/util-headers. BSL 1.0.
• /vendor/vrpn - Git submodule, accessed fromhttps://github.com/vrpn/vrpn. BSL 1.0. Contains optional recursive submodules HIDAPI and libjsoncpp.