           Chapter 6: Parameter Setting Routines

All parameters in  DISLIN  have default  values  set by  the
initialization routine DISINI.  This chapter summarizes sub-
routines  that allow the user  to alter default values.  The
following routines can be called from level 1, 2 or 3 except
for those noted throughout the chapter. Subroutines that can
only be called  from level 0  must appear before DISINI.  In
general, parameter setting routines should be called between
DISINI and the plotting routines they affect.

6.1 Basic Routines

                         R E S E T

RESET sets parameters back to their default values.

The call is:  CALL RESET (CNAME)               level 1, 2, 3

CNAME         is a character string  containing the name  of
              the routine whose parameters will be set  back
              to default values. If CNAME = 'ALL', all para-
              meters in DISLIN will be reset.

                         U N I T

UNIT defines the logical unit used for printing  error  mes-
sages and  listing data points  that lie outside of the axis
scaling.

The call is:  CALL UNIT (NU)                   level 1, 2, 3

NU            is the logical unit.  If NU = 0,  all messages
              will be suppressed.
                                             Default: NU = 6

                         O R I G I N

In  DISLIN,  all lines  are plotted  relative  to the origin
which is a  point located  in the upper  left corner  of the
page.  Modifying this point by ORIGIN produces a shifting of
plot vectors on the page.

The call is:  CALL ORIGIN (NX0, NY0)                 level 1

NX0, NY0      are the coordinates of the origin.
                                            Default: (0, 0).

                         C O L O R

COLOR defines the colours used for plotting text and lines.

The call is:  CALL COLOR (CNAME)               level 1, 2, 3

CNAME         is a character string that can have the values
              'BLACK',  'RED',   'GREEN',  'BLUE',   'CYAN',
              'YELLOW',  'ORANGE',  'MAGENTA',  'WHITE'  and 
              'FORE'. The keyword 'FORE' resets the color to
              the default value.

Note:         Colours can also be defined with SETCLR  which
              selects  a colour index  from an actual colour
              table (see chapter 11).

                         P A G E

PAGE determines the size of the page.

The call is:  CALL PAGE (NXP, NYP)                   level 0

NXP, NYP      are the length  and height of the page in plot
              coordinates.  The lower  right  corner  of the
              page is the  point (NXP-1, NYP-1).
                                      Default: (2970, 2100).

                         S E T P A G

SETPAG selects a predefined page format.

The call is:  CALL SETPAG (CPAGE)                    level 0

CPAGE         is a character  string  that defines  the page
              format.

  = 'DA4L'    DIN A4,        landscape,  2970 * 2100 points.
  = 'DA4P'    DIN A4,        portrait,   2100 * 2970 points.
  = 'DA3L'    DIN A3,        landscape,  4200 * 2970 points.
  = 'DA3P'    DIN A3,        portrait,   2970 * 4200 points.
  = 'DA2L'    DIN A2,        landscape,  5940 * 4200 points.
  = 'DA2P'    DIN A2,        portrait,   4200 * 5940 points.
  = 'DA1L'    DIN A1,        landscape,  8400 * 5940 points.
  = 'DA1P'    DIN A1,        portrait,   5940 * 8400 points.
  = 'PS4L'    PostScript A4, landscape,  2800 * 1950 points.
  = 'PS4P'    PostScript A4, portrait,   1950 * 2800 points.
  = 'KY4L'    Kyocera A4,    landscape,  2870 * 2000 points.
  = 'KY4P'    Kyocera A4,    portrait,   2000 * 2870 points.
  = 'HP4L'    HP-plotter A4, landscape,  2718 * 1900 points.
  = 'HP4P'    HP-plotter A4, portrait,   1900 * 2718 points.
  = 'HP3L'    HP-plotter A3, landscape,  3992 * 2718 points.
  = 'HP3P'    HP-plotter A3, portrait,   2718 * 3992 points.
  = 'HP2L'    HP-plotter A2, landscape,  5340 * 3360 points.
  = 'HP2P'    HP-plotter A2, portrait,   3360 * 5340 points.
  = 'HP1L'    HP-plotter A1, landscape,  7570 * 5340 points.
  = 'HP1P'    HP-plotter A1, portrait,   5340 * 7570 points.
                                    Default: CPAGE = 'DA4L'.

                         M E T A F L

