Repository files navigation

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

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

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

The Unity integration is based on theManaged-OSVR .NET binding for OSVR, which is maintained in a separate repository. That code is entirely Unity-independent so it can be used in other applications/frameworks.

OSVR-Unity uses the OSVR-RenderManager library for direct-mode rendering, lens correction, timewarp, etc..OSVR-RenderManager is a separate, Unity-independent project that is used in other applications/engines. The project which bridges between OSVR-Unity and OSVR-RenderManger isOSVR-Unity-Rendering, which uses the Unity low-levelnative plugin interface.

These libraries are copied over to the Plugins directory in our CI build, and are not included in the source.

Step-by-step getting started guide

Getting Started Video Tutorial

The development "project" for Unity is in theOSVR-Unity directory. We are currently maintaining support for 4.6.1 as well as 5.x in the same tree, so be aware of that if you're using a newer version that you don't break the older version. (You can parallel-install different versions of Unity, you just need to specify a different install directory). This is the project used to generate the.unitypackage file (there is an editor script that does it for the CI's sake).

TheOSVR-Unity directory contains its ownREADME with some basic documentation that is shipped with the built version, as well as aCHANGES file (also shipped with builds) that should be updated when changes that affect consumers of this project (users of the plugin) are made.

Note that if you're looking at the source OSVR-Unity project and not an imported unitypackage, you'll need to download and import the Managed-OSVR and OSVR-RenderManager project artifacts. The quickest way to obtain the necessary dlls may be to download and import the Plugins folder(s) from the latestbinary snapshot. If you're building Managed-OSVR from source as well, see below.

When thebuild-for-unity.cmd script inManaged-OSVR is run (by the CI or a human), it generates a tree withManaged-OSVR-Unity as the root directory.

install-managed-osvr.cmd can put those files in the right spot if you place theManaged-OSVR-Unity in the root of this repository first. Otherwise, the contents of that (which will be a.dll, and some additional subdirectories and files) should be moved to theOSVR-Unity/Assets/Plugins directory.

This contains the source project used to generate.unitypackage files, since that seems more useful as "source" than a repo containing a.unitypackage file. Any one of the scenes should work to get you in there. There is an editor script to automate the bundling of a.unitypackage for the sake of CI.

• install-managed-osvr.cmd - A script to copy the output of a Managed-OSVR build to the right spot in the current repo, given that you place theManaged-OSVR-Unity directory (produced by thebuild-for-unity.cmd script over in Managed-OSVR) in the root of this repository first.
• prep-package.cmd - Used by CI to create a directory that will eventually be packed as a snapshot, format the Unity readme and other markdown files as HTML, and copy files into the snapshot directory as well as theOSVR-Unity directory. Not used in the course of normal development.
• build-unity-packages.cmd - Used by CI (but potentially others as well) to invoke the Unity editor script that packs the Unity plugin into a.unitypackage file. Requires that the Managed-OSVR build already have been run to copy over the .NET assembly and native DLLs into the right place in the tree. It copies that.unitypackage file into the distribution directory made byprep-package.cmd if that directory exists.
• unity-generate.lua - Generates some very repetitive code wrapping the raw C-style pinvoke callbacks in something more .NET-idiomatic. It can be run with any reasonably recent version of a Lua interpreter, and its output should be placed intoOSVR-Unity/Assets/OSVRUnity/src/InterfaceCallbacks.cs in the designated area (see comments in that file)
• third-party/discount-2.1.6-win32 - This contains binaries of a liberally-licensed Markdown-compatible file formatter, used by CI (specificallyprep-package.cmd) to generate HTML documentation from the markdown files in OSVR-Unity.

Video showing how to integrate OSVR into Unity project can be seen here:https://youtu.be/TtLn6XpEisw

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