• Home
  • Knowledge Base
    • Licensing
    • Operation
    • Quality Improvement
    • References
  • Documentation
    • VIOSO Core
    • VIOSO Anyblend
    • VIOSO Anyblend VR&SIM
    • VIOSO Integrate
    • VIOSO Player
  • FAQ
    • Error and other feedback
    • Licensing
    • System & Requirements
  • Videos
  • Home
  • Knowledge Base
    • Licensing
    • Operation
    • Quality Improvement
    • References
  • Documentation
    • VIOSO Core
    • VIOSO Anyblend
    • VIOSO Anyblend VR&SIM
    • VIOSO Integrate
    • VIOSO Player
  • FAQ
    • Error and other feedback
    • Licensing
    • System & Requirements
  • Videos

VIOSO Integrate

home/Documentation/VIOSO Integrate
Expand All Collapse All
  • VIOSO Integrate Overview
  • VIOSO Integrate VS Integrate Plus
  •  Media Playback Solutions
    •   AV Stumpfl Pixera
      • Running Pixera Autocal standalone
      • UV-Mapping and 3D calibration
      • Multi-client setups
    •   Vertex VIOSO & IOVERSAL Vertex
      • AutoCal Single Camera: Getting started
      • Modifying, Optimizing and Recalibration
      • Using Autocal Standalone
  • Dome- and Planetarium Solutions
  •  3D Engines
    • VIOSO Unity Plugin
    • VIOSO Unreal Engine Integration
    • VIOSO MiddleVR Integration
  •  Simulators
    • AVSimulation: SCANeR Studio
    • rFactor Pro
    • Prepar3D
  • Projector Integration
  •  VIOSO WarpBlend API
    • API usage on Windows
    • API usage on Linux
    • Implementation Remarks
    • VIOSOWarpBlend.ini Reference
    •   API Examples
      • Example 1 - Simulator with moving platform
      • Example 2 - Another simulator with moving platform
      • Example 3 – Cave
      • Example 4 – Video player

VIOSO Unity Plugin

1238 views 1

Emanuel
April 30, 2020

Download the plugin from the Unity asset store

The plugin allows you to integrate your display calibration directly into a Unity Application.

Table of Contents

  • In VIOSO Core
  • In Unity3D
  • Notes
  • Bug fix- Cameras not displaying in the correct order:
    • 1st fix: Camera Target Display
    • 2nd fix: Camera Calibration Index
  • FAQ:
    • Does this plugin support URP / HDRP?
    • What does it look like for volumetric effects and boundaries/frustrum culling?

In VIOSO Core

Perform a calibration with Anyblend VR&SIM or VIOSO Integrate plus either in 2D (for static warping and blending) or 3D (model based for advanced dynamic features)

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

  • From the menu bar, go to File > Export Mapping
  • Select the VWF format.
  • Uncheck the “use settings from file” and if applicable check the “3D” box .
  • Choose a file name and path.
  • Click on Export.

Click here to learn more details about how to export VWF files.

In Unity3D

  1. Open your Unity Project.
  2. Download and import “Multi-Projection Integration for Warping and Blending” asset to your project.

    Click on “Import“

  3. Navigate to the plugin directory “Assets\Plugins\vioso” and add your mapping file (.vwf) to that folder.
  4. Add VIOSOcamera.cs script to each of your Camera Objects (Assets\Plugins\vioso\VIOSOcamera.cs)

    (!) The Camera for the main monitor (Display 1) should not contain the script, as it’s usually not part of the calibration.

  5. VIOSOWarpBlend.ini Configuration:
    Open Assets\Plugins\vioso\VIOSOWarpBlend.iniAdd the parameters for your cameras as shown below:
  • calibFile=:  Name of .VWF file(s).
  • name: Name of the Camera GameObject in Unity.
  • CalibIndex : Assign the Index according to your VIOSO calibration.

Optionally, you can:

  • Add your Pivot Point coordinates by editing the highlighted X,Y,Z parameters of the base matrix as shown below:
    • Base = [1000, 0, 0,0; 0, 1000, 0, 0; 0, 0,  -1000, 0; X, Y, Z, 1]
    • (X,Y,Z)=(0,0,0) being the center of the projection screen.
  • Enable Dynamic Eyepoint by setting eyePointProviderParam to listen to a specific port using UDP protocol (i.e = port 999)

 

