diff options
Diffstat (limited to 'upstream/fedora-40/man1/jbigtopnm.1')
-rw-r--r-- | upstream/fedora-40/man1/jbigtopnm.1 | 141 |
1 files changed, 141 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/jbigtopnm.1 b/upstream/fedora-40/man1/jbigtopnm.1 new file mode 100644 index 00000000..88c6ab8f --- /dev/null +++ b/upstream/fedora-40/man1/jbigtopnm.1 @@ -0,0 +1,141 @@ +\ +.\" 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 "Jbigtopnm User Manual" 0 "28 July 2020" "netpbm documentation" + +.SH NAME +jbigtopnm - JBIG to PNM image file converter + +.UN synopsis +.SH SYNOPSIS + +\fBjbigtopnm\fP +[\fB-xmax\fP] +[\fB-ymax\fP] +[\fB-binary\fP] +[\fB-diagnose\fP] +[\fB-plane\fP] +[\fIinput-file\fP [\fIoutput-file\fP]] +.PP +Minimum unique abbreviation of option is acceptable. You may use double +hyphens instead of single hyphen to denote options. You may use white +space in place of the equals sign to separate an option name from its value. + + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBjbigtopnm\fP reads a JBIG bi-level image entity (BIE) from a +file or standard input, decompresses it, and outputs a PBM or PGM +file. If the input has one plane, or you choose just one plane of it, +the output is PBM. Otherwise, the output is PGM. +.PP +JBIG is a highly effective lossless compression algorithm for +bi-level images (one bit per pixel), which is particularly suitable +for scanned document pages. +.PP +A JBIG encoded image can be stored in several resolutions in one or +several BIEs. All resolution layers except the lowest one are stored +efficiently as differences to the next lower resolution layer. You +can use options \fB-x\fP and \fB-y\fP to stop the decompression at a +specified maximal output image size. The input file can consist of +several concatenated BIEs which contain different increasing +resolution layers of the same image. + +.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 +\&), \fBjbigtopnm\fP recognizes the following +command line options: +.PP +Before Netpbm 10.85 (December 2018), only single-character single-hyphen +abbreviations of the options are accepted. + + + +.TP +\fB-xmax\fP \fInumber\fP +Decode only up to the largest resolution layer which is still not +more than \fInumber\fP pixels wide. If no such resolution layer +exists, then use the smallest one available. + +.TP +\fB-ymax\fP\fI number\fP +Decode only up to the largest resolution layer which is still not +more than \fInumber\fP pixels high. If no such resolution layer +exists, then use the smallest one available. You can also use options +\fB-x\fP and \fB-y\fP together which selects the largest layer that +satisfies both limits. + +.TP +\fB-binary\fP +Use binary values instead of Gray code words in order to decode +pixel values from multiple bitplanes. This option has effect only if +the input has more than one bitplane and you don't select just one of +those bitplanes. Note that the decoder has to be used in the same +mode as the encoder and cannot determine from the BIE, whether Gray or +binary code words were used by the encoder. + +.TP +\fB-diagnose\fP +Diagnose a BIE. With this option, \fBjbigtopnm\fP only prints a +summary of the header information found in the input file and then +exits. + +.TP +\fB-plane\fP\fI number\fP +If the input contains multiple bitplanes, then extract only the +specified single plane as a PBM file. The first plane has number 0. + + + +.UN standards +.SH STANDARDS +.PP +This program implements the JBIG image coding algorithm as +specified in ISO/IEC 11544:1993 and ITU-T T.82(1993). + +.UN author +.SH AUTHOR + + +.PP +\fBjbigtopnm\fP is based on the JBIG library by Markus Kuhn, part +of his +.UR http://www.cl.cam.ac.uk/~mgk25/jbigkit/ +\fBJBIG-KIT\fP package +.UE +\&. The \fBjbgtopbm\fP program is part of the +\fBJBIG-KIT\fP package. +.PP +\fBjbigtopnm\fP is part of the Netpbm package of graphics tools. + +.UN seealso +.SH SEE ALSO +.BR "pnm" (1)\c +\&, +.BR "pnmtojbig" (1)\c +\& + +.UN license +.SH LICENSE +.PP +There was at one time concern about the need for patent licenses to +use \fBjbigtopnm\fP, but any relevant patents expired by 2012. +.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/jbigtopnm.html +.PP
\ No newline at end of file |