HPGL2(1) Aegis HPGL2(1)
NAME
help hpgl2 - help in using an HP HP-GL/2 plotter. Use along with
help prf - help in using the Aegis prf 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 can be specified in the Aegis print server configuration
file. See the file /sys/hpgl2/hpgl2_setup_instructions for information
on setting up your Aegis environment for HP-GL/2 plotting and the
use of the print server config file.
The following options are supported by the CGM-to-HP-GL/2
translator in the Aegis print server config file:
ext pen c1,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.
ext pen default
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 ext pen default and ext pen c1..c8 together.
Specify only one of these two options.
ext rot on | off
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.
ext sc x,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.
ext qual n
Selects the plotting quality level. n = [0..100].
The default quality level is plotter dependent.
ext mt n
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.
ext info on | off
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.
ext dpe on | off
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.
ext br n
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 Aegis print environment, use
prf -pr <plotter> <filename>
where plotter is the name of the plotter specified in the
print server configuration file, and filename is a CGM file
or raw HP-GL/2 file.
This assumes that the Aegis HP-GL/2 printing environment has been
properly configured as specified in the online setup file
/sys/hpgl2/hpgl2_setup_instructions.
NOTE: With the exception of the pen option (pen), the
CGM-to-HP-GL/2 translator options can also be specified
on the prf command line.
prf -option value
where option is one of the options listed above WITHOUT
the leading "ext".
Example: prf -rot on -sc 200,200 -pr plotter_name plot_file
SEE ALSO
More information is available.
Type "help prf"
See online HP-GL/2 setup and usage instructions in the file
/sys/hpgl2/hpgl2_setup_instructions.