METAFL defines the metafile format.

The call is:  CALL METAFL (CFMT)                     level 0

CFMT          is a  character string  that defines  the file
              format.
  = 'GKSL'    defines a GKSLIN metafile.
  = 'CGM'     defines a CGM metafile.
  = 'POST'    defines a PostScript file.
  = 'PSCL'    defines  a coloured  PostScript  file  with  a
              black background.
  = 'KYOC'    defines a Kyocera file.
  = 'HPGL'    defines an HPGL file.
  = 'JAVA'    defines a Java applet file.
  = 'TIFF'    defines a TIFF file.
  = 'IMAG'    defines an image file.
  = 'VIRT'    defines a virtual file.  The metafile  is hold
              in a raster format in computer memory  and can
              be saved on a file  with the  routines  RIMAGE
              and RTIFF. 
  = 'CONS'    defines a graphics output on the screen.
  = 'XWIN'    defines an X Window display.
  = 'XWIi'    defines  an X Window  display,  where i is the
              window  number  between  1 and 5.  By default,
              window 1  is situated in the  lower right cor-
              ner,  window 2  in  the  upper  right  corner,
              window 3  in the  upper left corner,  window 4
              in the lower left  corner  and window 5 in the
              centre of the screen.
                                     Default: CFMT = 'GKSL'.

Notes:      - The  default size of  JAVA,  TIFF,  IMAGE  and
              virtual files is set to  853 x 603 points  but
              can be modified with the routine WINSIZ. 
            - JAVA applet files  created  by DISLIN  can  be 
              compiled with  Java  and then  displayed  in a
              browser.  The class names  of the  applets are
              identical  with the  filenames  of  the output 
              files.  They can be changed  with  the routine
              SETFIL. 
            - The default colour table loaded by  DISINI  is
              'RGREY'  for  greyscaled  PostScript files and
              'RAINBOW' for the other file formats. Coloured
              PostScript  files with a white background  can
              be created  with  the keyword  'PSCL'  and the
              statement CALL SCRMOD('REVERS') before DISINI,
              or with the keyword  'POST'  and the statement
              CALL SETVLT('RAINBOW') after DISINI.

                         S E T F I L

By default, the plotfile name consists of the keyword  'DIS-
LIN' and an extension  that depends  on the file format.  An
alternate filename can be set with SETFIL.

The call is:  CALL SETFIL (CFIL)                     level 0

CFIL          is a character string  that contains the file-
              name.

                         E R R F I L

By default, the name of the error file is 'dislin.err'.
An alternate filename can be set with ERRFIL.

The call is:  CALL ERRFIL (CFIL)                     level 0

CFIL          is a character string  that contains the file-
              name.

                         E R R D E V

The routine ERRDEV defines the output device for DISLIN war-
nings. By default, warnings are written to the screen.

The call is:  CALL ERRDEV (COPT)                     level 0

COPT          is a character string that can have the values
              'CONS' and 'FILE'.
                                     Default: COPT = 'CONS'.

                         S C L F A C

SCLFAC sets the scaling factor for an entire plot.

The call is:  CALL SCLFAC (XFAC)                     level 0

XFAC          is the scaling factor by which the entire plot
              is scaled up or down.
                                          Default: XFAC = 1.

                         S C L M O D

The method  by which  graphics  are scaled  to the  hardware
pages of devices such as a graphics terminal can be selected
with the routine SCLMOD.

The call is:  CALL SCLMOD (CMOD)                     level 0

CMOD = 'DOWN' means that graphics will be scaled down if the
              hardware page of a device  is smaller than the
              plotting page.
     = 'FULL' means that the  graphics will be scaled  up or
              down depending  upon the size  of the hardware
              page.
                                     Default: CMOD = 'DOWN'.

Notes:     -  The size of  a graphics screen will  be inter-
              preted as DIN A4 landscape. This means that by
              default graphics which are smaller than DIN A4
              will not fill the entire screen.
           -  SCLFAC and SCLMOD can affect each other.

                         F I L M O D

