Chapter 3: Introductory Routines

3.1 Initialization and Termination

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

3.2 Plotting of Text and Numbers

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:

3.3 Plotting Symbols

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: 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

3.4 Plotting a Page Border, Background and Header

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:

3.5 Sending a Metafile to a Device

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:

3.6 Including Metafiles into a Graphics

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:
Next | Previous | Contents