Debian Codegraph @

upstream/debian-unstable/man1/pamtopdbimg.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pamtopdbimg User Manual" 1 "12 March 2022" "netpbm documentation"
7
8 .SH NAME
9 pamtopdbimg - convert a Netpbm image to a Palm Pilot Image Viewer PDB Image
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpamtopdbimg\fP
15
16 [\fB-notefile=\fP\fIfilename\fP]
17 [\fB-title=\fP\fItext\fP]
18 [\fB-compressed\fP]
19 [\fB-uncompressed\fP]
20 [\fB-maybecompressed\fP]
21 [\fB-4depth\fP]
22 [\fB-fixedtime\fP]
23
24 [\fInetpbmfile\fP]
25
26 .UN description
27 .SH DESCRIPTION
28 .PP
29 This program is part of
30 .BR "Netpbm" (1)\c
31 \&.
32 .PP
33 \fBpamtopdbimg\fP reads a Netpbm image as input and produced a Palm Pilot
34 Image Viewer image (and Image record in a PDB file) as output.
35 .PP
36 If the Netpbm image is black and white, the Pilot image is monochrome.
37 Otherwise, the Pilot image is either 4-level or 16-level grayscale, depending
38 on the \fB-4depth\fP option.
39
40
41 .UN options
42 .SH OPTIONS
43 .PP
44 In addition to the options common to all programs based on libnetpbm
45 (most notably \fB-quiet\fP, see
46 .UR index.html#commonoptions
47 Common Options
48 .UE
49 \&), \fBpamtopdbimg\fP recognizes the following
50 command line options:
51
52
53
54 .TP
55 \fB-title=\fP\fItext\fP
56 The title of the image, to be included in the image.
57
58 .TP
59 \fB-compressed\fP
60 .TP
61 \fB-uncompressed\fP
62 .TP
63 \fB-maybecompressed\fP
64 You may specify only one of these.
65 \fB-compressed\fP says to generate the image in compressed format.
66 \fB-uncompressed\fP says to generate the image in uncompressed format.
67 \fB-maybecompressed\fP says to generate whichever format is smaller
68 (the compression algorithm sometimes actually makes the data larger).
69
70 .TP
71 \fB-4depth\fP
72 This option makes \fBpamtopdbimg\fP create the image in 16-level
73 grayscale (4 bits per pixel) format. If you don't specify this,
74 \fBpamtopdbimg\fP uses 4-level (2 bits per pixel) format.
75 .sp
76 This option has no effect when the input is black and white
77 (maxval 1). In that case, \fBpamtopdbimg\fP generates the monochrome
78 (1 bit per pixel) format regardless.
79
80 .TP
81 \fB-notefile=\fP\fIfilename\fP
82 Attach the note in the specified file to the image.
83 .sp
84 If you don't specify this, \fBpamtopdbimg\fP does not attach any note.
85
86 .TP
87 \fB-fixedtime\fP
88 Fake the mtime and ctime vaues in the PDB image with a value that is the
89 same every time you run the program. This facilitates testing and
90 verification because it means with the same input you always get the
91 same output.
92 .sp
93 This option was new in Netpbm 10.98 (March 2022).
94
95
96
97 .UN seealso
98 .SH SEE ALSO
99 .BR "pdbimgtopam" (1)\c
100 \&,
101 .BR "palmtopnm" (1)\c
102 \&,
103 .BR "pam" (1)\c
104 \&,
105
106 .UN history
107 .SH HISTORY
108 .PP
109 \fBpamtopdbimg\fP was new in Netpbm 10.52 (September 2010).
110 It was modelled after Eric A. Howe's \fBimgvtopbm\fP package, which
111 dates back to September 1997.
112 .SH DOCUMENT SOURCE
113 This manual page was generated by the Netpbm tool 'makeman' from HTML
114 source. The master documentation is at
115 .IP
116 .B http://netpbm.sourceforge.net/doc/pamtopdbimg.html
117 .PP