mgbilevel(1)

NAME
mgbilevel - compresses a bilevel image using a specified template

SYNOPSIS
mgbilevel -e [ -t “string” ] infile [ >compressed-outfile ]
or
mgbilevel -d compressed-infile [ >outfile ]

DESCRIPTION
mgbilevel performs (up to) a two-stage template-based compression. The user can specify the template to be used in the compression process. The default template size is a two-stage template 22/10. The compressed file contains the template type in the stream. The output files are written to stdout.

OPTIONS
Options may appear in any order.

-h  This displays a usage line on stderr.

-e  Compresses infile using a template specified, and writes to compressed-outfile.

-d  Decompresses compressed-infile using the template contained in the compressed file. Writes to outfile.

-t “string”
    This option specifies which template combination is to be used in the compression. Five different characters can occur in the string: `.' for a pixel not included in the template, `p' for a pixel included in the 1st level template, `2' for a pixel included in the 2nd level template (a subset of the 1st level), `*' denoting the position of the current pixel, and a `;' denoting the end of each template line. The default template is a two-level 22/10 template:

    .ppppp.;
    pp222pp;
    p22222p;
    p22*...;

    This would be specified on the command line as:
    -T ".ppppp.;pp222pp;p22222p;p22*...;"

infile
    This is the input .pbm file to be compressed.

outfile
    This is the decompressed .pbm file.

SEE ALSO
mg(1), mg_compression_dict(1), mg_fast_comp_dict(1), mg_get(1), mg_invf_dict(1), mg_invf_dump(1), mg_invf_rebuild(1), mg_passes(1), mg_perf_hash_build(1), mg_text_estimate(1), mg_weights_build(1), mgbuild(1), mgdictlist(1), mgfelics(1), mgquery(1), mgstat(1), mgtic(1), mgticbuild(1), mgticdump(1), mgticprune(1), mgticstat(1).