Skip to content

Scripting for VIOSO applications

A script file is an ANSI text file in XML format with the root section <VIOSO>.

<?xml version="1.0"?>
<VIOSO>
<File version="1.0.0" />
</VIOSO>

There are two types of elements:

A <task> section defines a certain action. Every <task> section must have one action attribute, which defines the task to be executed. Depending on the certain task there are usually other attributes required (see 2.).

action description required optional version
Condition used to specify one dependent action (see 2.1.) name use 5.0
Configure used to configure one known entity (see 2.2.) name, state use 4.0
Connect opens a connection to the specified client (see 2.3.) core 4.0
Control indicates that certain behavior of a client should be monitored (see 2.4.) type, subtype, core 4.0
Create creates a specific entity (see 2.5.) type, subtype core, use, name 4.0
Destroy destroys a specific entity (see 2.6.) name or type, subtype 5.0
DestroyAll destroys all entities of a specified type (see 2.7.) type, subtype 5.0
Disconnect disconnect one specific client (see 2.8.) core 5.0
Execute executes the specified command (see 2.9.) type, subtype use, name 4.0
IPC enables configuration of the inter-program control interface (see 2.10.) type use 5.0
Load loads a specific file/configuration, etc. (see 2.11.) type, subtype, name use 4.0
Manipulate command to alter various data (see 2.12.) type, subtype use 5.0
Playlist configures/manipulates the playlist of a presenter entity (see 2.13.) name use 5.0
Refresh updates a specified output, etc. (see 2.14.) name or type, subtype 4.0
RefreshAll updates all outputs of a specific entity (see 2.15.) type, subtype 4.0
Render outputs the state of a tender entity (see 2.16.) name use 5.0
Save stores calibrations / Configurations, etc (see 2.17.) type, subtype use 4.0
Send command to send data over the network (see 2.18.) type, subtype use 5.0
Start starts an action, task, etc. (see 2.19.) name or type, subtype 4.0
StartAll starts any existing actions of a certain type (see 2.20.) type, subtype 4.0
Stop stops one specific task (see 2.21.) name or type, subtype 4.0
StopAll stops processing all actions of a certain type (see 2.22.) type, subtype 4.0
Transfer action to transfer information, files, etc. (see 2.23.) type use 4.0
Wait general action to wait for certain events (see 2.24.) name, state core 4.0

A <define> section is used to summarize parameters that are required for certain actions. Parameters can also be defined directly in the <task> section. <define> sections are used to improve a script’s readability and enable the reuse of the same parameters in several <task> sections. Every <define> section requires the following attributes:

attribute value description version
name [identifier] name of the parameter block 4.0
type 3DModel basic initialization of a 3DModelTreat task (see 3.1.) 4.0


App common parameter for executing applications (see 3.13.) 5.0


BehaviourCreate creates or starts a certain behaviour (see 3.8.ff) 4.0


BlendParam handles configuration/manipulation of edge blending parameters (see 3.24.) 5.0


CalibChance handles changing of parameters for blending (see 3.20.) 5.0


CalibCommerce configures an Export/Convert task (see 3.4.) 4.0


CntSpace creates a custom content space entry (see 3.10.) 4.0


Common general parameters, used for several actions (see 3.12.ff) 4.0


Condition parameter to specify certain working actions (see 3.34.) 5.0


CreateImage parameter to create a standard image file (see 3.11.) 5.0


OS parameter to execute operating system-specific commands (see 3.14.) 5.0


Playlist parameter to configure a playlist (see 3.22.) 5.0


RenderPipe configures a Presenter behaviour (see 3.5.) 4.0


RenderTarget configures a presenter task (see 3.23.) 5.0


SC_DevSel configures the device selection of SingleClientCalib task (see 3.2.) 4.0


Transfer parameter to perform a transfer task (see 3.20.) 4.0

The following simple script file copies the “Calib.sps” file from the data folder to “D:\Backup\Calib.sps”:

<?xml version="1.0"?>
<VIOSO>
<File version="1.0.0" />
<task action="transfer" type="file" use="Backup" />
<define name="Backup" type="Transfer" >
<from file="Calib.sps" />
<to file="D:\Backup\Calib.sps" />
</define>
</VIOSO>

The following script file does exactly the same, except that the necessary parameters for the transfer action are specified directly in the <task> section:

<?xml version="1.0"?>
<VIOSO>
<File version="1.0.0" />
<task action="transfer" type="file" >
<from file="Calib.sps" />
<to file="D:\Backup\Calib.sps" />
</task>
</VIOSO>

In some places, attribute values can be defined by variables. E.g. to use script parameters or ingest other ini-files. In this Scripting context, variables are noted this way:

$[source]$[name]$
  • [source]: identifier of the source of the variable
  • [name]: name of the variable

Script variables are parameters that are specified directly with the name of the script file to be executed. Script variables are only valid for the script to be executed and are passed to the script engine as a parameter string. The parameter string has the following structure:

[name]=[value]{,[type]};[name]=[value]{,[type]}; ...
  • [name]: name of the script variable
  • [value]: value of the script variable
  • [typ]: optional variable type. If no [typ] is specified, [value] is interpreted as a string. Available variable types:
    • i => value is an integer number
    • f => value is a float number
    • d => value is a float number with double precision
    • s => value is a string of characters

During script runtime, script variables can be retrieved by calling ENV (see below).

This variable source can be used for the integration of project-specific configuration files and generally for the integration of selector parameter lists (see 4.1.). The content of additional ini-files is persistently available. Once loaded, all subsequent scripts can access the content.

This sample script loads the ini-file “List.ini”, interprets it as a selector parameter list, and publishes the content of the ini-file under the name Calibs.

<?xml version="1.0"?>
<VIOSO>
<task action="load" name="Calibs" type="file" subtype="paramlist" use="spsL" />
<define name="spsL" type="Common" >
<param file="List.ini" />
</define>
</VIOSO>

Example for a “List.ini” file:

<?xml version="1.0"?>
<VIOSO>
<list>
<element selector="el1" value="c1.sps" />
<element selector="el2" value="c2.sps" />
</list>
</VIOSO>

If now the following script is called with the parameter string: use = el1;…

<?xml version="1.0"?>
<VIOSO>
<task action="load" name="sps" type="file" subtype="sps" use="sps.Load" />
<define name="sps.Load" type="Common" >
<param sel="$ENV$use$" list="Calibs" />
</define>
</VIOSO>

…the file “c1.sps” is loaded.

Specifies a conditional task (see 3.27.). Required attribute: name

attribute value description version
name [identifier] name of the condition 5.0

Optional attribute: use

attribute value description version
use [identifier] name of a parameter block 5.0

Used to configure a known entity. Required attributes: name, state

attribute value description available for version
type subtype
name [identifier] name of the entity to be configured [all] [all] 4.0
state BaseMethod basic configuration (see 3.1.) Behaviour 3DModelTreat 4.0


Validate configuration of validation rules (see 3.5.) Behaviour Presenter 4.0


DeviceSel configuration of device selection (see 3.2.) Behaviour SingleClientCalib 4.0


ExportConfig configuration of export task (see 3.4.) Behaviour Export 4.0


ConvertConfig configuration of conversion task (see 3.3.) Behaviour Convert 5.0


all general purpose (see 3.7.) Renderer dx9 5.0


StartOption configuration of startup options (see 3.6.) Behaviour Presenter 5.0

Optional attributes: use

attribute value description version
use [identifier] name of a parameter block 4.0

Opens a connection to the specified client. Required attributes: core

attribute value description version
core [IP] IP address of the remote client 4.0

Indicates that certain tasks on a client should be monitored (controlled). Required attributes: type, subtype, core

attribute value description version
type behaviour restriction to this type 4.0
subtype [identifier] all available Behaviour subtypes (see 2.5.) 4.0
core [IP] IP address of the remote client 4.0

Creates a specific entity. Required attributes: type, subtype

type subtype description version
Behaviour Presenter creates a presenter layer (see 3.8.) 4.0


3DModelTreat creates a 3D model Treatment Scheduler (see 3.8.) 4.0


SingleClientCalib creates a single client calibrator scheduler (see 3.9.) 4.0


Export creates an export scheduler (see 3.8.) 4.0


Convert creates a conversion scheduler (see 3.8.) 5.0


MultiClientCalib creates multi-client calibration scheduler (see 3.8.) 5.0
CntSpace 3DModel creates a 3D model custom content space (see 3.10.) 4.0
file bmp creates a monochrome image file (Bitmap) (see 3.11.) 5.0
renderer dx9 creates a DirectX 9 renderer 5.0

Optional attributes: core, use, name

attribute value description available for type version
core [IP] IP address of the remote client Behaviour 4.0
use [identifier] IP address of the remote client Behaviour, CntSpace 4.0
name [identifier] entity name (necessary if other script tasks on this entity should be applied) Behaviour, CntSpace, renderer 4.0

Terminates/Destroys a certain entity. Required attributes: name or type, subtype

attribute value description version
name [identifier] name of the entity 5.0

or

attribute description version
type subtype
Behaviour [see 2.5] terminates all entities of a certain type 5.0

Terminates/Destroys all entities of a certain type. Required attributes: type, subtype See 2.6.

Closes the connection to a certain client. Required attribute: core

attribute value description version
core [IP] IP address of the designated client 5.0

