CPBACK(3NCARG)

📦 version 6.6.2.dfsg.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ CPBACK ✨ (3NCARG)

okay bestie, gather round, because this is a NCAR GRAPHICS situation and it's giving "i just need a cute little box around my contour plot" 💅

🌸 NAME 🌸

CPBACK — draws a background for a contour plot. that's it. that's the job. it makes the frame. 🎀

🦋 SYNOPSIS 🦋

CALL CPBACK (ZDAT, RWRK, IWRK)

💜 C-BINDING SYNOPSIS 💜

#include <ncarg/ncargC.h>

void c_cpback (float *zdat, float *rwrk, int *iwrk)

✨ DESCRIPTION ✨

so like, all three of these arguments are arrays that came from the last call to CPRECT, CPSPS1, or CPSPS2, and listen — their contents must not have been changed since that call. do not touch. do not edit. leave them exactly as they were. fr fr. 🙈

  • ZDAT — (REAL array, dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input) this is the data array. the main character. 👑
  • RWRK — (REAL array, dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input/output) this is the real workspace array.
  • IWRK — (INTEGER array, dimensioned as specified in the last call to CPRECT, CPSPS1, or CPSPS2, input/output) and this is the integer workspace array.

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are literally the same as the FORTRAN argument descriptions. same vibes, different syntax, no notes. 🫶

🔥 USAGE 🔥

you can call CPBACK at any time after the initialization call to CPRECT, CPSPS1, or CPSPS2. easy. no drama.

now — what CPBACK actually does depends on the value of the internal parameter 'MAP':

  • if 'MAP' is set to zero, CPBACK draws the perimeter of the current viewport by calling PERIM, in the utility Gridall, requesting 'ZDM'-1 major ticks on the horizontal sides of the perimeter and 'ZDN'-1 major ticks on the vertical sides. no minor ticks are drawn. nope, not a single one. 💀
  • if 'MAP' is set non-zero, CPBACK does nothing. it simply does not participate. it's in its quiet era. 😭

🍓 EXAMPLES 🍓

use the ncargex command to see the following relevant examples — and bestie, it's a whole roster, i'm not skipping a single one:

ccpback, ccpcff, ccpcfx, ccpcis, ccpcit, ccpclc, ccpcld, ccpcldm, ccpcll, ccpclu, ccpdflt, ccpfil, ccphand, ccphcf, ccphl, ccphlt, ccpila, ccpils, ccpilt, ccpklb, ccplbam, ccplbdr, ccpline, ccpllb, ccpllc, ccplll, ccpllo, ccpllp, ccpllt, ccpllw, ccpncls, ccpnet, ccpnof, ccpnsd, ccppc, ccppc1, ccppc2, ccppc3, ccppc4, ccppkcl, ccprc, ccprect, ccprwc, ccprwu, ccpscam, ccpset, ccpsps1, ccpsps2, ccpspv, ccptitle, ccpvp, cidsfft, cpex01, fsfsgfa.

okay that's a lot of examples but they ate. 🔥

💖 ACCESS 💖

to use CPBACK or c_cpback, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters, don't be chaotic about it. ✨

🎀 MESSAGES 🎀

see the conpack man page for a description of all Conpack error messages and/or informational messages. that's where the lore lives. iykyk. 📖

🌸 SEE ALSO 🌸

Online: conpack, cpchcf, cpchcl, cpchhl, cpchil, cpchll, cpcica, cpclam, cpcldm, cpcldr, cpcltr, cpcnrc, cpdrpl, cpezct, cpgetc, cpgeti, cpgetr, cplbam, cplbdr, cpmpxy, cpmviw, cpmvrw, cppkcl, cppklb, cprect, cprset, cpscae, cpsetc, cpseti, cpsetr, cpsps1, cpsps2, ncarg_cbind

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

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 one came from the UNIX world, dated March 1993, and it lives under the name CPBACK(3NCARG). slay, stay framed, and don't touch your workspace arrays. periodt. 🦋✨

📦 where this page comes from