Debian Codegraph @

upstream/debian-unstable/man1/bmptopnm.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Bmptopnm User Manual" 1 "05 December 2018" "netpbm documentation"
7
8 .SH NAME
9 bmptopnm - convert a BMP file into a PBM, PGM, or PNM image
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBbmptopnm\fP
15
16 [\fB-verbose\fP]
17
18 [\fIbmpfile\fP]
19
20 .UN description
21 .SH DESCRIPTION
22 .PP
23 This program is part of
24 .BR "Netpbm" (1)\c
25 \&.
26 .PP
27 \fBbmptopnm\fP reads a Microsoft Windows or OS/2 BMP file as input and
28 produces a PBM, PGM, or PNM image as output. If the input is colormapped and
29 contains only black and white, the output is PBM. If the input is colormapped
30 and contains only black white and gray, the output is PGM. Otherwise, the
31 output is PPM.
32 .PP
33 \fBbmptopnm\fP understands BMP files compressed with run length
34 encoding (RLE4/RLE8), but not if that encoding includes a "delta"
35 (which is rare). \fBbmptopnm\fP recognizes the delta and issues an
36 error message.
37 .PP
38 Before Netpbm 10.75 (June 2016), \fBbmptopnm\fP could not convert
39 Version 4 or Version 5 Windows BMP images.
40 .PP
41 \fBbmptopnm\fP cannot convert BMP files compressed with JPEG or PNG
42 encoding. It recognizes the compression and issues an error message. Before
43 Netpbm 10.32 (February 2006), \fBbmptopnm\fP couldn't convert RLE8 BMP files
44 either, and before Netpbm 10.85 (December 2018), it couldn't convert RLE4
45 (between 10.32 and 10.85, it would act like it recognized the format, but
46 produce garbage output).
47 .PP
48 Before Netpbm 10.18 (September 2003), this program could not convert
49 BMP images with the BI_BITFIELDS format ("compression type"). It would
50 recognize the format and issue an error message.
51 .PP
52 \fBbmptopnm\fP cannot convert OS/2 BMP files with 16 bits per
53 pixel (only because the author did not have a complete specification
54 for them). It recognizes the format and issues an error message.
55 Before Netpbm 10.16 (June 2003), it also could not convert Windows BMP
56 files with 16 bits per pixel.
57
58
59 .UN options
60 .SH OPTIONS
61 .PP
62 In addition to the options common to all programs based on libnetpbm
63 (most notably \fB-quiet\fP, see
64 .UR index.html#commonoptions
65 Common Options
66 .UE
67 \&), \fBbmptopnm\fP recognizes the following
68 command line option:
69
70
71
72 .TP
73 \fB-verbose\fP
74 Report contents of the BMP header to the standard error.
75
76
77
78 .UN seealso
79 .SH SEE ALSO
80 .BR "ppmtobmp" (1)\c
81 \&,
82 .BR "ppmtowinicon" (1)\c
83 \&,
84 .BR "ppm" (1)\c
85 \&
86
87 .UN author
88 .SH AUTHOR
89
90 Copyright (C) 1992 by David W. Sanderson.
91 .SH DOCUMENT SOURCE
92 This manual page was generated by the Netpbm tool 'makeman' from HTML
93 source. The master documentation is at
94 .IP
95 .B http://netpbm.sourceforge.net/doc/bmptopnm.html
96 .PP