jbgtopbm man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD logo
[printable version]

JBGTOPBM(1)							   JBGTOPBM(1)

NAME
       jbgtopbm - JBIG1 to portable bitmap file converter

SYNOPSIS
       jbgtopbm [ options ] [ input-file | -  [ output-file ]]

DESCRIPTION
       Reads  in  a  JBIG1 bi-level image entity (BIE) from a file or standard
       input, decompresses it, and outputs a portable bitmap (PBM) file.

       JBIG1 is a highly effective lossless compression algorithm for bi-level
       images  (one bit per pixel), which is particularly suitable for scanned
       document pages.

       A JBIG1 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.  Options
       -x  and -y can be used to stop the decompression at a specified maximal
       output image size. With option -m the input file can consist of	multi‐
       ple  concatenated  BIEs	which  contain different increasing resolution
       layers of the same image.

       If more than one bit per pixel is stored in the JBIG1 file, then a  PGM
       file will be produced.

OPTIONS
       -	     A	single hyphen instead of an input file name will cause
		     jbgtopbm to read the data	from  standard	input  instead
		     from a file.

       -x number     Decode  only  up to the largest resolution layer which is
		     still not more than number pixels wide. If no such	 reso‐
		     lution layer exists, then use the smallest one available.

       -y number     Decode  only  up to the largest resolution layer which is
		     still not more than number pixels high. If no such	 reso‐
		     lution layer exists, then use the smallest one available.
		     Options -x and -y can also be used together in which case
		     the  largest  layer  that	satisfies  both limits will be
		     selected.

       -m	     Process multiple concatenated BIEs. If  there  are	 bytes
		     left after the final SDE in the first BIE, then with this
		     option jbgtopbm will attempt to decode these as the start
		     of	 another  BIE that may contain higher resolution data.
		     Normally, any remaining bytes  will  generate  a  warning
		     message.

       -b	     Use  binary values instead of Gray code words in order to
		     decode pixel values from multiple bitplanes. This	option
		     has  only	an  effect if the input has more than one bit‐
		     plane and a PGM output file is produced.  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.

       -d	     Diagnose  a  single  BIE. With this option, jbgtopbm will
		     print a summary of the header information	found  in  the
		     input file, followed by a list of all PSCD and ESC marker
		     sequences encountered  until  the	end  of	 the  file  is
		     reached.

       -p number     If	 the  input  contains multiple bitplanes, then extract
		     only the specified single plane as a PBM file. The	 first
		     plane has number 0.

BUGS
       Using  standard input and standard output for binary data works only on
       systems where there is no difference between binary  and	 text  streams
       (e.g.,  Unix). On other systems (e.g., MS-DOS), using standard input or
       standard output may cause control  characters  like  CR	or  LF	to  be
       inserted or deleted and this will damage the binary data.

STANDARDS
       This  program  implements the JBIG1 image coding algorithm as specified
       in ISO/IEC 11544:1993 and ITU-T T.82(1993).

AUTHOR
       The jbgtopbm program is part of the JBIG-KIT package,  which  has  been
       developed  by  Markus  Kuhn.   The most recent version of this portable
       JBIG1	library	   and	   tools     set     is	    available	  from
       <http://www.cl.cam.ac.uk/~mgk25/jbigkit/>.

SEE ALSO
       pbm(5), pgm(5), pbmtojbg(1)

				  2003-06-04			   JBGTOPBM(1)
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net