PCL/Simple version 1.01
=======================

NAME

    PCL::Simple - Create PCL for printing plain text files

SYNOPSIS

      use PCL::Simple qw( PCL_pre PCL_post );

      open PLAIN,  '<plain_file.txt'         or die;
      open SNAZZY, '>ready_for_printing.txt' or die;

      print SNAZZY PCL_pre( -w => 132, -lpp => 66 );
      print SNAZZY while (<PLAIN>);
      print SNAZZY PCL_post;

      close PLAIN;
      close SNAZZY;

DESCRIPTION

    PCL::Simple will provide PCL strings that cause your printer to print
    a plain text file with *exactly* the right font -- i.e. the exact font
    needed to fill the page with as many fixed width characters across
    and down as you specify.

    In addition to providing for your desired width and height layout, the
    provided PCL strings will also cause the printer to honor your other
    desires regarding paper size, paper orientation, sides printed, and
    number of copies.

USAGE

    Two functions are exportable: PCL_pre and PCL_post.

    PCL_post takes no parameters, it simply returns a string containing the
    "Printer Reset Command" and "Universal Exit Language Command" as
    specified by PCL documentation. This string is meant for appending to
    the end of your plain text document.

    PCL_pre takes a list or an href of key value pairs and returns a PCL
    string for insertion at the beginning of your plain text document.
    PCL_pre Paramaters are:

    "-w"
      Width (Required)

    "-lpp"
      Lines Per Page (Required)

    "-ms"
      Media Size defaults to letter. Valid values are: executive, letter,
      legal, ledger, a4, a3, monarch, com-10, d1, c5, b5

    "-msrc"
      Media Source is not set by default.  Valid values are:
      numbers from 0 to 69.  Generally refers to paper trays or
      feeders.  See your printer documentation for details.

    "-o"
      Orientation defaults to portrait. Valid values are: landscape,
      portrait.

    "-s"
      Sides defaults to 0. Valid values are: 0 (Single), 1 (Double Long), 2
      (Double Short)

    "-c"
      Copies defaults to 1.

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

  None

BUGS

  PCL_pre will often slightly undersize the font for landscape orientations,
  such that one extra character might fit the page.  This means the printed
  page will have a *slightly* larger right margin than left.

COPYRIGHT AND LICENCE

Copyright (C) 2002 Phil R Lawrence.  All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.