1CPPKLB(3NCARG) NCAR GRAPHICS CPPKLB(3NCARG)
2
6 CPPKLB - Picks a set of labels for labeled contour levels.
7
9 CALL CPPKLB (ZDAT, RWRK, IWRK)
10
12 #include <ncarg/ncargC.h>
13 void c_cppklb (float *zdat, float *rwrk, int *iwrk)
15
17 All three arguments are arrays used in the last call to CPRECT, CPSPS1,
18 or CPSPS2, the contents of which must not have been changed since that
19 call.
20 ZDAT (REAL array, dimensioned as specified in the last call to
22 CPRECT, CPSPS1, or CPSPS2, input) is the data array.
23 RWRK (REAL array, dimensioned as specified in the last call to
25 CPRECT, CPSPS1, or CPSPS2, input/output) is the real
26 workspace array.
27 IWRK (INTEGER array, dimensioned as specified in the last call
29 to CPRECT, CPSPS1, or CPSPS2, input/output) is the integer
30 workspace array.
31
33 The C-binding argument descriptions are the same as the FORTRAN
34 argument descriptions.
35
37 Normally, CPPKLB is called by Conpack when labels for the contour
38 levels are needed. You can call CPPKLB directly (after the
39 initialization call to CPRECT, CPSPS1 or CPSPS2) when you want to
40 modify the resulting parameter arrays that specify the labels.
41 If the constant-field-flag 'CFF' is non-zero, indicating that, during
43 the last call to CPRECT, CPSPS1, or CPSPS2, the data were found to be
44 essentially constant, CPPKLB does nothing. Otherwise, CPPKLB examines
45 the first 'NCL' elements of the parameter array 'CLV', which defines
46 the contour levels, and the associated parameter arrays, looking for
47 levels that are to be labeled ('CLU' = 2 or 3) for which no label is
48 specified (the associated element of 'LLT' is ' ', a single blank.) If
49 any such levels are found, labels are generated for them.
50 The scale factor 'SFU' may be set as a byproduct of choosing the
52 labels. See the description of the parameters 'SFU' (scale factor
53 used) and 'SFS' (scale factor selector) in the conpack_params man page.
54 After calling CPPKLB, a user program may examine the generated labels
56 and change them in various ways.
57
59 Use the ncargex command to see the following relevant example: ccpklb.
60
62 To use CPPKLB or c_cppklb, load the NCAR Graphics libraries ncarg,
63 ncarg_gks, and ncarg_c, preferably in that order.
64
66 See the conpack man page for a description of all Conpack error
67 messages and/or informational messages.
68
70 Online: conpack, cpback, cpchcf, cpchcl, cpchhl, cpchil, cpchll,
71 cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc,
72 cpgeti, cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cprect,
73 cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind
74 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
76
78 Copyright (C) 1987-2007
79 University Corporation for Atmospheric Research
80 This documentation is free software; you can redistribute it and/or
82 modify it under the terms of the GNU General Public License as
83 published by the Free Software Foundation; either version 2 of the
84 License, or (at your option) any later version.
85 This software is distributed in the hope that it will be useful, but
87 WITHOUT ANY WARRANTY; without even the implied warranty of
88 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
89 General Public License for more details.
90 You should have received a copy of the GNU General Public License along
92 with this software; if not, write to the Free Software Foundation,
93 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
94UNIX March 1993 CPPKLB(3NCARG)