Areas(3NCARG)

💖 NAME 💖

Areas — bestie, this is a whole set of routines that lets you build an area map out of a bunch of edges, and then go absolutely feral using that area map for whatever you need. It's from the NCAR GRAPHICS manual, section 3NCARG. Slay.

---

✨ SYNOPSIS ✨

Like, here's the whole squad, one per line:

• ARINAM — Initializes an area map.
• AREDAM — Adds edges to an area map.
• ARMVAM — Moves an area map from one integer array to another.
• ARPRAM — Preprocesses an area map.
• ARSCAM — Obtains definitions of areas created by edges in an area map.
• ARDRLN — Draws a polyline masked by a given area map.
• ARGTAI — Gets area identifiers associated with a given point.
• ARGETI — Retrieves the integer value of an Areas parameter.
• ARGETR — Retrieves the real value of an Areas parameter.
• ARSETI — Provides a new integer value for an Areas parameter.
• ARSETR — Provides a new real value for an Areas parameter.
• ARDBPA — Produces a picture of a specified portion of the area map.

🦋 C-BINDING SYNOPSIS 🦋

Yes bestie, there's a C side too, and she eats:

#include <ncarg/ncargC.h>

and then the C-besties themselves:

• c_arinam
• c_aredam
• c_arpram
• c_arscam
• c_ardrln
• c_argtai
• c_argeti
• c_arseti
• c_ardbpa

---

🌈 ACCESS 🌈

To use the Areas Fortran or C routines, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. Order matters, ok? She's particular. 💅

---

💀 MESSAGES 💀

When error conditions are detected, the support routine SETER gets called. By default, SETER writes a message to the standard error file (as defined by I1MACH(4)) and then terminates execution. Not me getting absolutely obliterated by an error message 😭

But wait — it is possible to put SETER into recovery mode and regain control after a recoverable error, and lowkey all of the possible errors are recoverable. So the drama is optional.

The possible error messages are listed below. All errors are recoverable in the sense that a user program which has called ENTSR to set recovery mode will get control back after one of these errors occurs. Periodt.

ARDBDA - UNCLEARED PRIOR ERROR
ARDBPA - BAD POINTERS IN AREA MAP
ARDBPA - ERROR EXIT FROM GQPLCI
ARDBPA - ERROR EXIT FROM GQTXCI
ARDBPA - INITIALIZATION DONE IMPROPERLY
ARDBPA - UNCLEARED PRIOR ERROR
ARDRLN - ALGORITHM FAILURE
ARDRLN - INITIALIZATION DONE IMPROPERLY
ARDRLN - MAI TOO SMALL
ARDRLN - UNCLEARED PRIOR ERROR
AREDAM - AREA-MAP ARRAY OVERFLOW
AREDAM - INITIALIZATION DONE IMPROPERLY
AREDAM - UNCLEARED PRIOR ERROR
ARGETI - PARAMETER NAME NOT KNOWN - X
ARGETI - PARAMETER NAME TOO SHORT - X
ARGETI - UNCLEARED PRIOR ERROR
ARGETR - PARAMETER NAME NOT KNOWN - X
ARGETR - PARAMETER NAME TOO SHORT - X
ARGETR - UNCLEARED PRIOR ERROR
ARGTAI - ALGORITHM FAILURE
ARGTAI - INITIALIZATION DONE IMPROPERLY
ARGTAI - MAI TOO SMALL
ARGTAI - UNCLEARED PRIOR ERROR
ARINAM - AREA-MAP ARRAY IS TOO SMALL
ARINAM - UNCLEARED PRIOR ERROR
ARINIT - VALUE OF 'LC' IS TOO LARGE
ARMPIA - MULTIPLE-PRECISION QUANTITY IS TOO BIG
ARMVAM - INITIALIZATION DONE IMPROPERLY
ARMVAM - NEW AREA-MAP ARRAY IS TOO SMALL
ARMVAM - UNCLEARED PRIOR ERROR
ARPRAM - ALGORITHM FAILURE
ARPRAM - AREA-MAP ARRAY OVERFLOW
ARPRAM - INITIALIZATION DONE IMPROPERLY
ARPRAM - NO EDGES IN AREA MAP
ARPRAM - UNCLEARED PRIOR ERROR
ARSCAM - ALGORITHM FAILURE
ARSCAM - AREA-MAP ARRAY OVERFLOW
ARSCAM - INITIALIZATION DONE IMPROPERLY
ARSCAM - MAI TOO SMALL
ARSCAM - MCS TOO SMALL
ARSCAM - UNCLEARED PRIOR ERROR
ARSETI - PARAMETER NAME NOT KNOWN - X
ARSETI - PARAMETER NAME TOO SHORT - X
ARSETI - UNCLEARED PRIOR ERROR
ARSETR - PARAMETER NAME NOT KNOWN - X
ARSETR - PARAMETER NAME TOO SHORT - X
ARSETR - UNCLEARED PRIOR ERROR

---

🫶 SEE ALSO 🫶

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

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version

iykyk 💜

---

👑 COPYRIGHT 👑

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

---

Okay so that's the whole page bestie — from the UNIX manual, April 1995, filed under Areas(3NCARG). Go build some area maps and be the main character of your own plot. No cap. 🎀✨🦋