Description:
Display matrix allows a group of players to be set up in a video wall. Each player
will output a single element of the video wall grid. The players can be synchronized
using the STC Beacon function (STCBEACON).
This command specifies the number of elements in the matrix as well as which element in the
matrix this current decoder represents.
The DMX number of elements, current element and underscan values are stored as configuration
options and will be automatically applied when the system starts if the configuration changes
have been saved. The default configuration is 'OFF' which forces native display and overscan
values.
The scaling factor options (underscan/overscan) are not currently implemented.
Form:
Command Handler: DCMD
DISPLAYMATRIX|DMX|DM [ELEMENT X ELEMENT Y UNIT X UNIT Y UNDERSCAN WIDTH UNDERSCAN HEIGHT]
Argument List:
ELEMENT X Sets the number of elements in the matrix. Value must correspond to the
number of elements used.
ELEMENT Y Sets the current decoder to the desired element number in the matrix. Value
must correspond to the number of elements used.
UNIT X Sets the current unit to its corresponding x position in the matrix.
UNIT Y Sets the current unit to its corresponding y position in the matrix.
WIDTH Specifies the underscan/overscan width of the displayed image. Default is 100 percent.
HEIGHT Specifies the underscan/overscan height of the displayed image. Default is 100 percent.
Note: WIDTH and HEIGHT are not currently implemented.
Response:
DISPLAYMATRIX RESPONSE
Verbose- "OK\r\n" to acknowledge receipt of command, or
"ERROR- [Description]\r\n" if error, ending command
Terse- "0\r\n" to acknowledge receipt of command, or
"[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
"\r\n" concludes modify responses (empty line)
Examples:
Verbose command to set the number of columns and rows in the matrix
to two. The current decoder will be assigned position row one, column one.
Default underscan/overscan values will be used.
*.DCMD DMX 2 2 1 1<enter>
Response is: OK\r\n
Notes:
Currently only 1X1, 2X2, 3X3, and 4X4 matrices are supported. The underscan/overscan width
and height values are unimplemented at this time.
Due to the nature of the scaling required to implement the display matrix, some color banding
and motion artifacting may become apparent. It is recommended to use high resolution video
clips for best results. At this time, the underscan.overscan is not implemented, and the
size of the video output video is fixed.
This mode functions for all supported analog and digital outputs on the player.