           read-palmpix  - Convert all pictures in the files given or
           found on a Palm handheld.

## SECTION

           pilot-link: Userland Conduits

## SYNOPSIS

           read-palmpix [-p|--port <port>]  [--version]  [-q|--quiet]
           [-?|--help]    [--usage]    [-s|--stretch]   [-c|--colour]
           [-t|--type   [ppm|png]]   [-b|--bias   bias]   [-l|--list]
           [-n|--name name] [file] ...

           read-palmpix Image1.pdb Image2.pdb Image3.pdb

## DESCRIPTION

           read-palmpix allows a Kodak PalmPix camera user to extract
           the images from their Palm handheld and  convert  them  to
           Portable  Network Graphic (.png) or Portable Pixmap (.ppm)
           files on their system. The default output type is Portable
           Pixmap (.ppm).

## OPTIONS

       READ-PALMPIX OPTIONS
           -b, --bias bias
                  lighten  or darken the image (0..49 darken, 51..100
                  lighten)

           -c, --colour
                  Do a simple colour correction. The  colour  correc-
                  tion  code  makes a histogram from the image. Using
                  the histogram it then makes up a couple  of  colour
                  tables  to  try  and  balance  the colours. It also
                  clips the top and bottom colours to produce  better
                  perceived contrast.

           -l, --list
                  List picture information found on the Palm handheld
                  instead of converting the entries  found  to  image
                  files.

           -n, --name <pixname>
                  Convert only pixname to STDOUT, and output as type:
                  .ppm or .png.

           -s, --stretch
                  Do a histogram stretch on the colour planes

           -t, --type [ppm|png]
                  Specify the output  picture  type.  Can  be  either
                  "png" or "ppm".

       CONDUIT OPTIONS
                  handheld. If this is  not  specified,  read-palmpix
                  will  look for the $PILOTPORT environment variable.
                  If neither are found or supplied, read-palmpix will
                  print the usage information.

           -q, --quiet
                  Suppress 'Hit HotSync button' message

           -v, --version
                  Display  version  of  read-palmpix and exit without
                  connecting.

       HELP OPTIONS
           -h, --help
                  Display the help synopsis for read-palmpix and exit
                  without connecting.

           --usage
                  Display a brief usage message and exit without con-
                  necting.

## USAGE

           If a filelist is not given, connects to  the  target  Palm
           handheld,  and reads the images found in the Kodak PalmPix
           image database (ArchImage.pdb), and  allows  the  user  to
           view  the  list  of images and image details, or to select
           one or all of them, and convert them to  Portable  Network
           Graphic  (.png)  or  Portable  Pixmap  (.ppm)  files to be
           viewed or printed at the desktop.

           If no options are specified, all  of  the  images  on  the
           device will be converted to ppm files by default.

           If  a  filelist  is given, convert all listed files previ-
           ously fetched via pilot-xfer. See BUGS  -  a  single  file
           argument is ignored, a list will work.

## AUTHOR

           read-palmpix  was  originally  written  by  Angus  Ainslie
           angusa at deltatee.com, and updated by John Marshall jmar-
           shall@acm.org to include core pilot-link functionality.

           This  manual page was written by Neil Williams linux@code-
           help.co.uk

## BUGS

       KNOWN BUGS
           read-palmpix's colour correction  is  nearly  as  good  as
           Kodak's  own, but Kodak has deprecated the PalmPix device,
           so it is not likely that there  will  be  any  updates  to
           their software in the future, so this may be as good as it
           gets. A simple method to improve the look of colours is to

           read-palmpix command DOES read from a file,  but  only  if
           you  specify  a  LIST of files. If only one file is given,
           the command tries reading from $PILOTPORT.

       REPORTING BUGS
           Report bugs at http://bugs.pilot-link.org/

## COPYRIGHT

           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

## SEE ALSO

           pilot-link(7)