Executes the specified command. Required attributes: type, subtype

attributedescriptionversion
typesubtype

TimerSleeppauses script processing for a certain time (see 3.12.)4.0
ProgressNextproceeds one step in the processing of sequential tasks4.0

Backtakes a step back in the processing of sequential tasks4.0

Abortsuspends processing of a task4.0
AppStartstarts an application located in the execute folder of the parent application (see 3.13.)5.0

Restarttries to restart a (remotely) executed application (see 3.13.)5.0

Shutdowntries to shut down a (remotely) executed application (see 3.13.)5.0
OSRestarttries to restart the operating system (see 3.14.)5.0

Shutdowntries to shut down the operating system (see 3.14.)5.0
OSShutdowntries to shut down the operating system (see 3.14.)5.0

Optional attributes: use, name

attribute value description available for type version
use [identifier] name of a parameter block Timer, App, OS 4.0
name [identifier] task name Progress, Abort 4.0

Configures and populates the inter-process communication interface. Required attribute: type

attribute description version
type
Common general tasks to configure the IPC interface (see 3.33.) 5.0

Optional attribute: use

attribute value description available for type version
use [identifier] name of a parameter block Common 5.0

Loads a specific file, configuration, etc. Required attributes: type, subtype, name

attribute description version
type subtype
File arva.ini loads a specified configuration file for the ARVA project 4.0


sps loads a calibration file in SPS format (see 3.15.) 4.0


vc loads a virtual canvas description file (see 3.16.) 4.0


paramlist loads a special parameter list file (see 3.15.) 5.0


playlist loads a playlist (XML format) (see 3.17.) 5.0


calibuserdata loads a special binary file with calibration-specific user data (see 3.19.) 5.0

Optional attribute: use

attributevaluedescriptionavailable for typeversion
use[identifier]name of a parameter blockFile4.0

Tasks to edit/manipulate files like calibration files, etc. Required attributes: type(, subtype)

attribute description version
type subtype
Calibration Blending manipulation of edge blending parameters (currently only available for compound displays) (see 3.24.) 5.0


CalibChange general manipulations of a calibration (currently only available for compound displays) (see 3.25.) 5.0


Mask manipulate mask parameters of a single display calibration (see 3.26.) 5.0


BlackLevel manipulation of black level parameters (currently only available for compound displays) (see 3.27.) 5.0
ProjectManager manipulation of the project manager (see 3.28.) 5.0
NativeWB manipulation of display drivers capable of native warp (Nvidia) (see 3.29.) 5.0
GUI manipulation of the user interface (see 3.30.) 5.0

Optional attribute: use

attribute value description available for type version
use [identifier] name of a parameter block Calibration, ProjectManager, NativeWB, GUI 5.0

Configures/Manipulates the playlist of a presenter entity. Required attribute: name

attribute value description available for type version
name [identifier] name of an entity with a playlist Behaviour 5.0

Optional attribute: use

attribute value description available for type version
use [identifier] name of a parameter block (see 3.22.) Behaviour 5.0

Updates an output, value, etc. Required attributes: name or type, subtype

attribute value description version
name [identifier] name of the entity (so far only behaviour) 4.0

or

attribute description version
type subtype
Behaviour Presenter updates the output of all active presenter layers (on output, the displayed data will be loaded anew) 4.0

Updates the output of an entity class. Required attributes: type, subtype See 2.14.

Processes the output of a renderer Required attributes: name

attribute value description version
name [identifier] name of the renderer 5.0

Stores calibrations, configurations, etc. Required attributes: type, subtype

attribute description version
type subtype
File sps saves a calibration file in SPS format (see 3.15.) 4.0


vc saves a virtual canvas description file (see 3.16.) 4.0


playlist saves a presenter lines playlist (XML format) (see 3.17.) 5.0


calibuserdata saves a special binary file with calibration-specific user data (see 3.18.) 5.0

Optional attribute: use

attribute value description available for type version
use [identifier] name of a parameter block File 4.0

Sends information over the network Required attributes: type, subtype

attribute description version
type subtype
TCP Command sends a (simple) command string to a remote client (see 3.31.) 5.0
File sends a file to a remote client (see 3.32.) 5.0

Optional attribute: use

attribute value description available for type version
use [identifier] name of a parameter block Send 5.0

Starts a behaviour, etc. Required attributes: name or type, subtype

attribute value description version
name [identifier] name of the entity (so far only behaviour) 4.0

or

attribute description version
type subtype
Behaviour Presenter updates the output of all active presenter layers (files are refreshed from disk) 4.0
3DModelTreat starts all existing 3D model treatments 4.0
Export starts all existing export processes 4.0

Starts all existing behaviours of a certain type. Required attributes: type, subtype See 2.19.

Stops a running behaviour, etc. Required attributes: name or type, subtype

attribute value description version
name [identifier] name of the entity (so far only behaviour) 4.0

or

attribute description version
type subtype
Behaviour Presenter stops the output of all existing presenter layers 4.0

Stops all running tasks of a certain type. Required attributes: type, subtype See 2.21.

Action to transfer information, files, etc Required attribute: type

attribute value description version
type file file transfer operation (see 3.20.) 4.0
export transfer operation of a previous export task (see 3.21.) 5.0

Optional attribute: use

attribute value description available for type version
use [identifier] name of a parameter block Send 5.0

General action to wait for certain events. Required attributes: name, state

attribute value description available for type version
name [identifier] name of the entity (so far only behaviour) 4.0
state controlled waits for a certain remote task to be under the control of the Master [all] 4.0


BaseMethod waits for the specified task to be in basic configuration state 3DModelTreat 4.0


StaticModel waits for the specified task to be ready for receiving static model parameters 3DModelTreat 4.0


StdInteraction waits for the specified task to provide its default interaction channel 3DModelTreat, Presenter 4.0


Validate waits for the specified task to be in a validated state Presenter 4.0


Presentation waits for the specified task to be in presentation state Presenter 5.0


Interact.DeviceSel waits until the specified task provides an interaction channel to make a device selection SingleClientCalib 4.0


Interact.Export waits until the specified task provides an interaction channel to input export parameters Export 4.0


Interact.Convert waits until the specified task provides an interaction channel to input conversion parameters Convert 5.0


Finished waits for the specified task to be finished SingleClientCalib, Export 4.0

Optional attribute: core, use

attribute value description available for type version
core [IP] IP address of the specified client controlled 4.0
use [identifier] name of a parameter block Finished 5.0

3.1. action=“Configure” state=“BaseMethod”

Section titled “3.1. action=“Configure” state=“BaseMethod” ”

Type of the separate parameter block: 3DModel Available sections:

  • all attributes in the <param> section are optional except for file and tMethod
section attribute value description version
<param> file [filename] name of the SPS calibration file that contains the Multi-Client calibration data for usage 4.0
tMethod static model a static 3D model is to be used 4.0
dynamic marker detection not yet implemented
model [identifier] name of the 3D model to be used (custom content space definition) 4.0
externAssigns [variable] reference to an ini file and variable on a list of parameters to configure an automatic observer conversion of used displays 4.0
bUseModelCntSpace [0, 1] using the texture coordinates of the 3D model as content space 4.0
bUseDisplMap [0, 1] using a displacement lookup (displacement map) to determine actual display pixels 4.0
bGenP2WMap [0, 1] generation of a display pixel to world (3D) lookup map 4.0
bFillSmallMeshHoles [0, 1] fixes small holes in the 3D model (transitions between triangulated NURBS areas) during blending calculation 4.0
bSplitLargeMeshes [0, 1] splits very large into smaller triangle lists 4.0
bPostProcessBlending [0, 1] image-based postprocessing of the generated blend masks to improve the edge representation 4.0
bNoBlending [0, 1] no blend mask should be calculated 5.0
bAutoObserverConversion [0, 1] carries out an observer conversion of used displays 4.0
bUseCurrPrjMask [0, 1] display mask should be used when generating the display maps/blendings 4.0
bFillSmall3DMeshHoles [0, 1] fixes small holes in the 3D model (transitions between triangulated NURBS areas) directly in the 3D model 4.0
qSmallHoleContourMax [1 .. n] maximum contour size of a 3D model to detect small holes 4.0
qSmallHoleSearchSz [1 .. n] determines the coupling width of the search filter for small hole detection in a 3D model 4.0
smallHoleAngle [0 .. 360] defines an angle in degrees to determine the shape of small holes 4.0
<define name="3D.BaseParam" type="3DModel" >
<param file="SC_MT_1.sps" tMethod="static model"
model="externModel" externAssigns="$ARVA$Assigns$"
bUseModelCntSpace="1" bUseDisplMap="1"
bGenP2WMap="1" bFillSmallMeshHoles="1"
bSplitLargeMeshes="1" bPostProcessBlending="1"
bAutoObserverConversion="1" bUseCurrPrjMask="0"
bFillSmall3DMeshHoles="1" bNoBlending="0"
qSmallHoleContourMax="80"
qSmallHoleSearchSz="1" smallHoleAngle="10"
/>
</define>

3.2. action=“Configure” state=“DeviceSel”

Section titled “3.2. action=“Configure” state=“DeviceSel” ”

Type of the separate parameter block: SC_DevSel Available sections:

  • multiple <display> sections can be specified
  • apart from tCalib, all attributes in the <param> section are optional