The routine  FILMOD  determines  if a new  plotfile name  is
created for existing files.

The call is:  CALL FILMOD (CMOD)            level 0, 1, 2, 3

CMOD          is a character string containing the mode.
  = 'COUNT'   means that a new file version will be created.
  = 'DELETE'  means that the existing file will be overwrit-
              ten.
  = 'BREAK'   means that  the program  will be terminated by
              DISINI.
                                    Default: CMOD = 'COUNT'.

                         P A G M O D

GKSLIN and CGM files can be rotated by 90 degrees to use the
full  hardware page  of a device.  In general,  this is done
automatically by the driver program.

The call is:  CALL PAGMOD (CMOD)                     level 0

CMOD = 'LAND' means that the metafile is not rotated.
     = 'PORT' means that  the metafile is  rotated by 90 de-
              grees.
     = 'NONE' can be used  to disable automatic plotfile ro-
              tation in the driver program   (i.e. for Post-
              Script files).
                                     Default: CMOD = 'LAND'.

Figure 2 shows the effect of PAGMOD:
                                          +--------------+
                                          |              |
                                          |          ^   |
                                          |          |   |
                                          |          |   |
    +-----------------------+             |          |   |
    |  ^                    |             | Portrait |X  |
    |  |                    |             |          |   |
    | Y|    Landscape       |             |          |   |
    |  |                    |             |          |   |
    |  +--------------->    |             |  <-------+   |
    |         X             |             |     Y        |
    +-----------------------+             +---------------

                       Figure 2: PAGMOD

                         S C R M O D

Normally, the background  of screens and coloured PostScript
files is set to 'BLACK'  and the foreground colour is set to
'WHITE'.  With the routine  SCRMOD,  the back and foreground
colours can be swapped without changing the colour table.  

The call is:  CALL SCRMOD (CMOD)                     level 0

CMOD          is a character string containing the mode.
 = 'REVERS'   means  that  the  background colour  is set to
              'WHITE' and the foreground colour to 'BLACK'.
 = 'NOREV'    means  that  the  background  colour is set to
              'BLACK' and the foreground colour to 'WHITE'.
                                    Default: CMOD = 'NOREV'.

                         N E W P A G

NEWPAG creates a new page.

The call is:  CALL NEWPAG                            level 1

Notes:     -  NEWPAG is not useful for GKSLIN files.
           -  The number of pages for  CGM  files is limited
              to a length of 327 cm in the X-direction.
           -  For the  direct output  to graphic  terminals,
              NEWPAG has the same effect as ERASE.

                         W I N D O W

This routine defines,  for  X Window terminals,  a region on
the screen where the graphics will be displayed. By default,
the window size is set to 2/3 of the screen size and located
in the lower right corner of the screen.

The call is:  CALL WINDOW (NX, NY, NW, NH)  level 0, 1, 2, 3

NX, NY        are the  screen  coordinates of the upper left
              corner.
NW, NH        are the  width  and  height  of the  window in
              screen coordinates.

Note:         In general,  the screen  size is   1280 * 1024
              pixels.

                         W I N S I Z

This routine  defines  the size of windows.  By default, the
window size is set to 2/3 of the screen size.

The call is:  CALL WINSIZ (NW, NH)          level 0, 1, 2, 3

NW, NH        are  the  width  and height  of the  window in
              screen coordinates.

                         W I N A P P

The routine WINAPP defines if a  DISLIN program  should look
like a  Windows console, or more like a Windows program.  If
Windows mode is selected,  all  warnings  are  written to an
error file and the protocol in disfin is displayed in a wid-
get. 

The call is:  CALL WINAPP (COPT)                     level 0

COPT          is a character string that can have the values
              'CONSOLE' and 'WINDOWS'.
                                  Default: COPT = 'CONSOLE'.


                         H W P A G E

The routine  HWPAGE defines the size of the PostScript hard-
ware page.

The call is:  CALL HWPAGE (NW, NH)                   level 0

NW, NH        are the  width  and height  of the  PostScript
              hardware page in plot coordinates.
                                      Default: (1950, 2800).

                         H W O R I G

The routine  HWORIG defines the hardware origin of the Post-
Script hardware page.

