summary refs log tree commit diff
path: root/bmptopnm.html
blob: 3647976c4b740d5ef13439226c37dbb1a3d24c06 (plain) (blame)
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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Bmptopnm User Manual</title></head>
<body>
<h1>bmptopnm</h1>
Updated: 05 December 2018
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>
bmptopnm - convert a BMP file into a PBM, PGM, or PNM image

<h2 id="synopsis">SYNOPSIS</h2>

<b>bmptopnm</b>

[<b>-verbose</b>]

[<i>bmpfile</i>]

<h2 id="description">DESCRIPTION</h2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>bmptopnm</b> reads a Microsoft Windows or OS/2 BMP file as
input.  and produces a PBM, PGM, or PNM image as output.  If the input
is colormapped and contains only black and white, the output is PBM.
If the input is colormapped and contains only black white and gray,
the output is PGM.  Otherwise, the output is PPM.

<p><b>bmptopnm</b> understands BMP files compressed with run length
encoding (RLE4/RLE8), but not if that encoding includes a "delta"
(which is rare).  <b>bmptopnm</b> recognizes the delta and issues an
error message.

<p>Before Netpbm 10.75 (June 2016), <b>bmptopnm</b> could not convert
Version 4 or Version 5 Windows BMP images.

<p><b>bmptopnm</b> cannot convert BMP files compressed with JPEG or PNG
encoding.  It recognizes the compression and issues an error message.  Before
Netpbm 10.32 (February 2006), <b>bmptopnm</b> couldn't convert RLE8 BMP files
either, and before Netpbm 10.85 (December 2018), it couldn't convert RLE4
(between 10.32 and 10.85, it would act like it recognized the format, but
produce garbage output).

<p>Before Netpbm 10.18 (September 2003), this program could not convert
BMP images with the BI_BITFIELDS format ("compression type").  It would
recognize the format and issue an error message.

<p><b>bmptopnm</b> cannot convert OS/2 BMP files with 16 bits per
pixel (only because the author did not have a complete specification
for them).  It recognizes the format and issues an error message.
Before Netpbm 10.16 (June 2003), it also could not convert Windows BMP
files with 16 bits per pixel.


<h2 id="options">OPTIONS</h2>

<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>bmptopnm</b> recognizes the following
command line option:

<dl compact>

<dt><b>-verbose</b>
<dd>Report contents of the BMP header to the standard error.

</dl>

<h2 id="seealso">SEE ALSO</h2>

<b><a href="ppmtobmp.html">ppmtobmp</a></b>,
<b><a href="ppmtowinicon.html">ppmtowinicon</a></b>,
<b><a href="ppm.html">ppm</a></b>

<h2 id="author">AUTHOR</h2>

Copyright (C) 1992 by David W. Sanderson.

<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>