NAME

       DISPLA - Changes the values of certain primary control parameters purportedly having to do with the
       "display" of a graph.

SYNOPSIS

       CALL DISPLA(LFRA,LROW,LTYP)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_displa(int lfra, int lrow, int ltyp)

DESCRIPTION

       LFRA        (an  input  expression  of  type  INTEGER), if non-zero, must have an integer value, the real
                   equivalent of which is to become the new value of 'FRAME.'. If LFRA is zero, no change is  to
                   be made in the current value of 'FRAME.'.

                   •      The default value of 'FRAME.' is "1.", specifying that each of the routines EZY, EZXY,
                          EZMY, and EZMXY is to do a frame advance after drawing a graph.

                   •      The value "2." specifies no frame advance.

                   •      The value "3." specifies a frame advance before drawing a graph.

       LROW        (an  input  expression  of  type  INTEGER), if non-zero, must have an integer value, the real
                   equivalent of which is to become the new value of 'ROW.'. If LROW is zero, no change is to be
                   made in the current value of 'ROW.'. This parameter affects the way  in  which  the  routines
                   EZMY and EZMXY interpret the arguments XDRA and YDRA, as follows:

                   •      If  'ROW.'  is  positive, the first subscript of YDRA is a point number and the second
                          subscript is a curve number. If 'ROW.' is negative, the order  of  the  subscripts  is
                          reversed (row-wise, rather than column-wise, storage).

                   •      If  the absolute value of 'ROW.' is "1.", XDRA is singly-subscripted; its subscript is
                          a point number. If the absolute value of 'ROW.' is "2." or greater,  XDRA  is  doubly-
                          subscripted; the order of the subscripts is the same as for YDRA.

                   The  default  value  of  'ROW.'  is "1.", specifying that XDRA is singly-subscripted by point
                   number and that YDRA is doubly-subscripted by point number and curve number, in that order.

       LTYP        (an input expression of type INTEGER), if non-zero, is an integer specifying new  values  for
                   'X/LOGARITHMIC.'  and  'Y/LOGARITHMIC.'.  If  LTYP  is  zero,  no change is to be made in the
                   current values.

                   •      The parameter 'X/LOGARITHMIC.' has the default value "0.", specifying a linear mapping
                          of user X coordinates onto the horizontal axis of the grid window;  it  may  be  given
                          either  of  the  two values "-1." or "+1." to specify a logarithmic mapping. The value
                          "-1." protects it from being  reset  as  a  side  effect  of  setting  'SET.'.  DISPLA
                          generates the value "0." or "-1.".

                   •      The  parameter 'Y/LOGARITHMIC.' is defined similarly and affects the mapping of user Y
                          coordinates onto the vertical axis of the grid window.

                   A non-zero LTYP resets these values, as follows:

                             LTYP   'X/LOGARITHMIC.'   'Y/LOGARITHMIC.'
                             ----   ----------------   ----------------
                              1     linear             linear
                              2     linear             logarithmic
                              3     logarithmic        linear
                              4     logarithmic        logarithmic

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE

       This routine sets internal parameter values.  For  a  complete  list  of  parameters  available  in  this
       utility, see the autograph_params man page.

EXAMPLES

       Use the ncargex command to see the following relevant example: agex13.  bnchmk, splogy, sprevx.

ACCESS

       To  use DISPLA or c_displa, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in
       that order.

SEE ALSO

       Online: autograph, autograph_params, agback, agbnch, agchax,  agchcu,  agchil,  agchnl,  agcurv,  agdshn,
       aggetc,  aggetf,  aggeti, aggetp, aggetr, agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr,
       agstup, agutol, anotat, ezmxy, ezmy, ezxy, ezy

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                     DISPLA(3NCARG)