Scenarios may be created within a projection theatre with different settings for Geometry, Edge Adjustments, Colour and Gamma, for different times of the day. For example, a “Scenario (0% light)” would indicate complete darkness whereas “Scenario (100% light)” would indicate full daylight. During live operation, the system can be “instructed” that the light intensity is a particular, theoretical, value. The system will then automatically interpolate new settings for all adjustments except Geometry adjustment from actual settings of the two closest scenarios to the introduced theoretical. This instruction must come from the simulator host or some other part of the simulator connected to the host and must be a Light Level message according to the CompactLink protocol.

Other documentation

Other documents recommended for reading in conjunction with this manual are:


This article describes what a scenario is, which parameters it can control and how to switch between scenarios or interpolate between their light levels.

What is a scenario?

A scenario is a set of theatre parameters that are associated with a name and a light level. The following parameters that are scenario controlled per channel:

  • analogue input contrast, brightness and colour settings
  • projector contrast and brightness
  • black level adjustment
  • colour adjustment
  • edge adjustment
  • gamma adjustment
  • hotspot adjustment
  • mask adjustment

The values used for these scenario controlled parameters is control by:

  • manually selecting a scenario
  • setting the light level for the theatre by means of the interpolation test
  • sending a command through the external CompactLink interface

Scenario Manager

The scenario manager is used to create, rename, delete scenarios. The Scenario Manager tool will open by selecting the Scenario Manager icon in the Tools toolbar.

Create a scenario

A scenario can be created by selecting the Scenario icon in the Scenario section of the Home toolbar. The values, for scenario controlled parameters, for the new scenarios will have the value they had when the scenario is created. When a scenario is created, it is also the active scenario at that moment.

Add and lock scenario in the Home toolbar

Scenario Manager dialogue

Each scenario can have a name, like ‘Day Time’, which can be assigned by selecting the Rename button in the scenario manager. If no name is assigned, the default name will be scenario x, where x is a sequence number. At which light level (a value between 0% and 100%) the scenario is active is set by the Light level parameter in the scenario manager. One can select a scenario to become active by selecting a different scenario from the Scenario pull-down list in the scenario manager. Changing a value any scenario controlled parameter will cause the new value to be associated with the active scenario.

Weight information for adjustments

The influence of a certain adjustment can be controlled by setting its weight for a certain scenario. For example when software (nBox) edge blends are used during day time (light level 100%) scenario and only optical blenders are used during night time (light level 0%), the weight for the edge blend adjustment should be set to 0% for the night time scenario.

Weight parameter for scenario controlled adjustments

Testing Scenarios

Once at least 2 scenarios are created they can be tested by either switching between them by means of the Scenario pull down list in the scenario manager or by using the interpolation test available in the scenario manager.

Interpolation test dialogue

The slider in the interpolation test can be set at any value between 0 and 100%. nControl will for each value interpolate the scenario controlled parameters between the values for those parameters set for the scenario with nearest light level higher and lower than the set value in the interpolation test.

Scenario set-up workflow

Default there are no scenarios in an nControl theatre. Workflow for setting up scenarios is a follows:

  1. Create a scenario (select Scenario button in the Scenario section of the Home toolbar)
  2. Give a meaning full name( like ‘Day’, Twilight’, ‘Night’) to the scenario in the scenario manager
  3. Assign a light level value to the scenario. For example 100% for daylight at noon, 50 for twilight/sun set and 0% for night time.
  4. Change the scenario controlled parameters to the desired values
  5. Repeat steps 1 to 4 for each desired scenario

Extra scenarios need to be created when the scenario controlled parameters should have a value different from the linear interpolation of existing scenarios closest to a certain light level.

When managing scenarios it is practical to disable external control of the light level by means of the Lock Scenario button in the Scenario section of the Home toolbar.

Add and lock scenario in the Home toolbar

External scenario control

The UDP based Compact Link protocol can be used to set the light level in nControl and as such controls the scenario controlled parameter values. When the user uses the interpolation test or locks the scenario, by means of the Lock Scenario button in the Scenario section of the Home toolbar, the external control is disabled.

Compact Link control

A light level command can be sent to nControl using the CompactLink protocol. The command has the following syntax:

The light level is encoded as a numeric value, where 0.0 means total darkness, and 1.0 is maximum daylight. The number of decimals to use is up to the application. For this to have an effect, the projection theatre must have been set with settings for different light levels. If nControl receives any values other than those defined, the actual settings will be interpolated between the defined settings.

Value 0.0 represents 0% and value 1.0 represents 100% in nControl.

Default UDP port 56341 is used.

An example python script for sending various values can be seen below. It steps from level 0.0 to 1.0 in increments of 0.1 and back:

import socket

import time

sock = socket.socket(socket.AF_INET,socket.SOCK_DGRAM)

lightLevel= 1.0

for ll in range(10):

    lightLevel= ll/10.0;

    lStr="*LL %5.3f" % (lightLevel)

    print lStr



for ll in range(10):

    lightLevel= (10-ll)/10.0;

    lStr="*LL %5.3f" % (lightLevel)

    print lStr



Incoming light level messages can are logged in the object inspector in nControl. Navigate to object inspector:

Navigation to the Object Inspector

In the object inspector the information can be found under Compact Link

Logging of light level commands