GitHub - indianajohn/jopenvrwrapper: A wrapper around jopenvr, designed to ease development of VR applications in Java.

This package is a wrapper around jopenvr, which in turn wraps the binary libraries distributed with the OpenVR C API. jopenvr can be found as part of the Vivecraft project:

https://github.com/jrbudda/Vivecraft_110/tree/

When looking for a way to get an OpenGL project of mine working with the Vive, I looked around for a suitable OpenVR wrapper and could find none at the time. Vivecraft was the closest I could find, but it was not designed to be encapsulated and removed for use in different projects. This wrapper is meant to allow my project and maybe others work easily without adding a lot of application-specific adaptation.

The package is designed to insulate the user from making calls to OpenVR directly to avoid the need to deal with native data structures or debug the underlying C API calls. The basic usage is:

Instantiate OpenVRProvider.
Register any classes that you would like as ControllerListener implementers.
Instantiate OpenVRStereoRenderer in your render thread after creating your OpenGL context.
Every iteration of your render thread, bind the left eye frame buffer, retrieve the projection matrix and pose matrix for the left eye, pass them to your shaders, render, call glFinish() and any other frame clean up code, and then do the same for the right eye.

This process is demonstrated in examples/HelloWorld.java. Relevant parts are taggged with OPENVR:.

public class HelloWorld {
        public void run() {
            init();
            loop();
    }

    private void init() {
        // OpenGL and window setup
        // ...
        // OPENVR: Disable v-sync. This is important for VR to get high frame rates.
        glfwSwapInterval(0);
        // ...
    }

    private void loop() {
        // Create the OpenGL context
        GLContext.createFromCurrent();
        // ...

        // OPENVR: create the rendering context for the eyes.
        // This object must be constructed after a valid GLContext exists.
        vrRenderer = new OpenVRStereoRenderer(vrProvider,1280,720);

        // ...

        while ( glfwWindowShouldClose(window) == GL_FALSE ) {
            for (int nEye = 0; nEye < 2; nEye++)
            {
                // OPENVR: bind the FBO associated with the target eye
                EXTFramebufferObject.glBindFramebufferEXT(GL_FRAMEBUFFER_EXT,vrRenderer.getTextureHandleForEyeFramebuffer(nEye));

                // OPENVR: get rendering transformations
                // Get projection and pose matrices from OpenVR.
                Matrix4f matMVP = vrProvider.vrState.getEyeProjectionMatrix(nEye).mul(vrProvider.vrState.getEyePose(nEye));
                shader.setUniformMatrix("MVP", false, matMVP);

                // ...
                // rendering code

                // OPENVR: submit frame
                vrProvider.submitFrame();
            }
        }
    }

    public static void main(String[] args) {
        // OPENVR: object initialization.
        OpenVRProvider provider = new OpenVRProvider();
        try {
            // OpenVR: add a controller listener. Could also be this class if we wanted.
            provider.vrState.addControllerListener(new SampleControllerListener());
            Thread vrPoller = new Thread(provider, "vrPoller");
            vrPoller.start();
            SharedLibraryLoader.load();
            HelloWorld app = new HelloWorld();
            app.setVRProvider(provider);
            app.run();
            vrPoller.join();
        } catch (Exception e) {
            System.out.println("Unhandled exception: " + e.toString());
        }
        System.out.println("Exited normally.");"
}

A build.gradle file is included as well as a pre-made Gradle wrapper; on any machine with the JDK on it, running this should be as simple as running:

Or, for IDE support: