MiddleVR is a Unity plugin designed to enable the deployment of Unity applications to VR systems such as Walls, CAVEs, and other cluster rendering systems.
This guide shows you how to integrate your VIOSO projection calibration into MiddleVR.
1. In VIOSO Software
- Export your calibration in the VWF format. Learn more about that here.
- Create an .ini file for each display in the format below. You only need to change
calibFilepath (exported mapping from VIOSO),
[Channel_Name](of your choice) and
[default] logLevel=2 bLogClear=0 ;clear log file on start base=[1000,0,0,0; 0,1000,0,0; 0,0,1000,0; 0,0,0,1] ; frontal cam left handed, row major, most DX near=0.15 ; the minimum rendering distance, all faces closer than that are culled far=20000 ; the maximum rendering disctance, all faces futher than that are culled bTurnWithView=0 ; set to true, if moving platform alas world turns with view direction bicubic=0 ; set to true to enhance sampling acuracy, will use up some extra GPU calibFile=C:\Users\Public\Documents\VIOSO\VIOSOPlayer\Export\MyCalib.vwf autoViewC=1 ;widen FoV to cover a range of autoViewC * screen bAutoView=1 ;overwrites screen fov and dir [Channel_1] calibIndex=0
2. In MiddleVR 2.0
To add the VIOSO calibration:
- Open MiddleVRConfig.exe
- Create a new Configuration: File > New
- Go to the 3D Nodes tab. Then add a screen for each of your displays.
- In the screen properties, scroll down to ADVANCED and add the corresponding Configuration file path (.ini file) and Channel Name (that you chose in the.ini) . Then press ENTER.
You should now see the coordinate values locked and overwritten by the loaded warper.
Repeat this step for each of the screens.
- Now add a Camera for each display and assign it to its screen.
- In the Viewports Tab, create a viewport for each display and assign its camera
- Your VIOSO calibration is now integrated.
Go back to the APPS tab and click on RUN.
3. Notes & Bug Fixes
To Integrate the versions 2.1 and later of MVR, please follow this manual.
Field of view adjustment
Moving the camera far away from the screen can result in black borders appearing around the screen. To fix this, you can adjust the field of view coverage by increasing the
autoViewC variable in the .ini files until you get no visible black borders on the edges.
To run middleVR on several clusters with a VIOSO calibration make sure you take into consideration these measures:
- Calibration files (.vwf) and configuration files (.ini) must be available on all clusters with the same path. It is recommended to use local drives instead of a common network drive for better performance.
- Assign a viewport to every cluster. In case one cluster node is not part of the projection calibration, simply create a standard screen and camera for it in the 3D nodes tab.
- Follow the cluster configuration guide from middleVR for the initial setup of your multi-cluster system.