summary refs log tree commit diff
path: root/jbigtopnm.html
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2006-12-25 03:06:05 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2006-12-25 03:06:05 +0000
commit1017cbebe5d5edd859e0fddad0a8600f509f4821 (patch)
tree78bdf336648566f7a7d55f42837357dea3dd674c /jbigtopnm.html
parent16f2ac126651015a376eba864a3a35f738b0b25a (diff)
downloadnetpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.gz
netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.xz
netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.zip
Place user guide into Subversion repository
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@181 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'jbigtopnm.html')
-rw-r--r--jbigtopnm.html129
1 files changed, 129 insertions, 0 deletions
diff --git a/jbigtopnm.html b/jbigtopnm.html
new file mode 100644
index 00000000..4d92d1a0
--- /dev/null
+++ b/jbigtopnm.html
@@ -0,0 +1,129 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML><HEAD><TITLE>Jbigtopnm User Manual</TITLE></HEAD>
+<BODY>
+<H1>Jbigtopnm</H1>
+Updated: 19 November 2003
+<BR>
+<A HREF="#index">Table Of Contents</A>
+
+<A NAME="lbAB">&nbsp;</A>
+<H2>NAME</H2>
+jbigtopnm - JBIG to PNM image file converter
+
+<A NAME="lbAC">&nbsp;</A>
+<H2>SYNOPSIS</H2>
+
+<B>jbigtopnm</B>
+[<I>options</I>]
+[<I>input-file</I> [<I>output-file</I>]]
+
+<A NAME="lbAD">&nbsp;</A>
+<H2>DESCRIPTION</H2>
+
+<p>This program is part of <a href="index.html">Netpbm</a>.
+
+<p><b>jbigtopnm</b> 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.
+
+<P>JBIG is a highly effective lossless compression algorithm for
+bi-level images (one bit per pixel), which is particularly suitable
+for scanned document pages.
+
+<P>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 <B>-x</B> and <B>-y</B> 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.
+
+<A NAME="lbAE">&nbsp;</A>
+<H2>OPTIONS</H2>
+
+<DL COMPACT>
+
+<DT><B>-x</B> <I>number</I>
+
+<DD>Decode only up to the largest resolution layer which is still not
+more than <I>number</I> pixels wide.  If no such resolution layer
+exists, then use the smallest one available.
+
+<DT><B>-y</B><I> number</I>
+
+<DD>Decode only up to the largest resolution layer which is still not
+more than <I>number</I> pixels high.  If no such resolution layer
+exists, then use the smallest one available.  You can also use options
+<B>-x</B> and <B>-y</B> together which selects the largest layer that
+satisfies both limits.
+
+<DT><B>-b</B>
+
+<DD>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.
+
+<DT><B>-d</B>
+
+<DD>Diagnose a BIE.  With this option, <B>jbigtopnm</B> only prints a
+summary of the header information found in the input file and then
+exits.
+
+<DT><B>-p</B><I> number</I>
+
+<DD>If the input contains multiple bitplanes, then extract only the
+specified single plane as a PBM file.  The first plane has number 0.
+
+</DL>
+
+<A NAME="lbAF">&nbsp;</A>
+<H2>STANDARDS</H2>
+
+<p>This program implements the JBIG image coding algorithm as
+specified in ISO/IEC 11544:1993 and ITU-T T.82(1993).
+
+<A NAME="lbAG">&nbsp;</A>
+<H2>AUTHOR</H2>
+
+<!-- jbgtopnm below is not a typo.  It is not meant to be jbigtopnm -->
+<p><B>jbigtopnm</B> is based on the JBIG library by Markus Kuhn, part
+of his <a
+href="http://www.cl.cam.ac.uk/~mgk25/jbigkit/"><B>JBIG-KIT</B>
+package</a>.  The <B>jbgtopbm</B> program is part of the
+<B>JBIG-KIT</B> package.
+
+<P><B>jbigtopnm</B> is part of the Netpbm package of graphics tools.
+
+<A NAME="lbAH">&nbsp;</A>
+<H2>SEE ALSO</H2>
+
+<B><A HREF="pnm.html">pnm</A></B>,
+<B><A HREF="pnmtojbig.html">pnmtojbig</A></B>
+
+<A NAME="lbAI">&nbsp;</A>
+<H2>LICENSE</H2>
+
+If you use <B>jbigtopnm</B>, you are using various patents,
+particularly on its arithmetic encoding method, and in all probability
+you do not have a license from the patent owners to do so.
+
+<HR>
+<A NAME="index">&nbsp;</A><H2>Table Of Contents</H2>
+<UL>
+<LI><A HREF="#lbAB">NAME</A>
+<LI><A HREF="#lbAC">SYNOPSIS</A>
+<LI><A HREF="#lbAD">DESCRIPTION</A>
+<LI><A HREF="#lbAE">OPTIONS</A>
+<LI><A HREF="#lbAF">STANDARDS</A>
+<LI><A HREF="#lbAG">AUTHOR</A>
+<LI><A HREF="#lbAH">SEE ALSO</A>
+<LI><A HREF="#lbAI">LICENSE</A>
+</UL>
+</BODY>
+</HTML>
+
+