version 1, including all changes.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
JBIGTOPNM |
|
|
2 |
!!!JBIGTOPNM |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
OPTIONS |
|
|
7 |
STANDARDS |
|
|
8 |
AUTHOR |
|
|
9 |
SEE ALSO |
|
|
10 |
LICENSE |
|
|
11 |
---- |
|
|
12 |
!!NAME |
|
|
13 |
|
|
|
14 |
|
|
|
15 |
jbigtopnm - JBIG to PNM image file converter |
|
|
16 |
!!SYNOPSIS |
|
|
17 |
|
|
|
18 |
|
|
|
19 |
__jbigtopnm__ [[ ''options'' ] [[ ''input-file'' | - |
|
|
20 |
[[ ''output-file'' ]] |
|
|
21 |
!!DESCRIPTION |
|
|
22 |
|
|
|
23 |
|
|
|
24 |
Reads in a ''JBIG'' bi-level image entity (BIE) from a |
|
|
25 |
file or standard input, decompresses it, and outputs a PBM |
|
|
26 |
or PGM file. If the input has one plane, or you choose just |
|
|
27 |
one plane of it, the output is PBM. Otherwise, the output is |
|
|
28 |
PGM. |
|
|
29 |
|
|
|
30 |
|
|
|
31 |
''JBIG'' is a highly effective lossless compression |
|
|
32 |
algorithm for bi-level images (one bit per pixel), which is |
|
|
33 |
particularly suitable for scanned document |
|
|
34 |
pages. |
|
|
35 |
|
|
|
36 |
|
|
|
37 |
A ''JBIG'' encoded image can be stored in several |
|
|
38 |
resolutions in one or several BIEs. All resolution layers |
|
|
39 |
except the lowest one are stored efficiently as differences |
|
|
40 |
to the next lower resolution layer. Options __-x__ and |
|
|
41 |
__-y__ can be used to stop the decompression at a |
|
|
42 |
specified maximal output image size. The input file can |
|
|
43 |
consist of several concatenated BIEs which contain different |
|
|
44 |
increasing resolution layers of the same image. |
|
|
45 |
!!OPTIONS |
|
|
46 |
|
|
|
47 |
|
|
|
48 |
__-__ A single hyphen instead of an input file name will |
|
|
49 |
cause __jbigtopnm__ to read the data from standard input |
|
|
50 |
instead from a file. |
|
|
51 |
|
|
|
52 |
|
|
|
53 |
__-x__ ''number'' |
|
|
54 |
|
|
|
55 |
|
|
|
56 |
Decode only up to the largest resolution layer which is |
|
|
57 |
still not more than ''number'' pixels wide. If no such |
|
|
58 |
resolution layer exists, then use the smallest one |
|
|
59 |
available. |
|
|
60 |
|
|
|
61 |
|
|
|
62 |
__-y__ ''number'' |
|
|
63 |
|
|
|
64 |
|
|
|
65 |
Decode only up to the largest resolution layer which is |
|
|
66 |
still not more than ''number'' pixels high. If no such |
|
|
67 |
resolution layer exists, then use the smallest one |
|
|
68 |
available. Options __-x__ and __-y__ can also be used |
|
|
69 |
together in which case the largest layer that satisfies both |
|
|
70 |
limits will be selected. |
|
|
71 |
|
|
|
72 |
|
|
|
73 |
__-b__ Use binary values instead of Gray code words in |
|
|
74 |
order to decode pixel values from multiple bitplanes. This |
|
|
75 |
option has only an effect if the input has more than one |
|
|
76 |
bitplane and you don't select just one of those bitplanes. |
|
|
77 |
Note that the decoder has to be used in the same mode as the |
|
|
78 |
encoder and cannot determine from the BIE, whether Gray or |
|
|
79 |
binary code words were used by the encoder. |
|
|
80 |
|
|
|
81 |
|
|
|
82 |
__-d__ Diagnose a BIE. With this option, __jbigtopnm__ |
|
|
83 |
will only print a summary of the header information found in |
|
|
84 |
the input file and then exit. |
|
|
85 |
|
|
|
86 |
|
|
|
87 |
__-p__ ''number'' |
|
|
88 |
|
|
|
89 |
|
|
|
90 |
If the input contains multiple bitplanes, then extract only |
|
|
91 |
the specified single plane as a PBM file. The first plane |
|
|
92 |
has number 0. |
|
|
93 |
!!STANDARDS |
|
|
94 |
|
|
|
95 |
|
|
|
96 |
This program implements the ''JBIG'' image coding |
|
|
97 |
algorithm as specified in ISO/IEC 11544:1993 and ITU-T |
|
|
98 |
T.82(1993). |
|
|
99 |
!!AUTHOR |
|
|
100 |
|
|
|
101 |
|
|
|
102 |
The __jbigtopnm__ is based on the ''JBIG'' library by |
|
|
103 |
Markus Kuhn, part of his __JBIG-KIT__ package. The |
|
|
104 |
__jbgtopbm__ program is part of the ''JBIG-KIT'' |
|
|
105 |
package. The most recent version of that library and tools |
|
|
106 |
set is freely available on the Internet from anonymous ftp |
|
|
107 |
server ftp.informatik.uni-erlangen.de in directory |
|
|
108 |
pub/doc/ISO/JBIG/. |
|
|
109 |
|
|
|
110 |
|
|
|
111 |
__jbigtopnm__ is part of the Netpbm package of graphics |
|
|
112 |
tools. |
|
|
113 |
!!SEE ALSO |
|
|
114 |
|
|
|
115 |
|
|
|
116 |
pbm(5),pgm(5),pbmtojbg(1) |
|
|
117 |
!!LICENSE |
|
|
118 |
|
|
|
119 |
|
|
|
120 |
If you use __jbigtopnm__, you are using various patents, |
|
|
121 |
particularly on its arithmetic encoding method, and in all |
|
|
122 |
probability you do not have a license from the patent owners |
|
|
123 |
to do so. |
|
|
124 |
---- |