Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The system object provides functions related to the system software.

system IDL

Code Block
languagejs
interface System {
    void reboot();
    void factoryReset();
    void rebootWithCrashReport();
    Promise<void> setImageSizeThreshold(Size size);
};

interface Size {
    attribute int width;
    attribute int height;
};
Panel
borderColor#3D3D3D
bgColor#F4F4F4
titleColor#3D3D3D
borderWidth0
titleBGColor#3D3D3D
borderStylesolid

ON THIS PAGE

Table of Contents
indent20px



Object Creation

To create a system object, first load the brightsign/system module using the require() method. Then create an instance of the system class.

Code Block
languagejs
var systemClass = require("@brightsign/system");
var system = new systemClass();

System

Use this interface to call system-software methods.

reboot()
Code Block
languagejs
 void reboot()

Instructs the player to perform a soft reboot.

factoryReset()
Code Block
languagejs
 void factoryReset()

Instructs the player to perform a factory reset.

rebootWithCrashReport()
Code Block
languagejs
 void rebootWithCrashReport()

Instructs the player to perform a reboot with a crash report.

setImageSizeThreshold()
Code Block
languagejs
Promise<void> setImageSizeThreshold(Size size)

Changes the maximum allowed resolution for images. This method accepts a Size interface specifying the new allowed resolution.

The default image resolution limit is 2048x1280x32bpp (or 4096x2160x32bpp for XTx44, XTx43, XDx34, XDx33, 4Kx42 players). Displaying images larger than the default value may deplete the graphics memory and cause a crash, so we recommend testing a script that uses this method thoroughly before deploying it in a production environment.

Tip

Tip

Without altering the default maximum resolution, you can increase the maximum width of images by sacrificing height (e.g. using a 4096x640x32bpp image on non-4K-capable players is allowed). You can also increase the maximum width/height by reducing the bpp value (e.g. using a 4096x1280x16bpp on non-4K-capable players is allowed).

Size

This interface describes the dimensions of an image.

  • [width int] width: The width of the image

  • [height int] height: The height of the image

Example

Code Block
languagejs
var systemClass = require("@brightsign/system");
var system = new systemClass();

imageSize = {};
imageSize.width = 4224;
imageSize.height = 2376;

system.setImageSizeThreshold(imageSize).then(
        console.log("Image threshold configured."))
    .catch(
        function(data) {
            console.log(JSON.stringify(data));
        });