summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/pnmtoddif.1
blob: d75ab548d109c479d77f222013097d7c66917dfb (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
\
.\" 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 "Pnmtoddif User Manual" 0 "2003" "netpbm documentation"

.SH NAME

pnmtoddif - Convert a PNM image to DDIF format

.UN synopsis
.SH SYNOPSIS

\fBpnmtoddif\fP
[\fB-resolution\fP \fIx\fP \fIy\fP]
[\fIpnmfile\fP [\fIddiffile\fP]]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpnmtoddif\fP takes a PNM image and converts it into a DDIF image
file.
.PP
\fBpnmtoddif\fP writes PBM format (bitmap) data as a 1 bit DDIF,
PGM format data (grayscale) as an 8 bit grayscale DDIF, and PPM format
(color) data as an 8,8,8 bit color DDIF.  \fBpnmtoddif\fP writes any
DDIF image file uncompressed.  The data plane organization is
interleaved by pixel.
.PP
In addition to the number of pixels in the width and height
dimension, DDIF images also carry information about the size that the
image should have, that is, the physical space that a pixel occupies.
Netpbm images do not carry this information, hence you have to supply
it externally.  The default of 78 dpi has the beneficial property of
not causing a resize on most Digital Equipment Corporation color
monitors.

.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
\&), \fBpnmtoddif\fP recognizes the following
command line option:


.TP
\fBresolution\fP \fIx\fP \fIy\fP
The horizontal and vertical resolution of the output image in dots
per inch.  Default is 78 dpi.



.UN arguments
.SH ARGUMENTS


.TP
\fIpnmfile\fP
The filename for the image file in pnm format.  Default is to
read from Standard Input.

.TP
\fIddiffile\fP
The filename for the image file to be created in DDIF format.  By
default, \fBpnmtoddif\fP writes to Standard Output.



.UN seealso
.SH SEE ALSO
.BR "pnm" (1)\c
\&

.UN author
.SH AUTHOR

Burkhard Neidecker-Lutz, Digital Equipment Corporation, CEC Karlsruhe
\fIneideck@nestvx.enet.dec.com\fP
.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/pnmtoddif.html
.PP