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)
Man(1) output converted with
man2html