VIOSO Anyblend VR&SIM and VIOSO Integrate Plus let you export your warp and blend calibrations to the driving simulation software rFpro. Using the built-in VIOSO image plugin, you can easily apply the auto-alignment of your projectors in both single and multi-channel simulation setups, with supported dynamic warping for motion platforms and eye tracking.

Integration guideline:

1. In VIOSO Core

1.1. 3D calibration

Perform a camera based 3D calibration with Anyblend VR&SIM or VIOSO Integrate Plus following the workflow from this guide: 3D calibration

1.2. Export Mapping

After a successful calibration of your displays, export your mapping in the VWF format:

• From the menu bar, go to File > Export Mapping
• Select your compound display.
• Select the VWF format.
• Make sure the 3D box is checked.
• Choose a file name and path.
• Click on Export.

Alternatively, you can use an export script to automate the file distrubution to all instances, e.g:

<?xml version="1.0"?>
<VIOSO>
<File version="1.0.0" />
<CalibCommerceTask Typ="export" Format="vwf" >
<CommonParam bSilent="0" bSeparatedSplitDisp="1" bAllToMaster="1" bBlankUnusedSplitDispParts="0" bExactFileName="0"
FileName="_tmp.vwf" />

<TransferTask Format="vwf" Core="192.168.1.110" bUse3D="1" >
<Destination Core="192.168.1.110" FileName="C:\Users\Public\Documents\VIOSO\Anyblend\Export\_Startup.vwf" />
</TransferTask>
<TransferTask Format="vwf" Core="192.168.1.111" bUse3D="1" >
<Destination Core="192.168.1.111" FileName="C:\Users\Public\Documents\VIOSO\Anyblend\Export\_Startup.vwf" />
</TransferTask>

<TransferTask Format="vwf" Core="192.168.1.112" bUse3D="1" >
<Destination Core="192.168.1.112" FileName="C:\Users\Public\Documents\VIOSO\Anyblend\Export\_Startup.vwf" />
</TransferTask>
</CalibCommerceTask>
</VIOSO>

2. In rFpro

1. 1. From the rFpro admin console, go to the “Display” and enable VIOSO Warp&Blend Plugin from the Image Plugin list.
      * Alternatively, you can enable/disable warp and blend individually  for each channel from the “Config” tab as following:
      
2. Configure VIOSOWarpBlend.ini file on each machine to refer to the calibration file (*.vwf):
   [your_directory]\20xx.x\rFpro\VIOSOWarpBlend.ini
   If the file is missing please create it with the following template:

[default]
logLevel=2
bLogClear=1 ;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=1 ; 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\Anyblend\Export\_Startup.vwf ; Here you precise the path of your calibration file

;eyePointProvider=EyePointProvider ;specify some library name to query view parameters from. If unset, IG has to provide view parameters.
;eyePointProviderParam=sinewave

autoViewC=1 ;if viewplane is skewed, widen FoV to cover a moving range of autoViewC * screen
bAutoView=1 ;overwrites screen fov and dir

3. Notes

1. 1. To check if your version of rFpro contains the VIOSO image plugin, look for the VIOSOPlugin.ini file under
      [your_directory]\20xx.x\rFpro_Dedi\Plugins

      The file is in the format below, and you can edit it to specify camera and motion parameters:

      [General]
      ConsoleEnabled=False
      ConfigurationFile=.\Plugins\VIOSOWarpBlend.ini
      [MotionGain]
      PositionX=1.000
      PositionY=1.000
      PositionZ=1.000
      Yaw=1.000
      Pitch=1.000
      Roll=1.000
      

   2. Make sure you check the VIOSOPlugin log file for information about the status and errors of your warp and blend setup:
      [your_directory]\20xx.x\UserData\LOG\ViosoPlugin.log
   3.  Check if there are any shaders in rFpro GameData\SharedDX11 that are doing flipping / mirroring..etc.
   4. To learn more about how to set up IGs in rFpro and configure rendering, check out these documentation pages in your rFpro install directory:
      [your_directory]\20xx.x\Docs\rFpro_Installation_Guide.pdf
      [your_directory]\20xx.x\Docs\rFpro_Installation_of_Multiple_Instances.pdf