FENCE3(3NCARG)

✨ FENCE3 ✨ (the NCARG one, bestie)

okay so real talk β€” this one lives in the NCAR Graphics manual, and it's giving "3D but make it a picket fence." πŸ’… Let's get into it.


🌸 NAME 🌸

FENCE3 β€” draws the projection of a curve, just like CURVE3 does, except it also slaps a "fence" on it: a bunch of straight line segments, all parallel to one of the three axes, stretching from the curve out to a plane you specify (and that plane is perpendicular to the same axis). iconic behavior honestly 🚧✨


πŸŽ€ SYNOPSIS πŸŽ€

CALL FENCE3 (U,V,W,N,IOREN,BOT)

πŸ¦‹ C-BINDING SYNOPSIS πŸ¦‹

#include <ncarg/ncargC.h>

void c_fence3 (float *u, float *v, float *w, int n,
int ioren, float bot)

πŸ’– DESCRIPTION πŸ’–

  • U,V,W β€” input arrays, dimensioned at least N, of type REAL. They hold the U, V, and W coordinates (respectively, obviously πŸ’) of the points that define the curve whose projection we're about to draw. three arrays, three coordinates, one slay.
  • N β€” an input expression of type INTEGER, aka the number of points defining the curve. the headcount fr fr.
  • IOREN β€” an input expression of type INTEGER, and this is the direction the fence lines get drawn in. the options are:
    1. Parallel to the U axis.
    2. Parallel to the V axis.
    3. Parallel to the W axis.

that's it, that's the list, pick one 🌈

  • BOT β€” an input expression of type REAL that says where the bottom of the fence gets drawn. like, for example: if the fence lines are being drawn parallel to the W-axis, and BOT=2., then the bottom of the fence is the plane W=2. easy.
⚠️ okay so tiny reality check: the word "bottom" might be a liiiiittle misleading here. the entire curve could be below the plane of the "bottom," and the fence could actually be horizontal instead of vertical in three-dimensional space. so like. don't come for the naming. πŸ™ˆ

The curve and the fence are drawn in the colors implied by the values of the variables ITHRMJ and ITHRMN, respectively, over in the Threed COMMON block:

COMMON /THRINT/ ITHRMJ,ITHRMN,ITHRTX

The default value of both ITHRMJ and ITHRMN is 1; user code may change these values. so if the colors are off, that's on you bestie πŸ’…


🌈 C-BINDING DESCRIPTION 🌈

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different language. periodt. 🫢


⭐ EXAMPLES ⭐

Use the ncargex command to see the following relevant example: fthex04. go look at it, it's cute, it'll teach you things πŸŽ€


πŸ‘‘ ACCESS πŸ‘‘

To use FENCE3 or c_fence3, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c β€” preferably in that order. order matters, don't test fate πŸ”₯


πŸ’œ SEE ALSO πŸ’œ

Online: threed, curve3, frst3, line3, perim3, point3, psym3, pwrz, pwrzt, set3, threed, tick3, tick43, vect3, ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

(yes threed is in there twice, no I'm not deleting it, the manual said it twice and I respect the manual 🧚)


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's from the NCAR Graphics crew, dated March 1993, and it's the UNIX flavor of the manual. go forth and fence responsibly. πŸ’…βœ¨πŸ¦‹