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
or:void disini (void);

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
or:void disfin (void);

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
or:void messag (char *cstr, int nx, int ny);

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
or:void number (float x, int ndig, int nx, int ny);

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

or: void rlmess (char *cstr, float xp, float yp);
  void rlnumb (float x, int ndig, float xp, float yp);

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
or:void symbol (int nsym, int nx, int ny);

NSYM is a symbol number between 0 and 23. 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
or:void rlsymb (int nsym, float xp, float yp);

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
or:void pagera (void);

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
or:void pagfll (int nclr);

NCLRis a colour value.

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
or: void paghdr (char *cstr1, char *cstr2, int iopt, int idir);

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.
IDIRis 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
or:void symfil (char *cdev, char *cstat);

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 Meta- and Bitmap files into a Graphics

GKSLIN and CGM metafiles created by DISLIN and general BMP or GIF files 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 created by DISLIN, or general BMP and GIF files into a graphics.

The call is: CALL INCFIL (CFIL) level 1, 2, 3
or:void incfil (char *cfil);

CFIL is a character string that contains the filename.

Additional notes:


Next | Previous | Contents