NAME
versaplot - routines for creating vectors to be plotted on the versatec
SYNOPSIS
- plots_(option,p,v)
- int *option; char *p, *v;
- plot_(x,y,pen)
- float *x, *y; int *pen;
- offset_(xoff,xfac,yoff,yfac)
- float *xoff, *xfac, *yoff, *yfac;
- factor_(fact)
- float *fact;
- newpen_(nibs)
- int *nibs;
- where_(xnow,ynow,dfact)
- float *xnow, *ynow, *dfact;
- symbol_(x,y,height,text,angle,nc)
- float *x,*height,*y,*angle; char *text; int *nc;
- number_(x,y,height,fpn,ndec)
- float *x,*y,*fpn,*height; int *ndec;
- scale_(array,axlen,npts,inc)
- float array[],*axlen; int *npts,*inc;
- line_(x,y,npts,inc,lintyp,inteq)
- float x[],y[]; int *npts,*lintyp,*inteq,*inc;
- axis_(x,y,label,nchar,axlen,angle,fval,dv)
- int *nchar; char *label; float *x, *y, *axlen, *angle, *fval, *dv;
- setmsg_(msglvl)
- int *msglvl;
- grid_(x,y,nx,xd,ny,yd,lmask)
- float *x,*y,*xd,*yd; int *nx,*ny,*lmask;
- tone_(x,y,pat,n)
- int *n,pat[]; float x[],y[];
- curve_(x,y,ne,delta)
- float *delta,x[],y[]; int *ne;
DESCRIPTION
These subroutines generate a file of vectors and a parameter file which contains information necessary to rasterize the vectors. Plots must be called first to initialize variables and create files. Plot must be called last with pen = 999. These routines are obtained by the ld (1) option -lv. -lF77 -lI77 and -lm for example 'cc main.c -lv -lF77 -lI77 -lm'. The Versatec 'Versaplot Software Manual' provides descriptions and samples for each routine. Argument and function descriptions are as follows:
- plots_(option,p,v)
-
initializes internal plotting variables.
- 0
- initiate raster process, 'parm' is used for parameter file name 'vector' is used for vector file name
- 1
- initiate raster process, use p for parameter file name and v for vector file name
- 2
- do not initiate raster process, use p for parameter file name and v for vector file name
- plot_(x,y,pen)
- processes straight line 'pen' moves with the 'pen' up or down
- 999
- end of all plotting
- -999
- end of current plot
- 3
- move to (x,y)
- 2
- draw to (x,y)
- -2
- draw to (x,y), re-origin
- -3
- move to (x,y), re-origin
- -12
- draw to offset/scaled (x,y), re-origin
- -13
- move to offset/scaled (x,y), re-origin
- 12
- draw to offset/scaled (x,y)
- 13
- move to offset scaled (x,y)
- offset_(xoff,xfac,yoff,yfac)
- sets special scale factors and offsets to be used by plot when called with pen equal plus or minus 12 or 13, x and y coordinates are adjusted as follows: xnew = (xold - xoff) / xfac, ynew = (yold - yoff) / yfac
- factor_(fact)
- changes the size of entire plot by the ratio of new to normal plot size for example fact equal 2 would double the plot size
- newpen_(nibs)
- changes the line width from 1 to 5 nibs wide
- where_(xnow,ynow,dfact)
- returns the current 'pen' position and drawing factor ratio
- symbol_(x,y,height,text,angle,nc)
- plots characters at various angles and sizes
- x,y
- starting position
- height
- height in inches
- text
- character string if nc is positive, integer symbol number if nc is negative
- angle
- rotation angle in degrees
- nc
- positive nc indicates number of characters to be plotted, negative nc indicates text is an integer symbol number, nc = -1 means move to (x,y), nc = -2 means draw to (x,y)
- number_(x,y,height,fpn,ndec)
- converts floating point number to decimal and plots it
- > 0
- number of places to the right of decimal point
- = 0
- plot only integer portion and decimal point
- = -1
- plot only integer portion
- < -1
- absolute value ndec - 1 digits are right truncated from the integer portion
- scale_(array,axlen,npts,inc)
- computes scale factors for use with line and axis subroutines. This routine returns the starting unscaled data value and the scaling factor to the next two elements beyond the start of array plus npts times inc
- array
- array of unscaled data
- axlen
- axis length in inches
- npts
- number of points to be scaled in array
- inc
- increment used in picking data from array, if positive the first unscaled value is a minimum with a positive scale factor, if negative the first unscaled value is a maximum with a negative scale factor
- line_(x,y,npts,inc,lintyp,inteq)
- plots points from coordinate data arrays, coordinate data must be followed by scaling parameters set by scale
- x
- array of x values followed by scaling parameters
- y
- array of y values followed by scaling parameters
- npts
- number of data values in each array
- inc
- increment for picking data from array
- lintyp
- magnitude of lintyp is the symbol plot frequency for plotted symbols
- = 0
- points connected by straight lines
- > 0
- points connected by straight lines with plotting symbols
- < 0
- only symbols plotted
- inteq
- symbol number of symbol to be used if symbol plotting
- axis_(x,y,label,nchar,axlen,angle,fval,dv)
- generates an axis line with labels and scales
- x,y
- starting position
- label
- character string used to label axis
- nchar
- number characters in label, positive values indicate all marking is done above the axis line, negative values indicate all marking is done below the axis line
- axlen
- length in inches of axis
- angle
- angle of rotation of axis in degrees
- fval
- first value for axis annotation at inch intervals
- dv
- number of data points per inch
- setmsg_(msglvl)
- alters message level parameter (0-5) during execution
- grid_(x,y,nx,xd,ny,nd,lmask)
- generates grid patterns
- tone_(x,y,pat,n)
- provides patterned shading for specified area(s), for more than one area shading is done in alternate overlapping areas. At least two calls to tone must be made to shade an area, the first call (last argument negative) sets the pattern and the second call (last argument positive) defines the area(s).
- x,y
- data arrays defining the area(s) to be shaded
- pat
- integer array of either pattern elements (32 bits long) or number of elements specifying a particular area
- n
- if positive this is the number of areas defined in the x and y arrays, if negative this is the number of pattern elements (max 16) in the pattern array
- curve_(x,y,ne,delta)
- generates a smooth continuous curve through a series of points
- x,y
- arrays of points to be joined
- ne
- (absolute) number of points in arrays negative value indicates that the last two elements of each array are scale factors,
- delta
- (absolute value) is the segment length for the incremental approximation of the curve, positive value specifies plotting with solid line, negative value specifies plotting with dashed line, positive value indicates the points are already scaled
SEE ALSO
vrast(1) Versaplot Software Manual