Pimlical Android Help

User Icons

Each event can have up to four user-defined icons assigned to it - these icons are displayed ahead of the description line. Pimlical comes with a small, sample icon collection, but you can also import standard JPG or GIF graphics into the icon collection, using the Pimlical/Desktop Icon Management feature. The icon collection in the Pimlical/Desktop can be exported with the EXPORT button and the file IconArchive.dat created in that same folder as the icons is then copied to the Pimlical Folder on the Android device where Pimlical/Android will use it (see more detailed steps below):

Migrating Pimlical/Desktop Icons to Pimlical/Android

Converting a Palm OS icon collection into Pimlical-Android

For those users who previously used a Palm OS handheld and had a custom icon collection (or any Palm icon collection), there is a way to convert the icons into a format where Pimlical can use them. The first step is to convert from Palm OS format into a set of PNG (recommended) or JPG graphics in a single windows folder. See the Pimlical User Manual: http://www.PimlicoSoftware.com/pimlical-manual.pdf, Appendix A, Using DateBk Icons for instructions on how to handle this conversion. The conversion program creates several folders of the icons at different bit densities. Usually the folder marked as 8-bit d144 is the one that you will want to use.

When this has been done, you can then import the icons into Pimlical/Desktop using the Import button in that dialog. The Export button can take the same existing file folder of graphics and create a compatible IconArchive.dat file as shown in the above steps.

Customizing your Icon Collection

You can customize your icon collection using Pimlical/Desktop and then export a matching version for use on Android devices. The first step is to locate the folder that has all the Default Icons installed in Pimlical. That is usually in: C:\Program Files (x86)\PimlicalApp\PimlicalFiles\iconFolder (or C:\Program Files \PimlicalApp\PimlicalFiles\iconFolder on 64-bit versions of  Windows). You may wish to COPY this folder to an unprotected folder in your desktop - that way you can freely modify them, but still have the original collection stored in the PimlicalApp folder.

The second step is to realize that Pimlical/Desktop and Pimlical/Android have to have different versions of the archive due to architectural differences in Java on the two platforms. On the desktop, the icon file is called UserIcons.dat and is located in the Pimlical folder (same folder that your preferences are stored in). On an Android devices, the file is called IconArchive.dat and it is also stored in the Pimlical folder. Both of these files are created from the icon folder and that is a one-way path - i.e. you can not extract icons from UserIcons.dat or IconArchive.dat to re-create the original icon folder.

The third step is to understand that the filenames for the icons are important. Every icon has a unique, numeric index key which is used to access the icon, so you can move icons around, delete them, etc. without causing any problem in referencing the icons. That numeric key is embedded in the filename, so be very careful in constructing your filenames to avoid confusion by using a number as part of the filename!

Wrong Filename: The 24 hour Alarm clock_1145.png

Right Filename: The Twenty-Four hour Alarm Clock_1455.png

In the Wrong case above, the icon will erroneously get the unique ID of '24' - since that's the first number in the filename. So avoid using digits as part of the filename other than to set the uniqueID. If you have no digits in the filename, Pimlical will automatically assign the next sequential icon number, but this is discouraged because if you do a lot of editing, that number might change the next time you export a copy of the collection.

So it's best to start with a unique ID bigger than any existing icon. How can you quickly find the largest icon number used so far? Very simple: go into menu | Icon Management, make sure you are on the last page of icons, tap on the # button so that all uniqueID"s are displayed and tap the SORT button - the last icon displayed is the one with the highest number, so start at that number plus one. After doing that, remember to Cancel out of the dialog so you don't inadvertently end up re-sorting all your icons!

Acceptable file formats are those that Java can handle - JPG, GIF and PNG, with PNG being recommended. There is no specific requirement on the size of the graphic being imported, but for consistency, it's probably a good idea to keep the icons at the recommended size of 56x56 pixels, and to resize large graphics using a graphics program that does a good job of resizing (i.e  by using techniques such as bi-cubic spline interpolation, rather than just arbitrarily dropping out pixel rows and columns from the original image). The free app, Paint.NET is a good choice under windows for this.

You can drag and drop icons around to sort the collection into ways that make sense for you. Keep in mind that if you press the SORT button, all the icons will then be sorted based upon their numeric ID which may or may not be what you want.

To import new graphics, use the ADD button to just add a single graphic, or the IMPORT button to import all the graphics in a particular folder. In the latter case, you will be asked if you want to delete all the existing icons (respond yes if you are building a new collection from the icons in that folder).