User guide

Table Of Contents
Creating images with multiple states
Themes contain several elements that you cannot create a single static image for. Some images must display different
levels or states. For example, the battery meter displays how much power remains in the battery. The image for the
battery meter must display the battery power levels from 100% power to 0% power. The image must also show the
increase in the battery power level as the battery charges. In addition, you must include an image for cases when
the BlackBerry® device is unable to determine the battery power level.
Instead of specifying a separate image for each state, you must create a composite image. Composite images are
made up of a number of component images that depict every possible state of an element.
Component images can be any dimension; however, each component image within a composite must have the same
height and width. To determine the correct dimensions for each component image, the BlackBerry Theme Builder
takes the dimensions of the composite image and divides the width by the number of images in each row, and divides
the height by the number of rows. For example, the composite image for the wireless coverage indicator is made up
of a single row of nine component images. Therefore, if the composite image is 180 x 10 pixels, then the size of each
component image is 20 x 10 pixels.
Banner images with multiple states
Element Component
images
Description
battery power
indicator
24 This composite image must include two rows of 12 equal-sized images. The
composite image must include the following component images:
First row: 11 images that represent the battery power level from 0% to
100% from left to right in 10% increments, and one image for unknown
battery status.
Second row: 11 images that represent the battery charging from 0% to
100% from left to right in 10% increments, and one image for unknown
battery status.
Example:
User Guide
Creating images with multiple states
31