N_ICONS(1)

📦 version 0.32, in nixos 26.05, nixpkgs unstable

💅 N_ICONS(1) — like, the whole vibe 💅

okay bestie, buckle up — this is the manual page for n_icons, a User Command, and it's about to be your new obsession ✨

🌸 NAME 🌸

n_icons — sphericon like polyhedra 🌀 (yes, polyhedra, plural, we're being fancy today)

🎀 SYNOPSIS 🎀

n_icons [options]

that's it. that's the whole invocation. so clean 💅

🦋 DESCRIPTION 🦋

It creates Sphericon like Polyhedra — also known as Streptohedra, which is honestly such a main character name, no cap 👑

✨ Options ✨

the basics, the little guys, the starter pack 🫶

  • -h, --help — this help message (run 'off_util -H help' for general help)
  • --version — version information
  • -I — information on current n-icon
  • -l <lim> — minimum distance for unique vertex locations, given as a negative exponent (default: 12, which gives 1e-12)
  • -o <file> — write output to file (default: write to standard output)

🔥 Program Options 🔥

here's where you actually get to build the thing, bestie 🧚

  • -n <n/d> — n-icon of order n. n must be 3 or greater (default: 4). use d to make a star n-icon. d may not equal n
  • -t <twst> — number of twists. Can be negative, positive or 0 (default: 1)
  • -s — side-cut of even order n-icon (default is point-cut)
  • -H — hybrid of even order n-icon
  • -a — angle (-z 3 only)
  • -r <num> — override inner radius (-z 2 only)
  • -R <num> — override outer radius (-z 2 only)
  • -b — don't split bowtie faces for twisting (-z 3, -t 0 only)
  • -z <mthd> — construction method:
    • 1 — n/d must be co-prime. bow-ties can occur (default for d=1)
    • 2 — n/d compounds allowed. shell model (default for d>1)
    • 3 — n/d compounds allowed. No bow-ties (default if angle not 0)

🌈 Scene Options 🌈

setting the stage, making it look right 💜

  • -M <m,m2> — longitudes of model of m sides with optional m2 of m sides showing. m may be odd, 3 or greater if twist is 0 (default: 36,36)
  • -g — make m2 longitudes invisible instead of deletion (no -c)
  • -A — place a north and south pole in top and bottom if they exist (twist 0 or n/2, causes indentation of caps with side cut)
  • -c <clse> — close open model if m2<m. Valid values h or v (-z 1,2):
    • h = horizontal closure
    • v = vertical closure
  • -x <elms> — v, e and f to remove OFF faces with one vertex (vertices), two-vertices (edges) and three or more vertices (faces). E — if face is invisible, associated edge is made invisible
  • -Y — for n/d shells, when showing edges, show indented edges
  • -W — add symmetry polygon (-f s,c or -e s)

🍓 Coloring Options 🍓

run off_util -H color for help on color formats, bestie — iykyk

keyword: none — sets no color or methods. use: map_'color name'% for one color 🌸

  • -F <mthd> — mthd is face coloring method. The coloring is done before twist ✨
    • s — color by symmetry polygon (default)
    • f — color circuits with flood fill (-z 2,3 any n/d)
    • c — color by compound
    • k — color by compound with flood fill (-z 2,3 any n/d)

note: the following color options may look better at twist 0 👀

  • l — color latitudinally
  • m — color longitudinally
  • b — checkerboard with first two colors in the color map
  • n — use each color in map in succession
  • x — first two colors based on sign of x
  • y — first two colors based on sign of y
  • z — first two colors based on sign of z (z is the twist plane)
  • o — use first eight colors per xyz octants
  • -E <mthd> — mthd is edge coloring method. The coloring is done before twist ✨
    • keyword: Q — defer coloring all edges to option Q (default)
    • or use the same letter options specified in -f, except c,k
    • F — color edges with average adjoining face color
  • -T <t,e> — transparency. from 0 (invisible) to 255 (opaque). element is any or all of e — edges, f — faces, a — all (default: f)
  • -m <maps> — color maps to be tried in turn. (default: colorful, circuits -C). optionally followed by elements from e or f (default: ef). use map name of index to output index numbers
    • colorful: red,darkorange1,yellow,darkgreen,cyan,blue,magenta,white,gray50,black
    • circuits: white,gray50 (continuous, discontinuous no wrapping)
  • -S — color circuits symmetrically for coloring method s,f (even n)
  • -C — color continuous and discontinuous circuits with first two colors in the color list (-I required, s,f coloring, no -S, no -z 2)
  • -O <strg> — face transparency pattern string. valid values:
    • 0 — -T n,f value suppressed
    • 1 — -T n,f value applied (default: '1')
  • -P <strg> — edge transparency pattern string. valid values:
    • 0 — -T n,e value suppressed
    • 1 — -T n,e value applied (default: '1')
  • -Q <col> — color given to uncolored edges and vertices (default: invisible)
  • -G <c,e> — default color c for uncolored elements e (default: darkgray,ef). elements e can include e or f
  • -X <int> — flood fill stop. used with circuit or compound coloring (-f f,k). use 0 (default) to flood fill entire model. if -X is not 0 then return 1 from program if entire model has been colored

👑 Surface (or Compound) Count Reporting 👑

heads up bestie — the options above are ignored when you're in reporting mode 💀
  • -L <type> — types of n-icons to list. Valid values for type:
    • p = point cut even order n_icons
    • s = side cut even order n-icons
    • o = odd order n_icons
    • h = hybrids (all)
    • i = hybrids (where N/2 is even)
    • j = hybrids (where N/2 is odd)
    • k = hybrids (where N/4 is even)
    • l = hybrids (where N/4 is odd)
  • -N <n,n2> — range of n-icons to list. n > 2
  • -D <int> — set d of n/d for the report (default: 1)
  • -K <k,k2> — range of surfaces (or compounds) to list. k > 0 (default: 2,1000)
  • -J — long form report
  • -Z — filter out case 2 types (surfaces only)
  • -B — list compounds instead of circuits

⭐ SEE ALSO ⭐

The full documentation for n_icons is maintained as a Texinfo manual. If the info and n_icons programs are properly installed at your site, the command

info n_icons

should give you access to the complete manual. slay 💅

and that's the page, bestie 🫶 this one's from n_icons: Antiprism 0.32 — http://ww... (yeah the footer got cut off, not me tho 😭) — go forth and make iconic sphericons 💖✨🎀🦋

📦 where this page comes from