DG Themes R26A
DG Themes R26A
DG Themes R26A
August 2007
Themes
for Sony Ericsson phones
Developers guidelines | Sony Ericsson Themes
Preface
The document is intended for content providers who want guidelines to optimally create themes and the
elements required to create an appealing theme.
• Software developers
• Operators and service providers
• Content providers
It is assumed that the reader is familiar with different graphic and sound formats.
These Developers guidelines are published by: This document is published by Sony Ericsson
Mobile Communications AB, without any
Sony Ericsson Mobile Communications AB, warranty*. Improvements and changes to this text
necessitated by typographical errors, inaccuracies
SE-221 88 Lund, Sweden of current information or improvements to
programs and/or equipment, may be made by
Phone: +46 46 19 40 00 Sony Ericsson Mobile Communications AB at any
Fax: +46 46 19 41 00 time and without notice. Such changes will,
however, be incorporated into new editions of this
www.sonyericsson.com/ document. Printed versions are to be regarded as
temporary reference copies only.
© Sony Ericsson Mobile Communications AB,
2006. All rights reserved. You are hereby granted *All implied warranties, including without limitation
a license to download and/or print a copy of this the implied warranties of merchantability or fitness
for a particular purpose, are excluded. In no event
document. shall Sony Ericsson or its licensors be liable for
Any rights not expressly granted herein are incidental or consequential damages of any
reserved. nature, including but not limited to lost profits or
commercial loss, arising out of the use of the
information in this document.
26th edition (August 2007)
Publication number: EN/LZT 108 7584 R26A
2 August 2007
Developers guidelines | Sony Ericsson Themes
Sony Ericsson also offers technical support services to professional developers. For more information
about these professional services, visit the Sony Ericsson Developer World Web site.
The Bluetooth word mark and logos are owned by the Bluetooth SIG, Inc. and any use of such marks by
Sony Ericsson is under license.
Symbian and all Symbian-based marks and logos are trademarks of Symbian Limited.
Microsoft Windows is either a registered trademark or trademark of Microsoft Corporation in the United
States and/or other countries.
Mac OS is a trademark of Apple Computer, Inc., registered in the U.S. and other countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.
3 August 2007
Developers guidelines | Sony Ericsson Themes
Document conventions
Products
Sony Ericsson mobile phones are referred to in this document using generic names as follows:
K530 K530i
K600 K600i
K770 K770i
P1 P1i, P1c
4 August 2007
Developers guidelines | Sony Ericsson Themes
T68 T68i
W600 W600i
W660 W660i
W900 W900i
W960 W960i
5 August 2007
Developers guidelines | Sony Ericsson Themes
Z500 Z500a
Z525 Z525a
Z610 Z610i
Z750 Z750i
Z800 Z800i
Z1010 Z1010
Typographical conventions
In this document code examples are written in Courier font:
<textColor id="operator" text="#000000" outline="#9CCE9C"></ textColor>
Term Explanation
6 August 2007
Developers guidelines | Sony Ericsson Themes
Document history
Change history
2004-03-27 Version R3A Third edition. Editorial changes for K700 image
size.
2004-10-29 Version R5A Fifth edition. Added information for V800 and
T290 series.
2006-01-04 Version R11A 11th edition. Added information for W810 series
2006-02-13 Version R12A 12th edition. Added information for K610, M600
and W950 series
2006-02-28 Version R13A 13th edition. Added information for K800, K790,
Z530, W300, K510 and K310 series
2006-04-04 Version R14A 14th edition. Added information for W700 and
Z525 series
2006-06-19 Version R16A 16th edition. Added information for the K610im
7 August 2007
Developers guidelines | Sony Ericsson Themes
Change history
2006-08-22 Version R17A 17th edition. Added information for the K618i
and Z610 series
2006-12-04 Version R19A 19th edition. Added information for Z310 series
2007-01-08 Version R20A 20th edition. Added information for W200 series
2007-05-08 Version R23A 23rd edition. Added information for S500, T650,
W580 and Z750 series
2007-06-20 Version R25A 25th edition. Added information for K530, K850,
T250, W910, W960, Z250 and Z320 series
2007-08-21 Version R26A 26th edition. Added information for K770 series
8 August 2007
Developers guidelines | Sony Ericsson Themes
Contents
Themes architecture .................................................................................................11
Themes introduction ...............................................................................................12
Compatibility between different Sony Ericsson mobile phones ..........................12
Theme MIME types .................................................................................................14
Sony Ericsson Themes Creator ...............................................................................14
Characteristics and limitations of the Themes Creator .......................................16
Customized icons for preview in Themes Creator ...............................................16
Theme design recommendations ............................................................................17
Creating images ...................................................................................................17
Element colours ...................................................................................................18
Colour reduction and dithering features in Themes Creator ...............................19
Appendix 1
Themes version 1.0 ...................................................................................................21
Image files in themes ..............................................................................................22
Colour setting notes ................................................................................................23
Appendix 2
Themes version 2.0 ...................................................................................................24
Image files in themes ..............................................................................................25
Colour setting notes ................................................................................................26
Ringtones ................................................................................................................26
Appendix 3
Themes version 3.0 ...................................................................................................27
Image files in themes version 3.0 ............................................................................28
Colour setting notes ................................................................................................30
Alpha blended colours .........................................................................................31
Ringtones ................................................................................................................32
Appendix 4
P900/P910 themes ....................................................................................................33
Theme package contents ........................................................................................34
The XML file .........................................................................................................35
Skins and screen saver ........................................................................................37
Example of a valid XML file .................................................................................43
P900/P910 theme creation ......................................................................................44
Colour scheme ...................................................................................................44
Wallpaper .............................................................................................................45
Fixed elements ....................................................................................................45
System Sounds FAQ ...........................................................................................47
Appendix 5
Themes versions 3.1 and 3.2 ....................................................................................48
Organic elements ....................................................................................................49
Image files in themes version 3.1 and 3.2 ...............................................................49
Colour setting notes ................................................................................................51
Alpha blended colours .........................................................................................51
Ringtones ................................................................................................................53
Appendix 6
9 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 7
Themes version 4.1 ...................................................................................................61
Image files in themes version 4.1 ............................................................................62
Images order of placement ..................................................................................66
Colour setting notes ................................................................................................66
Alpha blended colours .........................................................................................66
Sounds ....................................................................................................................68
Appendix 8
Symbian 9/UIQ3 themes ...........................................................................................69
Symbian9/UIQ3 theme package contents ..............................................................70
Skins, skintexts and patches ..................................................................................70
Colour schemes ....................................................................................................70
Image files ...............................................................................................................71
Image drawstyles .................................................................................................71
Text colours and styles ...........................................................................................72
Sounds ....................................................................................................................72
The Preview screen .................................................................................................73
Theme elements ......................................................................................................73
Appendix 9
Themes version 4.5 ...................................................................................................80
Image files in themes version 4.5 ............................................................................81
Images order of placement ..................................................................................85
Colour setting notes ................................................................................................85
Alpha blended colours .........................................................................................86
Sounds ....................................................................................................................87
Illumination ..............................................................................................................87
Appendix 10
Themes version 4.6 ...................................................................................................89
Image files in themes version 4.6 ............................................................................90
Images order of placement ..................................................................................93
Colour setting notes ................................................................................................94
Alpha blended colours .........................................................................................94
Sounds ....................................................................................................................95
Illumination ..............................................................................................................96
Appendix 11
Themes version LF1.0 ...............................................................................................97
Image files in themes version LF1.0 ........................................................................98
Images order of placement ..................................................................................99
Colour setting notes ................................................................................................99
10 August 2007
Developers guidelines | Sony Ericsson Themes
Themes architecture
This chapter contains general information about themes in Sony Ericsson mobile phones. Specific infor-
mation about theme formats and specifications for different phone models and theme versions can be
found in the appendices of this document.
11 August 2007
Developers guidelines | Sony Ericsson Themes
Themes introduction
A theme is a way to change the graphical experience for the user in just one setting.
When the user selects to use a theme, the following user interface details may be affected:
Which elements that may be affected by themes depends on the mobile phone model. At delivery a
number of themes are pre-loaded into the phone. More themes can be achieved, for example through an
Internet connection, via MMS, or from a computer connected to the phone via Infrared, serial/USB cable
or Bluetooth™ wireless technology.
Theme files for Sony Ericsson phones, except for the Symbian™/UIQ™ phones (M600, P1, P900, P910,
P990, W950 and W960 series), are TAR archives with the file extension .thm. A theme file contains at least
an XML file, in which colour settings for graphical elements and optionally image file names and audio file
names are defined. If the XML file specifies image or audio file names, the specified files are also included
in the archive. To extract the individual files from THM theme files most standard archiving applications on
the market can be used.
Sony Ericsson Symbian/UIQ phone theme files are ZIP packages with file extension .utz. A package con-
tains an XML file specifying colour settings, images and sounds used in the theme, together with a
number of image and audio files.
For Sony Ericsson mobile phones other than the P900/P910, standard image formats, GIF, JPEG, PNG
and SVGT 1.1 are used.
For the P900/P910, a Symbian specific file format called “MultiBitMap” file (MBM) is used for certain
images in a theme. MBM files are native Symbian OS format. MBM files can consist of one or multiple
images. The MBM format is not supported for the UIQ3 phones, M600, P1, P990, W950 and W960 series.
Several themes versions exist for Sony Ericsson mobile phones. In the table below, phone models,
themes versions and screen sizes are listed. For more details and specifications for the different themes
versions and phone models, refer to the appendices of this document.
12 August 2007
Developers guidelines | Sony Ericsson Themes
J210, J220, J230 and Z300 subset of ver 2.0 128x128 65,536 colours
W550, W600, W810, Z550, Z558 ver 4.1 176x220 262,144 colours
K530, K550, K610, W610, W660, W710, Z610, ver 4.5 176x220 262,144 colours
Z710
K770, K790, K800, K810, S500, T650, W580, ver 4.5 240x320 262,144 colours
W830, W850, W880
M600, P1, P990, W950, W960 Symbian 9/UIQ 3 240x320 262,144 colours
specified theme
format
13 August 2007
Developers guidelines | Sony Ericsson Themes
.thm application/vnd.eri.thm MIME type for Sony Ericsson J210, J220, J230,
J300, K300, K310, K320, K500, K510, K530,
K550, K600, K610, K700, K750, K770, K790,
K800, K810, K850, S500, S700, T68, T230, T250,
T290, T300, T310, T610, T630, T650, V800,
W200, W300, W550, W600, W610, W660, W700,
W710, W800, W810, W830, W850, W880, W900,
W910, Z250, Z300, Z310, Z320, Z500, Z520,
Z525, Z530, Z550, Z558, Z600, Z610, Z710, Z800
and Z1010 themes
.utz application/vnd.uiq.thm MIME type for Sony Ericsson M600, P1, P900,
P910, P990, W950 and W960 themes
The Sony Ericsson Theme Creator application helps you to create/compose themes which are compatible
with Sony Ericsson mobile phones. The application is not a graphic editing tool, but more of a “com-
poser”, that is, it enables you to create a theme based on existing components (sound files, image files,
and so on.). It also allows you to change display colours for menu text, clock display, and so on.
The image below shows the main window of the Themes Creator application, with the K510 phone
selected for theme editing and preview.
• In the File menu the phone model to work with can be changed, existing theme files can be opened
and the current theme can be saved.
• The tabs are used to select group of theme elements to edit. In the example below, the Standby
screen is selected.
• The Import... buttons are used to select images for elements. When a button is pressed, an “Open”
dialog is displayed so the wanted image file can be selected and imported.
• Colour settings for text items, outlines and backgrounds can be entered directly into the text fields or
selected via a “Colour” dialog, displayed when a colour button is pressed.
14 August 2007
Developers guidelines | Sony Ericsson Themes
• Image and colour changes are immediately reflected in the preview image to the right.
• From Themes Creator v 3.08 a new feature has been added. When the user moves the cursor over a
graphic element, a pop up shows where that element is used, as in the image below.
• Additional features have been added with Themes Creator v 3.10. Three new menu items can be found
in the File menu:
• Export empty resources. This feature allows export of a collection of image elements to a selected
directory. Each image needed for a complete theme is saved in the selected directory as a .png file
with the correct element size and given the correct file name. The saved collection can be used as a
“template” for easy creation of all the image files needed for a complete theme for the currently
selected phone model. This feature only works with themes versions supporting PNG files.
• Import resources. This feature is used for import of a collection of image files from a selected direc-
tory into the current theme. If some images are missing or are not correctly named, a dialog lists
files that are missing for a complete theme to be created. This feature is primarily used for reimport-
ing files that was exported as “empty resources” and then “filled” with graphics.
• List missing elements. This feature allows the user to quickly find out if image elements/patches or
sound files needed to make the current theme complete, have not yet been imported to the current
theme.
15 August 2007
Developers guidelines | Sony Ericsson Themes
• With Themes Creator v 3.16, functionality for colour reduction and dithering of PNG images has been
added for themes versions 4.5 and 4.6. See “Colour reduction and dithering features in Themes Cre-
ator” on page 19
• Due to resolution and colour depth differences between the computer and the phone, the preview
pane of the Sony Ericsson Themes Creator can be slightly different compared to what is displayed in
the mobile phone. Differences may also depend on market or operator customizations of the phone.
• The Symbian graphic format (MultiBitMap – MBM) is required for the P900/P910 theme to provide the
graphical effects of the mobile phone. The application converts MBM files in opened theme files to
BMP files which are displayed in the preview pane of the Sony Ericsson Themes Creator. Therefore,
the appearance of the MBM skins might differ from the appearance in the actual P900/P910 devices.
For more information about MBM files, refer to the Symbian publication “Symbian OS C++ for Mobile
Phones” by Richard Harrison.
• If a P900/P910 theme (not created in the Themes Creator) is opened and an MBM file does not contain
the correct number of bitmaps, these bitmaps will not be shown in the applications.
• If not all bitmaps for an MBM file are present in the Themes Creator when saving the theme, a warning
message is displayed. If the warning is ignored, and the theme is saved, this specific MBM file will not
be included in the theme.
Note: This functionality is for preview only, and does not in any way affect the themes created – there is
no way to include these icons into the theme and make the phone software use them instead of standard
icons. Desktop icons are fixed in phone software.
Some operators, by special business agreements, may receive software variants with customized icons,
affecting desktop and status bar icons. The new Themes Creator functionality is intended to make it easier
to preview themes for such customized phone software – for example to adapt themes colours to icon
colours.
1. From the icon source, extract the icons to be used for the preview.
16 August 2007
Developers guidelines | Sony Ericsson Themes
• Desktop icons are named "RxC.png", where "R" is the row of the icon position, and "C" is the col-
umn. For instance, if the Messaging icon is placed in the middle of the second row (the SEMC stan-
dard position), the icon file should be named "2x2.png".
• Other icons:
RSSI icon must be named “rssi.png”
Battery icon must be named “battery.png”
Individual instances of icons can also be added to the preview by drag and drop on the preview window.
The path of the inserted icon is saved in an XML file. There is one XML file per phone model and they are
all stored in the directory:
The customized icons remain in the preview images until the resource file or the XML file is deleted.
• If images are to be used for wallpaper and desktop background, they must be of the defined size. Oth-
erwise the images will not be displayed correctly or, in worst case, the mobile phone will not be able to
install the theme.
Creating images
For creating pictures and image components, use any standard commercially available image editing
application, for example Adobe® Photoshop®.
17 August 2007
Developers guidelines | Sony Ericsson Themes
When creating images for themes, the following must be taken into consideration:
• The colour depth of the mobile phone: 256, 512, 4K, 65K or 262K colours
• Τhe height and width of the image.
• Images must be valid GIF/JPEG/PNG/MBM/BMP/SVGT 1.1 files (depending on the themes version of
the phone, see the specifications in the appendices of this document). If one file is corrupt the whole
theme file will be treated as corrupt.
• When using JPEG files, make sure that the files are converted/saved to JPEG format from images with
24-bit colour depth. Otherwise, the theme will be considered invalid and can not be installed in the
phone.
Note:
Images are not always required for elements that allow images. Using an image file results in a larger
theme file. In many cases, a colour attribute is sufficient for making the theme look good.
Element colours
The Sony Ericsson Themes Creator starts with a default set of colours for all required theme elements. It is
up to the user to change the colours he wants.
Colour selection
When selecting colours for certain elements of a theme, colours of some pairs and some triplets of ele-
ments must be chosen so that the user clearly can see the elements on the phone display. The RGB dis-
tance (see below) between elements need to be at least 20 for themes version 1 and 2, and at least 12 for
themes version 3.0, 3.2, 4.0, 4.1 and 4.5, to allow a user to see the colour difference on the screen.
When a colour setting for an element that need to be separable from other elements is changed in the
Themes Creator, the RGB distance between the colours is calculated. Small red triangles near the colour
buttons indicate that the current values are invalid, that is too close in colour. The theme can still be saved
after a warning message, but the theme can not be installed in a phone.
Note: For phones with 256, 512 or 4096 colour displays, element colour pairs may in rare cases become
invalid even if the RGB distance is greater than 20. This is because the colours are converted into the
screen’s palette, and two colours that are separable in RGB mode may be converted into palette colours
that are not.
Example:
To calculate the RGB distance between two blue colours, RGB(0,67,140) and RGB(0,82,164):
1. Calculate the differences between Red, Green and Blue colour values separately and calculate the
square of the differences.
Red difference = 0 – 0 = 0
Blue difference = 82 – 67 = 15
Green difference = 164 – 140 = 24
18 August 2007
Developers guidelines | Sony Ericsson Themes
3. The RGB distance is calculated as the square root of the sum of squares above:
RGB distance = UMN = 28.3
When colour reduction is enabled in the tools menu, all images will be colour reduced. Images having
Dither checked will also be dithered. Colour reduction operations are performed just before the theme is
saved to disk, and can be quite time-consuming. For large themes on large displays, it can take several
minutes to perform all reductions.
Note: The preview shows the original image, not the colour reduced/dithered one.
19 August 2007
Developers guidelines | Sony Ericsson Themes
There is no indication inside the saved theme file if images have been colour reduced and/or dithered. If a
theme including dithered images is saved and loaded back into Themes Creator, Dither is not checked for
these images.
Dithered image files are often considerably larger than their non-dithered originals which also has an
impact on the total size of the theme file. In Themes Creator image file sizes can be checked using the
menu Tools – Color reduced image size info.
The mid column states the image size when saved to the theme, dithered or not. The right most column,
only contains a value when the image is checked to be dithered, in which case the non-dithered size is
found here for comparison.
20 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 1
Themes version 1.0
This appendix contains theme specifications for the Sony Ericsson T68, T230, T290, T300 and T310
series.
21 August 2007
Developers guidelines | Sony Ericsson Themes
Phone specifications
Standby
Background 101x80 If the image is larger than 101x80 it is cut from the
bottom/right, if it is smaller, it is centered on the
screen.
Desktop
Desktop background 101x80 If the image is larger than 101x80 it is cut from the
bottom/right, if it is smaller it is centered on the
screen.
Navigation
Title (small) 101x20 When an image is used for this element, two rows
of text with small font can be displayed in the title,
which gives less room for menu items. Only in
menus, not in applications.
Title (medium) 101x27 When an image is used for this element, two rows
of text with medium font can be displayed in the
title, which gives less room for menu items. Only in
menus, not in applications.
Title (large) 101x16 Only room for one row with large font in the title
Title (Asian) 101x16 Same as Title (large) for phones on the Asian mar-
ket.
Highlight (small) N/A 101x10 Background for highlighted items with small font.
Highlight (medium) N/A 101x13 Background for highlighted items with medium
font.
Highlight (large) N/A 101x16 Background for highlighted items with large font.
22 August 2007
Developers guidelines | Sony Ericsson Themes
Highlight (Asian) N/A 101x16 Same as Highlight (large) for Asian phones.
Datalist Image N/A 101x80 Background picture used in menus. This image will
be obscured by Title and Highlight bar.
Note: The colour palette used for the GIF conversion has great impact on the quality of theme images.
The Developers Guideline Adapting images for Sony Ericsson phones contains instructions how to opti-
mize the 256 colour palette for GIF images to be viewed on phone displays. Particularly, great improve-
ments can be achieved on images for the T226 (512 colour/9-bit) and T230/T290 series (4,096 colour/12-
bit) phones. This document can be downloaded from www.sonyericsson.com/developer/multimedia.
Some colour settings only have effect on the display when an image is selected for the background.The
following colour values are replaced by the Text colour setting (set in the Navigation tab in Themes Cre-
ator) when there is no image in the background:
The colour setting Desktop title shadow is only used when there is an image for the desktop background.
23 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 2
Themes version 2.0
This appendix contains theme specifications for the Sony Ericsson J210, J220, J230, T610, T630, Z300
and Z600 series.
24 August 2007
Developers guidelines | Sony Ericsson Themes
Phone specifications
Supported image file for- GIF, JPEG GIF, JPEG image files must be valid GIF or JPEG files.
mats If one file is corrupt, the whole theme will be
treated as corrupt.
Standby
Desktop
Navigation
Title 128x23 128x23 When an image is used for this element, its
height is about two rows, instead of one
when the colour setting is used, which
gives less room for menu items. The image
is shown only in menus, not in applications.
Popup
Note: In general JPEG files are smaller than GIF files with the same image size. The image format used
therefore affects the final size of the theme file. A general recommendation is to use GIF files for coloured
line art graphics (“cartoon-like images”), and JPEG files for photographic pictures.
25 August 2007
Developers guidelines | Sony Ericsson Themes
Some colour settings only have effect on the display when an image is selected for the background.The
following colour values are replaced by the Text colour setting (set in the Navigation tab in Themes Cre-
ator) when there is no image in the background:
The colour setting Desktop title shadow is only used when there is an image for the desktop background.
Ringtones
Note: Ringtones can only be included in ver 2.0 themes for the J210, Z300, J220 and J230 series.
In the Themes Creator a ringtone can be imported into the theme. Select the Ring signal tab to import the
audio file you want. However, not all ringtone formats are suited for all phones. Please refer to the Ring-
tones Developers Guideline, available for download at www.sonyericsson.com/developer/multimedia.
26 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 3
Themes version 3.0
This appendix contains theme specifications for the Sony Ericsson J300, K300, K500, K700, S700, Z500,
and Z1010 series.
27 August 2007
Developers guidelines | Sony Ericsson Themes
The image file format used affects the total size of the theme file. In general GIF files are smaller than
JPEG files with the same image size. PNG files always contains full 24-bit colour representation and does
not approximate pixel areas as the JPEG format does, which in some cases leads to large files. The PNG
format allows semi transparency through alpha channels.
A general recommendation is to use GIF files for coloured line art graphics (“cartoon-like images”) and
animations, JPEG or PNG files for photographic pictures. In many cases it is worth the effort to save an
image in different formats and select the smallest file. PNG must be used for images with transparent or
semi-transparent areas.
The table below lists theme elements where images may be used and sizes of these images in pixels. In
the “Comment” column is noted which images are allowed to be animations and for which elements
image transparency is supported.
Phone specifications
Screen size 176x220 176x220 240x320 128x160 128x128 Z500 external display:
96x64
Supported image file GIF, JPEG, PNG If one image file is cor-
formats rupt, the whole theme
will be treated as cor-
rupt.
Standby
Desktop
28 August 2007
Developers guidelines | Sony Ericsson Themes
29 August 2007
Developers guidelines | Sony Ericsson Themes
Popup (background) 150x150 163x152 209x232 118x109 118x101 The size of the area
where this image is dis-
played depends on if
there is a title and (for
More menus) the
number of items in the
list. The image is
cropped if the area is
smaller than the image
size.
30 August 2007
Developers guidelines | Sony Ericsson Themes
Standby
Secondary statusbar background 70% of White (FFFFFF) Not in XML file. Z500 only.
Softkeys
Desktop
Desktop title text shadow 20% of Black (000000) Not in XML file
General
Popup/More list
Popup title text shadow 20% of Black (000000) Not in XML file
Popup disabled text 50% of text in More lists Not in XML file
Popup highlight disabled text 50% of highlighted text in Not in XML file
More lists
Tabs
Notes
31 August 2007
Developers guidelines | Sony Ericsson Themes
Ringtones
In the Themes Creator a ringtone can be imported into the theme. Select the Ring signal tab to import the
audio file you want. However, not all ringtone formats are suited for all phones. Please refer to the Ring-
tones Developers Guideline, available for download at www.sonyericsson.com/developer/multimedia.
32 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 4
P900/P910 themes
A P900/P910 theme package is a standard zip file with the file extension .utz, containing several files.
Some of the files must match the definition given in a XML file in the theme package, while others must
match the rules specific to the P900/P910 theme extensions.
33 August 2007
Developers guidelines | Sony Ericsson Themes
Mandatory
• One (1) Theme XML definition in a file with extension .xml.
This must be present in the package. The format will be explained below.
Optional
• Two (2) wallpaper images (typically JPEGs, but can be any image format handled by the P900/P910
media server – GIF, JPEG or PNG). One of the wallpaper images is for the Flip Open AppLauncher, and
one is for the Flip Close standby screen of telephony. The names of these two files are specified in the
XML definition file.
• 16 sound files (any audio format supported by the media server – MP3, MIDI or RMF).
A theme package can contain any combination of these files or none of them. File names are specified
in the XML definition file.
The name and format of these skin files are static, and cannot be defined in the XML definition file. A
theme package can contain any combination of the skin bitmap files. The Themes Creator automati-
cally gives the skin files correct names when a theme is saved.
A theme package can contain all or none of them. The name of the files are static. The Themes Creator
automatically names the file correctly when a theme is saved.
• One (1) screensaver image file (must be a GIF). File name is static. The Themes Creator automatically
names the file correctly when a theme is saved.
34 August 2007
Developers guidelines | Sony Ericsson Themes
Note:
Elements in the XML file that does not have any PCDATA or sub elements, but only attributes can be writ-
ten in an abbreviated format. So instead of writing
The XML file can contain the following elements ( example of xml file provided below):
<?xml version="1.0"?>
(Mandatory element)
<theme>…</theme>
(Mandatory element)
title: title of the theme (for example title="my theme". Should be the same as the file name of the
theme.)
author: author of the theme (for example author="John Doe")
copyright: copyright information (for example copyright="Sony Ericsson")
screenWidth: the screen width of the device for which this theme is intended (“208”)
screenHeight: the screen height of the device for which this theme is intended (“320”)
PCDATA
filename: name of the file to use for the specified wallpaper (for example wallpaperforest.jpg). The file
name can contain a relative path within the theme zip file. The image file can be of any type supported by
the media server. If the file is an animation (for example GIF) then only the first frame in the animation will
be used as wallpaper.
35 August 2007
Developers guidelines | Sony Ericsson Themes
<condensedColorScheme>...</condensedColorScheme>
Mandatory element used to define a colour scheme. The condendedColorSheme element has no
attributes or PCDATA, but must have the following three sub elements:
<darkColor></darkColor>
<midColor></midColor>
<lightColor></lightColor>
• background: a string defining a RGB colour (standard HTML hex format), for example "#316331"
• text: a string defining a RGB colour (standard HTML hex format), for example "#FFFFFF”
systemSound>filename</systemSound>
Optional element
If present, it must contain the following mandatory attribute:
id: id to identify the system sound that should use the specified file.
XML ID UI String
Reminder Reminder
Note:
If your theme will use MP3 files, make sure they contain an ID3V2 tag in the beginning of the file. If the
ID3V2 tag is missing from the beginning of the file, it will not be possible to pre-listen to the sound. Sound
files should not be bigger than 500 Kb. Bigger files can not be pre-listened to.
filename: name of the file to associate with the specified system sound. The sound file can be of any for-
mat supported by the media server, and the file name can include a relative path within the theme file.
<colors>…</colors>
Optional element used to specify some specific text colours that override the colour scheme specified.
Only the colour of the text in the standby screen in flip close (FC) can be customized by a theme.
36 August 2007
Developers guidelines | Sony Ericsson Themes
id: ID to identify the text colour that should use the colour specification.
text: RGB colour value in standard HTML hex format. Specifies the colour to be used on text.
outline: RGB colour value on standard HTML hex format. Specifies the colour to be used on the text out-
line.
The textColor IDs supported for the “FcStandby” id of the <colors> element are (all lowercase):
• operator
• softkeys
• clock
• alarm
• other
Examples:
Those images must have a specific file name, a specific file format and a specific size.
System/ScreenSaver.gif
Standard GIF image file (static or animated), if present in the theme package it will be used as screensaver
for the device (suggested size: 208x320). The “Screensaver.gif” file must be place in a subfolder of the zip
file called “System”
Skins – MBM
A theme package can contain any of the following MBM files with exactly the given names:
• AppickerSkin.mbm
• DialogSkin.mbm
• FcTitleBarSkin.mbm
• LauncherSkin.mbm
• ListBoxSkin.mbm
• MenuSkin.mbm
• MenuExtraSkin.mbm
• StatusBarSkin.mbm
37 August 2007
Developers guidelines | Sony Ericsson Themes
Each MBM contains one or more bitmaps with compatible sizes and in the correct predefined order inside
the MBM. In the Themes Creator, bitmap files are imported and the MBM files are created and named cor-
rectly when the theme is saved.
The bitmaps in the MBM files will be used to draw skins on associated UI control. If the bitmap is smaller
than its associated UI control, it will be applied using one of three methods:
• Normal: the bitmap is applied to the upper left corner of the control, no stretching or shrinking to
match the size of the control is done (the bitmap should already have the correct size).
• Stretch: the bitmap will be stretched to match the size of the control (details below).
• Tile: the bitmap will be tiled across the control (details below).
Each bitmap that is stretched or tiled when applied has a predefined margin associated with it (see
image below). When applied, the corner pieces (yellow) are copied as they are to the corners of the con-
trol. The side parts (blue) are stretched or tiled (depending on the method used) across the sides of the
control, and finally, the centre piece is stretched or tiled across the centre of the control.
Unless sizes of the bitmaps is mentioned below, the exact size does not matter much, since the bitmap
will be stretched or tiled to fit the control. However, in the case if tiling, the smaller the bitmap is, the more
times each piece needs to be tiled, which might affect drawing performance.
Typically, the colour depth of skin bitmaps shall be 12- or 16-bit colour, and the colour depth of masks
shall be 1-bit black and white, or 8-bit greyscale for alpha channel.
MenuSkin.mbm
This MBM contains the bitmaps that will be used for the menu bar, and some of the bitmaps for the menu
pane.
38 August 2007
Developers guidelines | Sony Ericsson Themes
MenuExtraSkin.mbm
1 bitmap for menu pane background
1 bitmap for menu pane separator
1 bitmap with 16 elements for menu item adornments
1 bitmap with 16 elements for menu item adornment masks
39 August 2007
Developers guidelines | Sony Ericsson Themes
MenuPaneOptionButtonClear
MenuPaneOptionButtonSet
MenuPaneOptionButtonClearHighlighted
MenuPaneOptionButtonSetHighlighted
MenuPaneOptionButtonClearDimmed
MenuPaneOptionButtonSetDimmed
MenuPaneOptionButtonClearDimmedHigh-
lighted
MenuPaneOptionButtonSetDimmedHighlighted
MenuPaneTick
MenuPaneTickHighlighted
MenuPaneTickDimmed
MenuPaneTickDimmedHighlighted
MenuPaneCascadeArrow
MenuPaneCascadeArrowHighlighted
MenuPaneCascadeArrowDimmed
MenuPaneCascadeArrowDimmedHighlighted
DialogSkin.mbm
This MBM contains the bitmaps that will be used for the dialogs:
40 August 2007
Developers guidelines | Sony Ericsson Themes
ListBoxSkin.mbm
This MBM contains the bitmap that will be used for the listboxes highlight:
StatusBarSkin.mbm
This MBM contains the bitmap that will be used for the status bar.
1 bitmap with 2 elements for StatusBar Background (each element 208x18 pixels)
Note:
Depending on the status bar implementation, the second element used for the background when empha-
sized might not be used.
FcTitleBarSkin.mbm
This MBM contains the bitmap that will be used for title bar in flip closed mode:
AppickerSkin.mbm
N=Äáíã~é=Ñçê=~ééáÅâÉêÛë=Ä~ÅâÖêçìåÇ
N=Äáíã~é=ïáíÜ=S=ÉäÉãÉåíë=ES=êçïëI=N=ÅçäìãåF=Ñçê=~ééáÅâÉêÛë=Üççéë
N=Äáíã~é=ïáíÜ=S=ÉäÉãÉåíë=ES=êçïëI=N=ÅçäìãåF=Ñçê=~ééáÅâÉêÛë=Üççé=ã~ëâë
^ééáÅâÉê=Ä~ÅâÖêçìåÇ=EëáòÉ=OMUñOR=éáñÉäëF
41 August 2007
Developers guidelines | Sony Ericsson Themes
LauncherSkin.mbm
This MBM contains the bitmap that will be used for the AppLauncher
1 bitmap with 5 elements (5 rows, 1 column) for AppLauncher disks & disks animation
(from 30x30 to 44x44)
1 bitmap with 5 elements (5 rows, 1 column) for mask to the disks (from 30x30 to 44x44)
42 August 2007
Developers guidelines | Sony Ericsson Themes
ShortCutUnselectedBall.png
42x42 pixels
ShortCutSelectedBall.png
42x42 pixels
ShortCutBallHalo.png
42x42 pixels
43 August 2007
Developers guidelines | Sony Ericsson Themes
Colour scheme
A theme xml must contain the definition of a colour scheme. It is often tricky to find a good combination of
colours that is readable and nice.
<condensedColorScheme>
<darkColor background="#B2C1D3" text="#000000"></darkColor>
<midColor background="#3B74B9" text="#FFFFFF"></midColor>
<lightColor background="#FFFFFF" text="#000000"></lightColor>
</condensedColorScheme>
44 August 2007
Developers guidelines | Sony Ericsson Themes
In Applauncher, to improve readability when a bitmap is used to highlight items, the text colour will be
dark with a light outline if the current colour scheme's highlight text colour is dark, and light with a dark
outline if the current colour scheme's highlight text colour is light.
Wallpaper
• A theme may contain wallpaper for Flip Open (FO), Flip Close (FC) , or both. The suggestion is to use
JPEG files for the images to limit the size of the final package.
• If an animated GIF is used, the first frame will be used as image for the wallpaper.
• Optimal size for Flip Close wallpaper is 208x190, and 208x256 for Flip Open wallpaper.
• If an image is too wide for the container area, the image will be cropped from the right.
• If an image is too high, the bottom part will be cropped.
• If a theme package does not contain any wallpaper, no image will be displayed and the light colour
from the colour scheme will be used instead.
Fixed elements
Bitmaps and colour scheme
It is important to find a good combination between the colours of the graphical elements (MBM) and the
colour scheme. For example when an element is highlighted in a list box it will use the bitmap provided by
listboxskin.mbm but the text colour will be taken from the colour scheme.
The same can be applied to most of all other graphical elements. A trade-off must be done between read-
ability and bitmap colours.
45 August 2007
Developers guidelines | Sony Ericsson Themes
For some elements the size on screen never changes. If their bitmap has the same size as the final draw-
ing area, performance will be optimal. Some on-screen sizes:
The optimal size for elements like bitmap in listboxskin.mbm, menu pane background (in menuex-
tra.mbm), and all the bitmaps other than menu bar background in menuskin.mbm is much more complex
to define. These bitmaps are used for elements with largely variable size and only a good balanced trade-
off can give the best results.
A simple suggestion is not to make those bitmaps too small, especially the ones that will be tiled (the more
times a bitmap must be tiled, the slower it will be).
Launcherskin.mbm
There is no fixed size for the bitmaps in this MBM, but every element of each bitmap must have the same
size. The shape of the elements must not necessarily be a square.
If the size of the bitmap is too wide or too high, it will not be used. For example, if the bitmap for the disk
icons is larger than 44 pixels, the default bitmap will be used instead.
If LauncherSkin.mbm is not included in the theme package, the default bitmap will be used, and its col-
ours will be remapped to the colour scheme.
Example:
AppickerSkin.mbm
All the bitmaps of this MBM have a fixed size.
46 August 2007
Developers guidelines | Sony Ericsson Themes
If this MBM is missing in the theme package, the default bitmap is used and its colours are remapped to
the colour scheme.
StatusBarSkin.mbm
The bitmap has a fixed size.
If this MBM is missing in the theme package, the default bitmap is used, and its colours are remapped to
the colour scheme.
Bitmap masks
Many of the bitmaps require masks.
A bitmap mask for an MBM file is a standard BMP file where white (#FFFFFF) identifies 100% opacity and
black 0% opacity (fully transparent). All shades of grey between white and black identify different levels of
opacity (alpha blending).
To be sure that the resulting mask in the final MBM give the expected result, we suggest converting the
original mask-bitmap to an 8bit grey-scale bitmap.
Q: Every time I create a theme, must I define all system sounds in the given order?
A: No, you can define any of the sounds in any order that suits you best
Q: Does the order I define my sounds in xml influence their order in the UI?
A: No, the order in the UI is always the same.
Q: What happens if I don't set a specific system sound (for example MessageNewSms)?
A: It will not appear in the UI, it will not be set, and its major sound (default message in this example) will
be used instead.
47 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 5
Themes versions 3.1 and 3.2
This appendix contains theme specifications for the Sony Ericsson V800 and Z800 series. Version 3.1
applies to themes without organic settings, and version 3.2 to themes with organic settings.
48 August 2007
Developers guidelines | Sony Ericsson Themes
Organic elements
In themes version 3.2 organic theme elements have been introduced. In an organic theme, one back-
ground and one foreground colour are specified for the organic elements. Animated patterns are gener-
ated automatically in these elements. Organic settings apply to wallpapers and list items on the first menu
level.
For example, in the V800, the preinstalled organic theme displays moving circles with varying opacity of
the organic foreground colour, overlayed on the organic background colour. In the preinstalled theme red
circles moves over a black background.
In the Themes Creator, organic themes are created by selecting “V800/Z800 Organic” in the Change
Phone Model dialog. The Organic Foreground and Organic Background colours are set in the Desktop
tab.
When organic colour settings are used for an element, no image can be used for that element.
One of the main benefits using organic themes instead of graphic animations or images is that the theme
files will be smaller.
The image file format used affects the total size of the theme file. In general JPEG files are smaller than
GIF files with the same image size. PNG files always contain full 24-bit colour representation and do not
approximate pixel areas as the JPEG format does, which in some cases leads to large files. The PNG for-
mat allows semi transparency through alpha channels.
A general recommendation is to use GIF files for coloured line art graphics (“cartoon-like images”) and
animations, JPEG or PNG files for photographic pictures. In many cases it is worth the effort to save an
image in different formats and select the smallest file. PNG must be used for images with transparent or
semi-transparent areas.
The table below lists theme elements where images may be used and their corresponding sizes in pixels.
The “Comment” column describes which images are allowed to be animated and which elements support
image transparency.
Phone specifications
49 August 2007
Developers guidelines | Sony Ericsson Themes
Supported image file formats GIF, JPEG, PNG If one image file is corrupt, the whole
theme will be treated as corrupt.
Standby
Desktop
Tab 176x40
50 August 2007
Developers guidelines | Sony Ericsson Themes
Popup (background) 150x150 The size of the area where this image
is displayed depends on if there is a
title and (for More menus) the number
of items in the list. The image is
cropped if the area is smaller than the
image size.
Secondary display
51 August 2007
Developers guidelines | Sony Ericsson Themes
Standby
Softkeys
Desktop
Desktop title text shadow 20% of Black (000000) Not in XML file
General
Popup/More list
Popup title text shadow 20% of Black (000000) Not in XML file
Popup highlight disabled text 50% of Popup highlight text Not in XML file
Tabs
Notes
Secondary display
52 August 2007
Developers guidelines | Sony Ericsson Themes
Ringtones
In the Themes Creator a ringtone can be imported into the theme. Select the Ring signal tab to import the
audio file you want. However, not all ringtone formats are suited for all phones. Please refer to the Ring-
tones Developers Guideline, available for download at www.sonyericsson.com/developer/multimedia.
53 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 6
Themes version 4.0
This appendix contains theme specifications for the Sony Ericsson K600, K750, W700, W800, Z520 and
Z525 series.
54 August 2007
Developers guidelines | Sony Ericsson Themes
The image file format used affects the total size of the theme file. In general JPEG files are smaller than
GIF files with the same image size. PNG files always contain full 24-bit colour representation and do not
approximate pixel areas as the JPEG format does, which in some cases leads to large files. The PNG for-
mat allows semi transparency through alpha channels.
A general recommendation is to use GIF or SVGT files for coloured line art graphics (“cartoon-like
images”) and animations, JPEG or PNG files for photographic pictures. In many cases it is worth the effort
to save an image in different formats and select the smallest file. PNG must be used for images with trans-
parent or semi-transparent areas.
Animations are supported in the GIF and SVGT formats. The GIF animation format support a 1 bit alpha
channel, but this will not be shown in the phone. If a GIF animation includes transparency, these areas will
be filled with a colour from the phone.
SVGT 1.1 content can be used for the Standby element (wallpaper in the Standby screen).
Themes version 4.0 support dynamic image sizes for a number of elements. Making images smaller than
the layout areas in the table below is always possible, but the look of the theme normally suffers from it.
Some images are allowed to be larger than the designated layout area. For these elements, max values
are given in the table below.
Highlight images can be made a little higher than the area they are supposed to highlight. Thus a Highlight
image may cover part of the text rows above and below the highlighted row. To avoid that a Highlight
image obscures the text above and below, one of the following actions can be taken:
• An image with less height than the maximum allowed can be used.
• For PNG images, an alpha channel can be used to make the upper and lower parts of the image, or the
whole image, transparent.
The table below lists theme elements where images may be used and their corresponding sizes in pixels.
The “Comments” column describes which images are allowed to be animated and which elements sup-
port image transparency.
Phone specifications
55 August 2007
Developers guidelines | Sony Ericsson Themes
Supported image file for- GIF, JPEG, GIF, JPEG, If one image file is corrupt,
mats PNG PNG the whole theme will be
treated as corrupt.
Supported animation for- GIF, SVGT GIF, SVGT SVGT animations only in
mats Standby (wallpaper).
Supported wallpaper file GIF, JPEG, GIF, JPEG, If one image file is corrupt,
formats PNG, PNG, the whole theme will be
SVGT 1.1 SVGT 1.1 treated as corrupt.
Standby
Softkey Left Pressed 176x26 128x18 Bottom, left Transparency (alpha chan-
nel) allowed.
Softkey Right Pressed 176x26 128x18 Bottom, right Transparency (alpha chan-
nel) allowed.
Desktop
Desktop 176x220 128x160 Center, center Note that the Statusbar and
Softkeys areas are parts of
the image.
Secondary display
56 August 2007
Developers guidelines | Sony Ericsson Themes
Navigation - Tabs
Popup
More List
57 August 2007
Developers guidelines | Sony Ericsson Themes
Input
Activity menu
Home Screen Tab 168x52 118x37 Center, center Transparency (alpha chan-
Max 168x57 nel) allowed.
Home Screen Tab Selected 60x27 37x20 Center, center Transparency (alpha chan-
nel) allowed.
Home Screen Tab Unse- 40x23 27x17 Center, center Transparency (alpha chan-
lected nel) allowed.
Home Screen Highlight 161x53 113x37 Center, center Transparency (alpha chan-
nel) allowed. Animation
allowed.
Home Screen Highlight 161x30 113x20 Center, center Transparency (alpha chan-
Small nel) allowed. Animation
allowed.
1. Background image
3. Inactive tabs
4. Active tab
5. Pressed softkeys
6. Highlight
58 August 2007
Developers guidelines | Sony Ericsson Themes
8. Popup title
Standby
Softkeys
Softkey Left text shadow 20% of Black (000000) Not in XML file
Softkey Right text shadow 20% of Black (000000) Not in XML file
Softkey Left disabled text 50% of Softkey Left Text Not in XML file
Softkey Right disabled text 50% of Softkey Right Text Not in XML file
Softkey Left disabled text shadow 20% of Black (000000) Not in XML file
Softkey Right disabled text shadow 20% of Black (000000) Not in XML file
Desktop
Desktop title text shadow 20% of Black (000000) Not in XML file
General
59 August 2007
Developers guidelines | Sony Ericsson Themes
Popup
Popup title text shadow 20% of Black (000000) Not in XML file
Popup highlight disabled text 50% of Popup highlight text Not in XML file
More List
Morelist highlight disabled text 50% of Morelist highlight text Not in XML file
Tabs
Activity menu
Homescreen tab text shadow 20% of Black (000000) Not in XML file
Homescreen highlight disabled text 50% of Homescreen highlight Not in XML file
text
Notes
Ringtones
In the Themes Creator a ringtone can be imported into the theme. Select the Ring signal tab to import the
audio file you want. However, not all ringtone formats are suited for all phones. Please refer to the Ring-
tones Developers Guideline, available for download at www.sonyericsson.com/developer/multimedia.
60 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 7
Themes version 4.1
This appendix contains theme specifications for the Sony Ericsson K310, K320, K510, W200, W300,
W550, W600, W810, W900, Z530, Z550 and Z558 series.
61 August 2007
Developers guidelines | Sony Ericsson Themes
The image file format used affects the total size of the theme file. In general JPEG files are smaller than
GIF files with the same image size. PNG files always contain full 24-bit colour representation and do not
approximate pixel areas as the JPEG format does, which in some cases leads to large files. The PNG for-
mat allows semi transparency through alpha channels.
A general recommendation is to use GIF files for coloured line art graphics (“cartoon-like images”) and
animations, JPEG or PNG files for photographic pictures. In many cases it is worth the effort to save an
image in different formats and select the smallest file. PNG must be used for images with transparent or
semi-transparent areas.
Animations are supported in the GIF format. The GIF animation format support a 1 bit alpha channel, but
this will not be shown in the phone. If a GIF animation includes transparency, these areas will be filled with
a colour from the phone.
SVGT 1.1 content (static or animated) can be used for the Standby element (wallpaper in the Standby
screen), except in K310 and K320 series.
Themes version 4.1 support dynamic image sizes for a number of elements. Making images smaller than
the layout areas in the table below is always possible, but the look of the theme normally suffers from it.
Some images are allowed to be larger than the designated layout area. For these elements, max values
are given in the table below.
Highlight images can be made a little higher than the area they are supposed to highlight. Thus a Highlight
image may cover part of the text rows above and below the highlighted row. To avoid that a Highlight
image obscures the text above and below, one of the following actions can be taken:
• An image with less height than the maximum allowed can be used.
• For PNG images, an alpha channel can be used to make the upper and lower parts of the image, or the
whole image, transparent.
The table below lists theme elements where images may be used and their corresponding sizes in pixels.
The “Comments” column describes which images are allowed to be animated and which elements sup-
port image transparency.
Phone specifications
62 August 2007
Developers guidelines | Sony Ericsson Themes
Supported image GIF, JPEG, GIF, JPEG, GIF, JPEG, If one image file is cor-
file formats PNG PNG PNG rupt, the whole theme will
be treated as corrupt.
Supported anima- GIF, SVGT GIF, SVGT GIF, SVGT SVGT animations only in
tion formats Standby (wallpaper).
Note: SVGT 1.1 is not
supported in K310 and
K320.
Supported wallpa- GIF, JPEG, GIF, JPEG, GIF, JPEG, If one image file is cor-
per file formats PNG, SVG PNG. SVG PNG, SVG rupt, the whole theme will
be treated as corrupt.
Note: SVGT 1.1 is not
supported in K310 and
K320.
Standby
63 August 2007
Developers guidelines | Sony Ericsson Themes
Desktop
Navigation - Tabs
64 August 2007
Developers guidelines | Sony Ericsson Themes
Popup
More List
Input
Activity menu
65 August 2007
Developers guidelines | Sony Ericsson Themes
1. Background image
3. Inactive tabs
4. Active tab
5. Pressed softkeys
6. Highlight
8. Popup title
Standby
Softkeys
Softkey Left text shadow 20% of Black (000000) Not in XML file
66 August 2007
Developers guidelines | Sony Ericsson Themes
Softkey Right text shadow 20% of Black (000000) Not in XML file
Softkey Left disabled text 50% of Softkey Left Text Not in XML file
Softkey Right disabled text 50% of Softkey Right Text Not in XML file
Softkey Left disabled text shadow 20% of Black (000000) Not in XML file
Softkey Right disabled text shadow 20% of Black (000000) Not in XML file
Desktop
Desktop title text shadow 20% of Black (000000) Not in XML file
General
Popup
Popup title text shadow 20% of Black (000000) Not in XML file
Popup highlight disabled text 50% of Popup highlight text Not in XML file
More List
Morelist highlight disabled text 50% of Morelist highlight text Not in XML file
Tabs
Activity menu
Homescreen tab text shadow 20% of Black (000000) Not in XML file
Homescreen highlight disabled text 50% of Homescreen highlight Not in XML file
text
67 August 2007
Developers guidelines | Sony Ericsson Themes
Notes
Sounds
In the Themes Creator a ringtone and Message alert signal can be imported into the theme. Select the
Sounds tab to import the audio files you want. However, not all ringtone formats are suited for all phones.
Please refer to the Ringtones Developers Guideline, available for download at www.sonyericsson.com/
developer/multimedia.
68 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 8
Symbian 9/UIQ3 themes
Theme packages for Sony Ericsson UIQ3 phones are standard zip files with the file extension .utz, con-
taining several files. Image and sound files must match the definitions given in a XML file in the theme
package.
69 August 2007
Developers guidelines | Sony Ericsson Themes
• Image and sound files as specified in the XML file. Files included in the package, but not referenced in
the XML file, will be ignored. If the XML file refers to files not present in the .utz package the theme will
not be possible to install.
It is strongly recommended to use the Sony Ericsson Themes Creator for creating theme packages to
avoid errors due to wrong file references or other XML file errors.
• A skin represents one screen layout, for example the application background display. Each skin has
one or more patches and skintext elements.
• Skintext elements define the different text styles that are used in a skin.
• Patches are graphic elements for the controls in a skin. In the themes.xml and in the Themes Creator,
patches are defined by specifying image files to be displayed in the different screen areas of a skin.
Colour schemes
A theme XML file must contain the definition of a colour scheme. The colour scheme settings are applied
on controls for which no image has been specified.
70 August 2007
Developers guidelines | Sony Ericsson Themes
In the Themes Creator, the colour scheme settings are entered as in the picture below.
A colour scheme defines three pairs of background and text colour settings, called “Light”, “Medium”
(“Mid”) and “Dark”. Most patches and skintexts are assigned a default colour scheme setting before the
phone is delivered.
Image files
The image file format used affects the total size of the theme file. In general JPEG files are smaller than
GIF files with the same image size. PNG files always contain full 24-bit colour representation and do not
approximate pixel areas as the JPEG format does, which in some cases leads to large files. The PNG for-
mat allows semi transparency through alpha channels.
A general recommendation is to use GIF files for coloured line art graphics (“cartoon-like images”) and
animations, JPEG or PNG files for photographic pictures. In many cases it is worth the effort to save an
image in different formats and select the smallest file for the theme. PNG must be used for images with
transparent or semi-transparent areas. The recommended and simplest solution is to use PNG files for all
images in the theme.
Animations are supported in the GIF format. The GIF animation format support a 1 bit alpha channel, but
this will not be shown in the phone. If a GIF animation includes transparency, these areas will be filled with
a colour from the phone.
Image drawstyles
If an image is smaller than its associated UI control, it will be applied using one of four methods:
• Normal:
The image is applied to the upper left corner of the control, no stretching or shrinking to match the size
of the control is done (the image should already have the correct size).
• Center:
The image is applied centered in the control area.
• Stretch:
The bitmap will be stretched to match the size of the control (see below).
• Tile:
The bitmap will be tiled across the control.
71 August 2007
Developers guidelines | Sony Ericsson Themes
In Themes Creator, the drawstyle for each image is selected from a dropdown list.
In the case of tiling, the smaller the image is, the more times each piece needs to be tiled, which might
affect drawing performance.
For images that are to be stretched when applied, four margin values (top, left, right and bottom, see
image below) are set in the Themes Creator. When applied, the corner pieces (yellow) are copied as they
are to the corners of the control. The side parts (blue) are stretched across the sides of the control, and
finally, the centre piece is stretched across the centre of the control.
For each skintext element, one of the following text styles can be selected via a dropdown list:
• Normal
• Shadow
• Outline
• ShadowOutline
Depending on which style is selected, colours can be set for shadow, outline or both.
Sounds
Several different file formats are supported for the sounds included in a theme, the most commonly used
are WAV, MP3 and MIDI.
72 August 2007
Developers guidelines | Sony Ericsson Themes
The preview image and text are defined in the Author tab in Themes Creator.
Theme elements
In the table below, all skins with their contained patches and skintext elements, are listed.
Note: Many elements are used for different purposes, noted in the “Comments” column of the table.
Skin
Wallpapers
Screensaver
Homescreen
73 August 2007
Developers guidelines | Sony Ericsson Themes
Skin
Today View Activity Bar 221x27 Light Also used for Standby View Activity
Bar. P990 only
Date Light
Text Light
Time Light
SIM AT Light
Softkeys
Horizontal Backgrounds 240x84 Medium Frames. M600, P1, W950 and W960
only
Control standin
Application background
74 August 2007
Developers guidelines | Sony Ericsson Themes
Skin
Menu Pane
Highlight Pressed 230x27 Medium Also used for building block Highlight
Pressed and Menu Highlight Pressed
Tabs
Title Bar
Back Button 86x24 Dark M600, P1, W950 and W960 only
Dialog
75 August 2007
Developers guidelines | Sony Ericsson Themes
Skin
Clear Title Text Medium Also used for container Popout Title
Text
Title Back Button 40x21 Dark M600, P1 , W950 and W960 only
Horizontal Scrollbar
Vertical Scrollbar
Option Button
Editor
76 August 2007
Developers guidelines | Sony Ericsson Themes
Skin
Info Print
Status Bar
Button
Button Bar
ListBox
Row Highlight 230x27 Dark Also used for building block High-
light, Options Highlight, Menu High-
light and Dialog Highlight
Highlighted Dimmed Text Medium Also used for building block Dimmed
Text, Choice List Highlight Dimmed
Text, Dialog Highlight Dimmed Text,
Menu Pane Highlight Dimmed Text
and Option Button Highlight Dimmed
Text
77 August 2007
Developers guidelines | Sony Ericsson Themes
Skin
Calendar
Arrows 16x14
Date Today
Number Editor
Arrows 28x16
CheckBox
ChoiceList
Color Selector
Label
Progress Bar
78 August 2007
Developers guidelines | Sony Ericsson Themes
Skin
Slider
Time Editor
Preview
79 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 9
Themes version 4.5
This appendix contains theme specifications for the Sony Ericsson K530, K550, K610, K770, K790, K800,
K810, S500, T650, W580, W610, W660, W710, W830, W850, W880, Z250, Z310, Z320, Z610 and Z710
series.
80 August 2007
Developers guidelines | Sony Ericsson Themes
The image file format used affects the total size of the theme file. In general JPEG files are smaller than
GIF files with the same image size. PNG files always contain full 24-bit colour representation and do not
approximate pixel areas as the JPEG format does, which in some cases leads to large files. The PNG for-
mat allows semi transparency through alpha channels.
A general recommendation is to use GIF files for coloured line art graphics (“cartoon-like images”) and
animations, JPEG or PNG files for photographic pictures. In many cases it is worth the effort to save an
image in different formats and select the smallest file. PNG must be used for images with transparent or
semi-transparent areas.
Animations are supported in the GIF format. The GIF animation format support a 1 bit alpha channel, but
this will not be shown in the phone. If a GIF animation includes transparency, these areas will be filled with
a colour from the phone.
SVGT 1.1 content (static or animated) can be used for the Standby element (wallpaper in the Standby
screen), except in the Z310 series.
Themes version 4.5 support dynamic image sizes for a number of elements. Making images smaller than
the layout areas in the table below is always possible, but the look of the theme normally suffers from it.
Some images are allowed to be larger than the designated layout area. For these elements, max values
are given in the table below.
Highlight images can be made a little higher than the area they are supposed to highlight. Thus a Highlight
image may cover part of the text rows above and below the highlighted row. To avoid that a Highlight
image obscures the text above and below, one of the following actions can be taken:
• An image with less height than the maximum allowed can be used.
• For PNG images, an alpha channel can be used to make the upper and lower parts of the image, or the
whole image, transparent.
The table below lists theme elements where images may be used and their corresponding sizes in pixels.
The “Comments” column describes which images are allowed to be animated and which elements sup-
port image transparency.
Phone specifications
81 August 2007
Developers guidelines | Sony Ericsson Themes
Supported image GIF, GIF, GIF, GIF, If one image file is cor-
file formats JPEG, JPEG, JPEG, JPEG, rupt, the whole theme
PNG PNG PNG PNG will be treated as cor-
rupt.
Supported anima- GIF GIF, SVG, GIF, SVG, GIF, SVG, SVG animations only in
tion formats MNG MNG MNG Standby (wallpaper).
MNG only for desktop
highlights and list high-
lights
Supported wallpa- GIF, GIF, GIF, GIF, If one image file is cor-
per file formats JPEG, JPEG, JPEG, JPEG, rupt, the whole theme
PNG PNG, PNG PNG will be treated as cor-
SVGT 1.1 SVGT 1.1 SVGT 1.1 rupt.
Standby
82 August 2007
Developers guidelines | Sony Ericsson Themes
Desktop
Desktop 128x160 176x220 240x320 240x320 Center, Note that the Statusbar
center and Softkeys areas are
parts of the image.
Navigation - Tabs
83 August 2007
Developers guidelines | Sony Ericsson Themes
Popup
More List
Input
Activity menu
Activity Menu Tab 118x37 168x52 212x70 206x68 Center, Transparency (alpha
Max center channel) allowed.
168x57
Menu Tab Unse- 27x17 40x23 54x33 48x33 Center, Transparency (alpha
lected center channel) allowed.
84 August 2007
Developers guidelines | Sony Ericsson Themes
1. Background image
3. Inactive tabs
4. Active tab
5. Pressed softkeys
6. Highlight
8. Popup title
85 August 2007
Developers guidelines | Sony Ericsson Themes
Standby
Softkeys
Softkey Left text shadow 20% of Black (000000) Not in XML file
Softkey Right text shadow 20% of Black (000000) Not in XML file
Softkey Left disabled text 50% of Softkey Left Text Not in XML file
Softkey Right disabled text 50% of Softkey Right Text Not in XML file
Softkey Left disabled text shadow 20% of Black (000000) Not in XML file
Softkey Right disabled text shadow 20% of Black (000000) Not in XML file
Desktop
Desktop title text shadow 20% of Black (000000) Not in XML file
General
Popup
Popup title text shadow 20% of Black (000000) Not in XML file
Popup highlight disabled text 50% of Popup highlight text Not in XML file
More List
Morelist highlight disabled text 50% of Morelist highlight text Not in XML file
86 August 2007
Developers guidelines | Sony Ericsson Themes
Tabs
Activity menu
Homescreen tab text shadow 20% of Black (000000) Not in XML file
Homescreen highlight disabled text 50% of Homescreen highlight Not in XML file
text
Notes
Sounds
In the Themes Creator a ringtone and Message alert signal can be imported into the theme. Select the
Sounds tab to import the audio files you want. However, not all ringtone formats are suited for all phones.
Please refer to the Ringtones Developers Guideline, available for download at www.sonyericsson.com/
developer/multimedia.
Illumination
Note: Not all Sony Ericsson phones have this feature.
Illumination is a coloured, flashing light behind the keypad and on the sides of the phone. The colour of
the light can be set to match the colour of images and other theme elements. To set the colour, select the
Illumination tab and use the colour picker or enter a hexadecimal RGB colour value.
Note: Illumination colour values set in the Themes Creator range from 0 to 255 (0x00 to 0xff) for each col-
our component (R,G and B). However, in the themes XML file, colour component values for illumination
has a narrower range, 0 to 100 (0x00 to 0x64). When a theme created in Themes Creator is saved, illumi-
nation colour component values are transformed using the formula: Colour(XML) = (Colour(TC) * 100 +
127) / 255. Conversely, when a theme file is loaded into Themes Creator, colour component values are
transformed in the other direction, using the formula: Colour(TC) = Colour(XML) * 255 / 100. During these
87 August 2007
Developers guidelines | Sony Ericsson Themes
transformation, decimal values have to be converted into integers, which may lead to slight (normally not
noticeable) illumination colour differences when a theme is saved into a theme file and then reopened in
Themes Creator.
88 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 10
Themes version 4.6
This appendix contains theme specifications for the Sony Ericsson K850, W910 and Z750 series.
89 August 2007
Developers guidelines | Sony Ericsson Themes
The image file format used affects the total size of the theme file. In general JPEG files are smaller than
GIF files with the same image size. PNG files always contain full 24-bit colour representation and do not
approximate pixel areas as the JPEG format does, which in some cases leads to large files. The PNG for-
mat allows semi transparency through alpha channels.
A general recommendation is to use GIF files for coloured line art graphics (“cartoon-like images”) and
animations, JPEG or PNG files for photographic pictures. In many cases it is worth the effort to save an
image in different formats and select the smallest file. PNG must be used for images with transparent or
semi-transparent areas.
Animations are supported in the GIF format. The GIF animation format support a 1 bit alpha channel, but
this will not be shown in the phone. If a GIF animation includes transparency, these areas will be filled with
a colour from the phone.
SVGT content (static or animated) can be used for the Standby element (wallpaper in the Standby screen).
Themes version 4.6 support dynamic image sizes for a number of elements. Making images smaller than
the layout areas in the table below is always possible, but the look of the theme normally suffers from it.
Some images are allowed to be larger than the designated layout area. For these elements, max values
are given in the table below.
Highlight images can be made a little higher than the area they are supposed to highlight. Thus a Highlight
image may cover part of the text rows above and below the highlighted row. To avoid that a Highlight
image obscures the text above and below, one of the following actions can be taken:
• An image with less height than the maximum allowed can be used.
• For PNG images, an alpha channel can be used to make the upper and lower parts of the image, or the
whole image, transparent.
The table below lists theme elements where images may be used and their corresponding sizes in pixels.
The “Comments” column describes which images are allowed to be animated and which elements sup-
port image transparency.
Phone specifications
90 August 2007
Developers guidelines | Sony Ericsson Themes
Supported image file for- GIF, If one image file is corrupt, the
mats JPEG, whole theme will be treated as
PNG corrupt.
Standby
Desktop
91 August 2007
Developers guidelines | Sony Ericsson Themes
Navigation - Tabs
Popup
More List
92 August 2007
Developers guidelines | Sony Ericsson Themes
Input
Activity menu
Activity Menu Tab Unse- 53x33 Center, center Transparency (alpha channel)
lected allowed.
1. Background image
3. Inactive tabs
4. Active tab
5. Pressed softkeys
6. Highlight
8. Popup title
93 August 2007
Developers guidelines | Sony Ericsson Themes
Standby
Softkeys
Softkey Left text shadow 20% of Black (000000) Not in XML file
Softkey Right text shadow 20% of Black (000000) Not in XML file
Softkey Middle text shadow 20% of Black (000000) Not in XML file
Softkey Left disabled text 50% of Softkey Left Text Not in XML file
Softkey Right disabled text 50% of Softkey Right Text Not in XML file
Softkey Middle disabled text 50% of Softkey Middle Text Not in XML file
Softkey Left disabled text shadow 20% of Black (000000) Not in XML file
Softkey Right disabled text shadow 20% of Black (000000) Not in XML file
Softkey Middle disabled text shadow 20% of Black (000000) Not in XML file
Desktop
Desktop title text shadow 20% of Black (000000) Not in XML file
General
94 August 2007
Developers guidelines | Sony Ericsson Themes
Popup
Popup title text shadow 20% of Black (000000) Not in XML file
Popup highlight disabled text 50% of Popup highlight text Not in XML file
More List
Morelist highlight disabled text 50% of Morelist highlight text Not in XML file
Tabs
Activity menu
Homescreen tab text shadow 20% of Black (000000) Not in XML file
Homescreen highlight disabled text 50% of Homescreen highlight Not in XML file
text
Notes
Sounds
In the Themes Creator a ringtone and Message alert signal can be imported into the theme. Select the
Sounds tab to import the audio files you want. However, not all ringtone formats are suited for all phones.
Please refer to the Ringtones Developers Guideline, available for download at www.sonyericsson.com/
developer/multimedia.
95 August 2007
Developers guidelines | Sony Ericsson Themes
Illumination
Note: Not all Sony Ericsson phones have this feature.
Illumination is a coloured, flashing light behind the keypad and on the sides of the phone. The colour of
the light can be set to match the colour of images and other theme elements. To set the colour, select the
Illumination tab and use the colour picker or enter a hexadecimal RGB colour value.
Note: Illumination colour values set in the Themes Creator range from 0 to 255 (0x00 to 0xff) for each col-
our component (R,G and B). However, in the themes XML file, colour component values for illumination
has a narrower range, 0 to 100 (0x00 to 0x64). When a theme created in Themes Creator is saved, illumi-
nation colour component values are transformed using the formula: Colour(XML) = (Colour(TC) * 100 +
127) / 255. Conversely, when a theme file is loaded into Themes Creator, colour component values are
transformed in the other direction using the formula: Colour(TC) = Colour(XML) * 255 / 100. During these
transformations, decimal values have to be converted into integers, which may lead to slight (normally not
noticeable) illumination colour differences when a theme is saved into a theme file and then reopened in
Themes Creator.
96 August 2007
Developers guidelines | Sony Ericsson Themes
Appendix 11
Themes version LF1.0
This appendix contains theme specifications for the Sony Ericsson T250 series.
97 August 2007
Developers guidelines | Sony Ericsson Themes
A general recommendation is to use GIF files for coloured line art graphics (“cartoon-like images”) and
animations, JPEG or PNG files for photographic pictures. In many cases it is worth the effort to save an
image in different formats and select the smallest file.
Note: In the T250, alpha channel transparency is not supported. Transparent areas in images are ren-
dered black.
Animations are supported in the GIF format. A maximum of 10 frames is allowed for GIF animations for
T250 themes. The GIF animation format support a 1 bit alpha channel, but this will not be shown in the
phone. If a GIF animation includes transparency, these areas will be filled with black.
• All images in themes version LF1.0 must have the size as specified in the table below. Themes Creator
does not allow importing of images that are not correctly sized.
• One image file cannot be used for more than one image element.
Themes Creator does not allow image files of the wrong size to be imported for an element. Furthermore,
one specific image file cannot be imported into more than one image element of the theme. If not all
images are set when saving a theme, Themes Creator displays a warning, but saves the theme so that the
user may continue to work with it at another time.
The table below lists theme elements where images may be used and their corresponding sizes in pixels.
Phone specifications
Supported image file for- GIF, If one image file is corrupt, the whole
mats JPEG, theme will be treated as corrupt.
PNG,
BMP
Standby
98 August 2007
Developers guidelines | Sony Ericsson Themes
Desktop
Navigation
Popup
Popup 122x98
1. Background image
3. Highlight image
4. Popup image
99 August 2007