ZLauncher Theme Specification | v 0.13

Index

1. Tools
2. Changing Theme Name
3. Theme Comments
4. Default BackImage & IconSet
5. Color Table
6. Bitmaps
7. Release History

Note:

> When you select a theme/icon set which is stored on expansion card with the Theme Manager in ZLauncher, ZLauncher will copy it to RAM, and add a flag to the selected item, and the item will be deleted automatically when it's no longer being used. So you can not create your theme/iconset basing on the ones selected from the Theme Manager, or they will be deleted once ZLauncher starts.

Tools

If you want to create your own ZLauncher theme, you should obtain the following tools before starting making themes:

1. Graphics edit tools such as Photoshop, Paint Shop Pro, etc.
2. PRCExplorer, a PRC viewer/resource extract tool, by Regis Nicolas. It's available for download it at PalmGear:
   http://www.palmgear.com/software/showsoftware.cfm?sid=33466820021220020035&prodID=40542.
   It's a freeware.
3. PilRC, a Palm resource compiler, by Wes Cherry & Aaron Ardiri. It's available for download it at www.ardiri.com:
   http://www.ardiri.com/index.php?redir=palm&cat=pilrc&PHPSESSID=0b95156b6f182d7a703d41352ad84e9e
   It's a freeware.
4. Constructor, the resource editor of CodeWarrior. The demo version of CodeWarrior 8 for PalmOS is available for download at Metrowerks:
   http://www.metrowerks.com/MW/Secure/Eval/Palm/default.htm. The demo version is OK for editing the existent themes.
5. If you want to edit the High-Density bitmaps, the version of Constructor must be v1.8 or higher. Constructor v1.8 can be found in the PalmOS5 SDK. PalmOS5 SDK is available for download at PalmSource:
   http://www.palmos.com/cgi-bin/sdk50.cgi. It's free for download.

Top

Changing Theme Name

If you want to change the theme name on desktop computer, you need an HEX editor software(such as UltraEdit) to edit the database name. The database name is the first 31 bytes of the theme file, and the name is terminated with a null character(zero).

Or you can install the theme to the handheld first, then change the database name with some file manage applications.

Top

Theme Comments

String Resource with ID 9100 is used to store the theme comments from the theme creator.

Top

Default BackImage & IconSet

String Resource with ID 9200 is used to specify the default background image and String Resource with ID 9210 is used to specify the default IconSet.

Top

Color Table

ZLauncher contains a color table that allows the theme creator to specify the default colors of UI.

The resource type of the default color table is 'cTbl', its resource ID is 1000. Each content of the color table contains 8 bytes, it describes one UI color for all color depths:

- Byte 1: The color index for 1-bit color depth
- Byte 2: The color index for 2-bit color depth
- Byte 3: The color index for 4-bit color depth
- Byte 4: The color index for 8-bit color depth
- Byte 5: The color index for 16-bit color depth
- Byte 6: Red value in RGB form
- Byte 7: Green value in RGB form

- Byte 8: Blue value in RGB form

The color table contains 21 colors. The first 10 colors in the color table are used for ZLauncher, they should not be changed by the theme creator. The rest 11 colors can be changed to match the theme. They are described bellow:

- Color 11: unactive tab title text color.
- Color 12: active tab title text color
- Color 13: icon text color
- Color 14: icon text shadow color
- Color 15: tab back color
- Color 16: underline color
- Color 17: Time Button text color
- Color 18: Battery Button text color
- Color 19: Memory Button text color
- Color 20: Category Button text color
- Color 21: Path Button text color

For exmaple:

