grolbp(1) - man - phpMan

GROLBP(1)                              General Commands Manual                             GROLBP(1)



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

SYNOPSIS
       grolbp [-l] [-c num-copies] [-F font-directory] [-o orientation] [-p paper-size] [-w width]
              [file ...]
       grolbp [--copies=num-copies] [--fontdir=font-directory] [--landscape] [--linewidth=width]
              [--orientation=orientation] [--papersize=paper-size] [file ...]

       grolbp -h
       grolbp --help

       grolbp -v
       grolbp --version

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(1) 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 diagonally 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.

       -c num-copies
       --copies=num-copies
              Print num-copies copies of each page.

       -F font-directory
       --fontdir=font-directory
              Prepend  directory  font-directory/devname  to the search path for font and device de‐
              scription files; name is the name of the device, usually lbp.

       -h
       --help Print a short help text.

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

       -o orientation
       --orientation=orientation
              Print the document with orientation orientation, which must be  ‘portrait’  or  ‘land‐
              scape’.

       -p paper-size
       --papersize=paper-size
              Set  the paper size to paper-size, which must be a valid paper size description as in‐
              dicated in section “Paper Sizes”, below.

       -v
       --version
              Print the version number.

       -w width
       --linewidth=width
              Set the default line thickness to width thousandths of an em.  If  this  option  isn't
              specified, the line thickness defaults to 0.04 em.

TYPEFACES
       The  driver  supports  the  Dutch, Swiss and Swiss-Narrow scalable typefaces, each one in the
       Regular, Bold, Italic 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 command-line options to  grolbp.   If  the
       paper size is specified both ways, the command-line options take precedence over the contents
       of the DESC file (this applies to the page orientation too).

       See groff_font(5) 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 insensitive.

       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 op‐
       tion  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  letter,  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 cor‐
              responding 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 available font names and font sizes of bitmapped fonts (as documented  above)  are
              hard-coded into the program.

       •      For  scalable  fonts, printer_font_name is identical to the font name as it appears in
              the printer's font listing A.

              For instance, to select the ‘Swiss’ font in bold style, which appears in the printer's
              font listing A as ‘Swiss-Bold’, the required lbpname command 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
       /usr/share/groff/1.22.4/font/devlbp/DESC
              Device description file.

       /usr/share/groff/1.22.4/font/devlbp/F
              Font description file for font F.

       /usr/share/groff/1.22.4/tmac/lbp.tmac
              Macros for use with grolbp.

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



groff 1.22.4                                23 March 2022                                  GROLBP(1)