VideoMode Multiscreen Configuration
Overview
The XC2055 and XC4055 are the first BrightSign media players to have multiple independent video outputs (the XC2055 has two HDMI® outputs, while the XC4055 has four HDMI outputs). This page describes how to configure these outputs with BrightSign APIs.
Relevant APIs
For multiple outputs the relevant API is roVideoMode
SetScreenModes
and the corresponding GetScreenModes
(for single output players the main API is roVideoMode
SetMode).
GetScreenModes
returns an roArray
of roAssociativeArray
which describe each available output on the platform and how they are configured. The members of the roAssociativeArray
are:
name: On the XC platform, the possible values are
HDMI-1
,HDMI-2
,HDMI-3
, orHDMI-4
. The number of array items depend on the number of outputs:The XC2055 has two outputs, HDMI-1 and HDMI-2
The XC4055 has four outputs, HDMI-1, HDMI-2, HDMI-3, and HDMI-4
The name tells the system which output is associated with the rest of the settings in that entry within the
roAssociativeArray
(the order of the HDMI outputs is not important).
video_mode: The videomode can be either
A known BrightSign format videomode (for example, 1920x1080x60p)
A full modeline as described in Applying a Custom Resolution#ModelineFormat
auto which differs slightly from previous platforms. auto isn’t recommended when using multiple outputs because the canvas positions are fixed and so if a screen uses an unexpected resolution then it won’t be positioned correctly in the canvas.
display_x and display_y: The position of the screen within the overall canvas. The origin 0,0 is the top left corner, and each screen can be positioned relative to that. This allows for bezel compensation as gaps can be left on the canvas between screens.
transform:
normal
,90
,180
or270
. Each screen can be rotated independently. When a screen is rotated, it rotates all of the content including video. If a single screen is set to 1920x1080x60p and90
then the screen is running in portrait mode and all of the firmware will run as if the screen is set to 1080x1920x60p with video and graphics all rotated.enabled: Whether the screen is enabled for output. To turn an output to off, set
enabled = false
. No other fields need to be set.
If you do not want to change the existing screen settings, do not enter a value for those settings.
The frame rates on all screens must be an exact match to ensure precise synchronization.
Videomode Plugins
Videomode plugins allow you to set custom multi-screen video modes. This feature has been updated to support multi-screens in BrightAuthor:connected 1.13.0 and later and BrightAuthor 5.0.1.1 and later. You must match the graphics mode that you set when authoring the presentation. See Apply a Custom Resolution | Custom Mode for more information.
Example
SetScreenModes
takes the argument that GetScreenModes
returns. To configure a 1x2 video wall with bezel compensation:
vm=CreateObject("roVideoMode")
sm = vm.GetScreenModes()
sm[0].video_mode="1920x1080x60p"
sm[0].transform = "normal"
sm[0].display_x=0
sm[0].display_y=0
sm[0].enabled=true
sm[1].video_mode="1920x1080x60p"
sm[1].transform = "normal"
sm[1].display_x=0
sm[1].display_y=1100 ' Bezel compensation of 20 pixels
sm[1].enabled=true
sm[2].enabled=false
sm[3].enabled=false
vm.SetScreenModes(sm)
In this case the resulting canvas will be 1920x2180, and full screen video and graphics will display across the whole canvas.
If a screen is enabled
, but isn't plugged in, then the correct size is used for the missing screen so that the canvas size and shape remains constant. Obviously, this isn’t possible with auto
mode as the screen size is unknown and so again auto mode is dis-recommended for use with multiple outputs.
Note that if a script calls SetMode
on a player capable of multiple screen outputs, then it effectively calls SetScreenModes
with just the first screen enabled
and a transform of normal
.
For internal debugging, the registry entry .bs/vms
is where the screen configuration is stored as a JSON string. For the above example it looks like this:
{"HDMI-1":{"mode":"1920x1080x60p","transform":"normal","x":0,"y":0},"HDMI-2":{"mode":"1920x1080x60p","transform":"normal","x":0,"y":1100}}
That is turned into an initialization file which is stored in memory. Currently, that format looks like this:
[core]
require-input=false
idle-time=0
[shell]
panel-location=""
panel-position=none
background-color=0xff000000
animation=none
close-animation=none
[output]
name=HDMI-A-1
mode=148.5 1920 2008 2052 2200 1080 1084 1089 1125 +hsync +vsync
force-on=true
transform=normal
x_position=0
y_position=0
[output]
name=HDMI-A-2
mode=148.5 1920 2008 2052 2200 1080 1084 1089 1125 +hsync +vsync
force-on=true
transform=normal
x_position=0
y_position=1100
[output]
name=HDMI-A-3
mode=off
force-on=false
transform=normal
x_position=0
y_position=0
[output]
name=HDMI-A-4
mode=off
force-on=false
transform=normal
x_position=0
y_position=0
Note that the BrightSign style mode is passed to our compositor as a complete modeline.