How to create theme for A780/E680i on Windows (2)

[eakrin]

Chapter 2 : Theme configulation files (*.dhm)

Requirement
1. Text editor like wordpad.
2. Knowledge about Linux or Unix file system.
3. Knowledge about RGB color system.

After we extract mtf file let see the first theme component to edit. Theme configulation file is a normal text file that contain theme color palette and theme file path. Use text editor like wordpad to edit it. Theme config files use .dhm extension and located at

/ezxlocal/download/appwrite/setup and
/ezxlocal/download/theme

This is A780_01.dhm file from a brand new A780 phone.

[THEME_CONFIG_TABLE]
ThemeColorPaletteIndex = 1
ThemeGeneralAlertFile = /usr/language/ringtone/Notification_4.mid
ThemeIconDir = /usr/language/theme/default1/
ThemeLogoIcon = /usr/language/theme/default1/A780_01.jpg
ThemeMsgAlertFile = /usr/language/ringtone/Polyphonic_Alert_5.mid
ThemeName = Maldives Blue
ThemePowerDownImage = /usr/language/animation/Moto2.gif
ThemePowerUpImage = /usr/language/animation/Moto1.gif
ThemeSkinFile = /usr/language/theme/default1/A780_01.skn
ThemeSoundFileLine1 = /usr/language/ringtone/Glacier.mid
ThemeSoundFileLine2 = /usr/language/ringtone/Acoustica.mid
ThemeTextSize = 0
ThemeWallpaperFile = /diska/MyImages/Cheer-Heartbeat.PNG

[THEME_COLOR_PALETTE_TABLE]
ThemeBackground = 243 240 230
ThemeBase = 243 240 230
ThemeBrightText = 0 0 0
ThemeButton = 143 169 181
ThemeButtonText = 0 0 0
ThemeForeground = 0 0 0
ThemeHighlight = 183 198 240
ThemeHighlightedText = 0 0 128
ThemeText = 0 0 0

[THEME_MULTI_LANG_NAME]
en-us = Maldives Blue
zh-cn = ้ฉฌๅฐ”ไปฃๅคซๅ…ฐ
zh-hk = ้ฆฌ็ˆพไปฃๅคซ่—

Theme configulation file contain 3 sections Config table, Color palette table, and Multi lang name

1. [THEME_CONFIG_TABLE] this section is use for define files and folders of theme components.

* ThemeName = Maldives Blue * Theme name is name of theme in english and can have space inside name.

* ThemeIconDir = /usr/language/theme/default1/ * ThemeIconDir is name of folder that contain iconres.ezx file.

* ThemeSkinFile = /usr/language/theme/default1/A780_01.skn * ThemeSkinFile is filename with folder path of skin file.

* ThemeLogoIcon = /usr/language/theme/default1/A780_01.jpg * ThemeLogoIcon is 320x240 Image filename and folder path that use in Setting -> Color scheme.

* ThemePowerDownImage = /usr/language/animation/Moto2.gif and ThemePowerUpImage = /usr/language/animation/Moto1.gif * ThemePowerDownImage and ThemePowerUpImage is 320x240 GIF Animate file that display when the phone is open and close.

* ThemeColorPaletteIndex = 1 * I don't know how to use ColorpaletteIndex but 3 default color palettes was
define in /usr/language/theme/colorpalette.cfg . so I set ThemeColorPaletteIndex to 0.

* ThemeWallpaperFile * Theme Wallpaperfile is use to define wallpaper. On A780/E680i wallpaper cannot be change by theme. Wallpaper can be change in Setting -> Wallpaper.

* ThemeGeneralAlertFile, ThemeMsgAlertFile,ThemeSoundFileLine1, ThemeSoundFileLine2 * all of this is use to define ringtone file of theme.

2. [THEME_COLOR_PALETTE_TABLE] this section is use for define colors of display component that doesn't use image such as font, highlight, background, etc. Color can be define in RGB system (Red Green Blue, start from 0 to 255 in each color).




* ThemeBackground * is color of display background and window background.
* ThemeForeground * is color of normal font.
* ThemeButton * is found only at title bar above some J2ME MIDlet.
* ThemeButtontext * is color of font on button, menubar, and statusbar.
* ThemeHighlight * is color of highlight.
* ThemeHighlightedText * is color of font when highlighted.

* ThemeBase ,ThemeText, ThemeBrightText * was not found where they was used. Please tell me if you found where is it.

3. [THEME_MULTI_LANG_NAME] this section is not nessesary. It's use for define theme name in another language.

PS. To define folder of theme components you should careful for
1. How to delete your theme? Theme_Uninstaller.lin can delete file in
/ezxlocal/download/appwrite/setup/Themename.dhm และ
/ezxlocal/download/theme/Themename.dhm และ
/ezxlocal/download/theme/icon/Themename.dhm/* (all file in this folder)
and now Theme Manager 1.6 can delete all file in ThemeIconDir.

2. Does your theme can use in USB storage mode? when you plug your usb cable in usb storage mode Phone memory (diska) and MMC memory (/mmc/mmca1) will changed to USB Flash drive and cann't be access by phone. Then if some part of your theme was on Phone memory or MMC memory It can't be access by phone. And phone will be hang because it cannot access those files.

3. Is there have an available space for Install theme file? To avoid phone hang when plug cable in storage we should install theme file in to ezxlocal memory. Because ezxlocal memory was not changed into USB flashdrive but ezxlocal size is only 5MB and have available size about 2-3MB upon your amount of contact, sms,mms, and email. If ezxlocal is nearly full phone will alert "Memory full" and then phone cannot run any application.

From the 3 cautions we should use folder of theme component like this for ezxlocal installed theme

/ezxlocal/download/appwrite/setup/ for Themename.dhm
/ezxlocal/download/theme/ for Themename.dhm
/ezxlocal/download/theme/icon/ for iconres.ezx
/ezxlocal/download/theme/icon/ for skin file (*.skn)

and to decrease space used in ezxlocal we move the rest of file in theme to diska like

/diska/MyImages/Themes/Themename.dhm/

Because PowerOn/Off Animate and ThemeLogoIcon Image will never used when phone in USB storage mode.

After edit Theme configulation file. the next chapter we 'll edit icon and skin.

[intoxicated]

to be honest i don't know why put .dhm file
in /ezxlocal/download/theme folder...
it works alright with it in ezxlocal folder only
...

[eakrin]

yep, I don't know too. only dhm file in appwrite/setup will work. Just follow the old theme.