GROLBP(1)                                             GROLBP(1)



NAME
       grolbp  -  groff  driver for Canon CAPSL printers (LBP-4
       and LBP-8 series laser printers).

SYNOPSIS
       grolpb [ -l ] [ --landscape ] [ -v ] [ --version ]
              [ -cn ] [ --copies=numcopies ] [ -ppaper_size ]
              [ --papersize=paper_size ] [ -oorientation ]
              [ --orientation=orientation ] [ -wwidth ]
              [ --linewidth=width ] [ -Fdir ] [ --fontdir=dir ]
              [ -h ] [ --help ] [ files... ]

DESCRIPTION
       grolbp  is  a  driver  for groff that produces output in
       CAPSL and VDM format suitable for Canon LBP-4 and  LBP-8
       printers.

       For  compatibility  with  grolj4  there is an additional
       drawing command available:

       \D'R dh dv'
              Draw a rule (i.e. a solid black rectangle),  with
              one corner at the current position, and the diag-
              onally opposite corner at  the  current  position
              +(dh,dv).

OPTIONS
       Note  that  there can be whitespace between a one-letter
       option and its argument; on the other hand,  there  must
       be whitespace and/or an equal sign (`=') between a long-
       name option and its argument.

       -cnumcopies
       --copies=numcopies
              Print numcopies copies of each page.

       -l
       --landscape
              Print the document with a landscape  orientation.

       -ppaper_size
       --papersize=paper_size
              Set the paper size to paper_size, which must be a
              valid paper size description as indicated in  the
              section PAPER SIZES.

       -oorientation
       --orientation=orientation
              Print  the document with orientation orientation,
              which must be `portrait' or `landscape'.

       -wwidth
       --linewidth=width
              Set the default line  thickness  to  width  thou-
              sandths  of  an  em.  If this option isn't speci-
              fied, the line thickness defaults to 0.04 em.

       -v
       --version
              Print the version number.

       -Fdir
       --fontdir=dir
              Prepend directory dir/devname to the search  path
              for  font  and  device description files; name is
              the name of the device, usually lbp.

       -h
       --help Print a short help text.

TYPEFACES
       The driver supports the Dutch,  Swiss  and  Swiss-Narrow
       scalable typefaces, each one in the Regular, Bold, Ital-
       ic and Bold-Italic styles.   Additionally,  the  Courier
       and  Elite  monospaced  typefaces  at the sizes 8 and 12
       points (for Courier) resp. 8 and 10 points  (for  Elite)
       are  supported, each one in the Regular, Bold and Italic
       styles.

       The following chart summarizes the font  names  you  can
       use to access these fonts:


   +----------------+-----------+--------+----------+--------------+
   |   Typeface     |  Regular  |  Bold  |  Italic  |  Bold-Italic |
   +----------------+-----------+--------+----------+--------------+
   | Dutch          |    TR     |   TB   |    TI    |      TBI     |
   +----------------+-----------+--------+----------+--------------+
   | Swiss          |    HR     |   HB   |    HI    |      HBI     |
   +----------------+-----------+--------+----------+--------------+
   | Swiss Narrow   |    HNR    |  HNB   |   HNI    |     HNBI     |
   +----------------+-----------+--------+----------+--------------+
   | Courier        |    CR     |   CB   |    CI    |              |
   +----------------+-----------+--------+----------+--------------+
   | Elite          |    ER     |   EB   |    EI    |              |
   +----------------+-----------+--------+----------+--------------+
PAPER SIZES
       The  paper size can be set in the DESC file or with com-
       mand line options to grolbp.  If the paper size is spec-
       ified  both  ways,  the command line options take prece-
       dence over the contents of the DESC file  (this  applies
       to the page orientation too).

       See groff_font(1) how to set the paper dimensions in the
       DESC file.

       To set the paper size in the command line, add

         -p paper-size

       or

         --papersize=paper-size

       to the other grolbp options, where paper-size is in  the
       same format as in the DESC file.

       If  no  paper  size is specified in the DESC file or the
       command line, a default size of A4 is used.

PAGE ORIENTATION
       As with the page size, the orientation  of  the  printed
       page (portrait or landscape) can be set in the DESC file
       or with command line options.  It is also case  insensi-
       tive.

       To  set  the orientation in the DESC file, insert a line
       with the following content:

         orientation [portrait|landscape]

       Only the first valid orientation  command  in  the  DESC
       file is used.

       To  set  the  page orientation with command line options
       you can use the -o or --orientation option with the same
       parameters  (portrait or landscape) as in the DESC file.
       Or you can use the -l option to force the  pages  to  be
       printed in landscape.

FONT FILE FORMAT
       In   addition   to   the  usual  commands  described  in
       groff_font(5), grolbp provides the command lbpname which
       sets  the  font name sent to the printer when requesting
       this font.  The syntax of this command is:

         lbpname printer_font_name

             For bitmapped fonts,  printer_font_name  has  the
              form

                N<base_fontname><font_style>

              base_fontname  is  the font name as it appears in
              the printers font listings without the first let-
              ter,  up  to  (but  not including) the font size.
              font_style can be one of the letters R, I, or  B,
              indicating the font styles Roman, Italic and Bold
              respectively.

              For instance, if the  printer's  font  listing  A
              shows font `Nelite12I.ISO_USA', the corresponding
              entry in the font description file is

                lbpname NeliteI

              Note that you may need to modify  grolbp  to  add
              support for new bitmapped fonts, since the avail-
              able font names and font sizes of bitmapped fonts
              (as  documented  above)  are  hard-coded into the
              program.

             For scalable fonts, printer_font_name is  identi-
              cal  to the font name as it appears in the print-
              er's font listing A.

              For instance, to select the `Swiss' font in  bold
              style,  which appears in the printer's font list-
              ing A as `Swiss-Bold', the required lbpname  com-
              mand line is

                lbpname Swiss-Bold


       The argument of lbpname is case sensitive.

ENVIRONMENT
       GROFF_FONT_PATH
              A  list of directories in which to search for the
              devname directory  in  addition  to  the  default
              ones.   See  troff(1)  and groff_font(5) for more
              details.

FILES
       c:/progra~1/groff/share/groff/1.20/font/devlbp/DESC
              Device description file.

       c:/progra~1/groff/share/groff/1.20/font/devlbp/F
              Font description file for font F.

       c:/progra~1/groff/share/groff/1.20/tmac/lbp.tmac
              Macros for use with grolbp.

SEE ALSO
       groff(1),   troff(1),    groff_out(5),    groff_font(5),
       groff_char(7)



Groff Version 1.20       5 January 2009               GROLBP(1)
