pilot-read-palmpix(1)

1pilot-read-palmpix(1)             PILOT-LINK             pilot-read-palmpix(1)
2
3
4

NAME

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

SECTION

10       pilot-link: Userland conduits
11
12

SYNOPSIS

14        pilot-read-palmpix   [-p|--port   <port>]   [--version]    [-?|--help]
15       [--usage]    [-q|--quiet]   [-s|--stretch]   [-c|--colour]   [-t|--type
16       [ppm|png]] [-b|--bias  bias] [-l|--list] [-n|--name  name] [file] ...
17
18
19        pilot-read-palmpix Image1.pdb Image2.pdb Image3.pdb
20
21

DESCRIPTION

23        pilot-read-palmpix allows a Kodak PalmPix camera user to  extract  the
24       images  from  their  Palm handheld and convert them to Portable Network
25       Graphic (.png) or Portable Pixmap (.ppm) files  on  their  system.  The
26       default output type is Portable Pixmap (.ppm).
27
28
29        pilot-read-palmpix  converts all pictures in the files given, or if no
30       files are given, on a Palm handheld, to Portable Pixmap files.
31
32

OPTIONS

34   pilot-read-palmpix options
35                               -b,
36                               --bias bias
37
38
39       lighten or darken the image (0..49 darken, 51..100 lighten)
40
41                               -c, --colour
42
43
44       Do a simple colour correction. The colour correction code makes a  his‐
45       togram from the image. Using the histogram it then makes up a couple of
46       colour tables to try and balance the colours. It also clips the top and
47       bottom colours to produce better perceived contrast.
48
49                               -l, --list
50
51
52       List picture information found on the Palm handheld instead of convert‐
53       ing the entries found to image files.
54
55                               -n, --name
56                               <pixname>
57
58
59       Convert only pixname to STDOUT, and output as type: .ppm or .png.
60
61                               -s, --stretch
62
63
64       Do a histogram stretch on the colour planes
65
66                               -t,
67                               --type [ppm|png]
68
69
70       Specify the output picture type. Can be either "png" or "ppm".
71
72
73   Conduit Options
74                               -p, --port port
75
76
77       Use device file <port> to communicate with the Palm handheld.  If  this
78       is  not  specified,  pilot-read-palmpix  will  look for the  $PILOTPORT
79       environment   variable.   If   neither   are   found    or    supplied,
80       pilot-read-palmpix will print the usage information.
81
82                               -q,
83                               --quiet
84
85
86       Suppress 'Hit HotSync button' message
87
88                               -v, --version
89
90
91       Display version of pilot-read-palmpix and exit without connecting.
92
93
94   Help Options
95                               -h, --help
96
97
98       Display  the help synopsis for pilot-read-palmpix and exit without con‐
99       necting.
100
101                               --usage
102
103
104       Display a brief usage message and exit without connecting.
105
106

USAGE

108       If a filelist is not given, connects to the target Palm  handheld,  and
109       reads  the  images  found  in the Kodak PalmPix image database (ArchIm‐
110       age.pdb), and allows the user to view the  list  of  images  and  image
111       details,  or to select one or all of them, and convert them to Portable
112       Network Graphic (.png) or Portable Pixmap (.ppm) files to be viewed  or
113       printed at the desktop.
114
115
116       If  no  options  are specified, all of the images on the device will be
117       converted to ppm files by default.
118
119
120       If a filelist is given, convert all listed files previously fetched via
121       pilot-xfer.  See  BUGS - a single file argument is ignored, a list will
122       work.
123
124

AUTHOR

126        pilot-read-palmpix  was originally written by Angus Ainslie <angusa at
127       deltatee.com  >  ,and  updated  by John Marshall <jmarshall@acm.org> to
128       include core pilot-link functionality.
129
130
131       This manual page was converted to XML  by  Neil  Williams  <linux@code‐
132       help.co.uk>
133
134

BUGS

136   Known Bugs
137        pilot-read-palmpix's  colour  correction  is nearly as good as Kodak's
138       own, but Kodak has deprecated the PalmPix device, so it is  not  likely
139       that there will be any updates to their software in the future, so this
140       may be as good as it gets. A simple  method  to  improve  the  look  of
141       colours  is to do a histogram equalization in your favourite image edi‐
142       tor.
143
144
145        pilot-read-palmpix command DOES read from a  file,  but  only  if  you
146       specify  a  LIST of files. If only one file is given, the command tries
147       reading from $PILOTPORT.
148
149
150   Reporting Bugs
151       We have an online bug tracker. Using this is the  only  way  to  ensure
152       that  your  bugs are recorded and that we can track them until they are
153       resolved or closed. Reporting bugs via email, while easy, is  not  very
154       useful  in  terms  of  accountability.  Please  point  your  browser to
155       http://bugs.pilot-link.org: http://bugs.pilot-link.org and report  your
156       bugs and issues there.
157
158

COPYRIGHT

160       This program is free software; you can redistribute it and/or modify it
161       under the terms of the GNU General Public License as published  by  the
162       Free  Software Foundation; either version 2 of the License, or (at your
163       option) any later version.
164
165
166       This program is distributed in the hope that it  will  be  useful,  but
167       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
168       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the  GNU  General
169       Public License for more details.
170
171
172       You should have received a copy of the GNU General Public License along
173       with this program; if not, write to the Free Software Foundation, Inc.,
174       51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
175
176