Chapter 3: Introductory Routines
D I S I N I
DISINI initializes DISLIN by setting default parameters and creating
a plotfile. The level is set to 1. DISINI must be called before any other
DISLIN routine except for those noted throughout the manual.
- The call is:
- CALL DISINI - level 0
D I S F I N
DISFIN terminates DISLIN and prints a message on the screen. The level
is set back to 0.
- The call is:
- CALL DISFIN - level 1, 2, 3
M E S S A G
MESSAG plots text.
- The call is:
- CALL MESSAG (CSTR, NX, NY) - level 1, 2, 3
- CSTR
- is a character string (<= 256 characters).
- NX, NY
- are the plot coordinates of the upper left corner.
N U M B E R
NUMBER plots a floating-point number or integer.
- The call is:
- CALL NUMBER (X, NDIG, NX, NY) - level 1, 2, 3
- X
- is a floating-point number.
- NDIG
- is the number of digits plotted after the decimal
point. If NDIG = -1, X will be plotted as an integer.
The last digit of X will be rounded up.
- NX, NY
- are the coordinates of the upper left corner.
RLMESS and
RLNUMB
are corresponding routines for user coordinates. They can
be used for plotting text and numbers in an axis system after a call to GRAF.
- The calls are:
- CALL RLMESS (CSTR, XP, YP) - level 2, 3
-
- CALL RLNUMB (X, NDIG, XP, YP) - level 2, 3
Additional notes:
- To continue character strings and numbers on
the same line, the coordinates (999, 999) should be sent
to MESSAG and NUMBER.
The text or numbers will be plotted after the last
plotted text character or number.
- The angle and height of the characters can be changed with
the routines ANGLE and HEIGHT.
- The format of numbers can be modified with the routines
NUMFMT and NUMODE.
- Text and numbers can be plotted in a box if the routine
FRMESS is used.
- The starting point of text and numbers can be interpreted
as upper left, upper center and upper right point if the
routine TXTJUS is used.
S Y M B O L
The routine SYMBOL plots symbols.
- The call is:
- CALL SYMBOL (NSYM, NX, NY) - level 1, 2, 3
- NSYM
- is a symbol number between 0 and 21. Available symbols
are given in the Appendix B.
- NX, NY
- is the centre of the symbol in plot coordinates.
Additional notes:
- The size of symbols can be set with HSYMBL.
- SYMROT (ANGLE) defines a rotation angle for symbols (in degrees).
The symbol is rotated in a counter-clockwise direction.
R L S Y M B
RLSYMB plots a symbol where the centre is specified by user coordinates.
- The call is:
- CALL RLSYMB (NSYM, XP, YP) - level 2, 3
P A G E R A
PAGERA plots a border around the page.
- The call is:
- CALL PAGERA - level 1, 2, 3
P A G F L L
The routine PAGFLL fills the page with a colour.
- The call is:
- CALL PAGFLL (NCLR) - level 1, 2, 3
- NCLR
- is a color number in the range 0 to 255.
P A G H D R
PAGHDR plots a page header at a corner of the page.
The header line contains date, time and user-defined information.
- The call is:
- CALL PAGHDR (CSTR1, CSTR2, IOPT, IDIR) -
level 1, 2, 3
- CSTR1
- is a character string preceding the header line.
- CSTR2
- is a character string following the header line.
- IOPT
- is the page corner where the header is plotted:
- = 1
- is the lower left corner.
- = 2
- is the lower right corner.
- = 3
- is the upper right corner.
- = 4
- is the upper left corner.
- IDIR
- is the direction of the header line:
- = 0
- is horizontal.
- = 1
- is vertical.
Additional note:
- The character size of the header line
is 0.6 * NH where NH is the parameter used in HEIGHT.
A metafile can be converted with a driver program and sent from the
operating system to several devices. From within a user program, the
SYMFIL routine is used for this purpose.
S Y M F I L
SYMFIL sends a metafile to a device. It must be called after DISFIN.
- The call is:
- CALL SYMFIL (CDEV, CSTAT) - level 0
- CDEV
- is the name of the device. 'CONS' refers to the
graphics screen, 'XWIN' to a X Window terminal, 'PSCi' to a
PostScript printer, 'KYOi' to a Kyocera laserprinter with Prescribe and
'HPLi' to a HP-plotter. The keyword 'NONE' can be used to delete
a metafile with no device plotting.
- CSTAT
- is a status parameter and can have the values
'DELETE' and 'KEEP'.
Additional note:
- SYMFIL calls the DISLIN driver utility DISDRV.
The parameter 'REVERS' can be passed to DISDRV from SYMFIL
if the routine SCRMOD is called before with the
parameter 'REVERS'.
A metafile can be included into a graphics with the routine INCFIL.
I N C F I L
The routine INCFIL includes a GKSLIN or CGM metafile into a graphics.
- The call is:
- CALL INCFIL (CFIL) - level 1, 2, 3
- CFIL
- is a character string that contains the filename.
Additional notes:
- The routine FILBOX (NX, NY, NW, NH) defines
a rectangular area on the page where the metafile will
be included. (NX, NY) are the plot coordinates of the
upper left corner, (NW, NH) are the width and length of
the box in plot coordinates. By default, the entire page
will be used.
- With the statement CALL FILCLR ('NONE'), colour values
in a metafile will be ignored. The default is
FILCLR ('ALL').
Next |
Previous |
Contents