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 skins use icons derived from one or more of the following
  sources, and modified by Alexander R. Pruss in July-August, 2004,
  and then with rotated versions generated in February, 2005, with
  modifications and other material
  copyright (c) 2002-2005 Alexander R. Pruss:
  - Bob Eaton's icons in two of his skins, used by permission,
    copyright 2002?-2003? Bob Eaton
  - Robert O'Connor's HOME and MENU icons in the Plucker Project
    (www.plkr.org), copyright 2003 Robert O'Connor (GPL, plkr.org)
  - Carles Carbonell Bernado's "Noia for KDE 1.00" icons (LGPL,
    kde-look.org), copyright (c) 2003 (maybe also 2004) by
    Carles Bernado
  - Michael Doches's "Amaranth, Altheae .5" icons
    (LGPL, kde-look.org), copyright (c) 2003 (I assume) and maybe
    2002 and 2004 by Michael Doches
  - David Vignoni's "NUVOLA ICON THEME for KDE 3.x" (www.icon-king.com),
    copyright (c) 2003 and 2004 by David Vignoni
  - Fractal Explorer plug-in data files, copyright (c) 1997 Daniel
    Cotting (included with the Gimp distribution I used)

  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 generally copyright (c) 2004 Alexander R. Pruss,
  except for some public domain items (out of copyright art, NASA and other
  U.S. Government photos).

  However, the memorystick, compact flash and other resources contained in
  the arp-icons directory 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.  The templates in template*.png are autogenerated
via the save-skins.scm script from sb-gf.xcf while the NR versions 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
ClieSkinner, which is a non-free product available from the same site you
obtained this.  Just search for "ClieSkinner" on that site.

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
in DOS or processall in bash.  (Only the latter generates landscape versions.)
The art skins currently don't have a DOS batch file, but by a *nix-style shell
script: processallart.  There is also a skins16custom script for generating
skins with different templates.

The Altheae Skin Pack is generated via the processnew shell script.
The second Altheae Skin Pack is generated via the processnew2 shell
script.


GEEK SKIN

For the Geek skin (based on Nuvola icons), I include a Gimp script-fu script,
save-geek.scm, a Gimp .xcf file, geek.xcf, a bash script "rungeek" and a DOS
batch file "rungeek.bat".  To build the Geek skin, edit save-geek.scm to point
to your Skin Generator directory (I use c:/palmBMX/quickconv) and drop it into
your Gimp scripts directory.  Start Gimp 2.0(www.gimp.org; make sure script-fu
support is loaded), and load xcf/geek.xcf and run "Save Geek" from the script-
fu skins menu.  This will create twenty-four .bmp files names Geek[A-D][1-6].bmp 
as well as eight more Geek[A-D][16]-Cap.bmp ones. To generate four non-
capitalizer skin pairs from this and four capitalizer Graffiti skins, make sure
you have ImageMagick installed, and run

   ./rungeek
in a bash shell or
   rungeek
in a DOS shell.

To create the left/right rotated versions, drop rotate-icons.scm into your Gimp
scripts directory, start Gimp, press ctrl-l to select layers, click on the buttons
layer, run the "Rotate icons" script with rotation 1, click on the selected buttons
layer, run the "Rotate icons" script with rotation 1, then run the "Save Geek" script.
Then run
    ./rungeekl
in a bash shell (it's easy to make a DOS version) to generate left-landscape.
Then rotate the two layers again with rotation 2 to get the right-versions, and
run
    ./rungeekr

To generate the amber versions, run "Save Geek" on the geek-amber.xcf file
and run
    rungeek-amber
(no bash version provided, but easy to make your own).



RENAMER.PL

renamer.pl is a perl script that renames an "extended" 16-bit skin to
"ext-renamer.pl".  This script needs "par":
http://www.djw.org/product/palm/par/



ACKNOWLEDGMENTS

Photographs starting with "Astro_" are from NASA. This project is in no way
affiliated with or endorsed by NASA.
