ARDRLN(3NCARG)

🦋 ARDRLN 🦋 (3NCARG)

okay bestie, sit down, hydrate, because we're doing the NCAR GRAPHICS manual page for ARDRLN, and she is lowkey iconic. This is the one that draws a polyline but makes it ✨respect the area map✨ — like a polyline with boundaries and self-respect. 💅

---

✨ NAME ✨

ARDRLN — draws a polyline that is masked by a given area map.

(that's it. that's the whole vibe. masked polyline. no cap.)

---

💖 SYNOPSIS 💖

CALL ARDRLN (MAP,XCD,YCD,NCD,XCS,YCS,MCS,IAI,IAG,MAI,LPR)

---

🌈 C-BINDING SYNOPSIS 🌈

#include <ncarg/ncargC.h>

void c_ardrln (int *map, float *xcd, float *ycd, int ncd, float *xcs,
float *ycs, int mcs, int *iai, int *iag, int mai, int (*lpr)(float *xcs,
float *ycs, int *ncs, int *iai, int *iag, int *nai))

---

🎀 DESCRIPTION 🎀

okay so here's the whole cast of characters, and bestie, every single one of them matters:

• MAP — (an input/output array of type INTEGER) — an array holding an area map that's been initialized by a call to ARINAM, and then had edges added to it by calls to AREDAM. And here's the tea: if you did not preprocess the area map by calling ARPRAM, then ARDRLN calls it for you before doing anything else. so generous of her honestly.

Note: as part of initializing the area map, ARINAM stores the dimension of MAP in MAP(1); therefore, the dimension does not have to be given as an argument in calls to ARDRLN. she already knows her own size, periodt.

• XCD — (an input array, dimensioned NCD, of type REAL) — the X coordinates, in the user coordinate system, of the points defining the polyline.
• YCD — (an input array, dimensioned NCD, of type REAL) — the Y coordinates, in the user coordinate system, of the points defining the polyline. (yes, she's the twin sister of XCD, they come as a set 🫶)
• NCD — (an input expression of type INTEGER) — the number of points defining the polyline.
• XCS — (a workspace array, dimensioned MCS, of type REAL) — used by ARDRLN in calls to LPR, the user-supplied line-processing routine, to hold the X coordinates of the polyline segment contained in a given area.
• YCS — (a workspace array, dimensioned MCS, of type REAL) — used by ARDRLN in calls to LPR, the user-supplied line-processing routine, to hold the Y coordinates of the polyline segment contained in a given area.
• MCS — (an input expression of type INTEGER) — dimension of each of the arrays XCS and YCS.
• IAI — (a workspace array, dimensioned MAI, of type INTEGER) — the area identifier array, used in calls to LPR, the user-supplied line-processing routine.
• IAG — (a workspace array, dimensioned MAI, of type INTEGER) — the group identifier array, used in calls to LPR, the user-supplied line-processing routine.
• MAI — (an input expression of type INTEGER) — dimension of each of the arrays IAI and IAG. MAI must be greater than or equal to n, where n is the number of groups in the area map. don't skimp on this one bestie, she will notice. 👀
• LPR — (a subroutine) — a line-processing routine that you supply for ARDRLN to call. LPR must be declared EXTERNAL in the routine that calls ARDRLN. LPR must have the following structure:

SUBROUTINE LPR (XCS,YCS,NCS,IAI,IAG,NAI)
DIMENSION XCS(*),YCS(*),IAI(*),IAG(*)

(code to process polyline defined by XCS, YCS, IAI, and IAG)

RETURN
END

and inside that routine, the arguments mean:

• XCS,YCS — (input arrays, dimensioned NCS, of type REAL) — hold the X and Y coordinates, in NDCs, of NCS points defining a piece of the original polyline that is completely contained in one of the areas defined by the area map.
• NCS — (an input expression of type INTEGER) — number of X and Y coordinates in the arrays XCS and YCS.
• IAI,IAG — (input arrays, dimensioned NAI, of type INTEGER) — hold NAI pairs of area identifiers and group identifiers, respectively, for the area in which the piece of the polyline lies. For each value of I from 1 to NAI, IAI(I) is the area identifier for the area with respect to the group of edges specified by the group identifier IAG(I).
• NAI — (an input expression of type INTEGER) — number of values given in IAI and IAG. NAI equals the number of groups of edges that you put in the area map.

Before executing the first call to LPR, ARDRLN calls GETSET to retrieve the current user-system mapping parameters and then executes the following statement:

CALL SET (VPL,VPR,VPB,VPT,VPL,VPR,VPB,VPT,1)

where VPL, VPR, VPB, and VPT are the viewport left, right, bottom, and top coordinates in NDCs.

This ensures correct results if the NDCs in XCS and YCS are used by the line-processing routine LPR in calls to such routines as GPL and CURVE, and it allows for clipping at the edges of the viewport. LPR may make its own SET call to achieve some other effect. Before returning control to the calling routine, ARDRLN calls SET again to restore the original mapping parameters. (she puts the room back exactly how she found it. considerate queen. 👑)

---

💜 C-BINDING DESCRIPTION 💜

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical, no notes, fr fr.

---

🌸 EXAMPLES 🌸

Use the ncargex command to see the following relevant examples: carline, tareas, fsppoint.

go look at them. they eat. 🔥

---

⭐ ACCESS ⭐

To use ARDRLN or c_ardrln, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. in that order bestie, the order is not a suggestion. 🙈

---

🍓 MESSAGES 🍓

See the areas man page for a description of all Areas error messages and/or informational messages. if she's yelling, that's where the translation lives.

---

🧚 SEE ALSO 🧚

• Online: areas, areas_params, ardbpa, aredam, argeti, argetr, argtai, arinam, armvam, arpram, arscam, arseti, arsetr, ncarg_cbind
• Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

iykyk 💅

---

💀 COPYRIGHT 💀

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

---

okay that's the whole page bestie, you ate, go draw your masked polylines 🦋✨

This was the UNIX version, dated March 1993, for ARDRLN(3NCARG). mwah, sending you off with the source and date, love u, bye 💖