HPGL2(1) BSD HPGL2(1)
NAME
man hpgl2 - help in using an HP HP-GL/2 plotter. Use along with
man lpr - help in using the BSD lpr print command
SYNOPSIS
For Aegis print environment use /sys/help/hpgl2.hlp
For UNIX BSD4.3 print environment use /usr/man/cat1/hpgl2.1
For UNIX Sys5.3 print environment use /usr/catman/a_man/man1/hpgl2.1m
DESCRIPTION
Beginning at "SR10.4 '94 Update", Domain/OS includes standard support
for the HP-GL/2 plotters shown in Table 1 below.
Table 1
Supported HP-GL/2 Plotters
-----------------------------------------
| HP 7600 Model 250 |
| HP 7600 Model 255 |
| HP 7600 Model 355 |
| HP DraftMaster SX |
| HP DraftMaster RX |
| HP DraftMaster MX |
| HP PaintJet XL (w/ HP-GL/2 cartridge) |
| HP PaintJet XL300 |
| HP DesignJet 650C |
-----------------------------------------
HP-GL/2 support allows the printing of CGM files and raw HP-GL/2
files on any of the supported plotters in their native HP-GL/2 format.
Included is a new Aegis driver called "hpgl2", and a CGM-to-HP-GL/2
filter for the Aegis, BSD, and SysV print environments.
AUTOMATED PROCESSING REQUIREMENTS
For the automatic processing of CGM and HP-GL/2 files to work
correctly, they must conform to the following guidelines:
CGM files must:
o Be based on the ANSI Specification
o Start with the BEGIN METAFILE element
HP-GL/2 files must:
o Conform to the HP Hyperdriver Specification
o Start with <ESC>%-1B sequence
The CGM-to-HP/GL2 translator automatically adds the <ESC>%-1B
sequence. If you are plotting a file where this sequence is not
present, you must use the prf -transparent command line option.
THE CGM-TO-HPGL2 TRANSLATOR
The CGM-to-HP-GL/2 translator reads a binary CGM file and generates
the corresponding HP-GL/2 instructions. Supported plotters must
conform to the HP-GL/2 Vector Graphics Kernel, Technical Graphics
Extensions, and Palette Extensions. The translator supports a
subset of the CGM specification as defined in APPENDIX B of the
file /sys/hpgl2/hpgl2_setup_instructions. A CGM file which does
not conform to this application profile may not plot properly. A
debug option is supported on the translator to help determine this
(see below).
The CGM-to-HP-GL/2 translator has a number of supported options
that must be specified in a BSD plotter configuration file. This
file must be located in the /sys/hpgl2 directory and named
either bsd.cfg or plotter_name.cfg, where plotter_name is the
name of the plotter specified in the /etc/printcap file.
See the file /sys/hpgl2/hpgl2_setup_instructions for information
on setting up your BSD environment for HP-GL/2 plotting and the
use of the plotter config file.
The following options are supported by the CGM-to-HP-GL/2
translator in the BSD plotter config file:
-Pc1,c2,c3,c4,c5,c6,c7,c8
Set this option when the target device is a pen plotter.
c1..c8 are optional pen color parameters. Valid colors are
shown below and are specified using the first three letters
of its name (with the exception of red-violet):
Color Specification on -P line
-----------------------------------------
green gre
aqua aqu
red red
blue blu
black bla
red-violet rdv
brown bro
violet vio
orange ora
yellow yel
If less than 8 pens are loaded, they MUST be loaded in the
first n slots.
Example: -Pgre,blu,rdv
Specifies that pen 1 is green, pen 2 is blue, and
pen 3 is red-violet.
-P
Use this option without pen colors specified to use the default
pen color palette shown below:
Pen Number Pen Color
-------------------------
0 white
1 black
2 red
3 green
4 yellow
5 blue
6 violet
7 aqua
8 orange
NOTE: You cannot use -Pc1..c8 and -P together. Specify only
one of these two options.
-R
Rotates the plot 90 degrees on the medium. Normally, the plot
is oriented so that the long axis of the paper is plotted as
the X axis.
-Sx,y
Forces the plot to scale to a size of x by y millimeters. This
option forces the plot to fit in an x by y square millimeter
area. To accomplish this, the HP-GL/2 space is scaled so that
the CGM VDC EXTENT is completely contained within this area,
regardless of the CGM SCALING MODE.
NOTE: The plot will usually be rendered smaller than the
specified x by y dimensions since the VDC EXTENT is
usually greater than the actual plot size.
-Qn
Selects the plotting quality level. n = [0..100].
The default quality level is plotter dependent.
-Mn
Specifies plotter medium type.
n = one of:
n Media
--------------------
0 paper (default)
1 transparency
2 vellum
3 polyester film
4 translucent paper
5 special paper
The following CGM-to-HP-GL/2 translator options are for debugging
purposes only.
-I
Dump contents of the CGM file (elements and values) into
the error file /tmp/hpgl2.err.printer_name. Use this
option to help determine whether a CGM file conforms to
the supported application profile specified in APPENDIX B
of file /sys/hpgl2/hpgl2_setup_instructions.
-D
Turn off the Polyline encode function. By default, the
translator produces HP-GL/2 code that uses the PE
function. This function defines coordinates in an
encoded form for faster throughput. Turning this switch
on forces the translator to produce ASCII representations
of the coordinate values, making them easier to
interpret for debugging purposes.
-Bn
Break on CGM element number n. This option causes the
translator to stop interpreting elements at element
number n, producing a partial picture.
PLOTTING FILES
To plot files in the BSD print environment, use
lpr -P<plotter> <filename>
where plotter is the name of the plotter specified in the
/etc/printcap file, and filename is a CGM file or raw HP-GL/2
file.
This assumes that the BSD HP-GL/2 printing environment has been
properly configured as specified in the online setup file
/sys/hpgl2/hpgl2_setup_instructions.
NOTE: The CGM-to-HP-GL/2 options can only be specified in a
plotter configuration file. The options are not
available on the lpr command line.
SEE ALSO
More information is available.
See lpr(1)
See online HP-GL/2 setup and usage instructions in the file
/sys/hpgl2/hpgl2_setup_instructions.