 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

LEGAL

This is a collection of command-line tools and graphical components that can be
used for generating 16-bit Sony Clie NX/NZ/TH or UX skins.  Various parts of this
tool collection are copyrighted by various authors.  This is an aggregation of 
these various tools.

  - The sample skins and templates use icons derived from Robert O'Connor's hi-
  res icons in the Plucker project and from Bob Eaton's icons in two of his
  skins.  These original elements are copyrighted by the authors, Robert O'
  Connor's being copyrighted 2003.  They were modified, in some cases heavily,
  in July 2004 by Alexander R. Pruss.  All use is either in accordance with the
  GPL license or by original author's permission.

 -  pilrc is copyright (C) 1997-1999 Wes Cherry and Copyright (C) 2000-2004
 Aaron Ardiri.  Modified in June or July 2004 by Alexander R. Pruss.

 -  Things otherwise unmarked are copyright (c) 2004 Alexander R. Pruss.

 -  However, the memorystick, compact flash and other icons contained in
 the abmp????.png files of the NX/NZ/TH version are hereby released into the
 public domain by Alexander R. Pruss.  This only applies to these files and to
 nothing else.


All of this collection is released under the Gnu General Public License.  See
the COPYING file for details.

I am not a lawyer and it is not clear to me what constitutes source code for
graphical elements.  My guess is that what constitutes source code for
graphical elements is layered bitmaps, like those in gf-sb.xcf.  This means
that if you distribute any skins generated by this collection of tools that
make use of copyrighted graphical elements from here, you may need to include
any layered bitmap files you've generated.


SOURCE CODE INFORMATION

This collection includes Windows binaries for a patched version of pilrc.exe
(source code available from http://handypalmstuff.sf.net) and for toprc.exe
(source code available from http://palmfontconv.sf.net, currently in cvs). If
you need Linux versions, you'll need to download source for these and recompile.


ADDITIONAL PREREQUISITES

You will also need to install pre-compiled binaries for ImageMagick which you
can download for free from www.imagemagick.org.


USAGE

The simplest thing to do is to generate a 24-bit .bmp file with a 320x160
background image for the NX/NZ/TH or 130x320 for the UX, and run

       skins16 image.bmp SkinName

In the NX/NZ/TH/NR version, this will generate SkinName-GF.prc, SkinName-Cap-GF.prc, 
SkinName-SB-NR.prc and SkinName-SB.prc, containing respectively a 16-bit
Graffiti skin for NX/NZ/TH models, a 16-bit Graffiti skin for use with
Capitalizer in numeric NE punctuation mode (see handypalmstuff.sf.net), a 16-
bit statusbar skin for NX/NZ/TH models, and a 16-bit statusbar skin for NR
models.  These skins will be semi-transparent and based on the templates mainly
in template?.png or nrtemplate?.png, which in turn are manually generated from
the Gimp image files sb-gf.xcf and sb-gf-nr.xcf, which you can modify, of
course, to fit your needs (as long as you adhere to the terms of the license).
In the UX version, this will generate just a 16-bit Graffiti skin, named
SkinName.prc.  This uses the selected-template.png and unselected-template.png
files which are manually generated from the Gimp image file gf.xcf.  I am also
throwing in the PhotoShop versions, sb-gf.psd and sb-gf-nr.psd or gf.psd.

The NX/NZ/TH Graffiti skin can also be loaded on NR models via Clie Skinner.

16-bit skins can be of two sorts.  Standard 16-bit skins keep all resources
under 65000 bytes.  These can be loaded with any decent skin loader for the
appropriate Clie model.  Extended 16-bit skins allow the main graffiti resource-
-the abmp 0x3e8 resource--(this is the only one for which this is really a
worry) to exceed 65000 bytes.  In these skins this resource is split into an
abmp 0x03e8 resource containing the first 65000 bytes, and a 2bmp 0x03e8
resource containing the rest.  The scripts and batch files included here
automatically generate a standard skin if possible, and an extended one if
impossible.  Which one gets generated depends on how well the main graffiti
background image compresses.  When distributing skins, please tell users if it'
s a standard or extended skin. You can tell which one you've generated, either
by inspecting the .prc file to see if there is a 2bmp resource, or by seeing if
pilrc, when called from the batch file or script, gave a warning about
exceeding 65000 bytes in a resource.  I would ask that an extended graffiti
skin be named ext-filename.prc.  Currently the only software for loading
extended skins is Alexander Pruss's Clie Skinner, which is a non-free product
available from PalmGear.com.

Clie Skinner's URL is:
http://www.palmgear.com/software/showsoftware.cfm?prodid=67667


There are more complex things you can do.  Run graffiti16 and sb16 at the
command line for information.

Note that when using sb16 to generate statusbars you do not need to generate
any memorystick or compactflash icons.  These are included in the abmp????.png
files.  Moreover, you only need to generate charging, full and an empty battery
icon state skins, as these get interpolated to produce intermediate states.
This interpolation only works for vertical bar type battery icons, but in any
case it needs to be done to support TH skins where the OS does this kind of
interpolation.


There is a bunch of possible backgrounds included in backs/*.bmp.  You can
create all the non-art skins from them automatically by running processall.bat.
The art skins currently don't have a DOS batch file, but a Linux script:
processallart.
