Plot a Drawing

Synopsis

num = PLOT/'plotter ID','drawing name'[{,COLOR|LWIDTH|DENS},pen list][,JOB,'jobname'][,SCALE,s][,ANGLE,a][,MEDIA,m][,COPIES,c][,ORIGIN,x,y][,START,x,y][,PAUSE,'message'][,PLTTOL,t][,IFERR,label:]

Description

Creates and submits a plot file.

The plot job ID is returned as a number when specified as [ID=]PLOT/..., as shown above and in File Managenment Statements table.

NOTE: The plot command will only work on a previously defined drawing of a part.

Parameters

Parameter

Description

'plotter ID'

The system identification of the output plotter. You can specify the plot server node with '>node:plotter ID' provided the following conditions are met:

The node you specify may have at most 10 characters and must be a valid plot server node.

The server node must be active.

The plotter ID must be on the plotter list.

The connection to the plot server node remains in effect until another node change occurs.

'drawing name'

The name of a previously defined drawing which may be up to 30 characters long.

COLOR

Minor word that indicates that the plot file will consist of the integer values which correspond to the object color.

LWIDTH or DENS

Minor words that indicate that the plot file will consist of the integer values which correspond to the line line width of the object.

pen list

A number list consisting of integers, greater than or equal to one, which correspond to pen positions on the designated plotter. The number of integers which must be supplied depends on whether COLOR or DENS was specified for the previous parameter. If COLOR was specified, fifteen integers must be supplied and if DENS was specified, three integers must be supplied.

JOB

Minor word that indicates that the following parameter is to be the name of the plot file in the plotter queue.

'jobname'

The jobname which may be up to 16 characters long.

SCALE

Minor word that indicates that the following parameter will be the plot scale.

s

The scale of the plot which may be any positive value.

ANGLE

Minor word that indicates that the following parameter will be the rotation angle of the plot.

a

The rotation angle of the plot in degrees.

MEDIA

Minor word that indicates that the following parameter will be an integer which corresponds to a customer defined media.

m

The media reference number which will only be used in the plotter queue.

COPIES

Minor word that indicates that the following parameter will be an integer specifying the number of times the image is to be replotted.

c

Any positive value which specifies the number of times the image is to be replotted.

ORIGIN

Minor word that indicates that the following parameters will be the X and Y coordinates of the plot origin.

x,y

The X and Y coordinates of the plot origin which must be positive and must be on the specified drawing. The minimum values are 0,0 which is the lower left corner and the maximum values are the drawing size. The maximum values for an "A" size drawing would be 8.5 and 11, the maximum values for a "B" size drawing would be 11 and 22, etc.

START

Minor word that indicates that the following parameters are the plotter delta X and Y offsets.

x,y

The X and Y offset values from the plotter origin. The minimum and maximum x and y values are dependant upon the type of plotter and its physical dimensions.

PAUSE

Minor word that indicates that the following parameter is a console message for the plotter operator. Use of this minor word places the specified plot on hold.

'operator message'

An operator message which is to be displayed on the operator console.

PLTTOL

Minor word that indicates that the following parameter is the plot tolerance.

NOTE: This minor word causes GRIP to ignore the global plot tolerance. Some of the ways of setting the global plot tolerance are interactively in Unigraphics or in the default initialization files (ug_metric.def or ug_english.def by the UG_plotTolerance parameter). GRIP uses the tolerance only for the specified plot job.

t

The plot tolerance value which is used only for the current plot job. Valid values are positive decimal numbers. The default value is 0.001 which produces curves which appear smooth. Values larger than 0.002 begin to show faceting, especially on arcs of large diameter.

IFERR,label:

Specifies a label to which the program jumps if an error occurs.

Parameter	Description
'plotter ID'	The system identification of the output plotter. You can specify the plot server node with '>node:plotter ID' provided the following conditions are met: The node you specify may have at most 10 characters and must be a valid plot server node. The server node must be active. The plotter ID must be on the plotter list. The connection to the plot server node remains in effect until another node change occurs.
'drawing name'	The name of a previously defined drawing which may be up to 30 characters long.
COLOR	Minor word that indicates that the plot file will consist of the integer values which correspond to the object color.
LWIDTH or DENS	Minor words that indicate that the plot file will consist of the integer values which correspond to the line line width of the object.
pen list	A number list consisting of integers, greater than or equal to one, which correspond to pen positions on the designated plotter. The number of integers which must be supplied depends on whether COLOR or DENS was specified for the previous parameter. If COLOR was specified, fifteen integers must be supplied and if DENS was specified, three integers must be supplied.
JOB	Minor word that indicates that the following parameter is to be the name of the plot file in the plotter queue.
'jobname'	The jobname which may be up to 16 characters long.
SCALE	Minor word that indicates that the following parameter will be the plot scale.
s	The scale of the plot which may be any positive value.
ANGLE	Minor word that indicates that the following parameter will be the rotation angle of the plot.
a	The rotation angle of the plot in degrees.
MEDIA	Minor word that indicates that the following parameter will be an integer which corresponds to a customer defined media.
m	The media reference number which will only be used in the plotter queue.
COPIES	Minor word that indicates that the following parameter will be an integer specifying the number of times the image is to be replotted.
c	Any positive value which specifies the number of times the image is to be replotted.
ORIGIN	Minor word that indicates that the following parameters will be the X and Y coordinates of the plot origin.
x,y	The X and Y coordinates of the plot origin which must be positive and must be on the specified drawing. The minimum values are 0,0 which is the lower left corner and the maximum values are the drawing size. The maximum values for an "A" size drawing would be 8.5 and 11, the maximum values for a "B" size drawing would be 11 and 22, etc.
START	Minor word that indicates that the following parameters are the plotter delta X and Y offsets.
x,y	The X and Y offset values from the plotter origin. The minimum and maximum x and y values are dependant upon the type of plotter and its physical dimensions.
PAUSE	Minor word that indicates that the following parameter is a console message for the plotter operator. Use of this minor word places the specified plot on hold.
'operator message'	An operator message which is to be displayed on the operator console.
PLTTOL	Minor word that indicates that the following parameter is the plot tolerance. NOTE: This minor word causes GRIP to ignore the global plot tolerance. Some of the ways of setting the global plot tolerance are interactively in Unigraphics or in the default initialization files (ug_metric.def or ug_english.def by the UG_plotTolerance parameter). GRIP uses the tolerance only for the specified plot job.
t	The plot tolerance value which is used only for the current plot job. Valid values are positive decimal numbers. The default value is 0.001 which produces curves which appear smooth. Values larger than 0.002 begin to show faceting, especially on arcs of large diameter.
IFERR,label:	Specifies a label to which the program jumps if an error occurs.