NPIET-FOOGOL(1)

📦 version 1.3f, in nixos 26.05, nixpkgs unstable

💖 NAME 💖

Okay so this is npiet-foogol(1), straight outta the General Commands Manual — and it's literally npiet-foogol — a foogol to piet compiler. Slay.

✨ SYNOPSIS ✨

npiet-foogol [ -v | -d ] [ -w <n> ] [ -b <n> ] [ -cs <n> ] inputfile

🌸 DESCRIPTION 🌸

npiet-foogol translates foogol input into a piet program. So basically npiet-foogol creates a picture from foogol source. That picture is — well, should be — a valid piet program, and it can be executed, eg. by the npiet interpreter. Iconic behavior, fr fr. 🎨

🎀 OPTIONS 🎀

  • -h — prints usage help and exits. respectful queen behavior 👑
  • -v — be somewhat verbose. not full yapper mode, just a little yap.
  • -d — prints debug output (lot's of more or less cryptic and mostly useless blurb). 💀 yes it says that, and yes it's giving "trust me bestie".
  • -w <n> — sets a wrap-width in pixel. This gives the compiler a hint about a block width to use when generating expressions or statements. Usually code is generated left to right until the wrap-width is reached and then to the left. To avoid codel overlaps in loops and conditionals, code is generated with a virtual left border — but this wrap-width too. Here is lot of optimisation possible. ✨
  • -b <n> — sets the base used by generating a number. The default is 7, and a value greater or equal of 2 is acceptable. In a piet program the number of codels (here pixels) of a color block represents a number. To be able to push a large number on the stack without wasting a lot of ink, the number is calculated and the given base is used to do so. math girlie moment 🧮💅
  • -cs <n> — sets the output codel size to n pixels. The default is 1. Use a higher value to get a larger output picture. big picture energy 🔥
  • -rnd — experimental feature to set the start codel not always to red, but to a somewhat more random value. This does not work reliable — please avoid if running in trouble... 🫶 warning bestie, it's experimental.
  • -o <filename> — sets the output filename. Default is npiet-foogol.png. 📁
  • inputfile — the foogol program to read. Use a - to read from <stdin>. 🧚

🦋 FILES 🦋

  • npiet-foogol.png — default name of the piet program file to write. It is overwritten if it exists. 🙈 so don't get attached, it will absolutely get replaced.

👑 AUTHOR 👑

Erik Schoenfelder <schoenfr@web.de>. 💌

💀 BUGS 💀

Surely lots. Not me saying that — the page says that. But honestly? Respect for the honesty. 😭

🌈 SEE ALSO 🌈

That's the whole cute lil manual page, bestie — go compile something iconic 🫶✨

npiet v1.3 • Aug 2011 • mwah 💋

📦 where this page comes from