RESET(3NCARG)

💫 RESET 💫

okay bestie, welcome to the NCAR Graphics section 3 manual page for RESET — yes that's the whole name, no lowercase weirdness, we're being loud about it. ✨

🌸 NAME 🌸

RESET — the "super" version of RESET zeroes the internal integer array used to detect crowded lines; other versions do nothing.

fr fr that's the entire job description. the super version is the one with main character energy, everyone else is just standing there 💅

🦋 SYNOPSIS 🦋

CALL RESET

💖 C-BINDING SYNOPSIS 💖

#include <ncarg/ncargC.h>

void c_reset()

✨ USAGE ✨

okay so here's the tea 🍵 — the "super" version of the Dashline utility is out here trying to cull crowded lines from the output picture. it does this using an internal integer array, ISCREN, where each bit used represents a single pixel in a square array of 1024x1024 pixels of the picture. so like, a whole pixel-per-bit situation, iconic.

initially, all the bits must be set to zero by calling the routine RESET. no skipping this, bestie, it's the whole point of the function.

then, when a line segment is about to be drawn, an appropriate set of bits in ISCREN (representing the pixels through which the line segment passes) is examined. if any bit in that set is a 1, the line segment is not drawn. so if that area's already spoken for, the line just... doesn't get its moment. 😭

then the bits representing the pixels in the immediate vicinity of the line segment are set to 1, so as to prevent any subsequent line segment from being drawn through the area. it's giving "this seat is taken" 🪑

and when each label is drawn, the bits in ISCREN representing the area occupied by the label are set to 1 as well, which prevents subsequent line segments from being drawn through the label. labels get protection, periodt.

this culling process has the following implications for the user of the "super" version of Dashline:

• the routine RESET should be called at the beginning of each new picture. if this is not done, each of a consecutive series of pictures will have progressively more gaps where line segments have been culled. (not me forgetting to reset and watching my picture slowly disintegrate 💀)
• more important lines should be drawn first, followed by less important lines. for example, the "super" version of the routine CONREC draws labeled contour lines first, followed by the contour lines halfway in between the labeled lines, followed by the rest of the lines. priority order, we love to see it 👑
• because each line segment is either drawn in its entirety or not at all, long straight line segments are broken into shorter pieces. the internal parameter MLLINE determines how small the resulting pieces will be; you may wish to reduce its value so that smaller pieces will be used.

🌈 EXAMPLES 🌈

use the ncargex command to see the following relevant examples: tdashp, fdlsmth.

go look at them, they're right there, they're cute 🎀

🫶 ACCESS 🫶

to use RESET or c_reset, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. yes the order matters, don't be chaotic about it 💅

👑 SEE ALSO 👑

Online: dashline, dashline_params, curved, dashdb, dashdc, frstd, lastd, lined, vectd, ncarg_cbind

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

⭐ 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 🧚 this little legend came to you from the UNIX crew back in March 1993, filed under RESET(3NCARG) — yeah, section 3, we're fancy like that. mwah, go call your RESET 💖