Unity URP example project with Vioso integration for the Lablab studio. You can find the HDRP template here.
If you are a first time user, we recommend installing this sample project first to ensure that everything is working correctly. To install this project, follow the steps "Installing the sample project" below.
If you are an experienced user and already have an existing project, follow the "Merging into your project" steps below.
-
Download or clone this project on your computer.
-
Download the Vioso calibration file here and add it to the Assets/Plugins/Vioso/ folder.
-
Open the SampleScene scene.
-
Follow the Game View setup below.
-
Press Play. You should see the wall outputs in the first game view, and the floor outputs in the second game view, as shown in the screenshot below.
-
Copy the Assets/Plugins/Vioso folder from this project into the Assets/Plugins folder of your project.
-
Copy the Assets/ProjectionSetup folder from this project into the Assets folder of your project.
-
Copy the Assets/Resources folder from this project into the Assets folder of your project.
-
Download the Vioso calibration file here and add it to the Assets/Plugins/Vioso/ folder.
-
Add the VIOSO Render Feature to your Univeral Renderer Data, and link the VIOSOWarpBlendPP shader to the Shader parameter of that feature.
- Disable Render Graph (enable URP compatibility mode) by going into Project Settings -> Player -> Add the URP_COMPATIBILITY_MODE scripting define.
Note
Compatibility mode is deprecated in Unity 6.3 but this fix is necessary until Vioso URP plugin is upgraded to support Render Graph.
-
Replace the camera in your scene by the ProjectionSetup prefab from the ProjectionSetup/Prefab folder.
-
Follow the Game view setup below.
To work with the Lablab video projectors setup, the Unity application creates 3 full screen windows. The window on display 1 is for the wall outputs, the window on display 2 is empty as it is the monitoring display, the window on display 3 is for the floor outputs.
To previsualize this in Unity :
-
Open a first Game View tab, set its output to Display 1, and its resolution to 3840x2400.
-
Open a second Game View tab, set its output to Display 3, and its resolution to 3840x2400.
With this setup, you should see the following output in the sample scene :
- If you have a black screen on your game outputs when enabling Vioso in play mode, make sure you have MSAA enabled (2x or more) in your Universal Render Pipeline Asset.
After building your application, copy the vioso calibration file (.vwf) and VIOSOWarpBlend.ini files from the Unity Assets/Plugins/Vioso folder to your build folder in [your_build_path..]/[your_application_name]_Data/Plugins/[your_architecture]/ next to the ViosoWarpBlend.dll file.
Note
When building for Windows 64 bits, the ViosoBuildPostProcessor script should automatically make this copy.
The projection setup for the Lablab studio is created in the ProjectionSetup prefab located in the ProjectionSetup/Lablab/Prefab/ folder.
Add this prefab to your scene and disable other cameras in order to setup your scene for projection in the Lablab studio.
Tip
The Lablab studio model is disabled by default in the prefab. You can activate it for debugging purposes by enabling the Lablab object in the ProjectionSetup prefab.
For example in this project SampleScene, this projection setup as been added to the First person controller to replace the default camera of the First person controller.
In the ProjectionSetup prefab, the Lablab object is a 3D model of the studio for debugging purposes. It is enabled to help you visualize the physical space of the studio in your 3D world and validate the outputs. Once it is setup correctly, you can disable the Lablab component of the ProjectionSetup to see the final output of your scene.
Last tested with Unity 6000.3.0f1.