AREDAM(3NCARG)

✨ AREDAM — bestie, we're adding edge segments to an area map 💖

okay so real quick, this is a page from the NCAR GRAPHICS manual, and it lives in section 3NCARG. It's giving "niche but iconic," and honestly? We love her for it. 🎀

---

🌸 NAME 🌸

AREDAM — she adds edge segments to an area map. That's it. That's the whole job. Slay. 💅

---

🦋 SYNOPSIS 🦋

CALL AREDAM (MAP,XCA,YCA,LCA,IGI,IDL,IDR)

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/ncargC.h>

void c_aredam (int *map, float *xca, float *yca, int lca, int igi, int
idl, int idr)

---

💜 DESCRIPTION 💜

okay so here's the lineup, bestie, every single one of them, no skips:

• MAP — an input/output array of type INTEGER, aka an array holding an area map that has already been initialized by a call to ARINAM.

note bestie: when ARINAM initialized the area map, it stored the dimension of MAP inside MAP(1). so the dimension does NOT have to be passed as an argument when you call AREDAM. she already knows her own size. main character energy. 👑

• XCA — an input array, dimensioned LCA, of type REAL. These are the X coordinates (in the user coordinate system) of the points that define an edge. 📍
• YCA — an input array, dimensioned LCA, of type REAL. The Y coordinates (in the user coordinate system) of those same points defining an edge. 📍
• LCA — an input expression of type INTEGER. It's the number of coordinates sitting in XCA and YCA. count 'em. 🔢
• IGI — an input expression of type INTEGER. The identifier of the group that the edge belongs to. 🏷️
• IDL — an input expression of type INTEGER. The identifier of the area lying to the left of the edge. ⬅️
• IDR — an input expression of type INTEGER. The identifier of the area lying to the right of the edge. ➡️

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are literally the same as the FORTRAN argument descriptions. same energy, different font. 🫶

---

🔥 USAGE 🔥

The area-map array MAP must have been initialized by a call to ARINAM — no skipping that step, bestie, she needs her setup. 💅

After that, every subsequent call to AREDAM adds the LCA-1 edge segments to the area map. Those segments are defined by the points whose user coordinates live in the arrays XCA and YCA. and here's how the pairing goes, it's lowkey simple:

• points 1 and 2 define the first edge segment
• points 2 and 3 define the next edge segment
• points 3 and 4 define the one after that
• and so on, forever, iconic behavior

---

⭐ EXAMPLES ⭐

use the ncargex command to see the following relevant examples, bestie, go look, they ate:

cardb1, cardb2, carfill, carline, carmap, arex01, cbex01, tareas, fsppoint

---

💖 ACCESS 💖

to use AREDAM or c_aredam, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that exact order, no cap. 🙈

---

🎀 MESSAGES 🎀

see the areas man page for a description of all Areas error messages and/or informational messages. she's got receipts. 🧾

---

🌸 SEE ALSO 🌸

Online: areas, areas_params, ardbpa, ardrln, argeti, argetr, argtai, arinam, armvam, arpram, arscam, arseti, arsetr, ncarg_cbind

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

---

👑 COPYRIGHT 👑

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

---

and that's the whole page, bestie, we did it 💜 this lil gem came to you courtesy of the UNIX manual, dated March 1993, filed under AREDAM(3NCARG) — fr fr, iconic since '93. bye bestie, go plot something gorgeous 🦋✨