Page Comparison

Object Creation

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-1", "HDMI-2", "HDMI-3", "HDMI-4". and "vga").

var VideoOutputClass = require("@brightsign/videooutput");
var videoOutputHDMI = new VideoOutputClass("hdmi");

VideoOutputConfiguration

Use this interface to perform operations on the video output.

Events

A VideoOutputEvent is raised when the hotplug status of the HDMI^® output changes. It has one type property:

• type: The event type is hotplugevent

Methods

getVideoResolution()

Promise<Size> getVideoResolution() 

Returns the current resolution of the video plane.

getGraphicsResolution()

Promise<Size> getGraphicsResolution() 

Returns the current resolution of the graphics plane.

getOutputResolution()

Promise<Size> getOutputResolution() 

Returns the current video-output resolution.

adjustGraphicsColor()

Promise<> adjustGraphicsColor(ColorProperties) 

Adjusts the video and graphics output of the player using the options in the passed ColorProperties instance.

getEdidIdentity()

Promise<EdidIdentity> getEdidIdentity()

Returns EDID information from a compatible monitor/television as an EdidIdentity interface.

getEdid()

Promise<String> getEdid()

Returns EDID information from a compatible monitor/television as a hex-encoded string

setMultiScreenBezel()

Promise<> setMultiScreenBezel(int xPercentage, int yPercentage)

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.

setBackgroundColor()

Promise<> setBackgroundColor(int color)

Specifies the background color using an #rrggbb hex value (8 bits for each color).

setPowerSaveMode()

Promise<> setPowerSaveMode(bool enable)

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.

getPowerSaveMode()

Promise<bool> getPowerSaveMode()

Returns True if power save mode is enabled on the video output.

set3dMode()

Promise<> set3dMode(int 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

isAttached()

Promise<bool> isAttached()

Returns true if the HDMI/VGA video connector is attached to an output device (i.e. the display EDID can be read successfully). This method will always return false if setPowerSaveMode(true) has been called on the output.

getOutputStatus()

[type == "hdmi"] Promise<OutputStatus> getOutputStatus()

Returns OutputStatus which describes the current state of the video output and is defined below.

disableAudio()

[type == "hdmi"] Promise<void> disableAudio(bool disable)

Disables audio output. If passed True, the video will continue to output.

getTxHdcpStatus()

[type == "hdmi"] Promise<TxHdcpStatus> getTxHdcpStatus()

Returns the current HDCP authentication state of the video output.

forceHdcpOn()

[type == "hdmi"] Promise<void> forceHdcpOn(bool)

Can be used to force HDCP authentication on the video output. Even without HDCP forced on, there can still be HDCP on the output if an HDMI input has requested authentication.

setSyncDomain() 

Anchor
setsyncdomain setsyncdomain

Promise<void> setSyncDomain(String domain)

Passing any string will enable Genlock synchronization.To disable Genlock on the domain, pass an empty string to this method. Genlock synchronization will lock the vertical sync of the video output to the system clock reference. PTP is then used to synchronize the system clock of multiple players (for example, in a video wall).

setMpcdi()

Promise<void> setMpcdi(String filename)

Users that construct an MPCDI file as per the version1a 2D media profile should pass videoOutputHDMI.setMpcdi("SD:/filename.mpcdi") to the BrightSign player to decode the file and apply the warp and blend to the output as per the requirements set in filename.mpcdi (replace "filename" with the name of your actual file). Passing an empty string will turn off the warp and blend, and the image will return to the normal format.

BrightSign Series 4 players implement all levels of the MPCDI 2D media profile (version 1a).

close()

Promise<void> close()

This method shuts down the instance, preventing it from further consuming resources. If it is not called, garbage collection determines when the instance will be destroyed.

EdidIdentity

This interface contains EDID information about an attached display:

• [String] manufacturer string

• [product int] product

• [serialNumber int] serialNumber

• [weekOfManufacture int] weekOfManufacture

• [yearOfManufacture int] yearOfManufacture

• [String] monitorName string

• [String] textString string

• [String] serialNumberString string

• [bt2020RgbSupport bool] bt2020RgbSupport

• [bt2020YccSupport bool] bt2020YccSupport

• [sdrEotfSupport bool] sdrEotfSupport

• [hdrEotfSupport bool] hdrEotfSupport

• [hdrSt2084Support bool] hdrSt2084Support

OutputStatus

This interface contains information about an attached HDMI display device.

• [bool] outputPresent bool: A flag indicating whether the HDMI output is connected to a display device or not.

• [outputPowered bool] outputPowered: A flag indicating whether the display device is on (i.e. RX powered) 

• [unstable bool] unstable: A flag indicating whether the display signal is unstable or stable

• [String] audioFormat string: The format of the audio output. A "PCM" value indicates that the player is sending decoded output.

• [audioSampleRate int] audioSampleRate: The audio sample rate (in hertz)

• [audioBitsPerSample int] audioBitsPerSample:  The number of bits per audio sample

• [audioChannelCount int] audioChannelCount: The number of audio channels in the output

• [String] eotf string: 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)"

  • "unspecified"

Size

This interface represents a video resolution.

• [width int] width: The height of the screen/plane

• [height int] height: The width of the screen/plane

ColorProperties

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.

• [contrast int] contrast

• [saturation int] saturation

• [hue int] hue

• [brightness int] brightness

TxHdcpStatus

This interface is returned by the getTxHdcpStatus() method.

• [String] state string: The HDCP status of the HDMI output, which can be one of the following values:

  • "not-required": 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 indicates not-required, 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.

  • "authenticated": HDCP has been enabled and successfully negotiated.

  • "authentication-in-progress": HDCP has been enabled but authentication is incomplete.

  • "authentication-failed": HDCP has been requested but could not be negotiated.

Example

var VideoOutputClass = require("@brightsign/videooutput");
var videoOutputHDMI = new VideoOutputClass("hdmi");

videoOutputHDMI.getOutputStatus().then(
        function(data) {
            console.log("\nPrint the HDMI output status");
            console.log(JSON.stringify(data));
        })
    .catch(
        function(data) {
            console.log(JSON.stringify(data));
        })