NAME

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

SECTION

       pilot-link: Userland conduits

SYNOPSIS

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

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

DESCRIPTION

        pilot-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).

        pilot-read-palmpix converts all pictures in the files given, or  if  no  files  are  given,  on  a  Palm
       handheld, to Portable Pixmap files.

OPTIONS

   pilot-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 correction 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
                               -p, --port port

       Use  device  file  <port>  to  communicate  with  the  Palm  handheld.  If   this   is   not   specified,
       pilot-read-palmpix will look for the  $PILOTPORT  environment variable. If neither are found or supplied,
       pilot-read-palmpix will print the usage information.

                               -q,
                               --quiet

       Suppress 'Hit HotSync button' message

                               -v, --version

       Display version of pilot-read-palmpix and exit without connecting.

   Help Options
                               -h, --help

       Display the help synopsis for pilot-read-palmpix and exit without connecting.

                               --usage

       Display a brief usage message and exit without connecting.

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 previously fetched via pilot-xfer. See BUGS - a single
       file argument is ignored, a list will work.

AUTHOR

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

       This manual page was converted to XML by Neil Williams <linux@codehelp.co.uk>

BUGS

   Known Bugs
        pilot-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 do a histogram
       equalization in your favourite image editor.

        pilot-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
       We  have an online bug tracker. Using this is the only way to ensure that your bugs are recorded and that
       we can track them until they are resolved or closed. Reporting bugs via email, while easy,  is  not  very
       useful   in   terms   of   accountability.  Please  point  your  browser  to  http://bugs.pilot-link.org:
       http://bugs.pilot-link.org and report your bugs and issues there.

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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

SEE ALSO

        pilot-link(7)