1NGWSYM(3NCARG) NCAR GRAPHICS NGWSYM(3NCARG)
2
6 NGWSYM - Draws a symbol from the standard WMO/NOAA meteorological fonts
7 by reference to the font name and symbol number within that font.
8
10 CALL NGWSYM(FTYPE,NUM,X,Y,SIZE,ICOLOR,IALT)
11
13 #include <ncarg/ncargC.h>
14 void c_ngwsym(char *ftype, int num, float x, float y,
16 float size, int icolor, int ialt)
17
19 FTYPE (an input parameter of type CHARACTER) specifying the
20 desired font. Legal values are:
21 'WW' - Present weather.
23 'C' - Cloud types.
25 'CL' - Low clouds.
27 'CM' - Medium clouds.
29 'CH' - High clouds.
31 'W' - Past weather.
33 'N' - Sky cover.
35 'a' - Pressure tendency.
37 NUM (an input parameter of type INTEGER) specifying the number
39 of the desired symbol within the specified font.
40 X (an input parameter of type REAL) specifying the X
42 coordinate position, in world coordinates, where the symbol
43 is to be positioned. This X position marks the horizontal
44 center of the symbol.
45 Y (an input parameter of type REAL) specifying the Y
47 coordinate position, in world coordinates, where the symbol
48 is to be positioned. This Y position marks the vertical
49 center of the symbol.
50 SIZE (an input parameter of type REAL) the value of which is the
52 height, in world coordinates, of the symbol.
53 ICOLOR (an input parameter of type INTEGER) the value of which is
55 the GKS color index specifying what color the symbol will
56 be.
57 IALT (an input parameter of type INTEGER) indicating whether an
59 alternate representation for the specified symbol is to be
60 used. If IALT=1, then the alternate symbol for the one
61 specified is drawn. This applies only to a few symbols
62 such as numbers 7, 93, 94, 95, 97 in the WW font and number
63 3 in the W font.
64
66 The C binding argument descriptions are the same as the FORTRAN
67 argument descriptions.
68
70 This function simply looks up the appropriate symbol in either font 36
71 or 37 of Plotchar and uses Plotchar to draw the symbol.
72 To produce a table of all the weather symbols broken down by font and
74 symbol number, execute "ncargex fngwsym".
75 For the WW (present weather) font, the descriptions for the symbols
77 are:
78 0 Cloud development NOT observed or NOT observable during past hour
81 1 Clouds generally dissolving or becoming less developed during
83 past hour
84 2 State of sky on the whole unchanged during past hour
86 3 Clouds generally forming or developing during past hour
88 4 Visibility reduced by smoke
90 5 Haze
92 6 Widespread dust in suspension in the air, NOT raised by wind, at
94 time of observation
95 7 Dust or sand raised by wind at time of observation
97 8 Well-developed dust whirl(s) within past hour
99 9 Dust storm or sandstorm within sight of or at station during past
101 hour
102 10 Light fog (mist)
104 11 Patches of shallow fog at station, NOT deeper than 6 feet on land
106 12 More or less continuous shallow fog at station, NOT deeper than 6
108 feet on land
109 13 Lightning visible, no thunder heard
111 14 Precipitation within sight, but NOT reaching the ground
113 15 Precipitation within sight, reaching the ground but distant from
115 station
116 16 Precipitation within sight, reaching the ground, near to but NOT
118 at station
119 17 Thunderstorm, but no precipitation at the station
121 18 Squall(s) within sight during past hour or at time of observation
123 19 Funnel cloud(s) within sight of station at time of observation
125 20 Drizzle (NOT freezing) or snow grains (NOT falling as showers)
127 during past hour, but NOT at time of observation
128 21 Rain (NOT freezing and not falling as showers) during past hour,
130 but NOT at time of observation
131 22 Snow (NOT falling as showers) during past hour, but NOT at time
133 of observation
134 23 Rain and snow or ice pellets (NOT falling as showers) during past
136 hour, but NOT at time of observation
137 24 Freezing drizzle or freezing rain (NOT falling as showers) during
139 past hour, but NOT at time of observation
140 25 Showers of rain during past hour, but NOT at time of observation
142 26 Showers of snow or of rain and snow, during past hour, but NOT at
144 time of observation
145 27 Showers of hail or of hail and rain, during past hour, but NOT at
147 time of observation
148 28 Fog during past hour, but NOT at time of observation
150 29 Thunderstorm (with or without precipitation) during past hour,
152 but NOT at time of observation
153 30 Slight or moderate dust storm or sandstorm, has decreased during
155 past hour
156 31 Slight or moderate dust storm or sandstorm, no appreciable change
158 during past hour
159 32 Slight or moderate dust storm or sandstorm has begun or increased
161 during past hour
162 33 Severe dust storm or sandstorm, has decreased during past hour
164 34 Severe dust storm or sandstorm, no appreciable change during past
166 hour
167 35 Severe dust storm or sandstorm has begun or increased during past
169 hour
170 36 Slight or moderate drifting snow, generally low (less than 6
172 feet)
173 37 Heavy drifting snow, generally low
175 38 Slight or moderate blowing snow, generally high (more than 6
177 feet)
178 39 Heavy blowing snow, generally high
180 40 For or ice fog at distance at time of observation, but NOT at
182 station during past hour
183 41 Fog or ice fog in patches
185 42 Fog or ice fog, sky discernible, has become thinner during past
187 hour
188 43 Fog or ice fog, sky NOT discernible, has become thinner during
190 past hour
191 44 Fog or ice fog, sky discernible, no appreciable change during
193 past hour
194 45 Fog or ice fog, sky NOT discernible, no appreciable change during
196 past hour
197 46 Fog or ice fog, sky discernible, has begun or become thicker
199 during past hour
200 47 Fog or ice fog, sky NOT discernible, has begun or become thicker
202 during past hour
203 48 Fog depositing rime, sky discernible
205 49 Fog depositing rime, sky NOT discernible
207 50 Intermittent drizzle (NOT freezing), slight at time of
209 observation
210 51 Continuous drizzle (NOT freezing), slight at time of observation
212 52 Intermittent drizzle (NOT freezing), moderate at time of
214 observation
215 53 Continuous drizzle (NOT freezing), moderate at time of
217 observation
218 54 Intermittent drizzle (NOT freezing), heavy at time of observation
220 55 Continuous drizzle (NOT freezing), heavy at time of observation
222 56 Slight freezing drizzle
224 57 Moderate or heavy freezing drizzle
226 58 Drizzle and rain, slight
228 59 Drizzle and rain, moderate or heavy
230 60 Intermittent rain (NOT freezing), slight at time of observation
232 61 Continuous rain (NOT freezing), slight at time of observation
234 62 Intermittent rain (NOT freezing), moderate at time of observation
236 63 Continuous rain (NOT freezing), moderate at time of observation
238 64 Intermittent rain (NOT freezing), heavy at time of observation
240 65 Continuous rain (NOT freezing), heavy at time of observation
242 66 Slight freezing rain
244 67 Moderate or heavy freezing rain
246 68 Rain or drizzle and snow, slight
248 69 Rain or drizzle and snow, moderate or heavy
250 70 Intermittent fall of snowflakes, slight at time of observation
252 71 Continuous fall of snowflakes, slight at time of observation
254 72 Intermittent fall of snowflakes, moderate at time of observation
256 73 Continuous fall of snowflakes, moderate at time of observation
258 74 Intermittent fall of snowflakes, heavy at time of observation
260 75 Continuous fall of snowflakes, heavy at time of observation
262 76 Ice prisms (with or without fog)
264 77 Snow grains (with or without fog)
266 78 Isolated starlike snow crystals (with or without fog)
268 79 Ice pellets or snow pellets
270 80 Slight rain shower(s)
272 81 Moderate or heavy rain shower(s)
274 82 Violent rain shower(s)
276 83 Slight shower(s) of rain and snow mixed
278 84 Moderate or heavy shower(s) of rain and snow mixed
280 85 Slight snow shower(s)
282 86 Moderate or heavy snow shower(s)
284 87 Slight shower(s) of snow pellets, or ice pellets with or without
286 rain, or rain and snow mixed
287 88 Moderate or heavy shower(s) of snow pellets, or ice pellets, or
289 ice pellets with or without rain or rain and snow mixed
290 89 Slight shower(s) of hail, with or without rain or rain and snow
292 mixed, not associated with thunder
293 90 Moderate or heavy shower(s) of hail, with or without rain, or
295 rain and snow mixed, not associated with thunder
296 91 Slight rain at time of observation; thunderstorm during past
298 hour, but NOT at time of observation
299 92 Moderate or heavy rain at time of observation; thunderstorm
301 during past hour, but NOT at time of observation
302 93 Slight snow, or rain and snow mixed, or hail at time of
304 observation; thunderstorm during past hour, but NOT at time of
305 observation
306 94 Moderate or heavy snow, or rain and snow mixed, or hail at time
308 of observation; thunderstorm during past hour, but NOT at time of
309 observation
310 95 Slight or moderate thunderstorm without hail, but with rain
312 and/or snow at time of observation
313 96 Slight or moderate thunderstorm, with hail at time of observation
315 97 Heavy thunderstorm, without hail, but with rain and/or snow at
317 time of observation
318 98 Thunderstorm combined with dust storm or sandstorm at time of
320 observation
321 99 Heavy thunderstorm with hail at time of observation
323 For the C (cloud types) font:
327 0 Ci - Cirrus
329 1 Cc - Cirrocumulus
331 2 Cs - Cirrostratus
333 3 Ac - Altocumulus
335 4 As - Altostratus
337 5 Ns - Nimbostratus
339 6 Sc - Stratocumulus
341 7 St - Stratus
343 8 Cu - Cumulus
345 9 Cb - Cumulonimbus
347 For the CL (low clouds) font:
351 0 not defined
353 1 Cu of fair weather, little vertical development and seemingly
355 flattened
356 2 Cu of considerable development, generally towering, with or
358 without other Cu or Sc bases all at same level
359 3 Cb with tops lacking clear-cut outlines, but distinctly not
361 cirriform or anvil-shaped; with or without Cu, Sc, St
362 4 Sc formed by spreading out of Cu; Cu often present also
364 5 Sc not formed by spreading out of Cu
366 6 St or StFra (stratus fractus), but no StFra of bad weather
368 7 StFra and/or CuFra of bad weather (scud)
370 8 Cu and Sc (not formed by spreading out of Cu) with bases at
372 different levels
373 9 Cb having clearly fibrous (cirriform) top, often anvil-shaped,
375 with or without Cu, Sc, St, or scud
376 For the CM (medium clouds) font:
380 0 not defined
382 1 Thin As (most of cloud layer semitransparent)
384 2 Thick As, greater part sufficiently dense to hide sun (or moon),
386 or Ns
387 3 Thin Ac, mostly semitransparent: cloud elements not changing much
389 and at a single level
390 4 Thin Ac in patches; cloud elements continually changing and/or
392 occurring at more than one level
393 5 Thin Ac in bands or in a layer gradually spreading over sky and
395 usually thickening as a whole
396 6 Ac formed by the spreading out of Cu or Cb
398 7 Double-layered Ac, or a thick layer of Ac, not increasing; or Ac
400 with As and/or Ns
401 8 Ac in the form of Cu-shaped tufts or Ac with turrets
403 9 Ac of a chaotic sky, usually at different levels; patches of
405 dense Ci are usually present also
406 For the CH (high clouds) font:
410 0 not defined
412 1 Filaments of Ci, or "mares tails," scattered and not increasing
414 2 Dense Ci in patches or twisted sheaves, usually not increasing,
416 sometimes like remains of Cb; or towers or tufts
417 3 Dense Ci, often anvil-shaped, derived from or associated with Cb
419 4 Ci, often hook-shaped, gradually spreading over the sky and
421 usually thickening as a whole
422 5 Ci and Cs, often in converging bands, or Cs alone; generally
424 overspreading and growing denser; the continuous layer not
425 reaching 45 degree altitude
426 6 Ci and Cs, often in converging bands, or Cs alone; generally
428 overspreading and growing denser; the continuous layer exceeding
429 45 degree altitude
430 7 Veil of Cs covering the entire sky
432 8 Cs not increasing and not covering entire sky
434 9 Cc alone or Cc with some Ci or Cs, but the Cc being the main
436 cirriform cloud
437 For the W (past weather) font:
441 0 Clear or few clouds [no associated symbol]
443 1 Partly cloudy (scattered) or variable sky [no associated symbol]
445 2 Cloudy (broken) or overcast [no associated symbol]
447 3 Sandstorm or dust storm, or drifting or blowing snow
449 4 Fog, ice fog, thick haze or thick smoke
451 5 Drizzle
453 6 Rain
455 7 Snow, or rain and snow mixed, or ice pellets
457 8 Shower(s)
459 9 Thunderstorm, with or without precipitation
461 For the N (sky cover) font:
465 0 No clouds
467 1 One-tenth or less
469 2 Two-tenths or three-tenths
471 3 Four-tenths
473 4 Five-tenths
475 5 Six-tenths
477 6 Seven-tenths or eight tenths
479 7 Nine-tenths or overcast with openings
481 8 Completely overcast (ten-tenths)
483 9 Sky obscured
485 For the a (pressure tendency) font:
489 0 Rising, then falling; same as or higher than 3 hours ago
491 1 Rising, then steady; or rising, then rising more slowly
493 2 Rising steadily, or unsteadily
495 3 Falling or steady, then rising; or rising, then rising more
497 rapidly
498 4 Steady; same as 3 hours ago
500 5 Falling, then rising; same as or lower than 3 hours ago
502 6 Falling, then steady; or falling, then falling more slowly
504 7 Falling steadily, or unsteadily
506 8 Steady or rising, then falling; or falling, then falling more
508 rapidly
509 9 not defined
511
513 CALL NGWSYM('N',5,.5,.5,.25,1,0)
514 Plots the symbol for six-tenths cloud cover at position (.5,.5)
515 and height .25 in the foreground color.
516 CALL NGWSYM('a',6,.2,.8,.3,1,0)
518 Plots the symbol for barometric pressure that is falling then
519 steady.
520 CALL NGWSYM('WW',95,.5,.5,.2,1,1)
522 Plots the alternate symbol for slight or moderate thunderstorm
523 without hail.
524 Use the ncargex command to see the following relevant example:
526 fngwsym.
527
529 To use NGWSYM or c_ngwsym, load the NCAR Graphics libraries ncarg,
530 ncarg_gks, and ncarg_c, preferably in that order.
531
533 If an illegal font, or symbol number within a font, is requested, then
534 a warning is issued.
535
537 Online: plotchar(3NCARG), ncarg_cbind(3NCARG)
538 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
540
542 Copyright (C) 1987-2007
543 University Corporation for Atmospheric Research
544 This documentation is free software; you can redistribute it and/or
546 modify it under the terms of the GNU General Public License as
547 published by the Free Software Foundation; either version 2 of the
548 License, or (at your option) any later version.
549 This software is distributed in the hope that it will be useful, but
551 WITHOUT ANY WARRANTY; without even the implied warranty of
552 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
553 General Public License for more details.
554 You should have received a copy of the GNU General Public License along
556 with this software; if not, write to the Free Software Foundation,
557 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
558UNIX March 1993 NGWSYM(3NCARG)