version 3.3
date    Mon Apr 28 12:46:50 EDT 2014
archive http://kinzler.com/ftp/faces/picons/src/bits-3.3.tar.Z

                 BITS Scripts for the Picons Databases

                             Steve Kinzler
                           steve@kinzler.com
                         http://kinzler.com/me/

This directory contains some bitmap manipulation programs I find handy
to maintain the picons databases.  They're shell scripts that depend on
the PBMPlus or NetPBM package.  In particular, I've based the scripts
on the 1mar1994 version of the NetPBM package.  You may need to modify
some command names and/or options within the scripts to use them with
another version.

At the top of each script, you'll find a short description of the
program.  Running the scripts with only a "-h" argument will produce a
usage message.  Any configuration you might want to change is also at
the top of each script.

The xbmtoikon and ikontoxbm scripts are not terribly general since I
don't have a specification for the Blit ikon format, but they at least
work for 48x48 and 64x64 bitmaps.

See also the support scripts in Anthony's Icon Library
at http://www.cit.gu.edu.au/~anthony/icons/support/ or
ftp://ftp.cs.indiana.edu/pub/AIcons/support.tar.gz.  The xbmbrowserrc
file here is adapted for picons management from the one included in this
support set; and the xb script here is for invoking xbmbrowser with the
right environment and configuration file.

The *map.ppm and *map.pgm files in this directory are intended to be used
with ppmquant(1) from the PBMPlus/NetPBM package to recolor PPM pixmaps
to a standard picons colormap.  The Picons_* files may be placed in your
.gimp/palettes directory for use with GIMP.

--------------------------------------------------------------------------
Copyright (c) 2023 Stephen B Kinzler.  All rights reserved.

Permission to use, copy, modify, distribute, and sell this software
and its documentation for any purpose is hereby granted without fee,
provided that the above copyright notice appear in all copies and
that both that copyright notice and this permission notice appear in
supporting documentation, and that the name Stephen B Kinzler not be used
in advertising or publicity pertaining to distribution of this software
without specific, written prior permission.

THIS SOFTWARE IS PROVIDED `AS-IS'.  STEPHEN B KINZLER DISCLAIMS ALL
WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL
IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
OR NONINFRINGEMENT.  IN NO EVENT SHALL STEPHEN B KINZLER BE LIABLE FOR
ANY DAMAGES WHATSOEVER, INCLUDING SPECIAL, INCIDENTAL OR CONSEQUENTIAL
DAMAGES, INCLUDING LOSS OF USE, DATA, OR PROFITS, EVEN IF ADVISED OF THE
POSSIBILITY THEREOF, AND REGARDLESS OF WHETHER IN AN ACTION IN CONTRACT,
TORT OR NEGLIGENCE, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.