The Application Manager APIs set application level attributes, which mostly affect the look-and-feel of the application. The use of screen styles gives each application a consistent look-and-feel, but it's often desirable to customize attributes such as colors, fonts, and logos for each application. Setting artwork and colors allows the developer to specify a theme for their application. If these values are not set, the application will use default values.
Supported Interfaces
Description
The table below describes each attribute and its values, the screen types to which it applies, and the firmware version in which the attribute was first supported. Unless otherwise indicated, an attribute is supported in all firmware versions after the one in which it was first supported.
To save space, the screen types in the table are specified by a two letter code:
| Co | roCodeRegistrationScreen |
| Di | roMessageDialog, roOneLineDialog, roPinEntryDialog |
| Gr | roGridScreen |
| Ke | roKeyboardScreen |
| Li | roListScreen |
| Pa | roParagraphScreen |
| Po | roPosterScreen |
| Se | roSearchScreen |
| Sp | roSpringboardScreen |
| Te | roTextScreen |
All attribute values are strings. Numeric values are specified as decimal strings.
| Attribute | Screen Types | Values | Example | Version |
| BackgroundColor | Gr Li Pa Po Se Sp Te | HTML HEX Color Value. | #E0DFDF | 1.0 |
| BreadcrumbDelimiter | Gr Li Pa Po Se Sp Te | HTML HEX Color Value. | #FF00FF | 1.0 |
| BreadcrumbTextLeft | Gr Li Pa Po Se Sp Te | HTML HEX Color Value. | #FF00FF | 1.0 |
| BreadcrumbTextRight | Gr Li Pa Po Se Sp Te | HTML HEX Color Value. | #FF00FF | 1.0 |
| ButtonHighlightColor | Di Se Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| ButtonMenuHighlightText | Di Se Sp | HTML HEX Color Value. | #0033FF | 1.0 |
| ButtonMenuNormalOverlayText | Di Se Sp | HTML HEX Color Value. | #B0B0B0 | 1.0 |
| ButtonMenuNormalText | Di Se Sp | HTML HEX Color Value. | #686868 | 1.0 |
| ButtonNormalColor | Di Se Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| CounterSeparator | Gr Po | HTML HEX Color Value. | #00FF00 | 2.7 |
| CounterTextLeft | Gr Po | HTML HEX Color Value. | #FF0000 | 2.7 |
| CounterTextRight | Gr Po | HTML HEX Color Value. | #0000FF | 2.7 |
| DialogBodyText | Di | HTML HEX Color Value. Must be a grayscale value. | #808080 | 3.1 |
| DialogTitleText | Di | HTML HEX Color Value. Must be a grayscale value. | #363636 | 3.1 |
| EpisodeSynopsisText | Po | HTML HEX Color Value. | #FF00FF | 1.0 |
| FilterBannerActiveColor | Po | HTML HEX Color Value. | #FF00FF | 1.0 |
| FilterBannerActiveHD | Po | URL to set HD Filter Banner Active/Focus Highlighter | pkg:/images/Filter_ActiveHint_SD43.png | 1.0 |
| FilterBannerActiveSD | Po | URL to set SD Filter Banner Active/Focus Highlighter | pkg:/images/Filter_ActiveHint_SD43.png | 1.0 |
| FilterBannerInactiveColor | Po | HTML HEX Color Value. | #FF00FF | 1.0 |
| FilterBannerInactiveHD | Po | URL to set HD Filter Banner Inactive Highlighter | pkg:/images/Filter_InactiveHint_SD43.png | 1.0 |
| FilterBannerInactiveSD | Po | URL to set SD Filter Banner Inactive Highlighter | pkg:/images/Filter_InactiveHint_SD43.png | 1.0 |
| FilterBannerSideColor | Po | HTML HEX Color Value. | #FF00FF | 1.0 |
| FilterBannerSliceHD | Po | URL to set HD Filter Banner Background Image | pkg:/images/Filter_BackgndSlice_SD43.png | 1.0 |
| FilterBannerSliceSD | Po | URL to set SD Filter Banner Background Image | pkg:/images/Filter_BackgndSlice_SD43.png | 1.0 |
| GridScreenBackgroundColor | Gr | HTML HEX Color Value Must be a grayscale value | #363636 | 2.7 |
| GridScreenBorderOffsetHD | Gr | String representing point "(x, y)" that is the offset from the upper left corner of the focused HD image. Set to the negative width & height of border. | (-25,-25) | 2.8 |
| GridScreenBorderOffsetSD | Gr | String representing point "(x, y)" that is the offset from the upper left corner of the focused SD image. Set to the negative width & height of border. | (-20,-20) | 2.8 |
| GridScreenDescriptionDateColor | Gr | HTML HEX Color Value. | #FF005B | 2.7 |
| GridScreenDescriptionImageHD | Gr | URL to set HD Description callout background image on Grid. | pkg:/images/Description_Background_HD.ng | 2.8 |
| GridScreenDescriptionImageSD | Gr | URL to set SD Description callout background image on Grid. | pkg:/images/Description_Background_SD43.png | 2.8 |
| GridScreenDescriptionOffsetHD | Gr | String representing point "(x, y)" that is the offset from the upper left corner of the focused SD image. Negative values have the description above and to the left of the focused image. | (190,255) | 2.8 |
| GridScreenDescriptionOffsetSD | Gr | String representing point "(x, y)" that is the offset from the upper left corner of the focused SD image. Negative values have the description above and to the left of the focused image. | (125,170) | 2.8 |
| GridScreenDescriptionRuntimeColor | Gr | HTML HEX Color Value. | #5B005B | 2.7 |
| GridScreenDescriptionSynopsisColor | Gr | HTML HEX Color Value. | #606000 | 2.7 |
| GridScreenDescriptionTitleColor | Gr | HTML HEX Color Value. | #00FFFF | 2.7 |
| GridScreenFocusBorderHD | Gr | URL to set SD Focus image on Active Grid Poster | pkg:/images/Border_16x9_HD.png | 2.8 |
| GridScreenFocusBorderSD | Gr | URL to set SD Focus image on Active Grid Poster | pkg:/images/Border_16x9_SD43.png | 2.8 |
| GridScreenListNameColor | Gr | HTML HEX Color Value. Must be a grayscale value | #FFFFFF | 2.7 |
| GridScreenLogoHD | Gr | Logo formatted for display in the overhang | pkg:/images/gridlogoHD.png | 2.7 |
| GridScreenLogoOffsetHD_X | Gr | Offset in pixels from the top-left origin of the display. Range 0 to 1280. | 592 | 2.7 |
| GridScreenLogoOffsetHD_Y | Gr | Offset in pixels from the top-left origin of the display. Range 0 to 720. | 31 | 2.7 |
| GridScreenLogoOffsetSD_X | Gr | Offset in pixels from the top-left origin of the display. Range 0 to 720. | 324 | 2.7 |
| GridScreenLogoOffsetSD_Y | Gr | Offset in pixels from the top-left origin of the display. Range 0 to 480. | 21 | 2.7 |
| GridScreenLogoSD | Gr | Logo formatted for display in the overhang | pkg:/images/gridlogoSD.png | 2.7 |
| GridScreenMessageColor | Gr | HTML HEX Color Value. Must be a grayscale value | #808080 | 2.7 |
| GridScreenOverhangHeightHD | Gr | The HD overhang height. Default: "69" | 75 | 2.8 |
| GridScreenOverhangHeightSD | Gr | The SD overhang height. Default: "49" | 55 | 2.8 |
| GridScreenOverhangSliceHD | Gr | URI for the overhang slice (thin piece of top of screen border). | pkg:/images/gridoverhangHD.png | 2.7 |
| GridScreenOverhangSliceSD | Gr | URI for the overhang slice (thin piece of top of screen border). | pkg:/images/gridoverhangSD.png | 2.7 |
| GridScreenRetrievingColor | Gr | HTML HEX Color Value. Must be a grayscale value | #CCCCCC | 2.7 |
| ListItemHighlightHD | Gr Li Po | URL to set HD highlight image | pkg:/images/listitem_highlight_hd.png | 3.1 |
| ListItemHighlightSD | Gr Li Po | URL to set SD highlight image | pkg:/images/listitem_highlight_sd.png | 3.1 |
| ListItemHighlightText | Gr Li Po | HTML HEX Color Value. | #CCCC00 | 3.1 |
| ListItemText | Gr Li Po | HTML HEX Color Value. | #00CC00 | 3.1 |
| ListScreenDescriptionText | Li | HTML HEX Color Value. | #00CC00 | 3.1 |
| ListScreenTitleColor | Li | HTML HEX Color Value. | #CC0000 | 3.1 |
| OverhangPrimaryLogoHD | Co Ke Li Pa Po Se Sp Te | Small application logo formatted for display in overhang top left. | pkg:/images/co_logo_sd.png | 1.0 |
| OverhangPrimaryLogoOffsetHD_X | Co Ke Li Pa Po Se Sp Te | Offset in pixels from the top-left origin of the display.Range 0 to 1280 | 25 | 1.0 |
| OverhangPrimaryLogoOffsetHD_Y | Co Ke Li Pa Po Se Sp Te | Offset in pixels from the top-left origin of the display films.Range 0 to 720 | 50 | 1.0 |
| OverhangPrimaryLogoOffsetSD_X | Co Ke Li Pa Po Se Sp Te | Offset in pixels from the top-left origin of the display. Range 0 to 720. | 25 | 1.0 |
| OverhangPrimaryLogoOffsetSD_Y | Co Ke Li Pa Po Se Sp Te | Offset in pixels from the top-left origin of the display.Range 0 to 480. | 50 | 1.0 |
| OverhangPrimaryLogoSD | Co Ke Li Pa Po Se Sp Te | Small application logo formatted for display in overhang top left. | pkg:/images/co_logo_sd.png | 1.0 |
| OverhangSecondaryLogoHD | Co Ke Li Pa Po Se Sp Te | Small application logo formatted for display in overhang top left. | pkg:/images/co_logo_sd.png | 1.0 |
| OverhangSecondaryLogoOffsetHD_X | Co Ke Li Pa Po Se Sp Te | Offset in pixels from the top-left origin of the display. Range 0 to 1280 | 25 | 1.0 |
| OverhangSecondaryLogoOffsetHD_Y | Co Ke Li Pa Po Se Sp Te | Offset in pixels from the top-left origin of the display films. Range 0 to 720 | 50 | 1.0 |
| OverhangSecondaryLogoOffsetSD_X | Co Ke Li Pa Po Se Sp Te | Offset in pixels from the top-left origin of the display.Range 0 to 720. | 25 | 1.0 |
| OverhangSecondaryLogoOffsetSD_Y | Co Ke Li Pa Po Se Sp Te | Offset in pixels from the top-left origin of the display.Range 0 to 480. | 50 | 1.0 |
| OverhangSecondaryLogoSD | Co Ke Li Pa Po Se Sp Te | Small application logo formatted for display in overhang top left. | pkg:/images/co_logo_sd.png | 1.0 |
| OverhangSliceHD | Co Ke Li Pa Po Se Sp Te | URI for the overhang slice (thin piece of border at the top of the screen in HD size) | pkg:/images/overhang_sd.png | 1.0 |
| OverhangSliceSD | Co Ke Li Pa Po Se Sp Te | URI for the overhang slice (thin piece of top of screen border). | pkg:/images/overhang_sd.png | 1.0 |
| ParagraphBodyText | Co Pa Te | HTML HEX Color Value. | #FF00FF | 1.0 |
| ParagraphHeaderText | Co Pa Te | HTML HEX Color Value. | #FF00FF | 1.0 |
| PosterScreenLine1Text | Po | HTML HEX Color Value. | #FF00FF | 1.0 |
| PosterScreenLine2Text | Po | HTML HEX Color Value. | #FF00FF | 1.0 |
| RegistrationCodeColor | Co | HTML HEX Color Value. | #FF00FF | 1.0 |
| RegistrationFocalColor | Co | HTML HEX Color Value. | #FF00FF | 1.0 |
| RegistrationFocalRectColor | Co | HTML HEX Color Value. | #10FF80 | |
| RegistrationFocalRectHD | Co | Position and size of the HD focal rectangle. Four integer: (x,y,width,height). | (228,360,120,82) | |
| RegistrationFocalRectSD | Co | Position and size of the SD focal rectangle. Four integer: (x,y,width,height). | (172,220,90,76) | |
| SpringboardActorColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardAlbumColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardAlbumLabel | Sp | Album Label | on | 1.0 |
| SpringboardAlbumLabelColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardAllow6Buttons | Sp | boolean string | true | |
| SpringboardArtistColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardArtistLabel | Sp | Artist Label | by | 1.0 |
| SpringboardArtistLabelColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardDirectorColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardDirectorText | Sp | Director Label | Written By | 1.0 |
| SpringboardDirectorLabelColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardDirectorPrefixText | Sp | HTML HEX Color Value. | #FF00FF | |
| SpringboardGenreColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardRuntimeColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardSynopsisColor | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| SpringboardTitleText | Sp | HTML HEX Color Value. | #FF00FF | 1.0 |
| TextScreenBodyBackgroundColor | Te | HTML HEX Color Value. Must be a grayscale value | #808080 | 4.3 |
| TextScreenBodyText | Te | HTML HEX Color Value. | #363636 | 4.3 |
| TextScreenScrollBarColor | Te | HTML HEX Color Value. | #CC0000 | 4.3 |
| TextScreenScrollThumbColor | Te | HTML HEX Color Value. | #00CC00 | 4.3 |
| ThemeType | Theme type. Generic-dark is the only valid value. Otherwise the default theme applies | generic-dark | 2.7 |
Example: roAppManager setting theme values
Sub SetApplicationTheme()
app = CreateObject("roAppManager")
theme = CreateObject("roAssociativeArray")
theme.OverhangSliceHD = "pkg:/images/Overhang_Slice_HD.png"
theme.OverhangPrimaryLogoSD = "pkg:/images/Logo_Overhang_SD43.png"
theme.OverhangPrimaryLogoOffsetSD_X = "72"
theme.OverhangPrimaryLogoOffsetSD_Y = "25"
theme.OverhangPrimaryLogoHD = "pkg:/images/Logo_Overhang_HD.png"
theme.OverhangPrimaryLogoOffsetHD_X = "123"
theme.OverhangPrimaryLogoOffsetHD_Y = "48"
app.SetTheme(theme)
End Sub