The call is:  CALL HWORIG (NX, NY)                   level 0

NX, NY        are the plot coordinates  of the hardware ori-
              gin.                       Default: (75, 100).

                         S E T X I D

The routine SETXID defines an external  X graphics window or
pixmap for DISLIN.  All graphical  output is sent to the ex-
ternal window or pixmap.

The call is:  CALL SETXID (ID, CTYPE)                level 0

ID            is the window or pixmap ID.
CTYPE         is a character string that can have the values
              'WINDOW' and 'PIXMAP'.

Notes:      - If an external  pixmap is used,  backing store 
              must also be enabled with the routine X11MOD.
            - An external window is not erased by DISINI. 
              This can be done with the routine ERASE.
            - External windows are not blocked in DISFIN 
              (see WINMOD).   

6.2 Axis Systems

This section describes  subroutines  that allow the user  to
modify axis systems.  The position  of an  axis system,  the
size,  the scaling,  ticks,  labels  and axis titles  can be
altered in  any way.  Some of the routines defining axis at-
tributes can also be used with secondary axes. Routines that
set axis attributes can be used  for one or for any combina-
tion of axes.  The axes are identified by a character string
that can contain the characters 'X', 'Y' and 'Z' in any com-
bination.

6.2.1 Modifying the Type

                         A X S T Y P

The routine AXSTYP defines the type of an axis system.  Axis
systems  can be plotted  as rectangles or in a crossed form.
For crossed axis systems, the scaling must be linear and the
axis limits must contain the origin.

The call is:  CALL AXSTYP (COPT)                     level 1

COPT          is a character string defining the type.
 = 'RECT'     defines a rectangular axis system. 
 = 'CROSS'    defines a crossed axis system.
                                     Default: COPT = 'RECT'.

6.2.2 Modifying the Position and Size

                         A X S P O S

AXSPOS determines the position of an axis system.

The call is:  CALL AXSPOS (NXA, NYA)                 level 1

NXA, NYA      are  plot  coordinates  that  define the lower
              left  corner of  an axis  system.  By default,
              axis systems  are  centred in  the X-direction
              while  NYA  is set to the value (page height -
              300).

                         A X S O R G

AXSORG is an alternate routine for defining the position  of
a crossed axis system.

The call is:  CALL AXSORG (NX, NY)                   level 1

NX, NY        are plot coordinates  that define the position
              of the origin of a crossed axis system.

                         A X S L E N

AXSLEN defines the size of an axis system.

The call is:  CALL AXSLEN (NXL, NYL)                 level 1

NXL, NYL      are the length and height of an axis system in
              plot coordinates.  The default values  are set
              to 2/3 of the page length and height.

                         C E N T E R

A call to the routine CENTER will centre  the axis system on
the page.  All elements of an axis system, including titles,
axis labels and names, will be taken into consideration. The
centralisation is done by GRAF through changing the position
of the origin. Therefore, all plotting routines called after
GRAF will work with the new origin.

The call is:  CALL CENTER                      level 1, 2, 3

Notes:     -  If there are several axis systems on the page,
              the origin  will be changed  only by the first
              call to GRAF.
           -  The character height of titles  should  be de-
              fined with HTITLE if it is different  from the
              current  character height in GRAF.

6.2.3 Axis Scaling

                         S C A L E

This routine sets the axis scaling to logarithmic or linear.

The call is:  CALL SCALE (CSCL, CAX)           level 1, 2, 3

CSCL = 'LIN'  denotes linear scaling.
     = 'LOG'  denotes logarithmic scaling.
CAX           is a character string that defines the axes.
                                     efault: ('LIN', 'XYZ').

Note:         For logarithmic scaling, the corresponding pa-
              rameters in GRAF must be exponents of base 10.

                         S E T S C L

The parameters in  GRAF  will be calculated automatically by
DISLIN  if the routine  SETSCL  is used.  In this case, GRAF
must have dummy parameters in which  DISLIN returns the cal-
culated values.

The call is:  CALL SETSCL (XRAY, N, CAX)       level 1, 2, 3

XRAY          is a vector  that  contains  user coordinates.
              SETSCL calculates the minimum and maximum  va-
              lues  of the data and  stores them in a common
              block.
