You can easily display text, images, and buttons using the ScreenManager
. To update the UI, simply give the manager your new data and (optionally) sandwich the update between the manager's beginTransaction()
and commit()
methods.
ScreenManager Parameter Name | Description |
---|---|
primaryGraphic | The primary image in a template that supports images |
secondaryGraphic | The second image in a template that supports multiple images |
sdlManager.getScreenManager().beginTransaction(); sdlManager.getScreenManager().setPrimaryGraphic(sdlArtwork); sdlManager.getScreenManager().commit(new CompletionListener() { @Override public void onComplete(boolean success) { DebugTool.logInfo(TAG, "ScreenManager update complete: " + success); } });
To remove an image from the screen you just need to set the screen manager property to null
.
sdlManager.getScreenManager().setPrimaryGraphic(null);
Templated images are tinted by Core so the image is visible regardless of whether your user has set the head unit to day or night mode. For example, if a head unit is in night mode with a dark theme (see Customizing the Template section for more details on how to customize theme colors), then your templated images will be displayed as white. In the day theme, the image will automatically change to black.
Soft buttons, menu icons, and primary / secondary graphics can all be templated. Images that you wish to template must be PNGs with a transparent background and only one color for the icon. Therefore, templating is only useful for things like icons and not for images that must be rendered in a specific color.
In the screenshots below, the shuffle and repeat icons have been templated. In night mode, the icons are tinted white and in day mode the icons are tinted black.
SdlArtwork image = new SdlArtwork("<#ArtworkName#>", FileType.GRAPHIC_PNG, image, true); image.setTemplateImage(true);
Static icons are pre-existing images on the remote system that you may reference and use in your own application. Each OEM will design their own custom static icons but you can get an overview of the available icons from the icons designed for the open source Generic HMI. Static icons are fully supported by the screen manager via an SdlArtwork
initializer. Static icons can be used in primary and secondary graphic fields, soft button image fields, and menu icon fields.
SdlArtwork staticIconArt = new SdlArtwork(StaticIconName.ALBUM);