BrightSign HD2000 Object Reference Manual - Manual (Page 13)

roVideoPlayer
A Video Player is used to play back video files (using the generic ifMediaTransport Interface). If the
message port is set, the object will send events of type roVideoEvent. All object calls are asynchronous.
That is, video playback is handled in another thread from the script. The script will continue to run while
video is playing. Note that the HD600 will decode a maximum resolution of D1 (DVD Quality). HiDef
video is not able to be decoded. However, the HD2000 will decode to a maximum resolution of
1920x1080 interlaced, including HiDef video. The decoded video will be scaled to the output resolution
specified by roVideoMode.
NOTE:
 Currently only MPEG2 files are supported by BrightSign
 All HD600 video files must have a 48Khz audio track, even if it is silence. This restriction does
not apply to the HD2000.
 Currently only MPEG2 program streams are supported. Simple elementary video streams are not
supported. A video stream must be muxed into a program stream. Audio can be either AC3 or
PCM.
Interfaces:
 ifSetMessagePort
rotVOID SetPort(rotOBJECT obj)
 ifAudioControl – see roAudioPlayer for docs
 ifVideoControl
rotBOOL SetViewMode(rotINT32 mode)
rotVOID SetRectangle(roRectangle r)
 ifMediaTransport
rotBOOL PlayFile(rotSTRING filename)
rotBOOL Stop(rotVOID)
rotBOOL Play(rotVOID)
rotBOOL SetLoopMode(rotINT32 mode)
rotBOOL ClearEvents(rotVOID)
rotBOOL AddEvent(rotINT32 userdata, rotINT32 time_in_ms)
rotBOOL StopClear()
If you wish to use a view mode different from the default, it must be set prior to starting video
playback.
view_mode values:
0 - Scale to fill (default). The aspect ratio can alter.
1 - Letterboxed and centered. The aspect ratio is maintained and the video has black borders.
2 - Fill screen and centered. The aspect ratio is maintained and the screen is filled.
To display the video in a zone, SetRectangle() must be called. EnableZoneSupport() must be
called to use zones functionality.
MPEG2 video files are encoded with a specific aspect ratio, and output display resolutions have an aspect
ratio. Video display modes 1 and 2 use these aspect ratios to ensure that the video file aspect ratio is
preserved when it is displayed. The only time that this will fail is when a widescreen monitor displays a 4:3
output resolution such as 800x600 across the whole screen i.e. the monitor doesn't respect the aspect ratio.
Please note that this feature relies on the correct aspect ratio marking of the MPEG2 video files.
Unfortunately, not all files are marked correctly.
13