root/gsdl/trunk/trunk/mg/man/man1/mgbilevel.1 @ 16583

Revision 16583, 2.4 KB (checked in by davidb, 12 years ago)

Undoing change commited in r16582

  • Property svn:executable set to *
  • Property svn:keywords set to Author Date Id Revision
Line 
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$
8.\"------------------------------------------------------------
9.TH mgbilevel 1 \*(Dt CITRI
10.SH NAME
11mgbilevel \- 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
24or
25.fi
26.B mgbilevel
27.B \-d
28.I compressed-infile
29[
30.I \>outfile
31]
32.SH DESCRIPTION
33.B mgbilevel
34performs (up to) a two-stage template-based compression.  The
35user can specify the template to be used in the compression process.  The
36default template size is a two-stage template 22/10.  The compressed file
37contains the template type in the stream.  The output files are written
38to
39.IR stdout .
40.SH OPTIONS
41Options may appear in any order.
42.TP "\w'\fB\-t\fP \fI\*(lqstring\*(rq\fP'u+2n"
43.B \-h
44This displays a usage line on
45.IR stderr .
46.TP
47.B \-e
48Compresses
49.I infile
50using a template specified, and writes to
51.IR compressed-outfile .
52.TP
53.B \-d
54Decompresses
55.I compressed-infile
56using the template contained in the compressed file.  Writes to
57.IR outfile .
58.TP
59\fB\-t \fP\fI\*(lqstring\*(rq\fP
60This option specifies which template combination is to
61be used in the compression.  Five different characters
62can occur in the string: `.' for a pixel not
63included in the template, `p' for a pixel included in the 1st
64level template, `2' for a pixel included in the 2nd level
65template (a subset of the 1st level), `*' denoting the position
66of the
67.I current
68pixel, and a `;' denoting the end of each template line.
69The default template is a two-level 22/10 template:
70.IP
71.RS
72.nf
73\&.ppppp.;
74pp222pp;
75p22222p;
76p22*.\|.\|.;
77.fi
78.RE
79.IP
80This 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
86This is the input
87.I .pbm
88file to be compressed.
89.TP
90.I outfile
91This is the decompressed
92.I .pbm
93file.
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).
Note: See TracBrowser for help on using the browser.