summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man1/pamtopdbimg.1
blob: 43ca08536ae462bce7d4b818e1e5156ee861e347 (plain)
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
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamtopdbimg User Manual" 0 "12 March 2022" "netpbm documentation"

.SH NAME
pamtopdbimg - convert a Netpbm image to a Palm Pilot Image Viewer PDB Image

.UN synopsis
.SH SYNOPSIS

\fBpamtopdbimg\fP

[\fB-notefile=\fP\fIfilename\fP]
[\fB-title=\fP\fItext\fP]
[\fB-compressed\fP]
[\fB-uncompressed\fP]
[\fB-maybecompressed\fP]
[\fB-4depth\fP]
[\fB-fixedtime\fP]

[\fInetpbmfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamtopdbimg\fP reads a Netpbm image as input and produced a Palm Pilot
Image Viewer image (and Image record in a PDB file) as output.
.PP
If the Netpbm image is black and white, the Pilot image is monochrome.
Otherwise, the Pilot image is either 4-level or 16-level grayscale, depending
on the \fB-4depth\fP option.


.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpamtopdbimg\fP recognizes the following
command line options:



.TP
\fB-title=\fP\fItext\fP
The title of the image, to be included in the image.

.TP
\fB-compressed\fP
.TP
\fB-uncompressed\fP
.TP
\fB-maybecompressed\fP
You may specify only one of these.
\fB-compressed\fP says to generate the image in compressed format.
\fB-uncompressed\fP says to generate the image in uncompressed format.
\fB-maybecompressed\fP says to generate whichever format is smaller
(the compression algorithm sometimes actually makes the data larger).

.TP
\fB-4depth\fP
This option makes \fBpamtopdbimg\fP create the image in 16-level
grayscale (4 bits per pixel) format.  If you don't specify this,
\fBpamtopdbimg\fP uses 4-level (2 bits per pixel) format.
.sp
This option has no effect when the input is black and white
(maxval 1).  In that case, \fBpamtopdbimg\fP generates the monochrome
(1 bit per pixel) format regardless.

.TP
\fB-notefile=\fP\fIfilename\fP
Attach the note in the specified file to the image.
.sp
If you don't specify this, \fBpamtopdbimg\fP does not attach any note.

.TP
\fB-fixedtime\fP
Fake the mtime and ctime vaues in the PDB image with a value that is the
same every time you run the program.  This facilitates testing and
verification because it means with the same input you always get the
same output.
.sp
This option was new in Netpbm 10.98 (March 2022).



.UN seealso
.SH SEE ALSO
.BR "pdbimgtopam" (1)\c
\&,
.BR "palmtopnm" (1)\c
\&,
.BR "pam" (5)\c
\&,

.UN history
.SH HISTORY
.PP
\fBpamtopdbimg\fP was new in Netpbm 10.52 (September 2010).
It was modelled after Eric A. Howe's \fBimgvtopbm\fP package, which
dates back to September 1997.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pamtopdbimg.html
.PP