N             is the number of points in XRAY.
CAX           is a character string that defines the axes.

Notes:     -  SETSCL can be used with linear and logarithmic
              scaling and with all label types.
           -  The calculation of scaling and label values is
              done by  GRAF.  The minimum and maximum of the
              data are  always used for the lower and  upper
              limits of an axis while even values are calcu-
              lated for the labels.
           -  The number of  digits after the decimal  point
              will be set automatically.
           -  If the scaling of an axis is logarithmic,  la-
              bels will be plotted with the format 'LOG'.

6.2.4 Modifying Ticks

                         T I C K S

This routine is used to define  the number  of ticks between
axis labels.

The call is:  CALL TICKS (NTIC, CAX)           level 1, 2, 3

NTIC          is the number of ticks (>= 0).
CAX           is a character string that defines the axes.
                                        Default: (2, 'XYZ').

                         T I C P O S

This routine defines the position of ticks.

The call is:  CALL TICPOS (CPOS, CAX)          level 1, 2, 3

CPOS          is a character string defining the position.
  = 'LABELS'  means that  ticks will  be plotted on the same
              side as labels.
  = 'REVERS'  means that ticks  will be plotted inside of an
              axis system.
  = 'CENTER'  means that ticks  will be centred  on the axis
              line.
CAX           is a character string that defines the axes.
                                 Default: ('LABELS', 'XYZ').

                         T I C L E N

TICLEN sets the lengths of major and minor ticks.

The call is:  CALL TICLEN (NMAJ, NMIN)         level 1, 2, 3

NMAJ          is the length  of major  ticks in plot coordi-
              nates (> 0).
NMIN          is the length  of minor  ticks in plot coordi-
              nates (> 0).
                                          Default: (24, 16).

                         L O G T I C

The  appearance of minor ticks  on logarithmic axes  differs
slightly from  linear axes.  By default,  logarithmic  minor
ticks  are generated automatically if the label step is 1 or
-1 and if the number of ticks in TICKS is greater than 1. If
the step has another value, minor ticks are plotted  as spe-
cified in TICKS. This algorithm can be modified with LOGTIC.

The call is:  CALL LOGTIC (CMOD)               level 1, 2, 3

CMOD          is a character string defining the  appearance
              of logarithmic ticks.
   = 'AUTO'   defines default ticks.
   = 'FULL'   means that logarithmic minor ticks will be ge-
              nerated for every cycle even if the label step
              is not 1 but some other integer.
                                     Default: CMOD = 'AUTO'.

6.2.5 Modifying Labels

                         L A B E L S

LABELS  determines  which label types  will be plotted on an
axis.

The call is:  CALL LABELS (CLAB, CAX)          level 1, 2, 3

CLAB          is a character string that defines the labels.
  = 'NONE'    will suppress all axis labels.
  = 'FLOAT'   will plot labels in floating-point format.
  = 'EXP'     will plot floating-point labels in exponential
              format where fractions range between 1 and 10.
  = 'FEXP'    will plot  labels in the format  fEn  where  f
              ranges between 1 and 10.
  = 'LOG'     will plot logarithmic labels  with base 10 and
              the corresponding exponents.
  = 'CLOG'    is similar to 'LOG' except that the entire la-
              bel is  centred  below  the  tick  mark;  with
              'LOG', only the base '10' is centred.
  = 'ELOG'    will plot  only the  logarithmic values of la-
              bels.
  = 'TIME'    will plot time labels in the format 'hhmm'.
  = 'HOURS'   will plot time labels in the format 'hh'.
  = 'SECONDS' will plot time labels in the format 'hhmmss'.
  = 'MAP'     defines geographical  labels which are plotted
              as non  negative  floating-point  numbers with
              the  following characters  'W',  'E',  'N' and
              'S'.
  = 'LMAP'    is simular to 'MAP' except that lowercase cha-
              racters are used.
  = 'DMAP'    selects labels  that are plotted as  floating-
              point numbers with degree symbols.
  = 'MYLAB'   selects labels that are defined  with the rou-
              tine MYLAB. 
