1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "pilot-read-palmpix" 1 "Copyright 1996-2007 FSF" "0.12.5" "PILOT-LINK"
.SH NAME
pilot-read-palmpix \- Convert all pictures in the files given or found on a Palm handheld.
.SH "SECTION"
.PP
pilot\-link: Userland conduits
.SH "SYNOPSIS"
.PP
\fIpilot\-read\-palmpix\fR [\fB\-p\fR|\fB\-\-port\fR <\fBport\fR>] [\fB\-\-version\fR] [\fB\-?\fR|\fB\-\-help\fR] [\fB\-\-usage\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-s\fR|\fB\-\-stretch\fR] [\fB\-c\fR|\fB\-\-colour\fR] [\fB\-t\fR|\fB\-\-type\fR [\fBppm|png\fR]] [\fB\-b\fR|\fB\-\-bias\fR \fBbias\fR] [\fB\-l\fR|\fB\-\-list\fR] [\fB\-n\fR|\fB\-\-name\fR \fBname\fR] [\fIfile\fR] \&.\&.\&.
.PP
\fIpilot\-read\-palmpix\fR Image1\&.pdb Image2\&.pdb Image3\&.pdb
.SH "DESCRIPTION"
.PP
\fIpilot\-read\-palmpix\fR 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)\&.
.PP
\fIpilot\-read\-palmpix\fR converts all pictures in the files given, or if no files are given, on a Palm handheld, to Portable Pixmap files\&.
.SH "OPTIONS"
.SS "pilot-read-palmpix options"
\fB\-b\fR,
\fB\-\-bias\fR \fBbias\fR
.PP
lighten or darken the image (0\&.\&.49 darken, 51\&.\&.100 lighten)
\fB\-c\fR, \fB\-\-colour\fR
.PP
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\&.
\fB\-l\fR, \fB\-\-list\fR
.PP
List picture information found on the Palm handheld instead of converting the entries found to image files\&.
\fB\-n\fR, \fB\-\-name\fR
<\fIpixname\fR>
.PP
Convert only \fIpixname\fR to STDOUT, and output as \fBtype\fR: \&.ppm or \&.png\&.
\fB\-s\fR, \fB\-\-stretch\fR
.PP
Do a histogram stretch on the colour planes
\fB\-t\fR,
\fB\-\-type\fR \fB[ppm|png]\fR
.PP
Specify the output picture type\&. Can be either "png" or "ppm"\&.
.SS "Conduit Options"
\fB\-p\fR, \fB\-\-port\fR \fIport\fR
.PP
Use device file <\fIport\fR> to communicate with the Palm handheld\&. If this is not specified, \fIpilot\-read\-palmpix\fR will look for the \fI $PILOTPORT \fR environment variable\&. If neither are found or supplied, \fIpilot\-read\-palmpix\fR will print the usage information\&.
\fB\-q\fR,
\fB\-\-quiet\fR
.PP
Suppress 'Hit HotSync button' message
\fB\-v\fR, \fB\-\-version\fR
.PP
Display version of \fIpilot\-read\-palmpix\fR and exit without connecting\&.
.SS "Help Options"
\fB\-h\fR, \fB\-\-help\fR
.PP
Display the help synopsis for \fIpilot\-read\-palmpix\fR and exit without connecting\&.
\fB\-\-usage\fR
.PP
Display a brief usage message and exit without connecting\&.
.SH "USAGE"
.PP
If a filelist is not given, connects to the target Palm handheld, and reads the images found in the Kodak PalmPix image database (\fIArchImage\&.pdb\fR), 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\&.
.PP
If no options are specified, all of the images on the device will be converted to ppm files by default\&.
.PP
If a filelist is given, convert all listed files previously fetched via pilot\-xfer\&. See \fIBUGS\fR \- a single file argument is ignored, a list will work\&.
.SH "AUTHOR"
.PP
\fIpilot\-read\-palmpix \fR was originally written by Angus Ainslie <angusa at deltatee\&.com > ,and updated by John Marshall <jmarshall@acm\&.org> to include core pilot\-link functionality\&.
.PP
This manual page was converted to XML by Neil Williams <linux@codehelp\&.co\&.uk>
.SH "BUGS"
.SS "Known Bugs"
.PP
\fIpilot\-read\-palmpix\fR'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\&.
.PP
\fIpilot\-read\-palmpix\fR 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 \fI$PILOTPORT\fR\&.
.SS "Reporting Bugs"
.PP
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: \fIhttp://bugs.pilot-link.org\fR and report your bugs and issues there\&.
.SH "COPYRIGHT"
.PP
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\&.
.PP
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\&.
.PP
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\&.
.SH "SEE ALSO"
.PP
\fIpilot\-link\fR(7)
|
