DISINI initializes DISLIN by setting default parameters and creating a plot file. 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); |
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); |
MESSAG plots text.
The call is: | CALL MESSAG (CSTR, NX, NY) | level 1, 2, 3 |
or: | void messag (const char *cstr, int nx, int ny); |
CSTR | is a character string (<= 256 characters). |
NX, NY | are the plot coordinates of the upper left corner. |
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 (const char *cstr, float xp, float yp); |
  | void rlnumb (float x, int ndig, float xp, float yp); |
Additional notes:
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.
The following constants can be used for symbol numbers in C and
Fortran 90/95 programs:
SYMBOL_SQUARE 0 SYMBOL_OCTAGONCROSS 13 SYMBOL_OCTAGON 1 SYMBOL_SQUARETRIANGLE 14 SYMBOL_TRIANGLE_UP 2 SYMBOL_CIRCLE 15 SYMBOL_PLUS 3 SYMBOL_SQUARE_FILLED 16 SYMBOL_CROSS 4 SYMBOL_OCTAGON_FILLED 17 SYMBOL_DIAMOND 5 SYMBOL_TRIANGLE_UP_FILLED 18 SYMBOL_TRIANGLE_DOWN 6 SYMBOL_DIAMOND_FILLED 19 SYMBOL_SQUARECROSS 7 SYMBOL_TRIANGLE_DOWN_FILLED 20 SYMBOL_STAR 8 SYMBOL_CIRCLE_FILLED 21 SYMBOL_DIAMONDPLUS 9 SYMBOL_DOT 21 SYMBOL_OCTAGONPLUS 10 SYMBOL_HALFCIRCLE 22 SYMBOL_DOUBLETRIANGLE 11 SYMBOL_HALFCIRCLE_FILLED 23 SYMBOL_SQUAREPLUS 12 |
NX, NY | is the centre of the symbol in plot coordinates. |
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); |
PAGERA plots a border around the page.
The call is: | CALL PAGERA | level 1, 2, 3 |
or: | void pagera (void); |
The routine PAGFLL fills the page with a colour.
The call is: | CALL PAGFLL (NCLR) | level 1, 2, 3 |
or: | void pagfll (int nclr); |
NCLR | is a colour value. |
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 (const char *cstr1, const 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. |
IDIR | is the direction of the header line: |
= 0 | is horizontal. |
= 1 | is vertical. |
Additional note:
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 (const char *cdev, const 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 laser printer 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:
The routine INCFIL includes a GKSLIN or CGM metafile created by DISLIN, or general PNG, BMP, GIF and TIFF files into a graphics.
The call is: | CALL INCFIL (CFIL) | level 1, 2, 3 |
or: | void incfil (const char *cfil); |
CFIL | is a character string that contains the filename. |
The routine FILSIZ returns the size on an image file.
The call is: | CALL FILSIZ (CFIL, NWIDTH, NHEIGHT, IRET) | level 0, 1, 2, 3 |
or: | int filsiz (const char *cfil, int *nwidth, int *nheight); |
CFIL | is a character string that contains the filename. |
NWIDTH | is the returned width of the image in pixel. |
NHEIGHT | is the returned height of the image in pixel. |
IRET | contains a returned status that can have the values: 1: BMP file, 2: GIF file, 3: TIFF file, 4: PNG file, 0: undefined format, -1: error. |
The routine FILTYP returns the type of a file.
The call is: | CALL FILTYP (CFIL, ITYP) | level 0, 1, 2, 3 |
or: | int filtyp (const char *cfil); |
CFIL | is a character string that contains the filename. |
ITYP | contains a returned status that can have the values: 1: BMP file, 2: GIF file, 3: TIFF file, 4: PNG file, 5: Dislin Image, 6: GKSL, 7: CGM, 8: WMF, 9: HPGL, 10: PostScript, 11: PDF, 12: Aldus WMF, 0: unknown format, -1: error. |