Debian Codegraph @

upstream/debian-unstable/man1/jbigtopnm.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 "Jbigtopnm User Manual" 1 "28 July 2020" "netpbm documentation"
7
8 .SH NAME
9 jbigtopnm - JBIG to PNM image file converter
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBjbigtopnm\fP
15 [\fB-xmax\fP]
16 [\fB-ymax\fP]
17 [\fB-binary\fP]
18 [\fB-diagnose\fP]
19 [\fB-plane\fP]
20 [\fIinput-file\fP [\fIoutput-file\fP]]
21 .PP
22 Minimum unique abbreviation of option is acceptable. You may use double
23 hyphens instead of single hyphen to denote options. You may use white
24 space in place of the equals sign to separate an option name from its value.
25
26
27 .UN description
28 .SH DESCRIPTION
29 .PP
30 This program is part of
31 .BR "Netpbm" (1)\c
32 \&.
33 .PP
34 \fBjbigtopnm\fP reads a JBIG bi-level image entity (BIE) from a
35 file or standard input, decompresses it, and outputs a PBM or PGM
36 file. If the input has one plane, or you choose just one plane of it,
37 the output is PBM. Otherwise, the output is PGM.
38 .PP
39 JBIG is a highly effective lossless compression algorithm for
40 bi-level images (one bit per pixel), which is particularly suitable
41 for scanned document pages.
42 .PP
43 A JBIG encoded image can be stored in several resolutions in one or
44 several BIEs. All resolution layers except the lowest one are stored
45 efficiently as differences to the next lower resolution layer. You
46 can use options \fB-x\fP and \fB-y\fP to stop the decompression at a
47 specified maximal output image size. The input file can consist of
48 several concatenated BIEs which contain different increasing
49 resolution layers of the same image.
50
51 .UN options
52 .SH OPTIONS
53 .PP
54 In addition to the options common to all programs based on libnetpbm
55 (most notably \fB-quiet\fP, see
56 .UR index.html#commonoptions
57 Common Options
58 .UE
59 \&), \fBjbigtopnm\fP recognizes the following
60 command line options:
61 .PP
62 Before Netpbm 10.85 (December 2018), only single-character single-hyphen
63 abbreviations of the options are accepted.
64
65
66
67 .TP
68 \fB-xmax\fP \fInumber\fP
69 Decode only up to the largest resolution layer which is still not
70 more than \fInumber\fP pixels wide. If no such resolution layer
71 exists, then use the smallest one available.
72
73 .TP
74 \fB-ymax\fP\fI number\fP
75 Decode only up to the largest resolution layer which is still not
76 more than \fInumber\fP pixels high. If no such resolution layer
77 exists, then use the smallest one available. You can also use options
78 \fB-x\fP and \fB-y\fP together which selects the largest layer that
79 satisfies both limits.
80
81 .TP
82 \fB-binary\fP
83 Use binary values instead of Gray code words in order to decode
84 pixel values from multiple bitplanes. This option has effect only if
85 the input has more than one bitplane and you don't select just one of
86 those bitplanes. Note that the decoder has to be used in the same
87 mode as the encoder and cannot determine from the BIE, whether Gray or
88 binary code words were used by the encoder.
89
90 .TP
91 \fB-diagnose\fP
92 Diagnose a BIE. With this option, \fBjbigtopnm\fP only prints a
93 summary of the header information found in the input file and then
94 exits.
95
96 .TP
97 \fB-plane\fP\fI number\fP
98 If the input contains multiple bitplanes, then extract only the
99 specified single plane as a PBM file. The first plane has number 0.
100
101
102
103 .UN standards
104 .SH STANDARDS
105 .PP
106 This program implements the JBIG image coding algorithm as
107 specified in ISO/IEC 11544:1993 and ITU-T T.82(1993).
108
109 .UN author
110 .SH AUTHOR
111
112
113 .PP
114 \fBjbigtopnm\fP is based on the JBIG library by Markus Kuhn, part
115 of his
116 .UR http://www.cl.cam.ac.uk/~mgk25/jbigkit/
117 \fBJBIG-KIT\fP package
118 .UE
119 \&. The \fBjbgtopbm\fP program is part of the
120 \fBJBIG-KIT\fP package.
121 .PP
122 \fBjbigtopnm\fP is part of the Netpbm package of graphics tools.
123
124 .UN seealso
125 .SH SEE ALSO
126 .BR "pnm" (1)\c
127 \&,
128 .BR "pnmtojbig" (1)\c
129 \&
130
131 .UN license
132 .SH LICENSE
133 .PP
134 There was at one time concern about the need for patent licenses to
135 use \fBjbigtopnm\fP, but any relevant patents expired by 2012.
136 .SH DOCUMENT SOURCE
137 This manual page was generated by the Netpbm tool 'makeman' from HTML
138 source. The master documentation is at
139 .IP
140 .B http://netpbm.sourceforge.net/doc/jbigtopnm.html
141 .PP