pilot-read-palmpix(1) PILOT-LINK pilot-read-palmpix(1)NAMEpilot-read-palmpix - Convert all pictures in the files given or found
on a Palm handheld.
SECTION
pilot-link: Userland conduits
SYNOPSISpilot-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
DESCRIPTIONpilot-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.
OPTIONSpilot-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 his‐
togram 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 convert‐
ing 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 con‐
necting.
--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 (ArchIm‐
age.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.
AUTHORpilot-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@code‐
help.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 edi‐
tor.
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 MER‐
CHANTABILITY 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 ALSOpilot-link(7)0.12.5 Copyright 1996-2007 FSF pilot-read-palmpix(1)