CAX           is a character string that defines the axes.
                                  Default: ('FLOAT', 'XYZ').

Notes:     -  The values 'LOG', 'CLOG' and 'ELOG' can be on-
              ly used with logarithmic scaling. If these la-
              bel types are used with linear scaling, DISLIN
              will change them   to 'FLOAT'.
           -  For the values  'TIME', 'HOURS' and 'SECONDS',
              the corresponding parameters in  GRAF  must be
              in seconds since midnight.

                         M Y L A B

MYLAB defines user labels.

The call is:  CALL MYLAB (CSTR, ITICK, CAX)    level 1, 2, 3

CSTR          is a character string containing  a label  (<=
              16 characters).
ITICK         is the tick number  where the  label  will  be
              plotted (<= 20). Tick numbering starts with 1.
CAX           is a character string that defines the axes.

                         L A B T Y P

LABTYP defines horizontal or vertical labels.

The call is:  CALL LABTYP (CTYPE, CAX)         level 1, 2, 3

CTYPE         is a character string defining the direction.
   = 'HORI'   defines horizontal labels.
   = 'VERT'   defines vertical labels.
CAX           is a character string that defines the axes.
                                   Default: ('HORI', 'XYZ').

                         L A B P O S

LABPOS defines the position of labels.

The call is:  CALL LABPOS (CPOS, CAX)          level 1, 2, 3

CPOS          is a character string defining the position.
  = 'TICKS'   means  that  labels  will be  plotted at major
              ticks.
  = 'CENTER'  means  that labels will be centred between ma-
              jor ticks.
  = 'SHIFT'   means that the starting and end labels will be
              shifted.
CAX           is a character string that defines the axes.
                                  Default: ('TICKS', 'XYZ').

                         L A B J U S

LABJUS defines the alignment of axis labels.

The call is:  CALL LABJUS (CJUS, CAX)          level 1, 2, 3

CJUS          is a character string  defining  the alignment
              of labels.
  = 'AUTO'    means that labels are automatically justified.
  = 'LEFT'    means that labels are left-justified.
  = 'RIGHT'   means that labels are right-justified.
  = 'OUTW'    means that labels are  left-justified  on  the
              left and lower axes of an axis system.  On the
              right and upper axes,  labels are right-justi-
              fied.
  = 'INWA'    means that labels are  right-justified  on the
              left and  lower axes of an axis system. On the
              right and upper axes,  labels are  left-justi-
              fied.
CAX           is a character string that defines the axes.
                                   Default: ('AUTO', 'XYZ').

                         D I G I T S

This routine  sets the number  of digits  after the  decimal
point displayed in labels.

The call is:  CALL DIGITS (NDIG, CAX)          level 1, 2, 3

NDIG  = -1  defines integer labels.
      =  0  defines integer labels  followed  by  a  decimal
            point.
      =  n  defines the number  of digits  after the decimal
            point. The last digit will be rounded up.
CAX         is a character string that defines the axes.
                                        Default: (1, 'XYZ').

                         I N T A X

With the routine INTAX,  all axes will be labeled with inte-
gers.

The call is:  CALL INTAX                       level 1, 2, 3

                         L A B D I S

This routine sets the distance between labels and ticks.

The call is:  CALL LABDIS (NDIS, CAX)          level 1, 2, 3

NDIS          is the distance in plot coordinates.
CAX           is a character string that defines the axes.
                                       Default: (24, 'XYZ').

                         T I M O P T

With  TIMOPT  time  labels  can  be  plotted  in the  format
'hh:mm'. The default is 'hhmm'.

The call is:  CALL TIMOPT                      level 1, 2, 3

                         R G T L A B

The routine RGTLAB right-justifies user labels.  By default,
user labels are left-justified.

The call is: CALL RGTLAB                       level 1, 2, 3

6.2.6 Modifying Axis Titles

                           N A M E

NAME defines axis titles.

The call is:  CALL NAME (CSTR, CAX)            level 1, 2, 3

CSTR          is a character string containing the axis tit-
              le  (<= 60 characters).
CAX           is a character string that defines the axes.
                                      Default: (' ', 'XYZ').

                         H N A M E

HNAME defines the character height for axis names.

