README.md
<HTML>

<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="TSE Pro 4.0 32-bit Editor, visit http://www.semware.com">
<title>Colorize 1.1</title>
<style>
td { font-size: 80% }
.red { color: #cc0000 }
.courier { font-family: "courier new", courier, monospace }
</style>
</head>

<BODY TOPMARGIN=0 LEFTMARGIN=10 BGCOLOR="white" LINK="#0000cc" VLINK="#660066" TEXT="#000000">
<FONT FACE="verdana,arial,helvetica,geneva" SIZE=2>



<h1>Colorize 1.1</h1>

by Christopher Antos (<a href="mailto:chrisant@premier1.net?subject=Colorize">chrisant@premier1.net</a>),
Copyright &copy; 2002-2003, All Rights Reserved.<br>



<h2>Colorize is Freeware</h2>

<p>
Colorize lets you choose from several color themes, to give your Palm based device a
facelift. You can also use custom color themes and share them with other users.

<p>
Colorize works on any color Palm&trade; based device including those from Palm,
Handspring, Sony, etc. Colorize works on Palm OS 3.5 through 5.0, and may work on
future Palm OS versions as well. When Palm OS 6.0 or whatever comes out, feel free
to try Colorize on it; it can't hurt anything.

<p>
Visit <a href="http://www.palmgear.com">PalmGear</a> for the latest version of Colorize.



<h2>Uninstalling Colorize</h2>

<p>
The Colorize application is only needed to select a color theme (or import one; see
below). Once the color theme is installed, Colorize can be removed from the handheld
device and the color theme will remain in effect (even after a Reset).

<p>
If you want to uninstall Colorize and go back to the original colors, then you must
first select "Original" as the color theme, and then delete Colorize from the device.



<h2>Choosing a Color Theme</h2>

<p>
<b>Colorize</b> - Use this popup to select one of the built in color themes. This
installs the selected color theme so the Palm OS will automatically use the color
theme for all applications.



<h2>Custom Color Themes</h2>

<p>
<b>Import</b> - This button lets you choose a Memopad record and import a color theme
from it. The color them format is described below.

<p>
<b>Export</b> - This button exports the current color theme to a new Memopad record,
switches to the Memopad application, and opens the new record for editing.



<h2>Memopad Color Theme Format</h2>

<p>
The format is very simple:

<ul>
<li>Lines that look like <font class="courier"><i>name</i>=xx xx xx</font> set the named
color element to the indicated color. Colors are RGB values (red green blue) expressed in
hexadecimal notation.
<li>Any lines not matching that format are ok; they are simply ignored. For example this
conveniently allows a convention where the first line is the "name" of the color theme.
I usually make the first line read <font class="courier">Colorize - <i>Theme Name</i></font>.
</ul>

<h4>Example</h4>

<p>
<font class="courier">
<table cellspacing=0 cellpadding=0>
<tr><td colspan="2">Colorize - Green theme</td></tr>
<tr><td width="132">ObjFrame=</td><td width="100">00 66 00</td></tr>
<tr><td>ObjFill=</td><td>cc ff cc</td></tr>
<tr><td>ObjFore=</td><td>00 00 00</td></tr>
<tr><td>ObjSelFill=</td><td>00 66 00</td></tr>
<tr><td>ObjSelFore=</td><td>ff ff ff</td></tr>
<tr><td>MenuFrame=</td><td>00 66 00</td></tr>
<tr><td>MenuFill=</td><td>cc ff cc</td></tr>
<tr><td>MenuFore=</td><td>00 00 00</td></tr>
<tr><td>MenuSelFill=</td><td>00 66 00</td></tr>
<tr><td>MenuSelFore=</td><td>ff ff ff</td></tr>
<tr><td>FldBack=</td><td>ff ff ff</td></tr>
<tr><td>FldText=</td><td>00 00 00</td></tr>
<tr><td>FldLines=</td><td>99 99 99</td></tr>
<tr><td>FldCaret=</td><td>00 00 00</td></tr>
<tr><td>FldSelBack=</td><td>00 66 00</td></tr>
<tr><td>FldSelFore=</td><td>ff ff ff</td></tr>
<tr><td>FldFepRawText=</td><td>00 00 00</td></tr>
<tr><td>FldFepRawBack=</td><td>ff ff ff</td></tr>
<tr><td>FldFepCvtText=</td><td>00 66 00</td></tr>
<tr><td>FldFepCvtBack=</td><td>cc ff cc</td></tr>
<tr><td>FldFepLines=</td><td>99 99 99</td></tr>
<tr><td>FrmFrame=</td><td>00 66 00</td></tr>
<tr><td>FrmFill=</td><td>ff ff ff</td></tr>
<tr><td>DlgFrame=</td><td>00 66 00</td></tr>
<tr><td>DlgFill=</td><td>ff ff ff</td></tr>
<tr><td>AlertFrame=</td><td>99 00 00</td></tr>
<tr><td>AlertFill=</td><td>ff ff ff</td></tr>
<tr><td>OK=</td><td>00 cc 00</td></tr>
<tr><td>Caution=</td><td>ff cc 00</td></tr>
<tr><td>Warning=</td><td>ff 00 00</td></tr>
</table>
</font>

<h3>Color Element Names</h3>

<p>
The color elements are defined and used by the Palm OS. Colorize has no control over the
available color elements or how they are used. It can only set new colors to be used by
the Palm OS. Here are some quick descriptions of how the Palm OS uses the color elements.

<h4>Objects</h4>

<p>
<b>ObjFrame</b> - Frame (outline) color for buttons, lists, triggers, etc.

<p>
<b>ObjFill</b> - Background color for buttons and lists.

<p>
<b>ObjFore</b> - Text color for buttons, lists, triggers, checkboxes, etc.

<p>
<b>ObjSelFill</b> - Background color for pressed buttons, selected item in lists, and
pressed triggers.

<p>
<b>ObjSelFore</b> - Text color for pressed buttons, selected item in lists, and pressed
triggers.

<h4>Menus</h4>

<p>
<b>MenuFrame</b> - Frame (outline) color for menus.

<p>
<b>MenuFill</b> - Background color for menus.

<p>
<b>MenuFore</b> - Text color for menus.

<p>
<b>MenuSelFill</b> - Background color for selected menu item.

<p>
<b>MenuSelFore</b> - Text color for selected menu item.

<h4>Fields - Basic</h4>

<p>
<b>FldBack</b> - Background color for fields.

<p>
<b>FldText</b> - Text color for fields.

<p>
<b>FldLines</b> - Dotted underline color for fields.

<p>
<b>FldCaret</b> - Blinking insertion point color for fields.

<p>
<b>FldSelBack</b> - Background color for selected text in fields.

<p>
<b>FldSelFore</b> - Text color for selected text in fields.

<h4>Fields - FEP</h4>

<p>
Some languages have special "front end processors", also known as "input methods". For
example to write a Japanese character may take several Graffiti strokes. The FEP colors
control how this text is drawn in the field. When a FEP is used as a text input method,
then these colors apply to the inline conversion area. If the FEP colors are identical
to the basic field colors, then unconverted text has a solid underline and converted
text has a double-thick underline.

<p>
<b>FldFepRawText</b> - Text color used for unconverted text in the inline conversion area.

<p>
<b>FldFepRawBack</b> - Background color used for unconverted text in the inline conversion area.

<p>
<b>FldFepCvtText</b> - Text color used for converted text in the inline conversion area.

<p>
<b>FldFepCvtBack</b> - Background color used for converted text in the inline conversion area.

<p>
<b>FldFepLines</b> - Underline color for the inline conversion area.

<h4>Forms, Dialogs, and Alerts</h4>

<p>
<b>FrmFrame</b> - Frame and title bar color for forms.

<p>
<b>FrmFill</b> - Background color for forms.

<p>
<b>DlgFrame</b> - Frame and title bar color for dialogs.

<p>
<b>DlgFill</b> - Background color for dialogs.

<p>
<b>AlertFrame</b> - Frame and title bar color for alerts.

<p>
<b>AlertFill</b> - Background color for alerts.

<h4>Miscellaneous</h4>

<p>
<b>OK</b> - Some applications use this color for "success", "good", "ok", or similar meanings.

<p>
<b>Caution</b> - Some applications use this color for "caution" or similar meanings.

<p>
<b>Warning</b> - Some applications use this color for "warning", "bad", or similar meanings.



<h2>History</h2>

<p>
<b>v1.1 (build 4901.1) January 1, 2003</b>

<ul>
<li>Added a color theme editor.
<li>Memopad is still used to save/beam/share/import color themes.
<li>Colorize only works on color devices, but didn't check if the device supported color.
Now it refuses to start unless it's on a color device.
</ul>

<p>
<b>v1.0 (build 4828) December 28, 2002</b>

<ul>
<li>Initial release.
<li>Supports all color devices with Palm OS 3.5 through 5.0 (including ARM devices).
<li>Has a variety of built in color themes.
<li>Custom color themes use Memopad records for easy beaming/sharing with other users.
</ul>



</BODY>
</HTML>