The videooutput object allows you to configure and retrieve non-persistent settings related to a video output (the video mode itself is configured with the videomodeconfiguration object).
To create a videooutput object, first load the
brightsign/videooutput module using the
Require() method. Then create an instance of the videooutput class with a string value specifying the video output to configure (currently accepted values are "hdmi" and "vga").
Use this interface to perform operations on the video output.
[EventHandler] hotplugevent: This event is raised when the hotplug status of the HDMI output changes.
Returns the current resoultion of the video plane.
Returns the current resoultion of the graphics plane.
Returns the current video-output resolution.
In most cases, the values returned by the getVideoResolution(), getGraphicsResolution(), and
() methods will be identical. The "GraphicsResolution" and "VideoResolution" values will differ when a 4K video mode is selected and full-resolution graphics is not enabled: The graphics plane remains at HD (1920x1080), while the video plane expands to 4K (e.g. to 3840x2160). The "OutputResolution" value will differ from the other two values when the video output is upscaled: For example, when upscaling from HD to 4K, the "GraphicsResolution" and "VideoResolution" values will remain at 1920x1080, while the "OutputResolution" values will indicate 3840x2160.
Adjusts the video and graphics output of the player using the options in the passed ColorProperties instance.
Returns EDID information from a compatible monitor/television as an EdidIdentity interface.
Returns EDID information from a compatible monitor/television as a hex-encoded string
Adjusts the size of the bezel used in calculations for multiscreen displays, allowing for users to compensate for the width of their screen bezels. The calculations for the percentages are as follows:
xPercentage = (width_of_bezel_between_active_screens / width_of_active_screen) * 100
yPercentage = (height_of_bezel_between_active_screens / height_of_active_screen) * 100
The bezel measurement is therefore the total of the top and bottom bezels in the y case, or the left and right bezels in the x case. When this value is set correctly, images spread across multiple screens take account of the bezel widths, leading to better alignment of images.
Specifies the background color using an
#rrggbb hex value (8 bits for each color).
Disables HDMI output and the syncs for VGA output if passed
true. The absence of a signal will cause some monitors to go into standby mode.
Sets the 3D video output mode, which is specified by passing one the following parameters:
- 0: Standard mono video (default)
- 1: Side-by-side stereo video
- 2: Top-and-bottom stereo video
true if the HDMI/VGA video connector is attached to an output device (i.e. the display EDID can be read successfully).
Returns an OutputStatus interface containing information about an attached HDMI display device.
Disables HDMI audio output if passed
Returns a TxHdcpStatus interface indcating the current HDCP status of the HDMI output.
Forces HDCP authentication on the HDMI output if passed
false to this method will prevent forced authentication attempts with subsequent hotplug events. This method will return
false if the player does not support HDCP or if f
orceHDCPOn() has already been called with the same value.
This interface contains EDID information about an attached display:
This interface contains information about an attached HDMI display device.
[bool] outputPresent: A flag indicating whether the HDMI output is connected to a display device or not.
[bool] outputPowered: A flag indicating whether the display device is on (i.e. RX powered)
[bool] unstable: A flag indicating whether the display signal is unstable or stable
[DOMString] audioFormat: The format of the audio output. A "PCM" value indicates that the player is sending decoded output.
[int] audioSampleRate: The audio sample rate (in hertz)
[int] audioBitsPerSample: The number of bits per audio sample
[int] audioChannelCount: The number of audio channels in the output
[DOMString] eotf: The current electro-optical transfer function (EOTF) used by the display. The following are possible values:
- "HDR (GAMMA)"
- "SDR (GAMMA)"
- "SMPTE 2084 (PQ)"
- "Future (BBC/NHK)"
This interface represents a video resolution.
[int] width: The height of the screen/plane
[int] height: The width of the screen/plane
This interface is passed to the
adjustGraphicsColor() method. Each of the following parameters has a default value of 0 and can accept a range of values between -1000 and 1000.
This interface is returned by the
[bool] notRequired: A flag indicating whether HDCP is not required by the player. HDCP is required by the player if the video has been decoded locally and needs protection or if the script has called the
forceHdcpOn()method. Note that, even if this parameter is
true, HDCP might still be active in passthrough mode if an upstream HDMI source (i.e. a device connected to the HDMI input port on the player) has requested it.
[bool] authenticated: A flag indicating whether HDCP has been enabled and successfully negotiated
[bool] authenticationInProgress: A flag indicating whether HDCP has been enabled but authentication is incomplete
[bool] authenticationFailed: A flag indicating whether HDCP has been requested but could not be negotiated