Versions Compared


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



backgroundURIuriinvalidSpecifies a graphic image file to be used for the Scene node background.

Specifies a background color for the scene. This color is only used if the backgroundURI field is set to an empty string. For example:

scene.backgroundUri = ""

dialognodeinvalidSetting this field to a node extended from a Dialog node causes the dialog to be displayed


trueIf true, a Back key press causes the scene to exit, back to the last user-focused item. If false, a Back key press does not cause the scene to exit. In order for the Back key to cause the scene to exit, the remote control focus must be explicitly set on the scene, or a child of the scene, using the ifSGNodeFocus interface setFocus(true) function. A Home key press always causes the scene to exit.

This field is available in firmware 7.7 and later.

This read-only field is set when the Scene is initialized. It indicates which of a channel's design resolutions (per manifest's ui_resolutions value) is being used, based on the player model and connected display type. Previously, a developer could deduct the same information by using both roDeviceInfo.GetUIResolution() and roAppInfo.getValue("ui_resolutions"). This new field simplifies the process.

The field is set to an AA with two numeric-valued keys — width and height — as well as a string value indicating the current design resolution ("HD", "FHD" or "SD"). E.g.

Code Block
Brightscript Debugger> ? myNode.getScene().currentDesignResolution
<Component: roAssociativeArray> =
    height: 720
    resolution: "HD"
    width: 1280