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
161
162
163
164
165
166
167
|
\
.\" 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 "Ppmtobmp User Manual" 0 "20 December 2018" "netpbm documentation"
.SH NAME
ppmtobmp - convert a PPM image into a BMP file
.UN synopsis
.SH SYNOPSIS
\fBppmtobmp\fP
[\fB-windows\fP]
[\fB-os2\fP]
[\fB-bpp=\fP\fIbits_per_pixel\fP]
[\fB-mapfile=\fP\fIfilename\fP]
[\fIppmfile\fP]
.PP
Minimum unique abbreviation of option is acceptable. You may use double
hyphens instead of single hyphen to denote options. You may use white
space in place of the equals sign to separate an option name from its value.
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBppmtobmp\fP reads a PPM image as input and produces a Microsoft
Windows or OS/2 BMP file as output.
.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
\&), \fBppmtobmp\fP recognizes the following
command line options:
.TP
\fB-windows\fP
Tells the program to produce a Microsoft Windows BMP file. (This
is the default.)
.TP
\fB-os2\fP
Tells the program to produce an OS/2 BMP file. (Before August
2000, this was the default).
.TP
\fB-bpp\fP
This tells how many bits per pixel you want the BMP file to
contain. Only 1, 4, 8, and 24 are possible. By default,
\fBppmtobmp\fP chooses the smallest number with which it can
represent all the colors in the input image. If you specify a number
too small to represent all the colors in the input image,
\fBppmtobmp\fP tells you and terminates. You can use \fBpnmquant\fP
or \fBppmdither\fP to reduce the number of colors in the image.
.sp
Before Netpbm 10.85 (December 2018), \fBppmtobmp\fP ignores this option if
the input is PBM and produces a BMP with 1 bit per pixel. With these
versions, if you want more than that, use \fBpbmtopgm\fP to convert the PBM
to PGM first.
.TP
\fB-mapfile=\fP\fIfilename\fP
This identifies a file to use as the BMP palette (aka
"colormap"). In one BMP subformat, the BMP stream contains
a palette of up to 256 colors, and represents the image raster as
indices into that palette. Normally, \fBppmtobmp\fP takes care of
computing a suitable palette, but if you are going to dissect the BMP
output in some way, you may want certain values for the palette
indices. E.g. you might want red to be 13, where \fBppmtobmp\fP
would (arbitrarily) choose 39. In that case, you can construct the
palette yourself and use this option to tell \fBppmtobmp\fP to use
your palette.
.sp
This option does \fInot\fP control what colors are in the
output. The colors in the output are exactly those in the input, and
the palette you supply must contain at least all the colors that are
in the input. You can use \fBpnmremap\fP to adjust your input image
so that it contains only colors from your palette.
.sp
The palette file is a Netpbm format file with one pixel per
palette entry. Each pixel must have a distinct color (no repeats).
The order of the BMP palette \fBppmtobmp\fP generates is the order
of the pixels in the palette file, going from top to bottom, left
to right.
.sp
A BMP palette may have at most 256 colors, so the palette file
must have at most 256 pixels.
.sp
You may find \fBpnmcolormap\fP useful in generating the palette
file. \fBpamseq\fP too.
.sp
In the case of grayscale image, if you are processing the BMP image, it
may be convenient for you to have the actual gray values in the raster
part of the image rather than arbitrary indices into a palette. There is
no BMP format specifically for that, but you can achieve it by using a
palette in which each index is equal to the indexed gray value, and then
ignoring the palette when you process the BMP image.
.sp
Here is an example of doing that:
.nf
\f(CW
$ pamseq 1 255 > mapfile.pgm
$ ppmtobmp -mapfile=mapfile.pgm input.pgm > output.bmp
\fP
.fi
.sp
This option was new in Netpbm 10.45 (December 2008).
.UN notes
.SH NOTES
.PP
To get a faithful reproduction of the input image, the maxval of the
input image must be 255. If it is something else,
the colors in the BMP file may be slightly different from the colors
in the input.
.PP
Windows icons are not BMP files. Use \fBppmtowinicon\fP to
create those.
.UN seealso
.SH SEE ALSO
.BR "bmptoppm" (1)\c
\&,
.BR "ppmtowinicon" (1)\c
\&,
.BR "pnmquant" (1)\c
\&,
.BR "ppmdither" (1)\c
\&,
.BR "pnmremap" (1)\c
\&,
.BR "ppm" (1)\c
\&
.UN author
.SH AUTHOR
Copyright (C) 1992 by David W. Sanderson.
.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/ppmtobmp.html
.PP
|
