image Attributes

This forum is dedicated to the discussion of the asset types (e.g., RSS feed) supported on a Screen.

image Attributes

Postby Cilutions Support » Thu May 05, 2011 4:40 pm

The image asset is a graphics file formatted for proper playback on the destination DMB Media Player (e.g., JPG, GIF, PNG, TIFF compatible with the Amino STBs). Images must be created using a 3rd party program (e.g., Adobe Illustrator) and the dimensions must be set properly. For example, a full screen background image used to build screens for a DMB Media Player configured with a full screen display of 1280x720 (i.e., HD Graphics Mode) must be created as a 1280x720 image. The attributes of an image asset are:

    Name: A user-defined string which can be a helpful reference to individuals creating or modifying assets. This field has no impact on the DMB player when the asset is played. If Local Edit is enabled the Name can be used to help describe this asset; used as a helpful hint to the local user.
    Local Edit: Used to enable or disable local editing of this asset at the user location. If enabled, the media player on the STB will permit updating the associated image file using a browser or iPad/Droid app locally logged into the STB.
    Source Type: File indicates that the Source attribute contains the name of the image file to render (e.g., background.png). Record indicates that the Source attribute points to a text file and inside the text file is the name of the image file to render; see Source Index for more information. Embed is a special source type used to encode theSource image file directly into the screenlist. The embed type is used to help create a screenlist transaction designed to be published to the DMB player on an STB for real-time display. Look at the Screenlist Publish API discussed here: viewtopic.php?f=11&t=61
    Source Index: If the Source Type is Record then the Source Index attribute designates the field within the file containing the name of the image file to render. Fields are comma-separated with their relative position numbered as 1, 2, etc. So, for example, if the image file name to render is the second field in the record file the Source Index value would be $2. Putting the image file name to render in a separate file offers greater flexibility where an image asset can be updated on the screen by simply updating its corresponding record file. Also, the record file can contain multiple, related, fields which are updated in a single record (e.g., a weather record showing "Temperature: 72, sunny.png, Humidity: 51%").
    Source: A file name which is either the image file to render or a record file containing the name of the image inside.
    X and Y Coordinates: Pixel addressing of the upper left-hand corner used to position this asset on the screen.
    Width and Height in Pixels: Size of the image zone. 1280x720 is a full screen setting on an HD Amino STB.
    Transparency: This is an alternative method to using alpha channel in an image file. If the image(s) to render already contains transparency information (i.e., an alpha channel) then this Transparency attribute need not be used. But if the image does not contain an alpha channel then the Transparency, Transparent Color and Transparent Toleration attributes can be used to achieve levels of transparency when rendering the image. The Transparency attribute designates the level of see through applied to the entire image asset. Values are from 0 to 255 with 0 being fully transparent and 255 being fully opaque. The default is 255, fully opaque.
    Transparent Color: The specific color, in an image, which should have transparency applied independent of the entire image. This is useful for, say, setting a border around an image to an unusual color (one not in the image) and then making the border fully transparent so only the image is displayed. For example, a setting of makes white fully transparent.
    Transparent Toleration: A number indicating the color variance that should apply when identifying the transparent color. For example, a transparent tolerance of 1 with a transparent color setting of 5.5.5 (in 24-bit RGB notation) would cause 4.4.4, 5.4.4, 5.5.6, etc. to also match as the transparent color.
    Background Color: Background is the color of the area, based on width and height, that the foreground image does not cover. Values are represented as ARGB notation (e.g., for black). The first digit represents transparency with 0 being fully transparent and 255 being fully opaque. The default is fully opaque black (i.e., A fully transparent background setting is
    Resize to Width and Height: Causes the image displayed to expand or contract, if necessary, to fill the zone dimensions.
    Keep Aspect Ratio: Causes the image to retain or ignore its original aspect ratio (e.g., 16x9) when resizing. Note that resized images which do not retain their original aspect ratio may appear stretched when displayed.
    Playlist: A text file containing the list of images to render. If the Playlist is not specified then the Source attribute applies.
    Playlist Order: Can be random or sequential and designates the playback order of images in the playlist.
    Playlist Item Duration: The number of seconds to render an image on the screen if an explicit duration for an image is not included in the playlist file.
    Transition: How to move from one image to another while automatically playing the images in the playlist. Settings can be Slide from top, Slide from bottom, Blinds from left, etc..
    Transition Blinds Count: Applies only to blinds-type transitions and indicates the total number of blinds to apply to the zone when moving from one image to the next. For example, a setting of 15 would create an effect of 15 blinds during the transition. Such an effect can give the desirable impression of one image blending into the next.
    Transition Blinds Step: Also applies only to blinds-type transitions and offers a way to control the maximum number of blinds to apply during each transition step. By default, the player will apply the entire blinds count during a processing step (a count of 15 in our example above). On STBs with lower-powered graphics capabilities this processing can be time consuming and have the undesirable side effect of slowing down other assets on the screen (e.g., slowing down a scrolling RSS feed). The transition blinds step count offers a way to apply the transition to only a sub-set of the total blinds in a processing step (e.g., a millisecond) avoiding a concentrated graphics load on the STB by spreading the blinds count operation across multiple steps. For example, a transition blinds step setting of 8 for a transition blinds count of 15 would apply half the blinds in the first step, then the remainder in the last step.
    Start with transition: Yes indicates that the first image in the playlist should include the transition effect while no indicates that the effect should begin with the second image and be applied to all subsequent images.
    X and Y Alignment: Used to position (e.g., center, top) an image inside a screen zone which may be larger than the image to play. For example, how to position a 400x200 image in a 600x400 screen zone.
    Rate: The transition speed; values are from 1 to 5 with the fastest as 1.
    Maximum Media Age: Optional attribute which applies only when the Source Type is record. This lets a user set a time limit (i.e., a maximum age) of the record file containing the image to render. If the record file fails to be updated (i.e., its time stamp stops changing) for Maximum Media Age seconds then the DMB player assumes that the information in this record file is no longer timely (e.g., an out-of-date weather report). In this case the player will replace the Source attribute with the Backup Source.
    Backup Source: The backup image file to render if Maximum Media Age expires.
    On Screen Duration: The number of seconds to render this image. Default is forever, as long as the screen is active.
    OnRemote Only: Only show this image if the screenlist/screen was activated through the use of the I/R Remote Control. This attribute permits the use of, say, an announcement image to be rendered when a screen begins. Used with the On Screen Duration attribute it can serve as a brief channel announcement at screen start-up; e.g., a channel logo.
Cilutions Support
Site Admin
Posts: 139
Joined: Mon Feb 07, 2011 3:03 pm

Return to All About Assets

Who is online

Users browsing this forum: No registered users and 1 guest