Documentation: Augmented Reality with Ovrvision

Augmented Reality with Ovrvision Stereo Cameras

If you have an Ovrvision Pro stereo video camera rig, you can use MARUI in your real environment by it’s using Augmented Reality mode.
The following videos show examples of using Ovrvision for AR modeling:
https://youtu.be/RrsMaShzVq0
https://youtu.be/vku8xTv4QW0

How to use

  • Attach your Ovrvison Pro cameras (http://ovrvision.com) to your VR head-set (Oculus Rift or HTC Vive) and make sure its cable is plugged in.
  • Place a copy of the “ovrvision.dll” in the same directory as your MARUI-PlugIn (.mll) file. You can download “ovrvision.dll” here: ovrvision.dll.zip.
  • The next time you start MARUI, an option to use Ovrvision will appear in the MARUI start-up dialog:

Wizard Ovrvision
You can start or stop the Ovrvision cameras during runtime with the MEL command:
MARUI_AR -active “ovrvision” <true|false>;

The MARUI Ovrvision Calibration Tool

If the visual quality is not optimal, you can improve it by using MARUI’s ovrvision calibration tool.
You can download the MARUI Ovrvision Calibration tool at:
https://www.marui-plugin.com/download/MARUI_Ovrvision_Calibration_Tool.zip

Preparation:

This tool includes a “checkerboard.pdf” or “checkerboard.jpg” file used for calibration.
This calibration pattern pattern is intended to be printed on a A4 paper.
If you cannot print it on a A4 sized paper, you can use a different paper size or open the file on your computer so that it will be displayed on your screen.
In this case, you need to measure the size of the rectangles (on an A4 paper, the rectangles should be 25mm x 25mm in size).

Running the calibration tool:

1.) Make sure that you Ovrvision Pro camera is connected to your PC by USB cable.

2.) Start the tool by executing the “Calibrator.exe” file.

3.) Confirm or adjust the information regarding the checkerboard pattern.
If the squares of your checkerboard pattern are not 25mm wide, please input the correct value here.
If you are using a different checkerboard pattern than the one provided with the calibration tool, you need to count the numbers of inner corners (both horizontally and vertically) and input the numbers as well.
Ovrvision Calibrator

4.) A window will open and display a live video stream from the Ovrvision Pro cameras.
Move either the Ovrvision Pro camera rig or the checkerboard pattern so that it is visible in both images.
Press the left mouse button to take a snapshot of the current video image. The calibration tool will attempt to detect the calibration pattern in both images.
If the checkerboard pattern was successfully detected, the tool will save the data for later calibration.
Proceed by taking another snapshot from a different angle and different distance.

5.) Repeat this taking pictures from different angles until you have collected about 10 to 20 snapshots.

6.) Press the right mouse button to end the capturing phase.
The calibration tool will start to calculate the distortion and rectification parameters for your cameras.
This may take several minutes, depending on the number of snapshots collected.

7.) When the calculations have been completed, the tool will output two files: “MARUI_ovrvision_camL.txt” and “MARUI_ovrvision_camR.txt”.
These files contain the calibration data.
Please place them in the same directory as your MARUI plug-in file (eg. the folder where your “MARUI_v2-0-9_Maya2018.mll” file is).

In some cases, the calibration result is not satisfactory.
This can happen if the number of collected snapshots is too low or the angles and distances from which the snapshots were taken were inappropriate.
If this happens, please repeat the calibration process.
If the problems persists, please contact support at contact@marui-plugin.com