plucky (3) displa.3NCARG.gz

Provided by: libncarg-dev_6.6.2.dfsg.1-10build2_amd64 bug

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 (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.