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:

Application	Location of SPSurDef.ini	Port
VIOSO 6	C:\ProgramData\VIOSO\VIOSO6\	8317
VIOSO 6 Pixera Module	C:\ProgramData\VIOSO\VIOSO6_AVStumpfl\	8317
Digital Projectin Advanced Align	C:\ProgramData\VIOSO\VIOSO6_Digital Projection\SPSurDef.ini	8317
VIOSO Anyblend	C:\ProgramData\VIOSO\Anyblend5\	8080
VIOSO Player	C:\ProgramData\VIOSO\VIOSOPlayer\	8080
AV Stumpfl Autocal	C:\ProgramData\AutoCal\	8080
Custom	select	8080

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

Before configuring abstract displays you need to check the following conditions:

• All PCs are on the same network and are up and running

• VIOSO 6 runs as client on each PC, see First Init & Autostart

• Ports are not blocked or closed (default is 8417). Check the firewall settings.

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:

1. Launch the Client Display Configurator:

   1. From within VIOSO 6: 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.

1.2. Notes

• 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

2. Manual configuration

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.