\
.\" 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 "Bmptopnm User Manual" 0 "05 December 2018" "netpbm documentation"

.SH NAME
bmptopnm - convert a BMP file into a PBM, PGM, or PNM image

.UN synopsis
.SH SYNOPSIS

\fBbmptopnm\fP

[\fB-verbose\fP]

[\fIbmpfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBbmptopnm\fP 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.
.PP
\fBbmptopnm\fP understands BMP files compressed with run length
encoding (RLE4/RLE8), but not if that encoding includes a "delta"
(which is rare).  \fBbmptopnm\fP recognizes the delta and issues an
error message.
.PP
Before Netpbm 10.75 (June 2016), \fBbmptopnm\fP could not convert
Version 4 or Version 5 Windows BMP images.
.PP
\fBbmptopnm\fP 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), \fBbmptopnm\fP 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).
.PP
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.
.PP
\fBbmptopnm\fP 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.


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



.TP
\fB-verbose\fP
Report contents of the BMP header to the standard error.



.UN seealso
.SH SEE ALSO
.BR "ppmtobmp" (1)\c
\&,
.BR "ppmtowinicon" (1)\c
\&,
.BR "ppm" (5)\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/bmptopnm.html
.PP