Get Started file / test fails

[mbd-dbc-dk]

Hi there

Could you perhaps provide some "get started" information? I am a bit unsure wheter I actually need to install the Occulus SDK to get this working. Here is what I get on Linux 64 bit:

$ mvn --version Apache Maven 3.0.5 Maven home: /usr/share/maven Java version: 1.7.0_72, vendor: Oracle Corporation Java home: /usr/lib/jvm/java-7-oracle/jre Default locale: da_DK, platform encoding: UTF-8 OS name: "linux", version: "3.13.0-39-generic", arch: "amd64", family: "unix"

$ mvn package

...

T E S T S

Running com.oculusvr.capi.OvrHmdTest Tests run: 2, Failures: 1, Errors: 1, Skipped: 0, Time elapsed: 2.171 sec <<< FAILURE! Running com.oculusvr.capi.OvrLibraryTest Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.012 sec

Results :

Failed tests: testDistortionMesh(com.oculusvr.capi.OvrHmdTest)

Tests in error: testDistortionMesh(com.oculusvr.capi.OvrHmdTest)

Tests run: 3, Failures: 1, Errors: 1, Skipped: 0

It seems the test does not create a mesh.

I realise this is probably way to little information for you to help, but perhaps you can ask me to provide some more information.

Kind regards

[jherico]

Building the project does require the Oculus SDK, but not the official one, since it doesn't create a DLL version. Rather, you need the custom one I maintain here: https://github.com/jherico/OculusSDK

But most people shouldn't really need to build the Jar for themselves, since you can fetch it from the public Maven repositories here: http://repo1.maven.org/maven2/org/saintandreas/jovr/

I haven't really provided a getting started file beyond the readme because the API I'm exposing is just the OVR CAPI methods.

[mbd-dbc-dk]

Hi jherico, thanks for the quick reply.

OK, I get it (now) - but still, what I meant was the "getting started" steps for building the jar - someone may want to do it, e.g. me, as the Linux binaries seems to be broken on my setup (the GlxOpenSomething call crashes, which appears to be referenced here: https://forums.oculus.com/viewtopic.php?f=20&t=16268).

BTW: Your effort is greatly appreciated but the README is somewhat hard to follow - the pom sections could benefit from verbatim tags, and it is slightly confusing that it refers to it self for more information, stuff like that.

And, for your example project, perhaps, if this is correct, you could add the following:

"To build the examples, run mvn package export MAVEN_OPTS=-Djava.library.path=target/natives mvn exec:java -Dexec.mainClass="org.saintandreas.vr.demo.RiftDemo" "

Disclaimer: I hope that is the right way to actually start the programs. :-)

If you wish, I do not mind creating a couple of pull requests with some updates to the readmes, but if you do not care, I wont ;-).

Again, thanks for creating this, and taking the time to answer.

[mbd-dbc-dk]

Sorry, I did not notice that you have written a book, and this is related. I reckon I should get a copy of the book to get more information - I just found this repository through some other channel.

[jherico]

The book mostly covers the use of the Java library, not building it. I'll look into creating some documentation for contributing to or building the library. Thanks for the feedback.