The call is:  CALL HNAME (NHNAME)              level 1, 2, 3

NHNAME        is the character height in plot coordinates.
                                        Default: NHNAME = 36

                         N A M D I S

NAMDIS sets the distance between axis names and labels.

The call is:  CALL NAMDIS (NDIS, CAX)          level 1, 2, 3

NDIS          is the distance in plot coordinates.
CAX           is a character string that defines the axes.
                                       Default: (30, 'XYZ').

                         N A M J U S

The routine NAMJUS defines the alignment of axis titles.

The call is:  CALL NAMJUS (CJUS, CAX)          level 1, 2, 3

CJUS          is a character string that can have the values
              'CENT', 'LEFT' and 'RIGHT'.
CAX           is a character string that defines the axes.
                                   Default: ('CENT', 'XYZ').

                         R V Y N A M

The routine RVYNAM is used to plot names on right Y-axes and
colour bars at an angle of 90 degrees.  By default, they are
plotted at an angle of 270 degrees.

The call is:  CALL RVYNAM                      level 1, 2, 3

6.2.7 Suppressing Axis Parts

                         N O L I N E

After a call to  NOLINE  the plotting  of axis lines will be
suppressed.

The call is: CALL NOLINE (CAX)                 level 1, 2, 3

CAX          is a character string that defines the axes.

                         A X E N D S

With a call to AXENDS certain labels can be suppressed.

The call is:  CALL AXENDS (COPT, CAX)          level 1, 2, 3

COPT          is a character string  that defines  which la-
              bels will be suppressed.
  = 'NONE'    means that all labels will be displayed.
  = 'FIRST'   means  that only  the starting label  will  be
              plotted.
  = 'NOFIRST' means  that the  starting  label  will  not be
              plotted.
  = 'LAST'    means that only the ending label will be plot-
              ted.
  = 'NOLAST'  means that the ending label  will not be plot-
              ted.
  = 'ENDS'    means that only  the start and end labels will
              be plotted.
  = 'NOENDS'  means that start  and end labels  will be sup-
              pressed.
CAX           is a character string that defines the axes.
                                   Default: ('NONE', 'XYZ').

                         N O G R A F

The routine  NOGRAF  suppresses the plotting of an axis sys-
tem.

The call is:  CALL NOGRAF                            level 1

                         A X 2 G R F

The routine  AX2GRF  suppresses the plotting of the upper X-
and left Y-axis.

The call is:  CALL AX2GRF                      level 1, 2, 3

                         S E T G R F

SETGRF removes a part of an axis  or a complete axis from an
axis system.

The call is:  CALL SETGRF (C1, C2, C3, C4)     level 1, 2, 3

Ci            are  character  strings  corresponding  to the
              four axes of an axis system. C1 corresponds to
              the lower X-axis, C2 to the left Y-axis, C3 to
              the upper X-axis  and C4 to the right  Y-axis.
              The parameters  can have  the  values  'NONE',
              'LINE', 'TICKS',  'LABELS'  and  'NAME'.  With
              'NONE', complete axes will be suppressed, with
              'LINE', only axis lines will be plotted,  with
              'TICKS', axis lines and ticks will be plotted,
              with  'LABELS',  axis lines,  ticks and labels
              will be plotted and with 'NAME', all axis ele-
              ments will be displayed.
                Default: ('NAME', 'NAME', 'TICKS', 'TICKS').

Notes:     -  By default,  GRAF plots a frame of thickness 1
              around axis systems. Therefore, in addition to
              the parameter 'NONE',  FRAME  should be called
              with the parameter 0 for suppressing  complete
              axes.
           -  SETGRF  does not  reset  the effect of  NOGRAF
              and NOLINE. This must be done using RESET.

6.2.8 Modifying Clipping

                         C L P W I N

The routine  CLPWIN  defines a rectangular  clipping area on
the page.

The call is:  CALL CLPWIN (NX, NY, NW, NH)     level 1, 2, 3

NX, NY        are the  plot  coordinates  of the  upper left
              corner.
NW, NH        are the width  and height  of the rectangle in
              plot coordinates.

                         C L P B O R

