| 1 | .\"------------------------------------------------------------
|
|---|
| 2 | .\" Id - set Rv,revision, and Dt, Date using rcs-Id tag.
|
|---|
| 3 | .de Id
|
|---|
| 4 | .ds Rv \\$3
|
|---|
| 5 | .ds Dt \\$4
|
|---|
| 6 | ..
|
|---|
| 7 | .Id $Id: mgbilevel.1 16583 2008-07-29 10:20:36Z davidb $
|
|---|
| 8 | .\"------------------------------------------------------------
|
|---|
| 9 | .TH mgbilevel 1 \*(Dt CITRI
|
|---|
| 10 | .SH NAME
|
|---|
| 11 | mgbilevel \- compresses a bilevel image using a specified template
|
|---|
| 12 | .SH SYNOPSIS
|
|---|
| 13 | .B mgbilevel
|
|---|
| 14 | .B \-e
|
|---|
| 15 | [
|
|---|
| 16 | .B \-t
|
|---|
| 17 | .I \*(lqstring\*(rq
|
|---|
| 18 | ]
|
|---|
| 19 | .I infile
|
|---|
| 20 | [
|
|---|
| 21 | .I \>compressed-outfile
|
|---|
| 22 | ]
|
|---|
| 23 | .nf
|
|---|
| 24 | or
|
|---|
| 25 | .fi
|
|---|
| 26 | .B mgbilevel
|
|---|
| 27 | .B \-d
|
|---|
| 28 | .I compressed-infile
|
|---|
| 29 | [
|
|---|
| 30 | .I \>outfile
|
|---|
| 31 | ]
|
|---|
| 32 | .SH DESCRIPTION
|
|---|
| 33 | .B mgbilevel
|
|---|
| 34 | performs (up to) a two-stage template-based compression. The
|
|---|
| 35 | user can specify the template to be used in the compression process. The
|
|---|
| 36 | default template size is a two-stage template 22/10. The compressed file
|
|---|
| 37 | contains the template type in the stream. The output files are written
|
|---|
| 38 | to
|
|---|
| 39 | .IR stdout .
|
|---|
| 40 | .SH OPTIONS
|
|---|
| 41 | Options may appear in any order.
|
|---|
| 42 | .TP "\w'\fB\-t\fP \fI\*(lqstring\*(rq\fP'u+2n"
|
|---|
| 43 | .B \-h
|
|---|
| 44 | This displays a usage line on
|
|---|
| 45 | .IR stderr .
|
|---|
| 46 | .TP
|
|---|
| 47 | .B \-e
|
|---|
| 48 | Compresses
|
|---|
| 49 | .I infile
|
|---|
| 50 | using a template specified, and writes to
|
|---|
| 51 | .IR compressed-outfile .
|
|---|
| 52 | .TP
|
|---|
| 53 | .B \-d
|
|---|
| 54 | Decompresses
|
|---|
| 55 | .I compressed-infile
|
|---|
| 56 | using the template contained in the compressed file. Writes to
|
|---|
| 57 | .IR outfile .
|
|---|
| 58 | .TP
|
|---|
| 59 | \fB\-t \fP\fI\*(lqstring\*(rq\fP
|
|---|
| 60 | This option specifies which template combination is to
|
|---|
| 61 | be used in the compression. Five different characters
|
|---|
| 62 | can occur in the string: `.' for a pixel not
|
|---|
| 63 | included in the template, `p' for a pixel included in the 1st
|
|---|
| 64 | level template, `2' for a pixel included in the 2nd level
|
|---|
| 65 | template (a subset of the 1st level), `*' denoting the position
|
|---|
| 66 | of the
|
|---|
| 67 | .I current
|
|---|
| 68 | pixel, and a `;' denoting the end of each template line.
|
|---|
| 69 | The default template is a two-level 22/10 template:
|
|---|
| 70 | .IP
|
|---|
| 71 | .RS
|
|---|
| 72 | .nf
|
|---|
| 73 | \&.ppppp.;
|
|---|
| 74 | pp222pp;
|
|---|
| 75 | p22222p;
|
|---|
| 76 | p22*.\|.\|.;
|
|---|
| 77 | .fi
|
|---|
| 78 | .RE
|
|---|
| 79 | .IP
|
|---|
| 80 | This would be specified on the command line as:
|
|---|
| 81 | .nf
|
|---|
| 82 | \&\fB\-T\fP ".ppppp.;pp222pp;p22222p;p22*.\|.\|.;"
|
|---|
| 83 | .fi
|
|---|
| 84 | .TP
|
|---|
| 85 | .I infile
|
|---|
| 86 | This is the input
|
|---|
| 87 | .I .pbm
|
|---|
| 88 | file to be compressed.
|
|---|
| 89 | .TP
|
|---|
| 90 | .I outfile
|
|---|
| 91 | This is the decompressed
|
|---|
| 92 | .I .pbm
|
|---|
| 93 | file.
|
|---|
| 94 | .SH "SEE ALSO"
|
|---|
| 95 | .na
|
|---|
| 96 | .BR mg (1),
|
|---|
| 97 | .BR mg_compression_dict (1),
|
|---|
| 98 | .BR mg_fast_comp_dict (1),
|
|---|
| 99 | .BR mg_get (1),
|
|---|
| 100 | .BR mg_invf_dict (1),
|
|---|
| 101 | .BR mg_invf_dump (1),
|
|---|
| 102 | .BR mg_invf_rebuild (1),
|
|---|
| 103 | .BR mg_passes (1),
|
|---|
| 104 | .BR mg_perf_hash_build (1),
|
|---|
| 105 | .BR mg_text_estimate (1),
|
|---|
| 106 | .BR mg_weights_build (1),
|
|---|
| 107 | .BR mgbuild (1),
|
|---|
| 108 | .BR mgdictlist (1),
|
|---|
| 109 | .BR mgfelics (1),
|
|---|
| 110 | .BR mgquery (1),
|
|---|
| 111 | .BR mgstat (1),
|
|---|
| 112 | .BR mgtic (1),
|
|---|
| 113 | .BR mgticbuild (1),
|
|---|
| 114 | .BR mgticdump (1),
|
|---|
| 115 | .BR mgticprune (1),
|
|---|
| 116 | .BR mgticstat (1).
|
|---|