section attribute value description version
<param> tCalib SingleManual manual single display calibration 4.0
OldAny legacy calibration method for any surface 4.0
any calibration method for any surface 4.0
flat calibration method for flat surfaces 4.0
curved calibration method for curved and dome-shaped surfaces 4.0
externP2C external geometric calibration 4.0
RoundCave custom curved screen calibration 4.0
Manual manual multi-display calibration 4.0
Preceeding blending calculations based on previous calibrations 4.0
extern3DModel 3D model-based calibration based on external information 4.0
tArrangement strip automatic display strip arrangement detection 4.0
grid arbitrary display arrangement 4.0
hStrip horizontal display strip arrangement 4.0
vStrip vertical display strip arrangement 4.0
tCamSpaceConvert none no camera space conversion 4.0
SrcToDst source to target camera space conversion (master-slave camera system) 4.0
calibName [identifier] name (description) of the calibration 4.0
fileName [filename] name of the file to where the calibration should be saved (not always available) 4.0
contentRatio free arbitrary (=maximum) aspect ratio 4.0
[x:y] predefined aspect ratio (e.g. [16:9] 4.0
geometricScanSize [float] parameter for setting the geometric scanning range (e.g.: 1.2) 4.0
blendingLinearizeSz [int] linearization width required for the blending calculation (should always be 0) 4.0
bHQBlending [0, 1] high-quality blending calculation 4.0
bContourBlending [0, 1] contour-based blending calculation 4.0
bAdditionalLNS [0, 1] additional calculation for any surfaces 4.0
bCntBasedManualMP [0, 1] content-based manual calibration 4.0
bOutsideCamView [0, 1] calibration beyond the visible camera image 4.0
bFillAbsentBubbles [0, 1] unrecognized measuring points should be extrapolated 4.0
bFixLinePattern [0, 1] improves the line pattern against noise, etc. 4.0
bExtLoD0 [0, 1] Using a non-planar LoD0 hypothesis 4.0
bRegulariseLNS [0, 1] eliminates outlier 4.0
bCalcDisplayPose [0, 1] determination of the display pose of all calibrated displays 4.0
bP2WAvailable [0, 1] not commented 4.0
bAutoCntSpaceConvert [0, 1] automatic content space conversion 4.0
bSavePartialCalib [0, 1] writes the calibration to a file after each display scan 4.0
bSetDisplayMask [0, 1] enables using display masks 4.0
bAWBCamera [0, 1] compensation for cameras with active auto white balancing 4.0
bVignetteFilter [0, 1] using a filter to compensate for a vignette effect 4.0
bAutoInvisibleBlendingCrop [0, 1] usage of an automatic clipping of non-visible display areas 5.0
qVisiblePrjRegionExtend [0 .. n] extension of the detected visible display area in display pixels 5.0
bUseMonoCamera [0, 1] usage of a monochrome camera 5.0
bUseHWBlend [0, 1] Generates scaling masks to enhance projections with hardware blend. 5.0
bForceNewScan [0, 1] If activated, a new geometric scan is always performed. 5.0
<display> tDevice sd single display 4.0
name [identifier] name of the display 4.0
iDeviceGroup [index] Determines the index of the display to use if no name is specified, (starting with 1). 5.0
<camera> tDevice camera single camera 4.0
name [identifier] name of the camera 4.0
iDeviceGroup [index] Determines the index of the display to use if no name is specified, (starting with 1). 5.0
<define name="C1.DevSel" type="SC_DevSel" >
<camera tDevice="camera" name="Logitech QuickCam Pro 9000" />
<display tDevice="sd" name="D2 SyncMaster (SAM04EA)" />
<param tCalib="flat" tArrangement="grid"
tCamSpaceConvert="none"
calibName="Test"
contentRatio="16:9" geometricScanSize="2.0"
bHQBlending="0" bContourBlending="1"
bAdditionalLNS="0"
bOutsideCamView="1" bFillAbsentBubbles="1"
bFixLinePattern="1"
bExtLoD0="0"bRegulariseLNS="0"
bCalcDisplayPose="0" bAutoCntSpaceConvert="0"
bSavePartialCalib="0" bSetDisplayMask="0"
bAWBCamera="0" bVignetteFilter="0"
bAutoInvisibleBlendingCrop="0"
qVisiblePrjRegionExtend="30"
bUseMonoCamera="0" bUseHWBlend="0"
bForceNewScan="0"
/>
</define>

3.3. action=“Configure” state=“ConvertConfig”

Section titled “3.3. action=“Configure” state=“ConvertConfig” ”

Type of the separate parameter block: CalibCommerce Available sections:

  • several <display> sections can be specified
  • apart from tConvert, all attributes in the <param> section are optional
  • several parameters from 3.4. can be used here as well
section attribute value description version
<param> tConvert custom content space conversion converts selected calibrations in the specified content space 5.0
observer conversion converts content mapping of the selected calibrations in the specified observer 5.0
exclude compound display removes selected display calibrations from the used display compound 5.0
add VC to P2C adds the current VC to the selected calibrations for content mapping and sets a standard VC 5.0
camera content space translation generates a translation matrix for the used camera 5.0
pseudo 3D plane generates a 3D mapping for the selected calibrations, based on a planar 3D model 5.0
pseudo 3D sphere generates a 3D mapping for the selected calibrations, based on a spherical 3D model 5.0
pseudo 3D cylinder generates a 3D mapping for the selected calibrations, based on a cylindrical 3D model 5.0
pseudo 3D equirectangular generates a 3D mapping for the selected calibrations, based on a hemispherical 3D model with equirectangular distribution 5.0
merge calibration merges selected compound/super compound calibrations to a compound/super compound calibration 5.0
auto frustum calculates a possible visibility frustum for the displays of all selected calibrations 5.0
clone calibration creates a copy of a selected calibration 5.0
remove P2C outlier tries to eliminate outliers from within a selected calibration 5.0
smooth P2C softens the edges of the content mapping of the selected calibration 5.0
PrjSpace overlap allows each display used to be mapped into the display space of each display 5.0
Crop Display Geometry allows clipping of the display geometry using mask files (image) 5.0
Crop Display Geometry with Projector Mask allows clipping of the display geometry using the currently set display mask 5.0
delete calibration allows deletion of the selected calibration 5.0
<display> tDevice sd single display 5.0
dc display compound 5.0
sc super compound 5.0
name [identifier] name of the display/display compound 5.0
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="pseudo 3D sphere" bNoDefaultParam="1" />
<param0 X="-180.0" Y="180.0" Z="0.0" W="90.0" />
<!-- X => min uY => max uZ => min vW => max v | all in degree -->
<param1 X="1000.0" Y="0.0" Z="0.0" W="0.0" />
<!-- X => radiusY => radius2Z => unusedW => unused -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="pseudo 3D plane" bNoDefaultParam="1" />
<param0 X="1600.0" Y="0.0" Z="900.0" W="0.0" />
<!-- X => widthY => …Z => heightW => … -->
<param1 X="1000.0" Y="0.0" Z="0.0" W="0.0" />
<!-- X => distanceY => unusedZ => unusedW => unused -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="pseudo 3D equirectangular" bNoDefaultParam="1" />
<param0 X="-180.0" Y="180.0" Z="-60.0" W="60.0" />
<!-- X => min uY => max uZ => min vW => max v | all in degree -->
<param1 X="1000.0" Y="0.0" Z="0.0" W="0.0" />
<!-- X => radiusY => radius2Z => unusedW => unused -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="pseudo 3D cylinder" bNoDefaultParam="1" />
<param1 X="1000.0" Y="0.0" Z="0.0" W="0.0" />
<!-- X => radiusY => radius2Z => unusedW => unused -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="add vc to P2C"
bNoDefaultParam="0" bPostProcess="1"
/>
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="custom content space conversion"
customContentSpace="Model Name"
bNoDefaultParam="0" bPostProcess="0"
/>
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="observer conversion"
customContentSpace="Pose Name"
bNoDefaultParam="1" bPostProcess="0"
/>
<param0 X="1.0" Y="0.0" Z="1.0" W="0.0" />
<!-- X => scale XY => offset XZ => scale YW => offset Y -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="sd" name="Display 1" />
<display tDevice="sd" name="Display 2" />
<param tConvert="exclude compound display" bNoDefaultParam="0" />
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="camera content space translation"
customContentSpace="Model Name"
bNoDefaultParam="0" />
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_1" />
<display tDevice="dc" name="DC_2" />
<param tConvert="merge calibration" />
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="auto frustum"
bNoDefaultParam="1"
/>
<eyePoint X="100.0" Y="100.0" Z="100.0" />
<param0 X="0.0" Y="0.0" Z="0.0" W="1.777" />
<!-- X => unusedY => unusedZ => unusedW => prefered ratio -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="clone calibration" />
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="remove P2C outlier"
bNoDefaultParam="1"
/>
<param1 X="8.0" Y="0" Z="0.0" W="0.0" />
<!-- X => filter sizeY => methodZ => unusedW => unused -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="smooth P2C"
bNoDefaultParam="1"
/>
<param1 X="8.0" Y="0" Z="0.0" W="0.0" />
<!-- X => filter sizeY => methodZ => unusedW => unused -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="smooth P2C"
bNoDefaultParam="1"
/>
<param1 X="8.0" Y="0" Z="0.0" W="0.0" />
<!-- X => filter sizeY => methodZ => unusedW => unused -->
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="PrjSpace overlap" />
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="Crop Display Geometry"
bNoDefaultParam="1"
path="c:\Mask.png"
/>
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="Crop Display Geometry with Projector Mask" />
</define>
<define name="Convert" type="CalibCommerce" >
<display tDevice="dc" name="DC_Final" />
<param tConvert="delete calibration" />
</define>

3.4. action=“Configure” state=“ExportConfig”

Section titled “3.4. action=“Configure” state=“ExportConfig” ”

Type of the separate parameter block: CalibCommerce Available sections:

  • several <display> sections can be specified
  • apart from tConvert, all attributes in the <param> section are optional
section attribute value description version
<param> tConvert vwf separated one vwf/bmp file pair per exported display calibration 4.0
vwf one vwf file per exported display-compound calibration 4.0
DWM not documented 4.0
x-file calibrations are exported out in x file format 4.0
OpenWarp calibrations are exported in the OpenWarp file format 4.0
MIPS calibrations are exported out in the Barco MIPS compatible file format 4.0
MPCDI v1 calibrations are exported in MPCDI version 1 format 4.0
MPCDI calibrations are exported in MPCDI version 2 format 4.0
SGC calibrations are exported in Sciss SGC format 4.0
openEXR calibrations are exported in ILM’s openEXR format 4.0
DISI calibrations are exported in Rheinmetall DISI X-treme format 5.0
NLIM calibrations are exported in IG NLIM format 5.0
CalibData calibrations are exported in “Calibration Data File” format 5.0
path [filepath] defines the folder in which the generated files should be saved 4.0
name [identifier/filename] defines the file prefix or the exact file name if bExactFileName = "1" 4.0
bNoVC [0 , 1] calibrations are exported without applying the virtual canvas 4.0
bNoGeom [0 , 1] calibrations are exported without applying the geometric adaption 4.0
bNoBlend [0 , 1] calibrations are exported without applying the blend masks 4.0
bNoMask [0 , 1] calibrations are exported without applying optional display masks 4.0
bNoBlack [0 , 1] calibrations are exported without black level compensation 5.0
bSplitDisplays [0 , 1] the individual parts of a split display are exported separately 4.0
bExactFileName [0 , 1] name attribute provides an exact filename (only available for tConvert = “vwf”) 4.0
bScaleSplitDisplays [0 , 1] parts of a split display are scaled to the entire display size 4.0
b3D [0 , 1] instead of content mapping, the 3D information of the displays is exported 4.0
bToMaster [0 , 1] in case of a multi-client calibration, all exports are saved on the master computer 4.0
bVirtualContentRect [0 , 1] applies a virtual content rectangle 4.0
bBlankUnused [0 , 1] unused parts of a split display are blackened, otherwise, one homogeneous content mapping is exported 4.0
bExtendedDefFile [0 , 1] using a configuration file for performing more complex export tasks 4.0
bSilent [0 , 1] execution of the task without visual output 4.0
bNoAutoFileCreation [0 , 1] suppresses the automatic generation of export files 4.0
bUseBasePath [0 , 1] exports to the root data path instead of the export subfolder (if no explicit path was specified) 4.0
bNoDefaultParam [0 , 1] Prevents the use of default parameters. All required parameters must be specified. 4.0
bPostProcess [0 , 1] activates/deactivates the filtering of calculation results 4.0
bMergeRemote [0 , 1] If a multi-client calibration is exported, all exports for all clients are written to one export file. 4.0
bFixParam [0 , 1] If enabled, all additional parameters in the UI should be disabled. 4.0
gammaBlend [0.0 .. 10.0] Allows defining a gamma value to be applied to the blending texture (0.0 = disabled). 4.0
<grid> row [1 .. n] indicates the number of lines for non-pixel-based export formats 4.0
col [1 .. n] indicates the number of columns for non-pixel-based export formats 4.0
<display> tDevice sd single display 4.0
dc display compound
sc super compound 4.0
name [identifier] name of the display/compound 4.0
<source> tSource Core the SPeASY core is the source (id parameter must be set) 5.0
GUI the GUI is the source 5.0
Network the network is the source (id and idString parameters must be set) 5.0
Process a different process is the source 5.0
ProjectDesign a project design is the source (idString parameter must be set) 5.0
id [-1 .. n] optional ID of the source 5.0
idString [identifier] optional identifier of the source 5.0
<define name="Export" type="CalibCommerce" >
<display tDevice="sd" name="D2 SyncMaster (SAM04EA)" />
<param tConvert="vwf"
path="C:\Export" name="Script_Test.vwf"
bNoVC="0" bNoGeom="0"
bNoBlend="0" bNoMask="0"
bNoBlack="0"
bSplitDisplays="0" bExactFileName="1"
bScaleSplitDisplays="0" b3D="0"
bToMaster="1" bVirtualContentRect="0"
bBlankUnused="0" bExtendedDefFile="0"
bNoDefaultParam="0" bPostProcess="1"
gammaBlend="0.0"
/>
<grid row="21" col="21" />
</define>

3.5. action=“Configure” state=“Validate”

Section titled “3.5. action=“Configure” state=“Validate” ”

Type of the separate parameter block: RenderPipe Available sections:

section attribute value description version
<param> extern [variabe] Reference to an ini file; variable with required parameters 4.0
<define name="RP1.config" type="RenderPipe" >
<param extern="$ARVA$Assign$View1$" />
</define>

or

section attribute value description version
<source> tDevice sd capturing the content of a display 4.0
file displaying the contents of a file 4.0
camera display the output of a camera / live input device 4.0
name [identifier] name of the device if tDevice = “sd” or tDevice = “camera 4.0
iDeviceGroup [index] if no name and tDevice : not “file”, determines the Index (starting with 1) of the used device within a device type 5.0
file [filename] Filename if tDevice = “file” 4.0
<target> tDevice sd single display 4.0
dc display compound 4.0
sc super compound 4.0
name [identifier] name of the display/compound 4.0
iDeviceGroup [Index] if no name and tDevice : not “file”, determines the Index (starting with 1) of the used device within a device type 5.0
ip [IP] IP address of a PC if tDevice points to a remote client (optional) 4.0
<param> bUseVC [0, 1] toggles the virtual canvas 5.0
bUseGeomCorr [0, 1] toggles the usage or automatic geometric correction 5.0
bUseColorCorr [0, 1] toggles the usage or color correction 5.0
bAABorderSmooth [0, 1] toggles the usage of border smoothing 5.0
bUseEdgeBlend [0, 1] toggles the edge blending 5.0
bAutoSave [0, 1] toggles the usage of automatic saving options 5.0
bCompleteInit [0, 1] toggles the usage of re-initializing at the next start 5.0
bAugmentedElements [0, 1] toggles the usage of enhanced elements 5.0
<define name="RP1.config" type="RenderPipe" >
<source tDevice="file" file="E:\test.bmp" />
<target tDevice="sd"name="D1(CMN1343)" ip="192.168.100.5" />
<param bUseVC="1" bUseGeomCorr="1" bUseColorCorr="0"
bAABorderSmooth="0"
bUseEdgeBlend="1"
bAutoSave="0" bCompleteInit="0" bAugmentedElements="0"
/>
</define>

3.6. action=“Configure” state=“StartOption”

Section titled “3.6. action=“Configure” state=“StartOption” ”

Type of the separate parameter block: RenderPipe Available sections:

section attribute value description version
<param> bUseContentCache [0, 1] toggles usage of the content cache 5.0
<define name="RP1.start" type="RenderPipe" >
<param bUseContentCache="1" />
</define>

3.7. action=“Configure” state=“all”

Section titled “3.7. action=“Configure” state=“all” ”

3.7.1. action=“Renderer” subtype=“dx9”

Section titled “3.7.1. action=“Renderer” subtype=“dx9””

Type of separate parameter block: common Available sections:

section attribute value description version
<param> file [filename/variable] name if the mrd-file to be used for configuring the renderer 5.0
<define name="Renderer.Config" type="Common" >
<param file="Test.mrd" />
</define>

3.8. action=“Create” type=“Behaviour”

Section titled “3.8. action=“Create” type=“Behaviour” ”

Type of the separate parameter block: BehaviourCreate Usually, this parameter block is not required. Available sections:

section attribute value description version
<param> interactLevel many all interactions 4.0
reduced reduced interactions 4.0
less minimal interactions 4.0
minimal all interaction disabled 4.0
<define name="C1.Start" type="BehaviourCreate" >
<param interactLevel="many"
/>
</define>

3.9. action=“Create” type=“Behaviour” subtype=“SingleClientCalib”

Section titled “3.9. action=“Create” type=“Behaviour” subtype=“SingleClientCalib” ”

Type of the separate parameter block: BehaviourCreate Available sections:

  • several <display> section can be defined
section attribute value description version
<param> interactLevel many all interactions 4.0
reduced reduced interactions 4.0
less minimal interactions 4.0
minimal all interaction disabled 4.0
the following values ​​can also be specified as a comma-separated parameter list 4.0
NoInterResult The result of each display calibration should not be displayed 4.0
NoFinalResult The result of all calibrated displays should not be shown will 4.0
<display> tDevice sd single display 4.0
dc display compound 4.0
name [identifier] name of display/compound 4.0
iDeviceGroup [index] if no name is provided: determines the index (starting with 1) of the used device within a device type 5.0
<define name="C1.Start" type="BehaviourCreate" >
<param interactLevel="many, noInterResult"
/>
<display tDevice="sd" name="D1 NEC LCD1760NX (NEC6604)" />
</define>

3.10. action=“Create” type=“CntSpace” subtype=“3DModel”

Section titled “3.10. action=“Create” type=“CntSpace” subtype=“3DModel” ”

Type of the separate parameter block: CntSpace Available sections:

section attribute value description version
<param> modelFile [filename/variable] defines the 3D model file 4.0
matrixFile [filename/variable] optional; defines an XML file with a transformation matrix for the 3D model 4.0
matrixNode [identifier] optional; defines the section/attribute where the transformation matrix in matrixFile is defined 4.0
cullMode cw culling mode clockwise 4.0
ccw culling mode counter-clockwise 4.0
none no culling 4.0
cntSpaceW [1 .. n] denotes the size of the used content space in x direction 4.0
cntSpaceH [1 .. n] denotes the size of the used content space in y direction 4.0
bVolatileModel [0, 1] indicates that the 3D model file should be re-read before each calculation 4.0
bSuppressRootTrans [0, 1] suppresses an eventually existing basic transformation matrix of a 3D model file 4.0
bTransposeTransMat [0, 1] defines than an optional transformation matrix (matrixFile) has to be transposed before using it 4.0
<define name="model param" type="CntSpace" >
<param modelFile="D:\model.obj"
matrixFile="D:\model.matx" matrixNode="Pose/Matrix4x4"
cullMode="none"
cntSpaceW="3072" cntSpaceH="3072"
bVolatileModel="1" bSuppressRootTrans="1"
bTransposeTransMat="1"
/>
</define>

3.11. action=“Create” type=“file” subtype=“bmp”

Section titled “3.11. action=“Create” type=“file” subtype=“bmp” ”

Type of the separate parameter block: CreateImage Available sections:

section attribute value description version
<param> tImage RGB creates a 24-bit RGB image 5.0
RGBA creates a 32-bit RGB image 5.0
GRAY creates an 8-bit monochrome image 5.0
width [size] defines the x-dimension of the image in pixels 5.0
height [size] defines the y-dimension of the image in pixels 5.0
<background> red [value] value ([0 .. 255]) for channel red of the background color 5.0
green [value] value ([0 .. 255]) for channel green of the background color 5.0
blue [value] value ([0 .. 255]) for channel blue of the background color 5.0
apha [value] only if tImage=“RGBA: defines the alpha value of the background color 5.0
<target> file [filename] sets the name for the file to be created 5.0
<define name="CntFile" type="CreateImage" >
<param tImage="RGBA" width="800" height="600" />
<background red="255" green="255" blue="0" alpha="255" />
<target file="Cnt.bmp" />
</define>

3.12. action=“Execute” type=“Timer” subtype=“Sleep”

Section titled “3.12. action=“Execute” type=“Timer” subtype=“Sleep” ”

Type of the separate parameter block: Common Available sections:

section attribute value description version
<param> duration [1 .. n] duration in milliseconds 4.0
<define name="StdWait" type="Common" >
<param duration="2000" />
</define>

3.13. action=“Execute” type=“App”

Section titled “3.13. action=“Execute” type=“App” ”

Type of the separate parameter block: App

Applicable for subtype:start, restart, shutdown

Available sections:

section attribute value value version
<param> tmSleep [1 .. n] duration in milliseconds before action is performed 5.0
name [filename] Used to specify the file name of the application to which the action refers. If name is not specified or empty, the parameter refers to the executing application. 5.0
param [String] can be used to define command line parameters 5.0
bWaitUntilFinished [0 .. 1] for subtype: start, enables waiting for the exit of the started app 5.0
<define name="CloseApp" type="App" >
  <param name="notepad.exe" bWaitUntilFinished="1" />
</define>
<define name="Restart" type="App" >
<param tmSleep="3000" param='/H' />
</define>

Type of the separate parameter block: OS Applicable for subtype:restart, shutdown Available sections:

section attribute value description version
<param> tmShowInfo [1 .. n] defines the display duration of the information dialog in seconds, if info was specified 5.0
info [String] can be used to define a reference text that will be shown at the execution of the action 5.0
bForceAppClose [0 .. 1] if activated, running applications will be closed automatically (data may be lost) 5.0
<define name="Restart" type="OS" >
<param tmShowInfo="10" info="System restart" bForceAppClose="1" />
</define>

3.15. action=“Load”, “Save” type=“file” subtype=“sps”

Section titled “3.15. action=“Load”, “Save” type=“file” subtype=“sps” ”

Type of the separate parameter block: Common Available sections:

section attribute value description version
<param> file [filename] name of the *.sps calibration file to be saved or loaded 5.0
bMustNotExist [0 .. 1] (optional) Available for action=“Load”. Controls whether the script will be executed further if the file does not exist. 5.0
fParam [0 ..] (optional) Can be used to define, which information from a file should be loaded. Additive, the following values are permitted as a sum: 5.0
1 the display calibrations should be loaded 5.0
2 the presentation status of the output lines should be loaded 5.0
8 the individual resource parameter should be loaded 5.0
128 the display-split information should be loaded 5.0
32 the output lines should not start automatically 5.0
256 the output lines should all be started after loading 5.0
512 loads calibrations that can not be assigned a display 5.0
<conditions> Available for action=“Load”. Enables the conditional loading of a file (see 3.34) 5.0

If the “Calib.sps” file exists, then it will only be loaded if the display compound with the name “screen0” does not exist.

<define name="sps" type="Common" >
<param file="Calib.sps" bMustNotExist="1" />
<conditions bAll="0" >
<condition tCondition="calibnotexist" tDevice="dc" name="screen0" />
</conditions>
</define>

or

section attribute value description version
<param> sel [Selector/Variable] Available for action=“Load”. Defines a selector that selects the desired file name from a list. 5.0
list [Name] Available for action=“Load”. Defines the name of the list that is to be searched for. 5.0
bOnlyNew [0, 1] Available for action=“Load”. If activated, the “Load” action should only be executed in case of a new selection. 5.0

3.16. action=“Load”, “Save” type=“file” subtype=“vc”

Section titled “3.16. action=“Load”, “Save” type=“file” subtype=“vc” ”

Type of the separate parameter block: Common Available sections:

section attribute value description version
<param> file [filename] name of the *.vc definition file to be saved or loaded 4.0
bMustNotExist [0 .. 1] (optional) Available for action=“Load”. Controls whether the script will be executed further if the file does not exist. 5.0
<display> tDevice sd single display 4.0
dc display compound 4.0
sc super compound 4.0
name [identifier] Name of the display/display compound for the virtual canvas to be loaded or saved 4.0
<define name="sps" type="Common" >
<param file="Calib.sps" />
<display tDevice="dc" name="Compound 187" />
</define>

3.17. action=“Load”, “Save” type=“file” subtype=“playlist”

Section titled “3.17. action=“Load”, “Save” type=“file” subtype=“playlist” ”

Type of the separate parameter block: Common !The name attribute of the task specifies the presenter line for which the playlist should be loaded/saved! Available sections:

section attribute value description version
<param> file [filename] name of the playlist file 6.0
bMustNotExist [0 .. 1] (optional) Available for action=“Load”. Controls whether the script will be executed further if the file does not exist. 6.0
<define name="Playlist" type="Common" >
<param file="LastPlaylist.xml" />
</define>

3.18. action=“Save” type=“file” subtype=“calibuserdata”

Section titled “3.18. action=“Save” type=“file” subtype=“calibuserdata” ”

Type of the separate parameter block: Common Available sections:

section attribute value description version
<param> file [filename] name of the target file 6.0
<display> tDevice dc display compound 6.0
name [identifier] Name of the display/display compound for the virtual canvas to be loaded or saved 6.0
<define name="userdata" type="Common" >
<param file="CalibData.dat" />
<display tDevice="dc" name="Final" />
</define>

3.19. action=“Load” type=“file” subtype=“calibuserdata”

Section titled “3.19. action=“Load” type=“file” subtype=“calibuserdata” ”

Type of the separate parameter block: Common (The information in the source file is assigned via the name of the calibration.) Available sections:

section attribute value description version
<param> file [filename] name of the source file 6.0
bMustNotExist [0 .. 1] (optional) Available for action=“Load”. Controls whether the script will be executed further if the file does not exist. 6.0
<define name="userdata" type="Common" >
<param file="CalibData.dat" bMustNotExist="1" />
</define>

3.20. action=“Transfer” type=“file”

Section titled “3.20. action=“Transfer” type=“file” ”

Type of separate parameter block: Transfer Available sections:

section attribute value description version
<from> file [filename] name of the local file to be transferred (copied) 4.0
<to> file [filename] name of the file on the remote location (any existing file will be overwritten) 4.0
<define name="Backup" type="Transfer" >
<from file="SH_Compounds.sps" />
<to file="E:\Backup\SH_Compounds.sps" />
</define>

3.21. action=“Transfer” type=“Export”

Section titled “3.21. action=“Transfer” type=“Export” ”

Type of separate parameter block: Transfer Available sections:

section attribute value description version
<source> tSource Core the SPeASY core is the source (id parameter must be set) 6.0
GUI the GUI is the source 6.0
Network the network is the source (id and idString parameters must be set) 6.0
Process a different process is the source 6.0
ProjectDesign a project design is the source (idString parameter must be set) 6.0
id [-1 .. n] optional ID of the source 6.0
idString [identifier] optional identifier of the source 6.0
<local>/<remote> bAll [0 .. 1] indicates that the export files of all PCs should be transferred 6.0
bBackup [0 .. 1] indicates that a backup of all files that are being overwritten should be made (only available when there’s a backupSuffix specified) 6.0
path [filepath] Defines the folder in which the generated files should be saved 6.0
fileFmt [fileformat] Defines the file name (without extension!) of the created file. Placeholders are allowed: - $ip$: IP address - $org$: original file name 6.0
backupSuffix [identifier] defines an extension, with which the backup files will be highlighted 6.0
core [IP] available for <remote> specifies the IP address of the desired PC, empty data as placeholders for all remote PCs 6.0
tmOut [0 .. n] available for <remote> answers with wait time in milliseconds 6.0
<define name="Backup" type="Transfer" >
<source tSource="ProjectDesign"
idString="8E113541-5698-488A-9FDF-5888F088AB22" />
<local bAll="1" bBackup="1" path="e:\test" fileFmt="_Startup_$ip$"
backupSuffix="bkp" />
<remote core="" bAll="0" bBackup="1" path="e:\test_remote"
fileFmt="_Startup_$ip$" backupSuffix="bkp" tmOut="5000" />
</define>

Transfers the export files of an export task related to a specified project design. Saves all export files for all PCs locally in the “E:\test” folder and saves all files to be overwritten beforehand by appending the “bkp” extension. Furthermore, the specific export files for the remote PCs involved are stored on these in the folder “E:\test_remote” and saved previous files there as well.

Type of separate parameter block: Transfer The list of specified <itemchange> sections is processed from top to bottom. Available sections:

section attribute value description version
<itemchange> tOp add adds a new item to the playlist 5.0
delete deletes an item/all items from the playlist 5.0
refresh refreshes an existing item/all items in the playlist 5.0
item all designates all existing items (available for tOp=“delete” and tOp=“refresh”) 5.0
[index] designates the item at the position index in the playlist (available for tOp=“delete” and tOp=“refresh”) 5.0
file designates a media file (available for tOp=“add”) 5.0
imgseq designates an image sequence (available for tOp=“add”) 5.0
mrd designates a 3D model rendering definition (available for tOp=“add”) 5.0
goto designates a “go to item” control item (available for tOp=“add”) 5.0
stop designates a stop control item (available for tOp=“add”) 5.0
pause designates a pause control item(available for tOp=“add”) 5.0
param [identifier] defines a file/file filter (available for tOp=“add” and item=“file, imgseq, mrd”) 5.0
flag [CSV] comma separated list with additional parameters (available for tOp=“add”) 5.0
none no additional flags 5.0
disabled initially deactivated item 5.0
autoplay sets the autoplay flag of the item 5.0
mute deactivates the items sound 5.0
select automatically selects the item 5.0
infinite signals that the item is to be played infinitely (image items) 5.0
loop signals that the item is to be repeated (video, image item) 5.0
singelplay combined flag; sets: loop, select, autoplay, infinite 5.0
iPos [index] designates the position at which the new item is to be added (available for tOp=“add”) 5.0
<define name="RP.PL" type="Playlist" >
<itemchange tOp="delete" item="all" />
<itemchange tOp="add"item="file" param="Cnt.bmp" flag="singleplay"/>
</define>

Deletes all items from the playlist. Then adds the file “Cnt.bmp” (located in the standard content folder) with “single play” properties to the playlist.

<define name="RP.PL" type="Playlist" >
<itemchange tOp="delete" item="6" />
</define>

Deletes the item at playlist position 6.

Type of the separate parameter block: RenderTarget Available sections:

section attribute value description version
<param> tTarget file the result of the rendering step is to be saved in a file 5.0
file [filename] name of the file if tTarget=“file” 5.0
<define name="Renderer.Target" type="RenderTarget" >
<param tTarget="file" file="Output.bmp" />
</define>

3.24. action=“Manipulate” type=“Calibration” subtype=“Blending”

Section titled “3.24. action=“Manipulate” type=“Calibration” subtype=“Blending” ”

Type of the separate parameter block: BlendParam Available sections:

section attribute value description version
<display> tDevice dc currently, only display compound calibrations are supported 5.0
name [identifier] name of the display compound 5.0
<param> tMethod uniform sets a uniform edge blending, no additional parameters are required 5.0
standard standard edge blending method; required attributes: plateau, gradient, gamma, gammaPrj 5.0
spline spline-based edge blending method; required attributes: blackPt, whitePt, midPt, curvation, tensor, gamma, gammaPrj 5.0
plateau [0 .. 100] plateau parameter if tMethod=“standard” 5.0
gradient [-120 .. 120] gradient parameter if tMethod=“standard” 5.0
gamma [-100 .. 100] gamma parameter if tMethod=“standard” or tMethod=“spline” 5.0
gammaPrj [2 .. 50] display gamma parameter if tMethod=“standard” or tMethod=“spline” (22 is equivalent to 2.2, 5 to 0.5) 5.0
blackPt [0 .. 100] black point parameter if tMethod=“spline” 5.0
whitePt [0 .. 100] white point parameter if tMethod=“spline” 5.0
midPt [0 .. 100] midpoint parameter if tMethod=“spline” 5.0
curvation [0 .. 100] curvation parameter if tMethod=“spline” 5.0
tensor [0 .. 100] tensor parameter if tMethod=“spline” 5.0
<define name="SetBlend"type="BlendParam" >
<display tDevice="dc" name="DC_Final" />
<param tMethod="standard"
plateau="50" gradient="8" gamma="0" gammaPrj="22"
/>
</define>

3.25. action=“Manipulate” type=“Calibration” subtype=“CalibChange”

Section titled “3.25. action=“Manipulate” type=“Calibration” subtype=“CalibChange” ”

Type of the separate parameter block: CalibChange The list of specified <change> sections is processed from top to bottom. Available sections:

section attribute value description version
<display> tDevice dc currently, only display compound calibrations are supported 5.0
name [identifier] name of the display compound 5.0
<param> bUseVC [0, 1] activates/deactivates the usage of the virtual canvas 5.0
bUseGeomCorr [0, 1] activates/deactivates the usage of geometrical correction 5.0
bUseColorCorr [0, 1] activates/deactivates the usage of underground color correction (if available) 5.0
bAABorderSmooth [0, 1] activates/deactivates the usage of border smoothing 5.0
bUseEdgeBlend [0, 1] activates/deactivates the usage of edge blending 5.0
bAutoSave [0, 1] activates/deactivates the auto-save function 5.0
bCompleteInit [0, 1] activates/deactivates the usage of the full initializing option on startup 5.0
<change> tManipulate power value Sets the performance parameter for all compound displays/for the specific display. Required attributes: red, green, blue 5.0
reset mask deletes the masks of all compound displays/for the specified display 5.0
set mask Sets the mask of all compound displays/for the specified display in a picture file. Required attributes: maskFile 5.0
tDevice sd Only single displays are currently supported. If tDevice and name are not specified, the action is applied to all compound displays. 5.0
name [identifier] name of the display 5.0
red [0.0 .. 1.0] Determines the performance parameter for the red color channel, if tMethod=“power value” 5.0
green [0.0 .. 1.0] Determines the performance parameter for the green color channel, if tMethod=“power value” 5.0
blue [0.0 .. 1.0] Determines the performance parameter for the blue color channel, if tMethod=“power value” 5.0
maskFile [filename] picture file, used as a mask, if tMethod=“set mask” 5.0
<define name="ChangeTest"type="CalibChange" >
<display tDevice="dc" name="DC_Final" />
<param bUseVC="1" bUseGeomCorr="1" bUseColorCorr="0"
bAABorderSmooth="0"
bUseEdgeBlend="1"
bAutoSave="0" bCompleteInit="0"
/>
<change tManipulate="power value" tDevice="sd" name="Display 1"
red="1.0" green="0.0" blue="0.0" />
<change tManipulate="power value" tDevice="sd" name="Display 2"
red="0.0" green="1.0" blue="0.0" />
<change tManipulate="set mask" maskFile="DisplayMask.bmp" />
</define>

This define-section enables VC, geometric correction, and edge blending. Also, surface color correction, edge antialiasing, edge blur, autosave, and full initialization on startup are disabled for the “DC_Final” display compound. In addition, the performance parameters for display “Display 1” are set to all red and for display “Display 2” they are set to all green. Finally, the “DisplayMask.bmp” file is set as a mask for all displays combined in the “DC_Final” display compound.

3.26. action=“Manipulate” type=“Calibration” subtype=“Mask”

Section titled “3.26. action=“Manipulate” type=“Calibration” subtype=“Mask” ”

Type of the separate parameter block: MaskParam Available sections:

section attribute value description version
<display> tDevice sd currently, only single displays are supported 5.0
name [identifier] name of the display 5.0
<param> scaleRed [0 .. 100] scaling factor for the red color channel 5.0
scaleGreen [0 .. 100] scaling factor for the green color channel 5.0
scaleBlue [0 .. 100] scaling factor for the blue color channel 5.0
scaleInverseRed [-100 .. 100] scaling factor for the inversed red color channel 5.0
scaleInverseGreen [-100 .. 100] scaling factor for the inversed green color channel 5.0
scaleInverseBlue [-100 .. 100] scaling factor for the inversed blue color channel 5.0
blackPt [0 .. 100] black point parameter 5.0
gamma [-100 .. 100] specifies the gamma value 5.0
bAdjustColor [0, 1] specifies if the mask color should be manipulated 5.0
bUseInverseColor [0, 1] specifies if the masks color channels should be inverted 5.0
bUseAlternativeGamma [0, 1] activates an alternative gamma method 5.0
bClampColor [0, 1] specifies that the color channels should be limited from 0 to 1 5.0
maskFile [filename] Picture file that should be used as a mask. If the attribute is empty, the mask will be set to white. 5.0
<define name="SetMask" type="MaskParam" >
<display tDevice="sd" name="D1 PROJECTOR (DPC7401)" />
<param scaleRed="100" scaleGreen="100" scaleBlue="100"
scaleInverseRed="0" scaleInverseGreen="0" scaleInverseBlue="0"
blackPt="0" gamma="0"
bContentAligned="0"
bAdjustColor="1" bUseInverseColor="0" bUseAlternativeGamma="0"
bClampColor="1" maskFile="mask.bmp"
/>
</define>

3.27. action=“Manipulate” type=“Calibration” subtype=“Blacklevel”

Section titled “3.27. action=“Manipulate” type=“Calibration” subtype=“Blacklevel” ”

Type of the separate parameter block: BlacklevelParam BlacklevelParam is used to manipulate the black-level correction texture, which is used to uplift pixels to match the overlap of black. outColor = MAX( uplift, ( color + uplift * maintainBlack ) * ( 1 - maintainBlack * maintainWhite ) ) Available sections:

section attribute value description version
<display> tDevice dc currently, only display compound calibrations are supported 5.0
name [identifier] name of the display compound 5.0
<param> value [0 .. 100] black level correction parameter 5.0
maintainDark [0 .. 100] Percentage to shift values lower than uplift. (0=values are clipped, 100=values are shifted up) 5.0
maintainBright [0 .. 100] Percentage to scale color range. (0=values above white are clipped to white, 100=values are scaled to fit above uplift) 5.0
<define name="SetBlacklevel" type="BlacklevelParam" >
<display tDevice="dc" name="DC_Final" />
<param value="20" maintainDark="0" maintainBright="0"
/>
</define>

3.28. action=“Manipulate” type=“Projectmanager”

Section titled “3.28. action=“Manipulate” type=“Projectmanager” ”

Type of the separate parameter block: ProjectManager Multiple operations can be specified successively. Available sections:

section attribute value description version
<operation> tOperation start design starts the project designer 6.0
start activate explicit start of the “activate” step 6.0
bQueued [0, 1] Controls if the subsequent operation should be executed if the project manager is currently running an operation. Else, the operation will be refused. 6.0
<define name="Start_Designer" type="ProjectManager" >
<operation tOperation="start design"/>
</define>

Starts the project designer.

<define name="Start_Designer"type="ProjectManager" >
<operation tOperation="start activate" bQueued="1" />
</define>

Explicitly starts the “activate” step. If the project manager is executing an operation, the operation will be executed right after.

3.29. action=“Manipulate” type=“NativeWB”

Section titled “3.29. action=“Manipulate” type=“NativeWB” ”

Type of the separate parameter block: NativeWB Multiple operations can be specified successively. The operations will be applied on displays, that were exported and addressed by <source> formerly. Available sections:

section attribute value description version
<source> see 3.4 6.0
<operation> tOperation apply sets native warp features like warping, blending 6.0
clear deletes native warp featured like warping, blending 6.0
set overlap sets a native display overlap 6.0
clear overlap deletes a native display overlap 6.0
tDevice dc display compound 6.0
name [identifier] name of the display/display compound 6.0
tDestination local the operation should be executed on all involved local displays 6.0
tmOutAccess remote the operation should be executed on all involved client displays 6.0
tmWait [0 .. n] determined a fixed waiting time in ms to gain access to internal structures 6.0
<operation><standard><param> Enables the specification of display-specific parameters. If there are none specified, the <standard> parameters will be used. 6.0
strOSDispID [identifier] OS display ID 6.0
hwDisplayID [ID] driver-specific display ID number (at least strOSDispID or hwDisplayID must be specified) 6.0
fFeature warp manipulation of the warp feature 6.0
blend manipulation of the blend feature 6.0
simpleTriangulation uses a simplified method for generating warp meshes 6.0
auto calculates the overlap, based on the display warp 6.0
overlapFromSize overlapH/overlapV specifies the desired display resolution (the actual one is calculated) 6.0
qTesselate [0 .. n] Determines the tesselation width in pixels to produce thinned warp meshes. Available for apply/clear warp 6.0
corrOverlapX [0 .. n] correction factor in x direction, used for warp operations (compensates for driver-specific errors), available for apply/clear warp 6.0
corrOverlapY [0 .. n] correction factor in y direction, used for warp operations (compensates for driver-specific errors), available for apply/clear warp 6.0
overlapH [0 .. n] specifies the horizontal overlap (depends on fFeature), available for set overlap/clear overlap 6.0
overlapV [0 .. n] specifies the vertical overlap (depends on fFeature), available for set overlap/clear overlap 6.0
<define name="SetWarp"type="NativeWB" >
<source tSource="GUI" />
<operation tOperation="apply" tDevice="dc" name="screen0"
tDestination="local" tmOutAccess="10000" tmWait="3000">
<standard fFeature="warp,blend" qTesselate="50"
corrOverlapX="0" corrOverlapY="0"/>
<param strOSDispID="\\.\DISPLAY2" hwDisplayID="2147881095"
fFeature="warp,blend" qTesselate="100"
corrOverlapX="0" corrOverlapY="0"/>
</operation>
</define>

Sets the warp/blend feature for all local displays addressed in display compound “screen0”, exported by the user via UI. A tessellation width of 100 pixels is used for displays with the OS display ID “\\.\DISPLAY2”. For all others, a tessellation width of 50 pixels.

<define name="ClearAll"type="NativeWB" >
<source tSource="GUI" />
<operation tOperation="Clear Overlap" tDevice="dc" name="screen0"
tDestination="local" tmOutAccess="10000" tmWait="3000">
<standard fFeature=""/>
</operation>
<operation tOperation="Clear" tDevice="dc" name="screen0"
tDestination="local" tmOutAccess="10000" tmWait="3000">
<standard fFeature="warp, blend"/>
</operation>
</define>

Deletes the warp/blend feature and the set overlap of all local displays addressed in display compound “screen0”, exported by the user via UI.

3.30. action=“Manipulate” type=“GUI”

Section titled “3.30. action=“Manipulate” type=“GUI” ”

Type of the separate parameter block: GUI Available sections:

section attribute value description version
<element> tSector main main UI/general elements 6.0
presentation presenter line elements 6.0
tIdent type the element is addressed through its type 6.0
id the element is addressed through its ID 6.0
tElement window window element 6.0
button button element 6.0
combo combo box element 6.0
menu menu element 6.0
id activate button activate/deactivate button 6.0
calibrate button calibration button 6.0
recalibrate button recalibration button 6.0
playlist button playlist button 6.0
liveinput button live input button 6.0
colorblend button color/blend button 6.0
display compound button display compound button 6.0
additional output button special output button 6.0
presopt fullscreen button presenter option: fullscreen 6.0
presopt stacking button presenter option: lending off/on 6.0
presopt auto save button presenter option: autosave (network) 6.0
presopt full init button presenter option: transfer everything new (network) 6.0
presopt color correction button presenter option: pixel-accurate color correction 6.0
mrd adjust dialog model-rendering adjustment dialog 6.0
wait dialog wait-info-dialog 6.0
main menue main window dialog 6.0
device target output goal 6.0
notify task finish special notification about the completion of a task 6.0
[ID] the elements ID, if tIdent=id 6.0
behaviour [name] name of the behaviour depending on tSector 6.0
tRequest set window text changes the elements label 6.0
enable window activates/deactivates an element 6.0
create client window creates a client window 6.0
destroy client window destroys a client-window 6.0
fSemantic status information separated through commas 6.0
active describes the active-status 6.0
inactive describes the inactive-status 6.0
initial describes the initial-status 6.0
bEnable [0, 1] indicates whether a specified state should be activated/deactivated 6.0
<define name="Enable_Activate" type="GUI" >
<element tSector="presentation" tIdent="type" id="activate button"
behaviour="RP0"/>
<param tRequest="enable window" bEnable="1" fSemantic="active"/>
</define>

Activates the “Activate” button of presenter line “RP0” (by activating the “active” state)

<define name="Enable_Playlist"type="GUI" >
<element tSector="presentation" tIdent="type" id="playlist button"
behaviour="RP0"/>
<param tRequest="enable window" bEnable="1" fSemantic="active, inactive"/>
</define>

Activates the “Playlist” button of presenter line “RP0” (by activating the “active” and “inactive” state, so the state of the presenter line decides whether the button is active)

<define name="Disable_Playlist"type="GUI" >
<element tSector="presentation" tIdent="type" id="playlist button"
behaviour="RP0"/>
<param tRequest="enable window" bEnable="0" fSemantic="active, inactive"/>
</define>

Deactivates the “Playlist” button of presenter line “RP0” (by deactivating the “active” and “inactive” state, so the button is always inactive, regardless of the state of the presenter line)

<define name="Disable_Playlist"type="GUI" >
<element tSector="main" tIdent="type" id="wait dialog"/>
<param tRequest="create client window"/>
</define>

Creates a waiting dialog (dialog with progress bar)

3.31. action=“Send” type=“TCP” subtype=“Command”

Section titled “3.31. action=“Send” type=“TCP” subtype=“Command” ”

Type of the separate parameter block: NetCommand Available sections:

section attribute value description version
<target> core [IP] IP address of the desired PC 5.0
iPort [1 .. n] port number 5.0
<param> command [String] Command that should be sent (see Remote Control Reference documentation) !! code &-characters as &amp; !! Non-printable characters in the form: “%hh” with [hh] : 2-digit hex code (e.g.: “%0D%0A” => “\r\n”) 5.0
tmOut [0 .. n] responds with wait time in ms 5.0
tFormat optional, the specified command will be sent in the specified format 5.0
HTTP_GET an HTTP GET request header is used 5.0
HTTP_POST an HTTP POST request header is used 5.0
<define name="test" type="NetCommand" >
<target core="192.168.2.20" iPort="8080" />
<param command="control.htm?present=1" tmOut="4000" />
</define>

Sends a simple (String) command.

<define name="test" type="NetCommand" >
<target core="192.168.2.20" iPort="8080" />
<param command="GET /control.htm?present=1 HTTP/1.1%0D%0A%0D%0A"
tmOut="4000" />
</define>
or
<define name="test" type="NetCommand" >
<target core="192.168.2.20" iPort="8080" />
<param command="/control.htm?present=1" tmOut="4000" tFormat="HTTP_GET" />
</define>

Sends the same command as an HTTP request.

3.32. action=“Send” type=“TCP” subtype=“File”

Section titled “3.32. action=“Send” type=“TCP” subtype=“File” ”

Type of the separate parameter block: NetCommand Available sections:

section attribute value description version
<target> core [IP] IP address of the desired PC 5.0
iPort [1 .. n] port number 5.0
<param> source [filename] Specifies the source file (if not in the standard folder with path specification) 5.0
target [filename] Specifies the target file. If not specified, the source file name will be used. If there’s no path given, the file will be saved in the respective standard folder. 5.0
tFile Content content (image) file 5.0
Calibration calibration file 5.0
Export export file 5.0
3DModel 3D model file 5.0
Script script file 5.0
Execute executable file 5.0
Playlist playlist file 5.0
tmOut [0 .. n] responds with wait time in ms 5.0
command [String] Command that should be sent (see Remote Control Reference documentation) !! code &-characters as &amp; !! if not specified, “/file” will be used 5.0
<define name="test" type="NetCommand" >
<target core="192.168.2.20" iPort="8080" />
<param source="datei.png" target="new.png" tFile="content" tmOut="4000" />
</define>

Type of the separate parameter block: Common Multiple <perform> sections can be specified. Available sections:

section attribute value description version
<perform> tAction finish stops a specific (tTask)/current IPC-task 5.0
tTask guided specifies a guided calibration/manipulation IPC-task 5.0
iError [0 .. n] can be used to specify an error ID 5.0
<define name="test" type="Common" >
<perform tAction="finish" tTask="guided" iError="1" />
</define>

Type of the separate parameter block: Condition Multiple <option> sections can be specified. Available sections:

section attribute value description version
<maker> tMaker GUI Specifies that the condition must be determined through the GUI 5.0
core Specifies that the condition must be evaluated through the core 5.0
network Specifies that the condition must be evaluated through a network request 5.0
process Specifies that the condition must be evaluated through a different process 5.0
<param> tCondition user confirm Indicates that user confirmation is required (tMaker=“GUI”) 5.0
task condition general task condition (tMaker=“core”, “network”) 5.0
desc [String] optional string, which is passed on to the decisive entity and may contain additional information 5.0
<option> tOption yes Specifies the general positive case (yes, okay, etc.) 5.0
no Specifies the general neutral case (no, cancel, etc.) 5.0
error Specifies the general error case (error, abort, etc.) 5.0
tAction continue Continues processing the script normally 5.0
abort Aborts processing the script 5.0
extCmd additional commands that should be executed during the choice of the respective option, separated through commas 5.0
informUser The user is to be informed (available for tMaker=“core”, “network”) 5.0
<conditions> Section for specifying conditions 5.0
bAll [0 .. 1] determines if all conditions must be met 5.0
<conditions/ condition> tCondition CalibNotExist tests whether the specified calibration does not exist 5.0
Picturall_Calibration_Start Available for tMaker=“network”. Tests whether a Pictureall server successfully switched to VIOSO calibration mode. Either the response of the last “send” action or an immediate “send” action is executed. If tSource=“send_command”, the command string may be left out. 5.0
Picturall_Calibration_Active Available for tMaker=“network”. Tests whether a Pictureall server is currently in VIOSO calibration mode. Either the response of the last “send” action or an immediate “send” action is executed. If tSource=“send_command”, the command string may be left out. 5.0
Picturall_Calibration_Stop Available for tMaker=“network”. Tests whether a Pictureall server successfully ended VIOSO calibration mode. Either the response of the last “send” action or an immediate “send” action is executed. If tSource=“send_command”, the command string may be left out. 5.0
Picturall_Calibration_Transfer Available for tMaker=“network”. Sends a file to a Pictureall server. Either the response of the last “send” action or an immediate “send” action is executed. If tSource=“send_file”, the command string may be left out. 5.0
HTTP_Request Evaluates whether a HTTP request was successful 5.0
Behaviour_Finished Evaluates how a behaviour was finished (no normal behaviour is used for wait action for finishing a behaviour) 5.0
tSource Determines the source of the condition. “current”, if not specified 5.0
current The current condition is used. 5.0
send_command The result of the TCP command is used. The required specifications for sending the command are expected (see 3.31.). 5.0
send_file The result of a file transmission via TCP is used. The required specifications for sending the command are expected (see 3.31.). 5.0
tDevice sd single display 5.0
dc display compound 5.0
sc super compound 5.0
name [identifier] name of the display/display compound 5.0
<define name="ConditionData" type="condition" >
<maker tMaker="GUI" />
<param tCondition="user confirm" desc="blabla" />
<option tOption="yes" tAction="continue" />
<option tOption="no" tAction="abort" />
</define>

This define block specifies that the user must decide whether the currently running script should be resumed or aborted via the GUI.

<define name="ConditionData" type="condition" >
<maker tMaker="core" />
<param tCondition="task condition" desc="" />
<option tOption="yes" tAction="abort" extCmd="informUser" />
<option tOption="no" tAction="continue" />
<option tOption="error" tAction="abort" extCmd="informUser" />
<conditions bAll="0" >
<condition tCondition="calibnotexist" tDevice="dc" name="screen0" />
</conditions>
</define>

This define block specifies that the script will only resume being processed if the display compound named “screen0” exists. If the specified calibration does not exist or an error occurred, the user will be informed that the script will not be executed further.

<define name="ConditionData" type="condition" >
<maker tMaker="network" />
<param tCondition="task condition" desc="" />
<option tOption="yes" tAction="continue" />
<option tOption="no" tAction="abort" extCmd="informUser" />
<option tOption="error" tAction="abort" extCmd="informUser" />
<conditions bAll="0" >
<condition tCondition="picturall_calibration_start"
tSource="send_command">
<target core="192.168.2.20" iPort="80" />
</condition>
</conditions>
</define>

This define block specifies that the script will only resume being processed if the specified Picturall server has been switched to VIOSO calibration mode. The network command required for this is sent directly when the condition is evaluated. If the Picturall server could not be switched to VIOSO calibration mode, the user will be informed.

Type of the separate parameter block: Condition Multiple <option> sections can be specified (see 3.34.). Currently available for state=“finished”.

<task action="wait" name="Export0" state="finished" use="Export0Finished" />
<define name="Export0Finished" type="condition" >
<option tOption="error" tAction="abort" extCmd="informUser" />
</define>
or
<task action="wait" name="Export0" state="finished" >
<option tOption="error" tAction="abort" extCmd="informUser" />
</task>

This define block specifies that script processing should be aborted and the user informed if the specified behavior (Export0) ended in error.

With a selector parameter list, a list of parameters can be defined, which can be selected/called upon via a selector. A parameter is defined by a <element> section, summarized by a higher-level <list> section.

section attribute value description
<element> selector [value] defines the selector value; the type of the selector depends on the attribute seltype
seltype string the selector is a string
integer the selector is an integer number
float the selector is a floating-point number
double the selector is a floating-point number with double precision
value [value] defines the parameter value; the type of the parameter depends on the attribute valtype
valtype string the parameter is a string
integer the parameter is an integer number
float the parameter is a floating-point number
double the parameter is a floating-point number with double precision

Example:

<?xml version="1.0"?>
<VIOSO>
<list>
<element selector="2.5" seltype="float" value="c1.sps" valtype="string" />
<element selector="3" seltype="float" value="c2.sps" valtype="string" />
</list>
</VIOSO>

The selector parameter list contains two entries. Each parameter defines a string (filename here) and can be selected using a floating point number.