The routine CLPBOR sets the clipping area to the entire page
or to the axis system.

The call is:  CALL CLPBOR (COPT)               level 1, 2, 3

COPT          is a character string that can have the values
              'PAGE' and 'AXIS'.
                                     Default: COPT = 'PAGE'.

                         N O C L I P

The suppressing of lines  outside  of the borders of an axis
system can be disabled with NOCLIP.

The call is:  CALL NOCLIP                      level 1, 2, 3

                         G R A C E

GRACE defines a margin around axis systems  where lines will
be clipped.

The call is:  CALL GRACE (NGRA)                level 1, 2, 3

NGRA          is the  width  of the  margin  in plot coordi-
              nates.  If NGRA is  negative,  lines  will  be
              clipped inside the axis system.
                                          Default: NGRA = -1

6.2.9 Framing Axis Systems

                         F R A M E

FRAME defines  the thickness  of frames plotted  by routines
such as GRAF and LEGEND.

The call is:  CALL FRAME (NFRM)                level 1, 2, 3

NFRM          is the thickness  of the frame in plot coordi-
              nates. If NFRM is negative,  the frame will be
              thickened  from the inside.  If positive,  the
              frame will be thickened towards the outside.
                                           Default: NFRM = 1

6.2.10 Setting Colours

                         A X C L R S

AXCLRS selects colours for single parts of axes.

The call is:  CALL AXCLRS (NCLR, COPT, CAX)    level 1, 2, 3

NCLR          is a  colour  number  between  -1  and 255. If
              NCLR = -1, the actual colour is used.
COPT          is a  character string  that can  have the va-
              lues  'LINE',  'TICKS',  'LABELS',  'NAME' and
              'ALL'.
CAX           is a character string that defines the axes.
                                Default: (-1, 'ALL', 'XYZ').

6.2.11 Axis System Titles

                         T I T L I N

This subroutine  defines up to four  lines of  text used for
axis system titles. The text can be plotted with TITLE after
a call to GRAF.

The call is:  CALL TITLIN (CSTR, IZ)           level 1, 2, 3

CSTR          is a character string (<= 60 characters).
IZ            is an integer that contains a value between  1
              and 4  or  -1 and -4.  If IZ is negative,  the
              line will be underscored.
                  Default: All lines are filled with blanks.

                         T I T J U S

The routine TITJUS defines the alignment of title lines.

The call is:  CALL TITJUS (CJUS)               level 1, 2, 3

CJUS          is a  character string that can  have the  va-
              lues 'CENT', 'LEFT' and 'RIGHT'.
                                     Default: CJUS = 'CENT'.

                         L F T T I T

Title lines are centred  above axis systems  by default  but
can be left-justified  with a call to  LFTTIT.  This routine
has the same meaning as TITJUS ('LEFT').

The call is:  CALL LFTTIT                      level 1, 2, 3

                         T I T P O S

The routine TITPOS defines the position of title lines which
can be plotted above or below axis systems.

The call is:  CALL TITPOS (CPOS)               level 1, 2, 3

CPOS          is a character string that can have the values
              'ABOVE' and 'BELOW'.
                                    Default: CPOS = 'ABOVE'.

                         L I N E S P

LINESP defines the spacing between title and legend lines.

The call is:  CALL LINESP (XFAC)               level 1, 2, 3

XFAC          The space  between lines is set to XFAC * cha-
              racter height.
                                        Default:  XFAC = 1.5

                         H T I T L E

HTITLE defines  the character height for titles. The charac-
ter height defined by  HEIGHT  will be used if HTITLE is not
called.

The call is:  CALL HTITLE (NHCHAR)             level 1, 2, 3

NHCHAR        is the character height in plot coordinates.

                         V K Y T I T

The space between titles and axis systems can be enlarged or
reduced with VKYTIT.  By default, the space is 2 * character
height.

The call is:  CALL VKYTIT (NV)                 level 1, 2, 3

NV            is an integer that determines the spacing  be-
              tween axis systems and titles.  If NV is nega-
              tive,  the space will be  reduced by  NV  plot
              coordinates. If NV is positive, the space will
              be enlarged by NV plot coordinates.
                                             Default: NV = 0
