Table of Contents
|Table of Contents|
Scene Graph SceneGraph applications allow you to specify an intended display screen resolution for your user interface application. But Scene Graph SceneGraph applications also automatically scale the screen elements for screen displays and Roku players that do not support the intended screen resolution. This gives you greater control of the appearance quality of your application than in previous Roku firmware, and allows you to design your application for full high-definition display resolution.
Scene Graph SceneGraph Display Resolution Scaling Support
The following describes how Scene Graph SceneGraph applications support different display screen resolutions.
Automatic Screen Element Scaling
Scene Graph SceneGraph applications can automatically scale screen elements, such as fonts and rectangles, to any specified supported resolution. This scaling is controlled by specifying the screen resolutions the application is intended to support. If support is only specified for high-definition, and not full high-definition, then the screen elements are scaled from 720 resolution to 1080 resolution if needed for the display resolution. If support is only specified for full high-definition, and not high definition, then the screen elements are scaled from 1080 resolution to 720 resolution if needed for the display resolution.
Automatic Selection of Supported Graphical Image Resolutions
Scene Graph SceneGraph applications can automatically select graphical images based on the supported resolution. The firmware can modify a special URI string with a variable that gets the correct graphical image for each supported and specified resolution. If this special URI string is not specified, the firmware will automatically scale graphical images to the display resolution from the specified intended resolution.
Recommended Intended Resolution
For Scene Graph SceneGraph applications, Roku recommends you design and develop for an intended 1080 screen resolution. But for performance reasons, for Roku players and display screens that do not support full high-definition resolution, you should supply both 1080 and 720 graphical images for your application. The Scene Graph SceneGraph application will scale the design elements and the graphical images for the actual supported resolution, but you can achieve the best appearance for all supported resolutions if you provide both resolutions of graphical images. If you can only provide one resolution of graphical images, provide 720 graphical images.
You specify the intended support for various screen display resolutions in special manifest file attributes for Scene Graph SceneGraph applications. The following describes the manifest file attributes to specify the supported screen resolutions for Scene Graph SceneGraph applications.
option list string
A comma-separated list of up to three strings that identify the UI resolutions the application has been designed to support. The string can include the following options:
The example shows how to specify that the application is intended for all three possible supported resolutions, and will automatically scale and select graphical images (if provided) for all three. The default value is
|uri_resolution_autosub||option list string|
Provides a flexible way to specify graphical image URIs that are automatically modified to replace a specified string with a string that gets a resolution-specific graphical image.
The attribute value is a comma-separated list of four strings that specify the string to be replaced along with the replacement strings for SD, HD and FHD resolutions.
For example, suppose the manifest includes this line:
And the Roku player supports full high-definition resolution. Then if the application specifies a URI of:
At runtime that URI will be modified to:
And the application will get the full-high definition version of the graphical image in the specified directory.
|splash_screen_fhd||uri||URI of the FHD version of the splash screen.|
|mm_icon_focus_fhd||uri||URI of the FHD application icon.|
When creating layouts of visual components that take advantage of the Roku Scene Graph SceneGraph ability to autoscale layouts from one screen resolution to another (such as, from FHD/1080p to HD/720p), the best results will be obtained if you use the following simple rule.