PLOT User Guide
PLOT User Guide
User Guide
Version 11.6SP1
This manual provides documentation relating to products to which you may not have
access or which may not be licensed to you. For further information on which Products
are licensed to you please refer to your licence conditions.
For details of AVEVA's worldwide sales and support offices, see our website at
http://www.aveva.com
AVEVA Solutions Limited, High Cross, Madingley Road, Cambridge CB3 0HB, UK
Contents
Chapter 2 summarises the function of PLOT and details the input and
output file formats that it can recognise.
Chapter 3 first explains some hardware considerations that you must be
aware of before you use PLOT. It then describes the range of facilities
available when using PLOT and the commands needed to control them.
Chapter 4 is a reference section that details the options available for
each of PLOT’s output formats.
Chapter 5 is a quick reference guide and summarises the driver specific
options and the options that apply to drivers generally.
Chapter 6 describes the recent to changes made to this manual.
If you are a new PLOT user, it is suggested that you should read, as a
minimum, Chapter 2 and the first three sections of Chapter 3. You will
also need to refer to at least one section in Chapter 4, depending on what
you intend to use the PLOT output for.
HP-GL/2
This is the standardised version of the Hewlett-Packard Graphical
Language. It provides a more consistent functionality between plotters. It
supports many types of device including pen, laser and electrostatic. The
HP-GL/2 plotter code is compact, especially for vectors that have a special
encoding scheme. It is held in binary file format.
Although HPGL and HP-GL/2 are related, HP-GL/2 is not a strict
superset of HPGL. It is best for most purposes to regard them as entirely
different. HP-GL/2 is often available in a dual context with
Hewlett-Packard’s PCL.
DXF
This is the AutoCAD representation of a drawing in their DXF (drawing
interchange) file format. It is an ASCII file format, widely used to
exchange drawing file data. The file does not define the units that its
values are held in, so explicit scaling is needed when these values are not
in millimetres.
Data from all sections of the DXF file is interpreted. This includes the
LTYPE and LAYER tables, and the contents of the Blocks section for
expansion of INSERT entities.
GPGP (or GP2)
This gives an ASCII format file that can define fully the viewing
parameters, line graphics, text and symbols for engineering drawings in
device-independent terms.
PLOT can translate an input plot file into a format suitable for driving a
plotter or printer directly, or it can send the translated output to another
file in a format suitable for inclusion into, say, a word processor or
desktop publishing document. It can, alternatively, send the translated
output to a graphical window for immediate viewing.
The device drivers incorporated into PLOT, which determine the output
format, are as follows:
Driver Name Description
BENSON Pen plotter
CALCOMP Pen plotter
DXF AutoCAD drawing interchange file
HOUSTON Pen plotter
HP Pen plotter
HPGL Pen plotter
HPGL2 Pen and raster plotter
LASERJET HP PCL page description language
LIST Displays drawing contents
If you are going to use PLOT to generate hard copy directly, this can be
done by printing from the graphical window created by the screen driver.
This method uses a normal Windows Print control to select, configure and
use any available print service.
It is also to send plot files directly to a printer or plotter using the
Windows print command. This method allows the user to take full control
of the printing operation, and responsibility for the compatibility of the
file type with the device. For example the command to send a PostScript
file to a printer service that supports and recognises this file format
would be as follows for a shared printer:
print /d:\\servername\printer_name plotfile.ps
The basic information that PLOT needs in order to process a plot file is as
follows:
• The type of processing which is required; that is, the device driver
that is to be used for the file translation process.
• The name of the input plot file that is to be processed.
• The destination to which the resulting output file is to be sent.
The full syntax for the command to run PLOT is:
plot driver plotfile output [options]
The command arguments have the following significance:
• driver = the name of the output device driver.
The available device drivers are:
BENSON
CALCOMP
DXF
HOUSTON
HP or HPGL
HPGL2
LASERJET
LIST
PDMS
PENMAN
PNG
POSTSCRIPT or PS
SCREEN
XDUMP
A full description of the functions of each of these is given in Chapter 4.
The Hewlett-Packard HP/HPGL and, to a lesser extent, the Calcomp
plotter codes have been adopted as industry standards, and many other
plotters are designed to emulate one or other of them. The corresponding
PLOT drivers may often be used successfully with such plotters, but only
when the emulation offers true compatibility with the standard.
• plotfile = the name of the pseudo-code file which is to be processed.
The file name must conform to the file naming conventions for your
computer.
PLOT automatically recognises the input plot file format used (PDMS,
HPGL, DXF or GPGP) by identifying some coding characters at the start
of the file, so there is no provision for you to enter this information.
• output = the destination to which the output data is to be sent.
This is either a file name or the command prompt window.
If you specify a file name, this must conform to the file naming
conventions for your computer. The command prompt window is specified
by setting the output to be –0 (minus-zero).
The output data file can for instance can be viewed later be sent to a
printer or plotter using operating system commands or it can be viewed
with a suitable program, including Plot itself.
Plot files can also be sent directly to a compatible printer or plotter with
the Windows print command.
• options = specific options to set values and control processing.
These allow you to control aspects of how the output files are produced.
Some options are general in their scope and apply to any output device
driver; these are described in Section 3.3 of this chapter. Other options
are relevant only to specific device drivers; these are described separately
in Chapter 4.
Note: The driver-specific options must be enclosed between quotation marks
and if there is more than one option, they must be separated by
commas.
Some Command Line Examples:
plot pdms plot12 ulay.pl
This command sends data from the file plot12 to the file ulay.pl in PDMS
pseudo-code format. The latter file could then be used as an underlay in a
PDMS drawing module, for example.
The following options are applicable to all drivers and may be combined
with any of the driver-specific options described in Chapter 4. You can
use all of these options with the soft drivers described in Section 3.4.
If an option is specified more than once, the last occurrence is the one
that applies.
This substitutes output pen integer2 for input pen integer1 and sets its
line style to linestyle and its line width to linetype with optional width
value.
Possible settings for linestyle are SOlid, DOt, DAsh, CHain or DChain.
The default, if linestyle is omitted, is SOLID.
Possible settings for linetype are Normal or Thick. The default, if linetype
is omitted, is NORMAL. THICK is optionally followed by the width value,
expressed in millimetres. If width is omitted the default line thickness is
set by the driver.
For example, the options:
PENS ATTR,ATTR 2 1 DOT,ATTR 3 1 CHAIN THICK
This sets input pen 2 to be output as dotted and normal thickness lines
and input pen 3 to be output as chained thick lines, both using output
pen 1.
'Pens Same' Mode
The option:
PEns Same
The causes all input pen numbers, line styles and line widths to be
ignored. All output is output with pen 1 only (unless redirected), and all
with the same line style and line width (solid and normal thickness by
default).
To redirect the output to use a different single pen, and to specify the line
style and line width for all output, use the command line option:
ATTR 1 integer linestyle linetype width
Here, integer specifies the required output pen number and the other
arguments set its line style to linestyle and its line width to linetype with
optional width value.
Possible settings for linestyle are SOlid, DOt, DAsh, CHain or DChain.
The default, if linestyle is omitted, is SOLID.
Possible settings for linewidth are Normal or Thick. The default, if
linetype is omitted, is NORMAL. THICK is optionally followed by the
width value, expressed in millimetres. If width is omitted the default line
thickness is set by the driver.
For example, the options:
PENS SAME,ATTR 1 4 CHAIN THICK 0.7
This causes all output to be output as chained thick lines with a width of
0.7 mm and pen 4. All pen settings, line styles and line widths defined in
the input file are ignored.
After the input file has been processed, a report is produced on the effect
of the Dekink filter. This gives the change in the total distance that the
pen needs to travel, and the change in the number of lines in the output
file (both as percentages). For example:
DEKINK reduced pen travel by 68.99% and number of lines by
43.93%
Example
Paper Edge
Drwg No
Paper Edge
Figure 1 shows six start marks and one end mark. This could be produced
by:
CUTMARK 6 1 1 0.1 8.0 5.0 2.0 5.0
The name soft_driver must not be the same as that of any of the standard
device drivers. Names are not case sensitive; that is, upper and lower
case characters are treated equally.
All soft driver definitions are held in the file PLOTDRIVERS. PLOT looks
for this file firstly in the directory defined by the CADC_PLOT_DIR
environment variable, then in the current directory and finally in the
same directory as the Plot Utility Program itself.
When a plot driver has an RGB option to set the colour mix of pens, this
can be done with a soft driver. For example, the following driver sets the
default PDMS colours for the screen:
pdmsc|screen|RGB 1 .659 .659 .659,RGB 2 .8 0 0,RGB 3 .93 .604 0,\
RGB 4 .8 .8 0,RGB 5 0 .8 0,RGB 6 0 .93 .93,RGB 7 0 0 .8,\
RGB 9 .647 .165 .165,RGB 10 1 1 1,RGB 11 .803 .569 .62,\
RGB 12 .4 0 .6,RGB 13 0 .75 .8,RGB 14 .2 0 .4,RGB 15 0 0 0
Each line in the PLOTDRIVERS file is the definition of a soft driver or, if
it begins with a # character, it is a comment.
When a soft driver is used with the command line options, the command
line options are placed after those from the soft driver and thus take
priority.
For example, the command:
plot psrgb plota22 plota22.out "BA N"
This has the same effect as the (similar) command above, except that the
banner page is switched off.
To change the default options of a built-in driver the usual soft driver
definition is used. However, both of the driver names are set to the built-
in driver name.
For example syntax:
screen|screen|RGB 0 0 0.2 0.2
This definition changes the background colour when the screen driver is
used with the plot command. Defaults defined in this way can be
modified by command line options.
The SCREEN and PNG drivers now have PDMS colours set as default
using this mechanism and the standard PLOTDRIVERS file. The
previous colours can be restored by deleting or commenting-out the
screen|screen|… and png|png|… definitions in that file.
This section summarises the types of message that you may see displayed
at your command prompt window while you are using PLOT. The
messages are divided into two categories: those that you can expect to see
under normal operating conditions and those that you see only under
error conditions.
This displays the driver quick reference information for PLOT that can
also found in Chapter 5 of this manual.
Target defines the command line to run Plot with the screen driver. Note
that the full pathname of the plot program is used and that the input file
is replaced by "*".
Start in is set as the directory that is most used for plot files.
Name labels the shortcut.
When this command is run from the shortcut a Multiple-File Open dialog
and a Console window are created. Select one or more plot files and plot
will view them all in the order specified. At each stage the file can be
viewed and printed. Close the graphics window or press Q to move on to
the next file. After all files have been viewed Plot returns to the multiple-
file open dialog. Click Cancel to finish.
Other drivers can be used with the input file set to "*". For example the
list driver can be used to display summary information about the
graphical contents of the files.
Alternatively, the shortcut on the desktop can be used to drag and drop
plot files as well as browsing for them if the shortcut target is a small
batch file DragDropPlot.bat, containing lines such as the following:
set file=%1
if "%file%" == "" set file="*"
start /b C:\AVEVA\pdms\plot\plot.exe plot screen %file% -0 "AUTO"
Models
This lists the supported plotters or defines the translation done by PLOT.
For plotters, the list gives the definitive models for which the driver was
originally written, and any other plotters on which the driver has been
tested. The list also gives other models, from the same or another
manufacturer, if they are known to be fully compatible with the driver.
Description
This describes, in broad terms, the plotter device code or the translation.
Output
This describes the file format output by the driver.
Options
This describes any additional options or controls for the driver, for
example scaling or paper layout.
Note that such options must be enclosed between quotation marks in the
command line and if more than one option is used they must be separated
by commas.
Example
This shows the minimum command syntax applicable to the driver, using
the default settings for all user-configurable options.
If applicable, a further example shows the use of some of the more
commonly used options.
Note: The LIST driver differs in principle from the drivers described in
this chapter in that it does not translate input plot file data into a
different format, but instead provides summarised information
about the overall content of the file. The functions of the LIST
driver are explained in Section 4.8.
4.1 BENSON
Models
This driver supports the Benson 1302 Plotter with intelligence level I0.
This is a drum plotter with a roll paper feed mechanism. The
code-compatible Benson 1322 plotter is also supported.
Description
The device code for these plotters is based on the relative positioning and
drawing commands of the symbolic Benson format.
Output
The output from this driver is device code that is sent directly to the
Benson plotter. This code is easy to read and the vectors are expressed
entirely as relative movements.
Files output by this driver are sequential and contain symbolic codes.
They are used only for maintenance purposes.
Options
None.
Example
plot benson view.pl -1
4.2 CALCOMP
Models
This driver produces code for the Calcomp 1040 series plotters using
906/907 plotter code. This data format is acceptable to most Calcomp
plotters.
The Calcomp 1040 series plotters are drum plotters with either cut sheet
or roll feed options, which can take media up to A0 size.
Description
The Calcomp device code produced by the driver is based on the use of
simple positioning, drawing, and pen selection commands. It can select
from up to eight pens.
Output
The output from this driver is device code that is sent directly to the
Calcomp plotter. The data is encoded and is unintelligible. The device
protocol means that the code is organised to include synchronising
Newline
Files output by this driver are ASCII coded and record structured. Their
content comprises all the data shown above, except for the request for
plotter response and its reply.
Options
The CALCOMP driver allows you to use options to control all low-level
detail of the plotter code format (as shown in the preceding table). You
can specify these options either directly, as PLOT command line
arguments (see Section 3.2), or indirectly, as parameters in a soft driver
definition.
The syntax for using each option is as follows (individual options must be
separated by commas):
[Key: int = an integer; val = a real number; Y/N = Yes or No]
BUffer int Sets device to use int data buffers (int must be 2 or 16).
Default: BU 16
CHecksum Y/N Specifies whether or not checksum is enabled.
Default: CH Y
WIndon val Sets the distance to be left blank between adjacent plots
to val mm.
Default: WI 20.0
You may use the CALCOMP64 driver as the basis for your option settings
if it is closer to your desired final specification.
Example
plot calcomp view.pl –1
plot calcomp64 view.pl –1
plot calcomp view.pl –1 "HE N,LI 110,PE N,WI 25"
4.3 DXF
• Tables. This section contains an LTYPE line types table defining the
definition of the line patterns available to the Entities section. It also
contains a LAYER and a style table.
• Blocks. This is empty.
• Entities. This contains all of the graphical elements of the drawing
and their attributes. The entity types are LINE, CIRCLE, ARC, TEXT,
POLYLINE and VERTEX.
Note: Sometimes the first three sections are omitted, depending on the
type of data and the purpose for which it is to be used.
Example
plot dxf view1.pl view1.dxf "UNITS INCHES"
Models
PLOT incorporates two Hewlett-Packard drivers, HP and HPGL, both of
which support all Hewlett-Packard pen plotters and the standard HP-GL
file format. The reference device supported by these drivers is the
HP7580B plotter, but they also support the HP7586 plotter, with or
without a roll feed option, the HP7550 plotter, which has an automatic
sheet feed, the IBM 6184 and 6186 plotters, and many other plotters
which use HP-GL code. The drivers also support the HP7475 plotter,
which has more restricted line style capabilities than the HP7580.
Description
The difference between the two drivers lies in the type of HP-GL code
which each uses:
• The HP driver uses only vectors and absolute positioning, and uses straight-
line chords to simulate arcs and circles. Each draw and move operation is
output on a separate line of the file. This makes this form of the code easier to
interpret.
• The HPGL driver uses vectors and relative positioning, and uses true arcs
and circles. Draw and move commands are merged together, and as many
commands as possible are put into each line of the file. These features make
this the more compact code of the two
The drivers derive the plotter model number by interrogating the device,
so that they allow for use with the HP7475 with its limited functionality.
They similarly determine the paper handling capabilities if used with an
HP7586 plotter, to allow it to be used with cut-sheet as well as roll-fed
paper. They make special provision for producing long plots on roll feed
versions of the latter plotter.
Output
The output from this driver is device code which is sent directly to the HP
plotter.
These drivers do not mix the two types of HP-GL command, namely
graphical commands and communication commands, within a line of
output.
Files output by this driver are ASCII coded and record structured. They
can be used as input to other conversion programs to produce device code
for otherwise unsupported devices.
Options
Several options are available which allow you to control the output from
these drivers. You can specify these options either directly, as PLOT
Note: All of the options are applicable when the plot output is sent to a
file, but only the HIGH and WAIT options apply when the plot is
sent directly to a plotter.
Example
plot hp view.pl plot1.plt (output to a file)
plot hp view.pl -1 (output direct to plotter)
plot hpgl view.pl plot1.plt (output to a file)
plot hpgl view.pl -1 (output direct to plotter)
plot hp view.pl plot1.plt "CE Y,MA"
4.5 HPGL2
Options
These options enable you to control the output of this driver. You can
specify these options either directly, as PLOT command line arguments
(see section 3.2), or indirectly, as parameters in soft driver definition (see
section 3.4).
The syntax for using each option is as follows (individual options must be
separated by commas):
[Key: Y/N = Yes or No; x y etc. coordinates in mm and other values; n
and pen are integers.]
COpies n Print n copies of each drawing in the plot file.
Default: COPIES 1
FF Y/N Specifies whether the formfeed character is output at
the end of the HP-GL/2 file. This is a communication
character was required previously for direct operation
of the plotter but may need to be omitted when a print
spooler is being used.
Default: FF Y
ECutter Y/N Enables the automatic cutter that operates after each
plot is completed.
Default: ECUTTER N
HIgh If selected the driver outputs higher level graphical
primitives such as arcs, circles, and line styles.
Default: HIGH is not selected.
MAp Derives the size of the plot from the plot file.
MAp x y w h Defines the position and size of the plot on the paper.
The default is to use the plot given in the plot file.
Default: MAP
PCL Y/N Specifies that the plotter is operating HP-GL/2 with
PCL in a dual context.
Default: PCL Y
PWidth w1 [w2] Specifies the widths of the thin and thick lines in mm.
The thinnest line width possible is selected by
specifying it as zero.
Default: PWIDTH 0.0 0.35
QUality n Sets the percentage quality level required from the
plotter. Where this is available the plotter will trade
quality for speed or reduced toner usage.
Default: QUALITY 100
RGb pen r g b Selects colour mode and defines the red/green/blue
colour mix for the specified logical pen number (pen
must be in the range 0-256). The colour values are in
the range 0 to 1.
Default: Monochrome
ROtate n Rotate the plot by 0, 90, 180, 270 degrees
counter-clockwise about the plotter coordinate system
origin.
Default: ROTATE 0
The defaults specified in the standard HP-GL/2 driver are equivalent to
the following options string:
"CO 1,EC N,MAP,PCL Y,PW 0.0 0.35,QU 100,RO 0"
Examples:
plot hpgl2 view.pl plot1.plt
4.6 HOUSTON
Models
This driver supports the Houston Hiplot DMP-40 and DMP-42 pen
plotters. These are drum plotters with media movement and registration
controlled by knurled gripping areas of the drum; they take A3 and A1
media sizes, respectively.
These plotters use Houston DM/PL III firmware, which is upwardly
compatible with DM/PL and DM/PL+.
Description
The DM/PL device code produced by the driver for these plotters is based
on simple absolute positioning and drawing commands and assumes that
there is a single pen.
Output
Files output by this driver are not record structured, but contain ASCII
codes. They are used only for maintenance purposes.
Options
None.
Example
plot houston view.pl view.out
4.7 LASERJET
Models
This driver produces output suitable for any printer that can interpret
Hewlett-Packard’s PCL page description language, such as the Laserjet
Series II devices.
Laserjet printers have a maximum resolution of 300 dots per inch (dpi),
but can also work at 150, 100 or 75 dpi
Description
Laserjet and compatible printers may be used to produce black and white
hard copy from graphical plot files. The PCL language has no facilities for
expressing graphical elements such as vectors; it provides instead a
group of raster graphics commands.
Output
The output from this driver is in device code that may be sent directly to
any PCL-compatible laser printer. Where the output is to a file, it
contains the complete PCL code needed to reproduce the printable
document defined by the pseudo-code plot file. This comprises a mixture
of PCL command escape sequences and 8-bit data that is not formatted
and not easy to inspect.
The Laserjet driver uses compression techniques to reduce the size of its
output files and, hence, the time needed to send them to the printer.
Further reductions in file size and data transfer time may be achieved by
specifying a lower raster graphics resolution (i.e. a lower dpi setting).
When multiple copies of a drawing are required, use of the COPIES
option gives increased speed by using the inbuilt printer facilities rather
than by repeated data transmission.
The drawing is scaled to a size that fills the printable area of an A4 sheet.
It is drawn automatically in portrait or landscape orientation to make the
best use of the available area.
Options
You can specify the LASERJET driver options either directly, as PLOT
command line arguments (see Section 3.2), or indirectly, as parameters in
a soft driver definition (see Section 3.4).
The syntax for using each option is as follows (individual options must be
separated by commas):
COpies integer This prints integer copies of each drawing in the plot
file. The default is 1 copy.
DPi integer Sets the printer resolution to integer dots per inch,
where integer may be 300, 150, 100 or 75. The default is
150 dpi, which usually gives a suitable compromise
between image quality, file size and data transmission
speed.
Examples
plot laserjet view.pl plot1.plt (output to a file)
plot laserjet view.pl -1 (output direct to printer)
plot laserjet view.pl -1 "CO 3,DPI 300" (print 3 copies of
each drawing at 300
dpi resolution)
4.8 LIST
The LIST driver differs from the others in that it does not translate input
plot file data into a different format, but instead provides summarised
information about the overall content of the file.
The information derived from the file includes:
• The pseudo-code format in which the file is written (PDMS, HPGL,
HP-GL/2, DXF or GPGP)
• The file header block (if it is a PDMS file)
• Details of the drawing in the file, namely:
- The drawing number, with its identifying number in brackets if it is a
GPGP file
- The dimensions of the drawing, in mm
- The total number of vectors that make up the drawing
- The number of arcs and circles
- The numbers of text strings and text characters
- The numbers of block definitions, block references (or inserts), and the
maximum depth of block reference nesting. The DXF input file format
can contain blocks.
- A list of the pens needed to plot the drawing
- The full list of symbol names. Symbols are shown with a prefix
character to indicate how often they are referenced:
Prefix References
none unreferenced
+ once
* one or more times
The information may be sent to an ASCII file, or it may be listed at your
command prompt window (by specifying output to line 0).
For example, the command:
plot list pdmsplot.pl -0
This would list the content of the PDMS pseudo-code plot file
pdmsplot.pl, containing an A1 drawing, thus:
Interpreter: PDMS
File Header: piper 18/07/04 12.25
Drawing: 1
Size 841 by 594 MM
Vectors 3403
Pens 1 2
The list driver does not use any options but will display any that are
specified on the command line or from a soft driver as a combined options
string.
4.9 PDMS
Models
This driver generates output in PDMS plot file format (i.e. PDMS
pseudo-code).
Description
This file format (which is also one of PLOT’s valid input formats) is
intended primarily for transferring graphical data between the modules
of PDMS. PLOT’s PDMS output driver also allows you to transfer data to
PDMS from other sources that generate HPGL or GPGP formatted
graphics.
Output
Files output by the PDMS driver are in binary format and comprise a
textual header block followed by the graphical data.
The header block contains:
• A user identifier - up to 6 characters - derived from the login user
name (truncated if longer than 6 characters).
• The current date - in the format DDMMYY.
• The current time - in the format HHMM.
The graphical data is a sequence of coded items, including pen moving
and drawing commands, pen changes, and paper size definitions. The
code is made more efficient by the provision of special codes for short line
drawing and moving operations, and for drawing horizontal or vertical
lines.
Options
None.
Example
plot pdms view.pl ulay2.pdms (output must be to a file)
4.10 PENMAN
Models
This driver outputs directly to the Penman Turtle Plotter.
Description
The Turtle plotter has a pen with an up/down mechanism mounted on a
wheeled carriage that is connected for power and control via a flying
cable. It uses a home marker that it can detect optically to register its
origin.
Output
The output from this driver is device code that is sent directly to the
Turtle plotter. The device code uses simple absolute positioning and
drawing commands. Periodic returns to the origin, to re-establish a
datum point, limit the build up of positional errors during plotting.
Files output by this driver are ASCII coded and record structured. They
are used only for maintenance purposes.
Options
None.
Example
plot penman view.pl -1
4.11 PNG
Models
This driver generates output in PNG file format.
Description
The PNG (Portable Network Graphics) format is a patent-free
replacement for GIF and can also replace many common uses of TIFF. It
provides a means for the lossless, portable storage of well-compressed
raster images.
PNG is designed to work well in online viewing applications, such as the
World Wide Web, and for user interface and general usage.
Note that the standard PLOTDRIVERS file changes the default for this driver
to use PDMS colours. To find out how to restore the colours to their previous
state and other details about modifying the default options of the built-in
drivers see the section on creating your own device drivers.
Output
Files output by the PNG driver are in binary format.
Options
The syntax for each option is as follows (individual options must be
separated by commas):
BItmap width height Defines the size of the bitmap image in pixels.
Sizes should be greater than 16 x 16 and the
upper size limit is 8000 x 8000. The default size
is 600 x 400.
Example
plot png in.dxf out.png "BITMAP 32 32"
4.12 POSTSCRIPT or PS
Models
These drivers produce output suitable for any printer that can interpret
the Postscript page description language.
The driver default options give output suitable for immediate use with
the commonest laser printers, which take A4 paper and which produce
Description
Postscript is a widely used page description language that efficiently
describes the appearance of text, images and drawings on the printed
page.
Output
The output from these drivers is an ASCII record structured file that
conforms to the standard structuring conventions for Postscript
multiple-page documents. It contains the complete Postscript program
needed to print the document defined by the input pseudo-code file.
The output is in device code that may be sent directly to the laser printer
or may be included in another document as an illustration. The laser
printer is treated as a plotter with a single pen, grey-scale pens or colour
pens, which can draw vectors in all line styles for both normal and thick
lines.
The drawing is scaled to form an image that fills the specified paper size,
with options to set margin widths, page orientation, and so on. Other
options allow you to control features such as a summarising banner page,
page headers and footers, and page layout.
It may be useful to override the parameters of this driver in the
PLOTDRIVERS file, for example to use PDMS colours by default. See the
description of this file for further details.
Options
The POSTSCRIPT/PS drivers provide many options. You can specify
these either directly, as PLOT command line arguments (see Section 3.2),
or indirectly, as parameters in a soft driver definition (see Section 3.4).
For convenience, the descriptions of the driver options are split into two
functional groups:
• Layout options, which control the overall page presentation.
• General options, which control the banner page and the detailed
graphics plotting (including monochrome/grey-scale/colour, scaling,
resolution, etc.).
The syntax for using each option is as follows (individual options must be
separated by commas):
Layout Options
LAyout type Defines the output page layout as type, where type is one of the
following:
The values from the MAP option are used directly with
this option. There are no margin or other adjustment
factors. The positioning is applied before the rotation,
its x values increase to the right, and y values increase
upwards.
Portrait - this is identical to the Landscape layout except that it is
positioned into the bottom left-hand corner of the image
area of the page and there is no rotation of the drawing.
Whole - uses the whole page for graphics, except for a 7 mm
margin on all four sides. The drawing is rescaled
(retaining the original width/height ratio) and rotated to
fill the page as efficiently as possible. The output file is
a complete PostScript document that may contain many
pages and may start with a banner page.
Margin - uses the whole page for graphics, except for a 26 mm
margin on all four sides (to allow for punch holes and
header/footer texts, etc.). The drawing is rescaled
(retaining the original width/height ratio) and rotated to
fill the page as efficiently as possible. The output file is
a complete Postscript document that may contain many
pages and may start with a banner page.
General Options
BAnner Y/N Specifies whether or not a banner page is output at the
head of the document.
Default: BA Y
EOt Y/N Specifies whether the EOT character is output at the
end of the PostScript file. This is a communication
character required previously for direct operation of a
printer but may need to be omitted when a print spooler
is being used.
Default: EOT Y
IGraphics Y/N Allows the use of the initgraphics command. (You
should not normally need to change this setting.)
Default: IG N
PType string Sets page type to string. Where string is a sequence of
printer specific PostScript commands to be inserted into
the output file at the point where paper size and tray
selection might take place. This option does not affect
anything else (e.g. scaling).
For example, below is an example of the PostScript
command to set up a printer to select a particular paper
try, perhaps one containing A3 sized paper. The
PostScript string used with PTYPE is not standard and
needs to be obtained for each model of printer. Below
are two examples showing how the printer specific
commands might look like to select a particular tray
and to select manual feed.
PTYPE 'statusdict begin 2 setpapertray end'
PTYPE 'statusdict begin /manualfeed true def end'
Default: PT
MAp x y val1 val2 Defines the position of the plot on the paper (x and y
coordinates of its origin expressed in mm). It defines
the plot dimensions as val1 wide by val2 high.
Default: MA 0 0 283.6 197.3
STeps val Sets the printer steps per inch (i.e. the printer
resolution) to val.
Default: ST 300
GRay Selects grey-scale output to represent colours.
MOno Selects monochrome output.
RGb Selects RGB colour output (using default
colour definitions).
Default colour representation: MONO
RGb pen r g b Selects RGB colour mode and defines the red/green/blue
colour mix for the specified logical pen number (pen
must be in the range 0-15).
Default: The colours of the graphics screen device (see
following table).
Example
plot ps view.pl fig1.ps (Output to file, e.g. for inclusion in
another file)
plot postscript view.pl fig1.ps
(Output to file, e.g. for inclusion in
another file)
plot postscript view.pl -2 (output direct to printer)
plot ps view.pl -2 "LA M,BR 'Page #',MA 10 40 100 70"
(Note nested quotation marks.
These are needed as 'Page #' is all
one string)
4.13 SCREEN
Models
The SCREEN driver displays plot files on a workstation graphics screen.
Description
This driver provides a convenient plot file viewing facility, allowing you to
preview your plot files before plotting or printing hard copies.
Output
This driver always creates a new graphics window to view the input plot
file. There is no output file and –0 takes its place on the command line. If
the output drawing comprises more than one page, the display pauses at
each page until you press a key or button.
User Interaction
The SCREEN driver is an interactive plot viewer with zoom and pan
actions under mouse control with appropriate cursors and
'rubber-banding'. To use the viewer:
• To pan the view by a specified distance, press and hold down the
left mouse button while you move the mouse. Release the button to
pan the view by a specified distance. A cursor 'rubber-band' shows you
the move while you are holding the button.
• As an alternative to scroll bars press and release the left mouse
button without moving the mouse to 'snap' the current point under the
cursor to the centre of the screen.
• To select a new view, press and hold down the middle button of your
mouse while you move it between the opposite corners of its boundary.
• To snap the current point to the centre of the screen and then
zoom in by a fixed amount, press and then release the middle
mouse button (without moving the mouse).
• Snap the current point to the centre of the screen and then
zoom out by a fixed amount, press and release the right mouse
button without moving the mouse.
Command Summary
Key/button Description
Home View all of the drawing
Shift-Home Refresh the window
Arrow keys Pan down/left/right/up by 10% of window
Control-Arrow Pan down/left/right/up by 2% of window
Shift-Arrow Pan down/left/right/up by 50% of window
H or ? Display help text
X Toggle cursor style, small cross and crosshair
/ Toggle cursor style, ISO and crosshair
N or Space Next drawing from plot file
Q or Return Quit viewer
0 to 9 Set cursor colour (1=white)
Mouse 1 Press/Move/Release pans around drawing. Press/release
(no move) centres this position in the window.
Mouse 2 Press/Move/Release zooms in on the box cursor.
Press/release (no move) centres this position in the
window and zooms in by 20%.
Mouse 3 Press/Move/Release zooms in on the box cursor.
Press/release (no move) centres this position in the
window and zooms out by 20%.
Note that for a 2-button mouse the effect of the middle button can be
achieved by pressing both buttons together.
Options
Note that the standard PLOTDRIVERS file changes the default for this driver
to use PDMS colours. To find out how to restore the colours to their previous
state and other details about modifying the default options of built-in drivers see
the section on creating your own device drivers.
The syntax for using each option is as follows (individual options must be
separated by commas):
MAp x y val1 val2
Defines the position of the plot on the screen (x and y
coordinates of its origin expressed in pixels). It defines
the graphics window dimensions as val1 pixels wide by
val2 pixels high.
Default: To match the graphics screen device.
CUrsor n Sets the long cursor pen number and must be in the
range 1-15. The default value is 4.
RGb pen r g b Defines the red/green/blue colour mix for the specified
logical pen number (pen must be in the range 0-15).
Example
plot screen logo.plt -0 "CUR 10,MA 20 40 250 150"
4.14 XDUMP
This driver outputs the plot to a specially formatted bitmap image file,
such as that produced by the X-Windows utility, xwd and displayed by
xwud.
Description
This driver produces a bitmap image file. This is always a single plane
image that represents the plot in monochrome, with the graphics from all
pens drawn in the foreground colour.
This form of output file can be used to compare whether two plots look
the same, regardless of overdrawing and the order in which the graphical
elements are drawn.
Output
Files output by this driver are in binary format and consist of a header
and data sections. See the X-Windows and xwd utility for references to
its format definition.
The drawing is scaled to a size that fills the bitmap. It is automatically
rotated by 90 degrees if this makes better use of the available area.
Options
The syntax for each option is as follows (individual options must be
separated by commas):
BItmap width height Defines the size of the bitmap image in pixels.
Sizes should be greater than 100 x 100. The
default size is 1000 x 800, and the upper size limit
is 9600 x 5000.
Size width height Defines the minimum plot size in millimetres that
is scaled to fill the bitmap image. Increasing the
size of a number of plots to a common value means
that their pixel scaling is also the same. This is
important if the bitmap files are to be manipulated
by other programs.
Example
plot xdump view.pl view.px "BITMAP 200 200"
The drivers are listed below in alphabetic order. The driver specific options can be abbreviated to 2 or
more characters, except where specified otherwise.
BENSON Driver
No options
CALCOMP Driver
Default: BU 16,CH Y,EO 3,HE Y,LI 119,NL Y,PA 10,PE Y,RA 95,
RES Y,SC 1,ST 80,SY 1 2,WA Y,WI 20
option description
BUFFER n Number of data buffers
CHECKSUM [Y|N] Checksum enabled
EOM n End of message character
HEADER [Y|N] Include search address in header
LINE n Line length
NL [Y|N] Output newline after each line
PAD n Number of padding characters
RADIX n Data conversion radix, 64 or 95
RESPONSE [Y|N] Plotter response used for flow control (Abbreviation RES)
SCALE n Plotter device scale factor
STEPS v Plotter device steps per MM
SYNC n n Number of sync characters and the sync character
WAIT [Y|N] Plotter to wait at the end of each plot
WINDON v Wind-on distance between plots in MM
CALCOMP64 Driver
This is equivalent to the CALCOMP driver with the options
BU 2,CH Y,EO 13,HE n,LI 125,NL Y,PA 0,PE N,RA 64,RES N,SC 0,
ST 40,SY 2 22,WA N,WI 20
DXF Driver
Default: POLY Y,UNITS MM
option description
AUTOSIZE Set drawing size from extent of graphics
HEADER [s] File supplying header, tables and blocks sections
POLYLINES [Y|N] Lines and arcs are output within polyline entities
UNITS [s] Define units as MM or INCHES
ZAXIS v Define the constant Z-axis value
HOUSTON Driver
No options
HP Driver
Default: CEN N,MAP,STEPS 40,WAIT Y
option description
AUTOSIZE Set drawing size from extent of graphics
CENTRE [Y|N] Physical coordinate origin position
HIGH Use higher level graphics primitives
MAP x0 y0 [w h] Define the position and size of plot
STEPS v Plotter steps per MM
WAIT [Y|N|P] End of plot action
HP7580B Driver
This is an alternative name for the HP driver.
HPGL Driver
This is equivalent to the HPGL with the following options
CEN NO,HIGH,MAP,STEPS 40,WAIT Y
HPGL2 Driver
Default: COP 1,ECUT N,FF Y,MAP,PCL Y,PWI 0.0 0.35,QUA 100,ROT 0
option description
COPIES [n] Print multiple copies
ECUTTER [Y|N] Enable cutter
FF [Y|N] Formfeed after HP-GL/2
HIGH Use higher level graphics primitives
MAP x0 y0 [w h] Define the position and size of plot
PCL [Y|N] Dual HP-GL/2 and PCL context
PWIDTH v [v] Pen widths for thin and thick pens (MM)
QUALITY n Quality level, percentage
RGB n r g b Define red/green/blue mix for pen number
ROTATE n Rotate plot by 0/90/180/270 degrees
INTERLEAF Driver
Default:
option description
HEADER s Select file header, default or RAPPORT
HIGH Use higher level graphics primitives
LASERJET Driver
Default: COP 1,DPI 150
option description
COPIES n Print multiple copies
DPI n Printer resolution, dots per inch
LIST Driver
No options
PDMS Driver
No options
PEGS Driver
Default: LAYERS 11 20 11 20,POLY Y,TSCALE 1.0
option description
FLAT Output without symbol structure
LAYERS n n [n n] Select Pegs layers for output
POLYLINES [Y|N] Lines are output as connected polylines
TSCALE v Text size relative scale factor
PENMAN Driver
No options
PNG Driver
Default: BITMAP 600 400,LAY FIT
option description
BITMAP w h Set the bitmap dimensions
LAYOUT [FIT|CENTRE|CORNER] Define bitmap layout of the graphics
RGB n r g b Define red/green/blue mix for pen number
SIZE w h Set the minimum plot size in MM
TRANSPARENT Set the bitmap background transparent
POSTSCRIPT Driver
Default: BA N,EOT Y,LAY L,MAP 0 0 283.6333 197.2733,MONO,
IG N,PT,STEPS 300
option description
BANNER [Y|N] Print banner page
BC s Bottom centre label
BL s Bottom left label
BR s Bottom right label
EOT [Y|N] EOT after PostScript
FONTNAME s Graphical text font
FLUSH Graphical primitives start on new lines
GRAY Grayscale output, see MONO and RGB
HIGH Use higher level graphics primitives
IGRAPHICS [Y|N] Include an "initgraphics" command
LAYOUT [L|P|W|M|F|I|E|D] Define the page layout
MAP x0 y0 [w h] Define the position and size of plot
MONO Monochrome output, see GRAY and RGB
PAGE n Set the initial page number
PTYPE [s] Include a page type command
RGB n r g b Define red/green/blue mix for pen number
STEPS v Plotter device steps per inch
TC s Top centre label
TL s Top left label
TR s Top right label
PS Driver
This is an alternative name for POSTSCRIPT
SCREEN Driver
Default: DEV 13
option description
CURSOR n Set the long cursor colour
MAP x0 y0 [w h] Define the window position and size
RGB n r g b Define red/green/blue mix for pen number
XDUMP Driver
Default: BITMAP 1000 800
option description
BITMAP w h Set the bitmap dimensions
SIZE w h Set the minimum plot size in MM