Skip to content

Multiclient Configuration (Abstract Displays)

“Abstract displays” allows you to handle projectors that are connected on different machines than the master running VIOSO Software. Abstract Displays virtualize the projectors connected on remote machines during the calibration:

This example shows 4 projectors connected on 2 clients. By using "Abstract Display" configuration, the Master can access all 4 projectors during calibration

Abstract Displays virtualize any number of projectors on the master and make them available during the calibration. The configuration of abstract displays is stored in the configuration file: SPSurDef.ini in the global program configuration directory.

Location of SPSurDef.ini:

ApplicationLocation of SPSurDef.iniPort
VIOSOC:\ProgramData\VIOSO\VIOSO6\8317
VIOSO Pixera ModuleC:\ProgramData\VIOSO\VIOSO6_AVStumpfl\8317
Digital Projectin Advanced AlignC:\ProgramData\VIOSO\VIOSO6_Digital Projection\SPSurDef.ini8317
VIOSO AnyblendC:\ProgramData\VIOSO\Anyblend5\8080
VIOSO PlayerC:\ProgramData\VIOSO\VIOSOPlayer\8080
AV Stumpfl AutocalC:\ProgramData\AutoCal\8080
Customselect8080

Port is used to contact the client running on the remote machine where the display configuratio is read. The table show the default ports used by the application.

There are two methods to configure this:

  1. Automatic generation: Abstract Display Configurator tool
  2. Manual configuration

1. Automatic generation via Abstract Display Configurator

Section titled “1. Automatic generation via Abstract Display Configurator ”

This program is a configuration tool for multi-client (multi IGs) abstract displays. It lets you add Clients via IP address, automatically retrieves their connected displays, and then generates a SPSsurDef.ini File in its default location.

Download the Abstract Display Configurator

1.1. Step-by-step guide to generate the abstract display configuration:

Section titled “1.1. Step-by-step guide to generate the abstract display configuration:”
  1. Launch the Client Display Configurator:
    1. From within VIOSO: Menu => Tools => Client Display Configurator
    2. Alternatively download here: https://vioso.com/download/vioso-abstract-display-config/
  2. Connect your PCs to the same network and make sure they are up and running with VIOSO Calibrator launched and configured on each.
  3. Open Abstract Display Configurator.exe:
  4. Choose the target VIOSO Software from the drop down menu: VIOSO6, Integrate or Custom. When choosing Custom, you can the destination folder for the SPSurdef.ini file, otherwise the default Surdef.ini file is replaced.
  5. Add your first client: Set a Name and type in its IP address.
  6. Click on Add. If the connection to the client was successful, the console will display a message like this:
  7. Repeat steps 4 - 5 until you’ve added all clients.
  8. Click the Apply to save and complete the configuration. The console will display “Remote Configuration Completed”:

Now open VIOSO Calibrator and you should see your displays in the “target” menu available for calibration. The next time you start VIOSO, all displays from the connected clients are provided to calibrate.

  • You can click on an added display in the list and Rename, Delete, and Split.
  • The Reset button re-initialize the configuration and starts over from scratch.
  • Click Apply before exiting the Abstract Display Configurator to save this configuration.
  • Restart VIOSO

This is the most basic way and requires more time, but it’s suited to repair an existing Abstract Display configuration in case of failure.

Open the SPSurDef.ini file located in the software`s main configuration folder. Contents of a “SPSurDef.ini” file:

<?xml version="1.0"?>
<VIOSO>
<File version="1.0.0" build="1234"/>
<logicalDisplay name="Abs01" idString="ABSDEVICE\DISPLAY\{6B25DFF9-B88F-4277-83CA-DFCEEC31C217}\0000" >
<topology rows="1" cols="1" />
<display iRow="0" iCol="0" posX="0" posY="0" sizeX="1920" sizeY="1080" core="192.168.2.20" />
</logicalDisplay>
<logicalDisplay name="Abs02" idString="ABSDEVICE\DISPLAY\{4E0A13AB-FEDB-443F-A102-B817B71C628B}\0000" >
<topology rows="1" cols="1" />
<display iRow="0" iCol="0" posX="1920" posY="0" sizeX="1920" sizeY="1080" core="192.168.2.21" />
  </logicalDisplay>
</VIOSO>

Each entry of <logicalDisplay>  represents a virtualized display from client to master. The parameters to edit are the following:

  • name: Define a name for the display, e.g. name="LeftProjector_Client1"
  • idString: Define a unique ID for the virtualized display: "ABSDEVICE\DISPLAY\{PASTE NEW GUID HERE}\0000"

To generate the GUID, you can use the VIOSO_GenerateGUID tool: Menu Tools => Generate GUID Tool. Alternatively this tool is availabe in the folder Shared Tools inside the programs installation path, e.g. C:\Program files\VIOSO 6 \Shared tools\.

  • posX posY sizeX sizeY represent the display coordinates and resolution of the remote projector. You can type this data from your knowledge of the setup or retrieve them with this method:
    • Open a browser and enter the following link using your corresponding client IP address :
      http://192.x.x.x:8080/info.htm?displays&fmt

    • The result is shown below, you can use the Size (x,y) and Position (x,y) to fill out your SPSurDef.ini file parameters

  • core IP address of the remote projector. example: core=”192.168.2.21″

Make a new entry for each projector you need to calibrate.

At the end you will have a SPSurDef.ini file where all projectors on all clients will be listed as logicalDisplay entries. Once you are done, Save the file.

Restart VIOSO on the Master machine. Then you will see your projectors appearing in the target menu available for calibration.