ZLauncher Theme Specification
 v 0.30

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 into 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 extraction 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.
    Constructor requires version 3.1.0.0 of ASINTPPC.DLL, which is shipped with the Metrowerks CodeWarrior for Palm OS R-series environments. If you want to use Constructor with a Pro-series version of CodeWarrior, you need to copy ASINTPPC.DLL and SHW32.DLL (version 4.0.0.0) into the same directory as the "Constructor for Palm OS.EXE" file.
  6. A great ZLauncher Theme Maker by Festus440 is currently available at his homepage. Very easy to use and nice. You download the latest version at his home page:
    http://festus440.happypalm.com

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 consists of 31 characters and a terminal character - NULL(zero).

Or you can install the theme to the handheld first, then change the database name with some 3rd-party 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:

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:

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 No longer available. Removed since ZLauncher v3.60.
1600 16 X 13 No longer available. Removed since ZLauncher v3.60.
5000 160 X 12 Bottom bar background. HiRes and High-Density should be double dimension. For landscape mode(480 X 320), should be 480 X 24. Does not support tranparent at the moment.
5001 160 X 16 Title bar background. HiRes and High-Density should be double dimension. For landscape mode(480 X 320), should be 480 X 32. Does not support tranparent at the moment.
5010 160 x 33 Pop up panel background. HiRes and High-Density should be double dimension. For landscape mode(480 X 320), should be 480 X 66. Does not support tranparent at the moment.
5050 ~ 5057 Recommended Size: 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 Recommended Size: 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 Recommended Size: 8 x 8 ROM tag If necessary, the dimension can be up to 16 X 16.
5082 Recommended Size: 8 x 8 Short Cut If necessary, the dimension can be up to 16 X 16.
5083 Recommended Size: 8 x 8 Tag for the application which is stored in the /Palm/Launcher/ directory of the first expansion card. If necessary, the dimension can be up to 16 X 16.
5084 Recommended Size: 8 x 8 Tag for the application which is stored in the /Palm/Launcher/ directory of the second expansion card. 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 Recommended Size: 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 Recommended Size: 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 Recommended Size: 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 Recommended Size: 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 Recommended Size: 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 Recommended Size: 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 Recommended Size: 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 when tab titles on top or bottom. HiRes and High-Density should be double dimension.
5202, 5203 10 x 14 Activate next tab button when tab titles on top or bottom. HiRes and High-Density should be double dimension.
5204, 5205 10 x 14 Activate tab list button when tab titles on top or bottom. HiRes and High-Density should be double dimension.
5210, 5211 12 x 8 Activate previous tab button when tab titles on left or right. HiRes and High-Density should be double dimension.
5212, 5213 12 x 8 Activate next tab button when tab titles on left or right. HiRes and High-Density should be double dimension.
5214, 5215 10 x 16 Activate tab list button when tab titles on left or right. HiRes and High-Density should be double dimension.
5250 160 x 2 Left separator of the tab titles when the tabs are set on Top or Bottom. HiRes and High-Density should be double dimension. For landscape mode(480 X 320), should be 480 X 4.
5251 160 x 2 Right separator of the tab titles when the tabs are set on Top or Bottom. HiRes and High-Density should be double dimension. For landscape mode(480 X 320), should be 480 X 4.
5252 2 x 160 Top separator of the tab titles when the tabs are set on Left or Right. HiRes and High-Density should be double dimension. For Hires+ mode(320 X 480), should be 4 X 480.
5253 2 x 160 Bottom separator of the tab titles when the tabs are set on Left or Right. HiRes and High-Density should be double dimension. For Hires+ mode(320 X 480), should be 4 X 480.
5301 Recommended Size: 4 x 12 Left part of the unactive tab title when the tab title is on top. If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.Note: if you want the tab title transparent, you must set the Transparent flag of this bitmap to ON.
5302 Recommended Size: 4 x 12 Right part of the unactive tab title when the tab title is on top. If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
5303 Recommended Size: 4 x 12 Body of the unactive tab title when the tab title is on top. If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
5320 Recommended Size: 4 x 16 Left part of the active tab title when the tab title is on top.. If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.Note: if you want the tab title transparent, you must set the Transparent flag of this bitmap to ON.
5321 Recommended Size: 4 x 16 Right part of the active tab title when the tab title is on top.. If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.
5322 Recommended Size: 8 x 16 Body of the active tab title when the tab title is on top. If necessary, the dimension can be up to 16 X 16. HiRes and High-Density should be double dimension.
5341 Recommended Size: 4 x 12 Left part of the unactive tab title when the tab title is on bottom. If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.Note: if you want the tab title transparent, you must set the Transparent flag of this bitmap to ON.
5342 Recommended Size: 4 x 12 Right part of the unactive tab title when the tab title is on bottom. If necessary, the dimension can be up to 8 X 12 HiRes and High-Density should be double dimension.
5343 Recommended Size: 4 x 12 Body of the unactive tab title when the tab title is on bottom. If necessary, the dimension can be up to 8 X 12. HiRes and High-Density should be double dimension.
5361 Recommended Size: 4 x 16 Left part of the active tab title when the tab title is on bottom. If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.Note: if you want the tab title transparent, you must set the Transparent flag of this bitmap to ON.
5362 Recommended Size: 4 x 16 Right part of the active tab title when the tab title is on bottom. If necessary, the dimension can be up to 8 X 16. HiRes and High-Density should be double dimension.
5363 Recommended Size: 8 x 16 Body of the active tab title when the tab title is on left. If necessary, the dimension can be up to 16 X 16. HiRes and High-Density should be double dimension.
5370 Recommended Size: 4 x 15 Left part of the unactive tab title when the tab title is on left. If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.Note: if you want the tab title transparent, you must set the Transparent flag of this bitmap on.
5371 Recommended Size: 4 x 15 Right part of the unactive tab title when the tab title is on left. If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
5372 Recommended Size: 4 x 15 Body of the unactive tab title when the tab title is on left. If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
5375 Recommended Size: 6 x 19 Left part of the active tab title when the tab title is on left.. If necessary, the dimension can be up to 12 X 19. HiRes and High-Density should be double dimension.Note: if you want the tab title transparent, you must set the Transparent flag of this bitmap on.
5376 Recommended Size: 6 x 19 Right part of the active tab title when the tab title is on left. If necessary, the dimension can be up to 12 X 19. HiRes and High-Density should be double dimension.
5377 Recommended Size: 8 x 19 Body of the active tab title when the tab title is on left. If necessary, the dimension can be up to 16 X 19. HiRes and High-Density should be double dimension.
5380 Recommended Size: 4 x 15 Left part of the unactive tab title when the tab title is on right. If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
5381 Recommended Size: 4 x 15 Right part of the unactive tab title when the tab title is on right. If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
5382 Recommended Size: 4 x 15 Body of the unactive tab title when the tab title is on right. If necessary, the dimension can be up to 8 X 15. HiRes and High-Density should be double dimension.
5385 Recommended Size: 6 x 19 Left part of the active tab title when the tab title is on right. If necessary, the dimension can be up to 12 X 19. HiRes and High-Density should be double dimension. Note: if you want the tab title transparent, you must set the Transparent flag of this bitmap on.
5386 Recommended Size: 6 x 19 Right part of the active tab title when the tab title is on right. If necessary, the dimension can be up to 12 X 19. HiRes and High-Density should be double dimension.
5387 Recommended Size: 8 x 19 Body of the active tab title when the tab title is on right. If necessary, the dimension can be up to 16 X 19. 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. For landscape mode(480 X 320), should be 480 X 26. 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. HiRes and High-Density should be double dimension.
5550, 5551, 5552, 5553 12 X 12 Prepare for future use. HiRes and High-Density should be double dimension.
5570, 5571, 5572, 5573 12 X 12 Prepare for future use. HiRes and High-Density should be double dimension.
5580 Recommended Size: 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.Note: if you want the button transparent, you must set the Transparent flag of this bitmap to ON.
5581 Recommended Size: 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 Recommended Size: 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.Note: if you want the button transparent, you must set the Transparent flag of this bitmap to ON.
5591 Recommended Size: 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 Perform HotSync operation directly. 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.
5756, 5757 12 X 12 Beam button. HiRes and High-Density should be double dimension.
5758, 5759 12 X 12 Send button. HiRes and High-Density should be double dimension.
5760, 5761 12 X 12 Open Theme Manager button. HiRes and High-Density should be double dimension.
5762, 5763 12 X 12 Open File Manager button. HiRes and High-Density should be double dimension.
5764, 5765 12 X 12 Popup All Function Button Panel button. HiRes and High-Density should be double dimension.
5850, 5851 12 X 12 No longer available. Removed since ZLauncher v3.60.
5800, 5801 12 X 12 Power Off button. HiRes and High-Density should be double dimension.
6000, 6001, 6002, 6003 12 X 12 Toggle Top bar 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 No longer available. Removed since ZLauncher v3.60.
6102, 6103 8 X 8 No longer available. Removed since ZLauncher v3.60.
7000 10 X 10 Handheld 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.30 - Sep 2, 2003

0.20 - Mar 28, 2003

0.13 - Feb 13, 2003

0.12 - Jan 6, 2003

0.11 Beta - Dec 23, 2002

0.1 Beta - Dec 20, 2002

Top

 

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