Document toolboxDocument toolbox

Private & Confidential

Igloo nDisplay Toolkit

Installation Instructions

Copy plugin into project

Copy the Igloo nDisplay Toolkit plugin to the Plugins folder in the root of your project.

If a plugin’s folder doesn’t yet exist; You can make an empty folder called ‘Plugins' in the root of your project.

Plugin folder located in root of a sample project

To check that the plugin has imported successfully;

  • Click Edit → Plugins

  • Under the Installed section on the left will be the Livestreaming group

  • In this group the Igloo nDisplay Toolkit plugin should be installed and active.

    image-20241015-124200.png
    Igloo nDisplay Plugin installed and active

Recommended Additional Plugins

We recommend you also install the nVidia DLSS plugins from their web page.

NVIDIA DLSS - Download and Get Started

DLSS provides increased framerate by up-scaling the camera’s output. As most of nDisplay systems use high resolution outputs, this is incredibly beneficial.

To activate DLSS, please follow the included instructions within the plugin. There are several commands that can be entered on Begin Play. It’s unwise to use the included HUD display, as that will only enter the commands on the master node, unless you write additional blueprints to synchronise the cluster.

Sadly Frame Generation is not yet supported by nDisplay. But once it’s supported, this will double the framerate possible.

Adjust Project Settings

Ensure nDisplay is enabled

Even though the plugin may be enabled, often it can be disabled in project settings leading to an error when trying to load it using switchboard

Editor Configuration

View Plugin Assets

To view the assets within the plugin you’ll need to enable “Show Plugin Assets” within your Content Browser Settings.

Then you should be able to see the Plugins folder on the left hand panel of the content browser. Which can be expanded out to view the Igloo nDisplay Toolkit content.

Igloo nDisplay Test configuration file

This is a test file, that enables you to view the nDisplay output on your system that will be sent to the cave. It looks like this when previewed:

You can use nDisplay Preview to launch this which is found on the top ribbon of your editor

Igloo Crosshair

This is a blueprint that attaches to your player, and replicates itself across the nDisplay system. It provides a crosshair for direction, and allows both OSC and Optitrack to control the player’s location.

Setting up your level

Placing Actors

Drag both the Igloo Crosshair and the nDisplay Test actors into your scene. It doesn’t matter where they are, as their position is dictated entirely by where your player is.

Corrupt Crosshair

One final thing that may become corrupt when importing the prefabs is the material used for the crosshair.

Check that the Texture on the Crosshair material is set to CrossHairOne as the default texture.

Exposure Control

Due to the location of the sun in each viewport, the exposure of each camera can potentially be very different. This leads to artifacts and disjointed visuals within the cave, that ends in a loss of immersion.

To combat this, we recommend setting all exposure to Fixed Manual within the project settings.

 

You can still utilise exposure zones based on post processing volumes, but the exposure needs to be set to manual in these volumes exposure settings.

Delivery

How the nDisplay Cluster will function

The below diagram explains how a standard cluster system functions. There are options to have multiple outputs per cluster node, but we’ve simplified the diagram to be one output (or screen) per node.

 

Installing onto a cluster

Each node in the cluster needs a copy of the build. It cannot effectively run from a shared network location (however for lightweight test builds, this is possible, but there is a large loading overhead)

Igloo are developing a tool to automatically distribute the build between the clusters, but until this product is finished; the files will need to be copied to the exact same location on each cluster node manually.

For instance, each cluster will need the build to be placed in “D:/Realtime/Build_Name_version

 

(c) Igloo Vision 2020