ZLauncher IconSet
Specification
|
v 0.02 |
Index
- Tools
- Icon Mapping Table
- The Order of Items
- 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 iconset, you should obtain the following
tools before starting making iconsets:
- Graphics editing tools on the desktop computer such as Photoshop, Paint
Shop Pro, etc.
- PRCExplorer, a PRC viewer/resource extract tool, by Regis Nicolas. It's
available for download it at PalmGear:
http://www.palmgear.com/index.cfm?fuseaction=software.showsoftware&prodID=40542.
It's a freeware.
- 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
It's a freeware.
- 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/iconsets.
- 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.
ZL Iconset Factory by Robert Eaton:(Highly
Recommended!)
ZL Iconset Factory allows you to easily change any icon on your
PDA. ZL Iconset Factory isn't an icon editor, rather it's a specialized compiler
that allows you to easily import and assign icons to the programs on your PDA.
Some of ZL Iconset Factory's Features:
- Replace program, Palm system, and ZLauncher icons
- Replace shortcut icons for programs stored on your memory card
- Edit existing iconsets or create new ones
- Create iconsets with only icons you need
- Identifies icons in existing iconsets using it's associated program name
(EX: Palm Date Book, not tAIB3506)
- Automatically searches your Palm Desktop directory and adds the programs
you have installed on your PDA to it's database so they'll be available in
the program
- When importing graphics, automatically chooses the transparent colors, or
change them easily from within the program.
- View the icons using their transparent colors, and with variable background
colors
- Supports drag and drop for both icons and ZL iconsets.
- Supports copy and paste to and from your paint program, or from PalmBMX
(see below)
- Automatically creates low-res icons from the high-res icons.
- Supports saving and loading user templates of your favorite program icons
- Supports 4, 8, and 16-bit icons
- Automatically converts from one color depth to another
- Automatically converts icons to the correct color depth when added
- No programming knowledge required and no manual editing
- Supports all Palm OS compression types and automatically selects the best
compression for each icon so that files are small as possible, with option
to compile for Palm OS 3.5 (no packbits compression)
PalmGear: http://www.palmgear.com/index.cfm?fuseaction=software.showsoftware&prodID=52897
ZLthemes: http://www.zlthemes.com/UtilityDetail.php?PID=24
For more details and more useful tools, visit Robert Eaton's homepage:
http://festus440.happypalm.com/
Top
Icon Mapping Table
ZLauncher contains an icon mapping table that records the corresponding icon
of a certain item.
The resource type of the icon mapping table is 'iTbl', its resource ID is 1000.
Each content of the icon mapping table contains 16 bytes, it describes icon
bitmaps' ID:
- Byte 1 to Byte 4: TypeID of the specific item. For example, if the item
is an application, the four-byte is 1634758764(0x6170706C), the corresponding
bytes are: 0x61('a'), 0x70('p'), 0x70('p'), 0x6C('l').
- Byte 5 to Byte 8: CreatorID of the specific item. For example, if the item
is Address Book, the four-byte is 1634758764(0x61646472), the corresponding
bytes are: 0x61('a'), 0x64('d'), 0x64('d'), 0x72('r').
- Byte 9 to Byte 10: The bitmap resource ID of the large icon. For example,
the resource ID of Adress Book's large icon is 3500(0x0DAC).
- Byte 11 to Byte 12: The bitmap resource ID of the small icon. For example,
the resource ID of Adress Book's small icon is 3501(0x0DAD). If you don't
want to specify the small icon, set it to zero.
- Byte 13 to Byte 16: Reserved for future use, must be zero.
Top
The Order of Items
All icons in the IconSet must follow the order rule of icons:
The item which has a larger TypeID must be followed by the one which has a
smaller TypeID. If the TypeIDs of two items are same, the item which has the
larger CreatorID will be followed by the one which has a smaller CreatorID.
Note, capital letter is less than lower case letter. For example, '0' < '9'
< 'A' < 'Z' < 'a' < 'z'.
For example:
Item |
Type ID |
Creator ID |
Address Book |
appl |
addr |
Clie Demo |
appl |
CLie |
Data Book |
appl |
date |
Owner(panel) |
panl |
ownr |
Sony HiRes(panel) |
panl |
SnHp |
Todo List |
panl |
todo |
The order of the above items is:
Clie Demo < Address Book < Date Book < Todo List < Sony HiRes(panel)
< Owner(panel)
Top
Release History
0.02 - Dec 15, 2003
- Added introduction for ZL Iconset Factory
by Robert Eaton.
- Updated several links.
- Corrected some wrong descriptions.
0.01 - Mar 17, 2003
Top
If you have any question or suggestion on ZLauncher, please email to zlauncher@zztechs.com