X, X, X, X, X, X, X, X; // Color 1
X, X, X, X, X, X, X, X; // Color 2
...
X, X, X, X, X, X, X, X; // Color 10
1, 2, 6 , 221, 221, 170, 170, 170;// unactive tab title text color.
1, 3, 12, 125, 125, 255, 0, 0; // active tab title text color
1, 3, 15, 226, 226, 128, 0, 0; // icon text color
0, 0, 0 , 0, 0, 255, 255, 255; // icon text shadow color
0, 1, 2, 12, 12, 255, 255, 153; // tab back color
1, 2, 7 , 96, 96, 0, 255, 204; // underline color
0, 0, 0, 0, 0, 255, 255, 255; // Time Button text color
0, 0, 0, 0, 0, 255, 255, 255; // Battery Button text color
0, 0, 0, 0, 0, 255, 255, 255; // Memory Button text color
1, 3, 15, 226, 226, 128, 0, 0; // Category Button text color
0, 1, 3 , 12 , 12, 255, 255, 153; // Path Button text color

Top

Bitmaps

Picture | Resource ID | Dimension | Function | Comment
| 1500 | 24 X 22 | The logo displayed in the About form. | For different color depths and densities
| 1600 | 16 X 13 | Prepared for future updates. | For different color depths and densities
| 5000 | 160 X 12 | Bottom bar background. | HiRes and High-Density should be double dimension. Does not support tranparent at the moment.
| 5001 | 160 X 16 | Title bar background. | HiRes and High-Density should be double dimension. Does not support tranparent at the moment.
| 5010 | 160 x 33 | Pop up panel background. | HiRes and High-Density should be double dimension. Does not support tranparent at the moment.
| 5050 ~ 5057 | Recommded: 16 X 16 | Waiting animation pictures. | If necessary, the dimension can be up to 24 X 24. HiRes and High-Density should be double dimension.
| 5070 | Recommded: 100 x 40 | Waiting logo. | If necessary, the dimension can be up to 140 X 60. HiRes and High-Density should be double dimension.
| 5081 | Recommded: 8 x 8 | ROM tag | If necessary, the dimension can be up to 16 X 16.
| 5082 | Recommded: 8 x 8 | Short Cut | If necessary, the dimension can be up to 16 X 16.
| 5083 | Recommded: 8 x 8 | Tag of the application which stored in the /Palm/Launcher/ directory | If necessary, the dimension can be up to 16 X 16.
| 5090 | 15 x 11 | Unhighlighted directory in the Path Tree | HiRes and High-Density should be double dimension.
| 5091 | 15 x 11 | Highlighted directory in the Path Tree | HiRes and High-Density should be double dimension.
| 5095 | 10 x 10 | Contract tag in the Path Tree | HiRes and High-Density should be double dimension.
| 5096 | 10 x 10 | Expend tag in the Path Tree | HiRes and High-Density should be double dimension.
| 5100, 5101 | 8 x 8 | Scroll up button of scroll bar. | HiRes and High-Density should be double dimension.
| 5102, 5103 | 8 x 8 | Scroll down button of the scroll bar. | HiRes and High-Density should be double dimension.
| 5120 | Recommded: 8 x 6 | Top part of the Track button of the scroll bar. | If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
| 5121 | Recommded: 8 x 6 | Bottom part of the Track button of the scroll bar. | If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
| 5122 | Recommded: 8 x 8 | Body of the Track button of the scroll bar. | If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.
| 5123 | Recommded: 8 x 6 | Center tag of the Track button of the scroll bar. | If necessary, the dimension can be up to 8 X 8 HiRes and High-Density should be double dimension.
| 5140 | Recommded: 8 x 4 | Top part of the Track bar of the scroll bar. | If necessary, the dimension can be up to 8 X 8. HiRes and High-Density should be double dimension.
| 5141 | Recommded: 8 x 4 | Bottom part of the Track bar of the scroll bar. | If necessary, the dimension can be up to 8 X 8. HiRes and High-Density should be double dimension.
| 5142 | Recommded: 8 x 8 | Body of the Track bar of the scroll bar. | If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.
| 5200, 5201 | 10 x 14 | Activate previous tab button. | HiRes and High-Density should be double dimension.
| 5202, 5203 | 10 x 14 | Activate next tab button. | HiRes and High-Density should be double dimension.
| 5204, 5205 | 10 x 14 | Activate tab list button. | HiRes and High-Density should be double dimension.
| 5210, 5211 | 14 x 8 | Prepared for future updates. | HiRes and High-Density should be double dimension.
| 5212, 5213 | 14 x 8 | Prepared for future updates. | HiRes and High-Density should be double dimension.
| 5214, 5215 | 10 x 16 | Prepared for future updates. | HiRes and High-Density should be double dimension.
| 5250 | 160 x 2 | Left separator of the tab titles. | HiRes and High-Density should be double dimension.
| 5251 | 160 x 2 | Right separator of the tab titles. | HiRes and High-Density should be double dimension.
| 5252 | 2 x 160 | Prepared for future updates. | HiRes should be 4 X 480, High-Density should be 4 X 320.
| 5253 | 2 x 160 | Prepared for future updates. | HiRes should be 4 X 480, High-Density should be 4 X 320.
| 5301 | Recommded: 4 x 12 | Left part of the unactive tab title. | If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
| 5302 | Recommded: 4 x 12 | Right part of the unactive tab title. | If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
| 5303 | Recommded: 4 x 12 | Body of the unactive tab title. | If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
| 5320 | Recommded: 4 x 16 | Left part of the active tab title. | If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.
| 5321 | Recommded: 4 x 16 | Right part of the active tab title. | If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.
| 5322 | Recommded: 8 x 16 | Body of the active tab title. | If necessary, the dimension can be up to 16 X 16. HiRes and High-Density should be double dimension.
| 5341 | Recommded: 4 x 12 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
| 5342 | Recommded: 4 x 12 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 12 HiRes and High-Density should be double dimension.
| 5343 | Recommded: 4 x 12 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
| 5361 | Recommded: 4 x 16 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.
| 5362 | Recommded: 4 x 16 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.
| 5363 | Recommded: 8 x 16 | Prepared for future updates. | If necessary, the dimension can be up to 16 X 16. HiRes and High-Density should be double dimension.
| 5370 | Recommded: 4 x 15 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
| 5371 | Recommded: 4 x 15 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
| 5372 | Recommded: 4 x 15 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
| 5375 | Recommded: 6 x 17 | Prepared for future updates. | If necessary, the dimension can be up to 12 X 17. HiRes and High-Density should be double dimension.
| 5376 | Recommded: 6 x 17 | Prepared for future updates. | If necessary, the dimension can be up to 12 X 17. HiRes and High-Density should be double dimension.
| 5377 | Recommded: 8 x 17 | Prepared for future updates. | If necessary, the dimension can be up to 16 X 17. HiRes and High-Density should be double dimension.
| 5380 | Recommded: 4 x 15 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
| 5381 | Recommded: 4 x 15 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
| 5382 | Recommded: 4 x 15 | Prepared for future updates. | If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
| 5385 | Recommded: 6 x 17 | Prepared for future updates. | If necessary, the dimension can be up to 12 X 17. HiRes and High-Density should be double dimension.
| 5386 | Recommded: 6 x 17 | Prepared for future updates. | If necessary, the dimension can be up to 12 X 17. HiRes and High-Density should be double dimension.
| 5387 | Recommded: 8 x 17 | Prepared for future updates. | If necessary, the dimension can be up to 16 X 17. HiRes and High-Density should be double dimension.
| 5400, 5401 | 24 x 24 | Category button. | HiRes and High-Density should be double dimension.
| 5402, 5403 | 24 x 24 | New Tab button. | HiRes and High-Density should be double dimension.
| 5404, 5405 | 24 x 24 | Beam button. | HiRes and High-Density should be double dimension.
| 5406, 5407 | 24 x 24 | Information button. | HiRes and High-Density should be double dimension.
| 5408, 5409 | 24 x 24 | Empty Trash Bin button. | HiRes and High-Density should be double dimension.
| 5410, 5411 | 24 x 24 | Trash Bin button. | HiRes and High-Density should be double dimension.
| 5430, 5431 | 16 x 16 | Create ShortCut/BackImage button. | HiRes and High-Density should be double dimension.
| 5432, 5433 | 16 x 16 | Create directory button. | HiRes and High-Density should be double dimension.
| 5434, 5435 | 16 x 16 | Copy button. | HiRes and High-Density should be double dimension.
| 5436, 5437 | 16 x 16 | Move button. | HiRes and High-Density should be double dimension.
| 5438, 5439 | 16 x 16 | Beam File button. | HiRes and High-Density should be double dimension.
| 5440, 5441 | 16 x 16 | File Information button. | HiRes and High-Density should be double dimension.
| 5442, 5443 | 16 x 16 | File Delete button. | HiRes and High-Density should be double dimension.
| 5444, 5445 | 160 x 13 | Path button. | HiRes and High-Density should be double dimension. Does not support tranparent at the moment.
| 5460, 5461 | 24 x 24 | ZLauncher Preferences button. | HiRes and High-Density should be double dimension.
| 5462, 5463 | 24 x 24 | Display Setup button. | HiRes and High-Density should be double dimension.
| 5464, 5465 | 24 x 24 | Color Setup button. | HiRes and High-Density should be double dimension.
| 5466, 5467 | 24 x 24 | Dialog Setup button. | HiRes and High-Density should be double dimension.
| 5500, 5501 | 30 X 12 | DateTime button background. | HiRes and High-Density should be double dimension. Does not support tranparent at the moment.
| 5520, 5521, 5522, 5523 | 12 X 12 | Toggle Tools panel button. | HiRes and High-Density should be double dimension.
| 5530, 5531, 5532, 5533 | 12 X 12 | Toggle Control panel button. | HiRes and High-Density should be double dimension.
| 5540, 5541, 5542, 5543 | 12 X 12 | Toggle Fullscreen button. | Only available for HiRes themes. HiRes should be double dimension.
| 5580 | Recommded: 6 X 12 | Left part of the released state of button. | If necessary, the dimension can be up to 12 X 12. HiRes and High-Density should be double dimension.
| 5581 | Recommded: 6 X 12 | Right part ofthe released state of button. | If necessary, the dimension can be up to 12 X 12 HiRes and High-Density should be double dimension.
| 5582 | 12X 12 | Body of the released state of button. | HiRes and High-Density should be double dimension.
| 5590 | Recommded: 6 X 12 | Left part of the pressed state of button. | If necessary, the dimension can be up to 12 X 12. HiRes and High-Density should be double dimension.
| 5591 | Recommded: 6 X 12 | Right part ofthe pressed state of button. | If necessary, the dimension can be up to 12 X 12. HiRes and High-Density should be double dimension.
| 5592 | 12X 12 | Body of the pressed state of button. | HiRes and High-Density should be double dimension.
... | 5600 ~ 5609 | 24 X 12 | Memory status button. | HiRes and High-Density should be double dimension.
..., | 5650 ~ 5659, 5670 | 24 X 12 | Battery status button. | HiRes and High-Density should be double dimension.
| 5700, 5701 | 12 X 12 | Activate next tab button. | HiRes and High-Density should be double dimension.
| 5702, 5703 | 12 X 12 | Pop up menu button. | HiRes and High-Density should be double dimension.
| 5704, 5705 | 12 X 12 | Pop up Find dialog button. | HiRes and High-Density should be double dimension.
| 5706, 5707 | 12 X 12 | Pop up Brightness dialog button. | HiRes and High-Density should be double dimension.
| 5708, 5709 | 12 X 12 | Quick Launch + button. | HiRes and High-Density should be double dimension.
| 5710, 5711 | 12 X 12 | Toggle Icon Views button. | HiRes and High-Density should be double dimension.
| 5712, 5713 | 12 X 12 | Launch Silk-Calc application button. | HiRes and High-Density should be double dimension.
| 5714, 5715 | 12 X 12 | Launch Security application button. | HiRes and High-Density should be double dimension.
| 5716, 5717 | 12 X 12 | Launch Prefs application button. | HiRes and High-Density should be double dimension.
| 5718, 5719 | 12 X 12 | Lock button. | HiRes and High-Density should be double dimension.
| 5720, 5721 | 12 X 12 | Category button on bottom bar. | HiRes and High-Density should be double dimension.
| 5722, 5723 | 12 X 12 | New Tab button on bottom bar. | HiRes and High-Density should be double dimension.
| 5724, 5725 | 12 X 12 | ZLauncher Prefs button on bottom bar. | HiRes and High-Density should be double dimension.
| 5726, 5727 | 12 X 12 | Information button on bottom bar. | HiRes and High-Density should be double dimension.
| 5728, 5729 | 12 X 12 | Trash Bin button on bottom bar. | HiRes and High-Density should be double dimension.
| 5730, 5731 | 12 X 12 | Launch HotSync application button. | HiRes and High-Density should be double dimension.
| 5732, 5733 | 12 X 12 | Beam Tab button. | HiRes and High-Density should be double dimension.
| 5734, 5735 | 12 X 12 | Delete Tab button. | HiRes and High-Density should be double dimension.
| 5736, 5737 | 12 X 12 | Tab Properties button. | HiRes and High-Density should be double dimension.
| 5738, 5739 | 12X 12 | Soft Reset button. | HiRes and High-Density should be double dimension.
| 5740, 5741 | 12 X 12 | Pop up Path Tree button. | HiRes and High-Density should be double dimension.
| 5742, 5743 | 12 X 12 | Refresh Apps button. | HiRes and High-Density should be double dimension.
| 5744, 5745 | 12 X 12 | Exit ZLauncher. | HiRes and High-Density should be double dimension.
| 5746, 5747 | 12 X 12 | Toggle the back light state button. | HiRes and High-Density should be double dimension.
| 5748, 5749 | 12 X 12 | Pop up the Contrast dialog button. | HiRes and High-Density should be double dimension.
| 5750, 5751 | 12 X 12 | Pop up Graffiti Preference form button. | HiRes and High-Density should be double dimension.
| 5752, 5753 | 12 X 12 | Open Command Bar button. | HiRes and High-Density should be double dimension.
| 5754, 5755 | 12 X 12 | Show/Hide hidden tab button. | HiRes and High-Density should be double dimension.
| 5800, 5801 | 12 X 12 | Power Off button. | HiRes and High-Density should be double dimension.
| 6010, 6011, 6012, 6013 | 12 X 12 | Toggle Bottom bar button. | HiRes and High-Density should be double dimension.
| 6100, 6101 | 8 X 8 | Prepared for future updates. | HiRes and High-Density should be double dimension.
| 6102, 6103 | 8 X 8 | Prepared for future updates. | HiRes and High-Density should be double dimension.
| 7000 | 10 X 10 | Palm icon | HiRes and High-Density should be double dimension.
| 7001 | 10 X 10 | Specific tab icon. | HiRes and High-Density should be double dimension.
| 7002 | 10 X 10 | Card tab icon. | HiRes and High-Density should be double dimension.
| 7010 ~ 7099 | 10 X 10 | custom tab icons. | You can add any icon to the theme, no exact meaning for every icon. HiRes and High-Density should be double dimension.

Top

Release History

0.13 - Feb 13, 2003

- ADDED: Changing Theme Name section.

0.12 - Jan 6, 2003

- FIXED: Resource ID of Path Button bitmap should be 5444 and 5445.
- FIXED: Resource ID of Battery Button should be 5650~5659,5670.

0.11 Beta - Dec 23, 2002

- First public release.
- Added description of Title button of Detail View.

0.1 Beta - Dec 20, 2002

- First version.

Top

If you have any question or suggestion on ZLauncher, please send to zlauncher@zztechs.com