ncarg_displa(3)

1DISPLA(3NCARG)                   NCAR GRAPHICS                  DISPLA(3NCARG)
2
3
4

NAME

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

SYNOPSIS

10       CALL DISPLA(LFRA,LROW,LTYP)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_displa(int lfra, int lrow, int ltyp)
16

DESCRIPTION

18       LFRA        (an input expression of type INTEGER), if non-zero, must
19                   have an integer value, the real equivalent of which is to
20                   become the new value of 'FRAME.'. If LFRA is zero, no
21                   change is to be made in the current value of 'FRAME.'.
22
23                   ·      The default value of 'FRAME.' is "1.", specifying
24                          that each of the routines EZY, EZXY, EZMY, and EZMXY
25                          is to do a frame advance after drawing a graph.
26
27                   ·      The value "2." specifies no frame advance.
28
29                   ·      The value "3." specifies a frame advance before
30                          drawing a graph.
31
32       LROW        (an input expression of type INTEGER), if non-zero, must
33                   have an integer value, the real equivalent of which is to
34                   become the new value of 'ROW.'. If LROW is zero, no change
35                   is to be made in the current value of 'ROW.'. This
36                   parameter affects the way in which the routines EZMY and
37                   EZMXY interpret the arguments XDRA and YDRA, as follows:
38
39                   ·      If 'ROW.' is positive, the first subscript of YDRA
40                          is a point number and the second subscript is a
41                          curve number. If 'ROW.' is negative, the order of
42                          the subscripts is reversed (row-wise, rather than
43                          column-wise, storage).
44
45                   ·      If the absolute value of 'ROW.' is "1.", XDRA is
46                          singly-subscripted; its subscript is a point number.
47                          If the absolute value of 'ROW.' is "2." or greater,
48                          XDRA is doubly-subscripted; the order of the
49                          subscripts is the same as for YDRA.
50
51                   The default value of 'ROW.' is "1.", specifying that XDRA
52                   is singly-subscripted by point number and that YDRA is
53                   doubly-subscripted by point number and curve number, in
54                   that order.
55
56       LTYP        (an input expression of type INTEGER), if non-zero, is an
57                   integer specifying new values for 'X/LOGARITHMIC.' and
58                   'Y/LOGARITHMIC.'. If LTYP is zero, no change is to be made
59                   in the current values.
60
61                   ·      The parameter 'X/LOGARITHMIC.' has the default value
62                          "0.", specifying a linear mapping of user X
63                          coordinates onto the horizontal axis of the grid
64                          window; it may be given either of the two values
65                          "-1." or "+1." to specify a logarithmic mapping. The
66                          value "-1." protects it from being reset as a side
67                          effect of setting 'SET.'. DISPLA generates the value
68                          "0." or "-1.".
69
70                   ·      The parameter 'Y/LOGARITHMIC.' is defined similarly
71                          and affects the mapping of user Y coordinates onto
72                          the vertical axis of the grid window.
73
74                   A non-zero LTYP resets these values, as follows:
75
76
77                             LTYP   'X/LOGARITHMIC.'   'Y/LOGARITHMIC.'
78                             ----   ----------------   ----------------
79                              1     linear             linear
80                              2     linear             logarithmic
81                              3     logarithmic        linear
82                              4     logarithmic        logarithmic
83

C-BINDING DESCRIPTION

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

USAGE

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

EXAMPLES

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

ACCESS

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

COPYRIGHT

108       Copyright (C) 1987-2007
109       University Corporation for Atmospheric Research
110
111       This documentation is free software; you can redistribute it and/or
112       modify it under the terms of the GNU General Public License as
113       published by the Free Software Foundation; either version 2 of the
114       License, or (at your option) any later version.
115
116       This software is distributed in the hope that it will be useful, but
117       WITHOUT ANY WARRANTY; without even the implied warranty of
118       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
119       General Public License for more details.
120
121       You should have received a copy of the GNU General Public License along
122       with this software; if not, write to the Free Software Foundation,
123       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
124
125
126
127UNIX                              March 1993                    DISPLA(3NCARG)