6. The Integration is now complete. You can preview it by running the player and switching between displays (see note 2 below). If everything looks good, Build your project.

7. Copy the vioso3d.vwf and VIOSOWarpBlend.ini files from Unity Assets/plugin/vioso to folder [your_build_path..]/_data/plugin/ next to ViosoWarpBlend.dll.

8. Launch your application and enjoy the integrated calibration.

Notes

  1. Make sure you activate multi-display support in your Unity Application.
    Unity’s default display mode is one monitor only. When you run your application, you need to use Display.Activate() to explicitly activate additional displays.
    Follow the Unity Manual https://docs.unity3d.com/Manual/MultiDisplay.html
  2. The multi-display feature of Unity only runs in the built standalone application.
    However, you can preview your displays in the Editor by running the project (Play button), then navigating through displays in the Game tab to see the different calibrated outputs:
  3. Unity’s multi-display system can enable only a maximum of 8 displays. If you want to work around this limitation, and use digital compounds for example (Nvidia Mosaic, Surround, Eyefinity, Datapath..etc) you must configure split screen outputs for your project using a render texture for each camera, find here an example of this use-case.
  4. Make sure you only have one audio listener in the scene. Therefore, remove this component from all of your cameras except one:
  5. Dynamic Eyepoint: Enable Dynamic Eyepoint in VIOSOWarpBlend.ini by setting eyePointProviderParam to listen to a specific port using UDP protocol (i.e = listen 999). The format of the coordinates is the following: Px Py Pz Rx Ry Rz where P is the position and is the rotation. For a simple test, you can use =sinewave to undulate all axes and angles in a loop, or download our Eye Tracker Simulator here.
  6. You can manually add the following parameters to your cameras in VIOSOWarpBlend.ini:dir= [x,y,z] : Direction.fov=[x,y,z,w] : Field of view. They will be recalculated automatically and overwritten if bAutoView = 1.
  7. Make sure you build for x86_64 Architecture.
    File > Build Settings:
  8. Please check VIOSO_Plugin64.log in the build directory \plugin to examine the status and errors of the integration.

Bug fix- Cameras not displaying in the correct order:

1st fix: Camera Target Display

  • Select a camera.
  • From the Inspector window, go to Camera > Target Display
  • Select the corresponding display according to the index from the Windows Display Settings.

 

2nd fix: Camera Calibration Index

  • Open the .vwf file and verify that the calibration index corresponds to the one you assigned in the VIOSOWarpBlend.ini file.

3d VWF preview

 

FAQ:

Does this plugin support URP / HDRP?

Unfortunately not. It works only with the built-in SRP (Scriptable Render Pipeline) at the moment.

What does it look like for volumetric effects and boundaries/frustrum culling?

Such effects should work: We positively tested frustum culling, additionally there is a parameter in our plugin in the (.ini) file that defines rendering boundaries with near/far distances.
We also tested volumetric light effects with Aura, which also worked.

Was this helpful?

1 Yes  No
Related Articles
  • VIOSO Integrate Overview
  • AVSimulation: SCANeR Studio
  • rFactor Pro
  • Prepar3D
  • AutoCal Single Camera: Getting started
  • VIOSO Integrate VS Integrate Plus
  • Ticket System
  • VIOSO Home
  • Imprint
  • Forum
  • © 2020 VIOSO GmbH. All Rights Reserved.

We use cookies on our website to give you the most relevant experience by remembering your preferences and repeat visits. By clicking “Accept”, you consent to the use of ALL the cookies.
Do not sell my personal information.
Cookie settingsACCEPT
Manage consent

Privacy Overview

This website uses cookies to improve your experience while you navigate through the website. Out of these, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may affect your browsing experience.
Necessary
Always Enabled

Necessary cookies are absolutely essential for the website to function properly. This category only includes cookies that ensures basic functionalities and security features of the website. These cookies do not store any personal information.

Non-necessary

Any cookies that may not be particularly necessary for the website to function and is used specifically to collect user personal data via analytics, ads, other embedded contents are termed as non-necessary cookies. It is mandatory to procure user consent prior to running these cookies on your website.

SAVE & ACCEPT