ncl_displa (3) - Linux Manuals

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.'
------------------------------------
1linearlinear
2linearlogarithmic
3logarithmiclinear
4logarithmiclogarithmic

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.

COPYRIGHT

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

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