BlackBerry Theme BuilderVersion: 6.0User Guide
Screen elementDescriptionIn the BlackBerry Theme Builder, you can customize the Home screen banner for your theme by clicking the Banner button in the
Managing themes on the BlackBerry device 18Delete a theme from the BlackBerry device1. Connect your BlackBerry® device to a computer.2. On the File me
Making themes available to BlackBerry device users 19Considerations for exporting themesWhen you export a theme, the BlackBerry® Theme Builder places
Consideration Description• You can export the theme so that BlackBerry device users can download it over the wireless network directly to a BlackBerry
After you finish:In BlackBerry App World, you must create an application in the vendor portal and set the category to Themes. For more information abo
6. In the Target OS drop-down list, click the version of the BlackBerry® Device Software that you created the theme for.7. To overwrite any existing f
Distribute the .alx and .cod files to all BlackBerry device users who require the theme.User GuideExport a theme for distribution using the applicatio
Provide feedback about the BlackBerry Theme Studio 20Research In Motion can use the feedback that you provide to help improve the BlackBerry® Theme St
Provide feedback 21To provide feedback on this deliverable, visit www.blackberry.com/docsfeedback.User GuideProvide feedback105
Legal notice 22©2011 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, and related trademarks, names, and logos
REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE
Screen elementDescriptionActive Call screenThe Active Call screen appears when you make a call on the device.In your theme, you can make the following
The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto. NOTHING IN THIS DOCUM
Screen elementDescriptionPhone Hotlist screenThe Phone Hotlist screen appears when you view the call log on the device.In your theme, you can make the
Screen elementDescriptionUI controls Controls, such as dialog boxes, menus, title bars, buttons, lists, pop-up menus, group boxes, and the search fiel
Theme layout typesWhen you create a theme, you must first select a theme layout type. A theme layout type determines how the applications appear on th
Zen The Home screen displays application icons along the bottom of the screen. Users can click an icon to access that application on the device.Today
Icon The Home screen displays application icons in a grid layout. You can organize the application icons into a hierarchy of folders. No application l
Canvas The canvas displays the preview area. You can move the preview area around the canvas.Toolbar You can use the toolbar in the BlackBerry Theme B
Inspector The Inspector includes the buttons that you can use to select a screen and the elements for each screen that you can change. You can expand
Inspector Button DescriptionActive Call You can click the Active Call screen button in the Inspector to access options to change background images, ic
Published: 2011-05-19SWD-1298781-0519083651-001
Button DescriptionPreview Theme on SimulatorPreview Theme on BlackBerryYou can click Preview Theme on BlackBerry to see how a theme appears on a Black
Button DescriptionShow the TitlebarYou can click Show the Titlebar to show or hide the title bar in the preview area of the canvas. When the title bar
Selecting multiple objectsYou can select more than one object and make changes to all the objects at one time. For example, you can select multiple te
Configuring the BlackBerry Theme Builder 2Change the screen that appears when the BlackBerry Theme Builder startsBy default, the Quickstart screen app
Description Provide a brief description of the theme. Limit the description to one or two sentences.3. Click OK.Change the applications that you use f
Show or hide BlackBerry Theme Builder toolsIf a BlackBerry® Theme Builder tool isn't displayed on the UI of the BlackBerry Theme Builder, you can
4. Click OK.Turn off the SVG preview1. On the Edit menu, click Preferences.2. Click the SVG tab.3. Clear the SVG Preview check box.4. Click OK.User Gu
Creating and changing theme projects 3You can create your new theme project using the selected layout type as your starting point. You can change from
Open a theme project1. On the File menu, click Open, and navigate to the (.thm) file for the theme project that you want to open.2. Click Open.Update
When you import a theme that targets a different screen size, all modified theme elements are imported into your new theme. After the theme is importe
Contents1 BlackBerry Theme Builder overview...
Working with images 4When you add an image to a theme, the BlackBerry® Theme Builder stores the converted image as part of the theme. If the image is
• The file names of your images must have the same file names that the BlackBerry Theme Builder uses as default file names. To see the names of the fi
Since background images for dynamic elements require borders and you do not know what size you should use for the dynamic elements, you should use dyn
Creating images with multiple statesThemes contain several elements that you cannot create a single static image for. Some images must display differe
Element Component imagesDescriptionwireless coverage indicator9 This composite image must include one row of 9 equal-sized images. The composite image
Element Component imagesDescriptionExample:Message list images with multiple statesElement Component imagesDescriptionmessage icons 96 This composite
Element Component imagesDescriptionweb icons 6 This composite image must include one row of 6 equal-sized images, representing all the possible browse
Element Component imagesDescription• BlackBerry® Bold™ 9000 smart phone• BlackBerry® Curve™ 8900 smartphone• BlackBerry® Pearl™ Flip 8200 Series smart
Screen element Image Image size in pixelsApplication list 360 x 21Application list (landscape) 480 x 21alarm indicator 11 x 13 to 21x 21new items indi
Screen element Image Image size in pixelscomponent image 26 x 26message icons composite image 624 x 104component image 26 x 26Phone phone receiver (ac
Banner images with multiple states... 31Message
Screen element Image Image size in pixelscomponent image 29 x 12underlay focus for profiles icon 36 x 36unread icons composite image 325 x 22component
Screen element Image Image size in pixelscomponent image 29 x 29message icons composite image 696 x 116component image 29 x 29Phone phone receiver (ac
Screen element Image Image size in pixelstocomposite image 468 x 38component image 39 x 19signal meter composite image 261 x 12component image 29 x 12
Screen element Image Image size in pixelssearch field cursor 4 x 18menu arrow 15 x 12menu background 40 x 40menu cursor 193 x 29list cursor 360 x 42Me
Screen element Image Image size in pixelsBlackBerry 6BlackBerry® Device Software 5.0underlay focus for profiles icon 36 x 36 60 x 60alarm indicator 11
Screen element Image Image size in pixelsBlackBerry 6BlackBerry® Device Software 5.0pop-up background tiled image —group box bodygroup box titlegroup
Screen element Image Image size in pixelsBlackBerry 6BlackBerry® Device Software 5.0component image 90 x 100phone icons (hotlist) composite image 522x
Screen element Image Image size in pixelsLock screen background 360 x 480Global images transmission arrows 22 x 22 to 50 x 30Alt mode, NUM lock, CAP l
Screen element Image Image size in pixelsBlackBerry 6BlackBerry® Device Software 5.0tab, tab focus (Zen) 50 x 50 52 x 52cursor (today) 320 x 23 320 x
Screen element Image Image size in pixelsBlackBerry 6BlackBerry® Device Software 5.0Phone phone receiver (active phone call)composite image 264 x 17co
Create a slide show for your wallpaper... 62C
Screen element Image Image size in pixelsBlackBerry 6Image size in pixelsBlackBerry® Device Software 5.0new items indicator 25 x 22 21 x 21cursor 360
Screen element Image Image size in pixelsBlackBerry 6Image size in pixelsBlackBerry® Device Software 5.0button activebutton disabledbutton highlightbu
Screen element Image Image size in pixelsBlackBerry 6Image size in pixelsBlackBerry® Device Software 5.0component image 24 x 24phone icons (active cal
Screen element Image Image size in pixelsdialog box background, dialog box buttons (all states), menu background, title bar backgroundtiled imageMessa
Screen element Image Image size in pixelsPhone phone receiver variable (multistate image)volume control variable (multistate image)incoming call backg
Screen element Image Image size in pixelsincoming call background 320 x 240Lock screen background 320 x 240Global images transmission arrows 26 x 15 o
Screen element Image Image size in pixelsnavigation arrows 10 x 7 to 28 x 18hourglass cursor 19 x 19 to 50 x 50Image sizes for the BlackBerry Pearl 82
Screen element Image Image size in pixelsbattery meter variable (multistate image)signal meter variable (multistate image)Home screen (Icon theme)back
If you want to create themes for various BlackBerry device models and you want to use similar background images and colors on each device, you can cre
Delete items from a catalog1. In the Catalog pane, click the item that you want to delete.2. In the upper-right corner of the Catalog pane, click the
Change BlackBerry device elements in portrait or landscape mode... 76Design a Home screen
Changing fonts for themes 5You can change fonts throughout your theme. You can specify a font for dialog boxes, buttons, lists, and the phone and mess
Setting DescriptionStroke color The stroke color specifies the color of the outline of the text. This setting is only available for text elements on t
complete set of bitmaps. For example, if you use the same TrueType font in a menu, but you specify different colors for the highlighted text and norma
Using colors 6You can use the color selector to specify the color of a theme element or to define and save a palette of custom colors. You can also sa
Customizing the Home screen 7The Home screen for each available base theme is unique and is the primary difference between the base themes. You can cu
3. Click Slideshow.4. In the Slides section, click Add.5. In the Open dialog box, click the images that you want to include in the wallpaper.6. Click
4. To change the font color, on the Quick Edit bar, click the Fill box and click a color.5. To change the font outline, on the Quick Edit bar, click t
• To change the image that is displayed in front or behind the application icon that the user selects, on the Quick Edit bar, click the Tab Focus drop
Change the background color of the Notification barYou can change the color of the background of the Notification bar in a theme with a BlackBerry® 6
2. In the preview area of the canvas, in the Notification bar, click the number that represents the number of unread items.3. On the Quick Edit bar, i
Layer the Lock screen over the banner... 92A
Change the font settings for the subentry.a. In the preview area of the canvas, click an entry under an application, for example an email message unde
Layer the Home screen over the bannerYou can create a layered effect by placing the Home screen over the banner. The .svg file and any applications th
• To create horizontal links automatically, select the Auto Create Horizontal Defaults option.• To create links manually, select the Do Not Create Def
Designing banners 8Banners display the following:• date, time, and wireless service provider• application notifications, such as the alarm indicator,
Change the size of a bannerYou can set the banner height to a value between 10 pixels and 120 pixels. If you are creating a theme for a BlackBerry® de
Move the banner elements1. In the Inspector, click the Banner button.2. On the Toolbar, click Turn On/Off Bounding Boxes.3. Click a bounding box and d
Customizing external flip screens 9You can customize external flip screens of BlackBerry® Pearl™ Flip Series devices using the same elements you use f
b. On the Quick Edit bar, click the color swatch and specify the color that you want to use.5. To change the indicator images for notifiers, do the fo
Customizing BlackBerry devices with touch screens 10You can customize BlackBerry® devices with a touch screen using the same elements that you use for
Change background images for the Shortcut barThe Shortcut bar appears only on BlackBerry® devices with a touch screen.1. In the Inspector, click the S
BlackBerry Theme Builder overview 1You can create themes to personalize the screens on the BlackBerry® device. For example, you can change the backgro
Customizing the Application List screen 11The Application List screen is a part of all theme layouts. It is the Home screen for the Icon layout type,
d. To apply bold, click the Bold button.e. To apply italic, click the Italics button.f. To apply anti-aliasing, click the Anti-alias button.g. To chan
1. In the Inspector, click the Application List Screen button.2. On the Quick Edit bar, in the Application List section, click Application Icons.3. Dr
Customizing UI controls and application lists 12Show or hide UI controlsYou can show only the controls that you want to change the appearance for and
Change the image for a button. You can change the image for buttons in normal, disabled, highlight, disabled highlight, and active states.a. On the To
Change the image for the group box body.a. On the Toolbar, click the Show the Group Box button.b. In the preview area of the canvas, click the body of
Change text settings for the title bar.a. On the Toolbar, click Show the Titlebar.b. In the preview area of the canvas, click the text in the title ba
b. In the preview area of the canvas, click the cursor.c. On the Quick Edit bar, click a color swatch.d. In the Color Picker dialog box, select a colo
Customizing the message list 13Change the text settings for the date1. In the Inspector, click the Message List button.2. In the preview area of the c
Change the color for messages sent with high importanceYou can specify the color of messages that are sent with high importance to the BlackBerry® dev
Screen elementDescriptionApplication listThe Application list displays the applications, games, and folders that are on the device. For devices runnin
Customizing the Phone screens 14You can customize the Phone hotlist, the Active Call screen, and the Incoming Call screen. Depending on the phone scre
3. On the Quick Edit bar, in the drop-down list next to the name of the image that you want to change, click Change Image.4. Navigate to an image.5. C
Area Element DescriptionConference Change text properties for conference call text.Buttons Change text properties for button text.Icons Speaker Change
Customizing the Lock screen 15Change the background image for the Lock screenIf the image does not have the same dimensions as the BlackBerry® device
Layer the Lock screen over the bannerThe owner information appears on the BlackBerry® device when the BlackBerry device is locked. You can create a la
Customizing global UI elements 16You can use the Global Items Inspector to change the UI elements used across all BlackBerry® applications.Change imag
c. Click Change Image.d. Navigate to an image.e. Click Open.Change colors for global UI elements1. In the Inspector, click the Global Items button.2.T
3. In the drop-down list for the screen or list, click a transition effect.You can click the button beside each drop-down list to preview the screen t
Testing your theme 17You can test your themes by using the BlackBerry® Smartphone Simulator or a BlackBerry device.Using the BlackBerry Smartphone Sim
View a theme in the BlackBerry Smartphone SimulatorAfter you configure the BlackBerry® Smartphone Simulator, you can view a theme in the BlackBerry Sm
Comments to this Manuals