ICO(1)

💖 ico — bestie, it's giving ROTATING POLYHEDRA 💖

okay so real quick, this is the manual for ico, from the General Commands Manual section of your friendly neighborhood man pages. sit down, grab a strawberry, we're gonna spin some shapes 🌸

---

✨ NAME ✨

ico — animate an icosahedron or other polyhedron 🦋

---

🌈 SYNOPSIS 🌈

ico [-display display] [-geometry geometry] [-r] [-d pattern] [-i]
[-dbl] [-faces] [-noedges] [-sleep n] [-obj object] [-colors color-list]

ico -objhelp

ico -version

---

💅 DESCRIPTION 💅

So ico literally draws a wire-frame rotating polyhedron for you — and it's not messy about it, because it removes the hidden lines. or, if you'd rather, it does a solid-fill polyhedron with the hidden faces removed. either way? iconic. 👑

and the best part, bestie: there are a bunch of different polyhedra available, and adding a new polyhedron to the program is quite simple. no cap. ✨

---

🎀 OPTIONS 🎀

• -r — display on the root window instead of making a whole new window. main character energy, just vibing on the background 🫶
• -d pattern — specify a bit pattern for drawing dashed lines for wire frames.
• -i — use inverted colors for wire frames. the flip side, the remix 💜
• -dbl — use double buffering on the display. this works for either wire frame or solid fill drawings. for solid fill drawings, using this switch results in substantially smoother movement. lowkey important note tho: this requires twice as many bit planes as without double buffering. and since some colors are typically allocated by other programs, most eight-bit-plane displays will probably be limited to eight colors when using double buffering. 😭
• -faces — draw filled faces instead of wire frames. glow-up mode 🔥
• -noedges — don't draw the wire frames. typically used only when -faces is used.
• -sleep n — sleep n seconds between each move of the object. slow it down, let it breathe 🧚
• -obj object — specify what object to draw. if no object is specified, an icosahedron is drawn.
• -objhelp — print out a list of the available objects, along with information about each object. the menu, basically 📋
• -colors color color ... — specify what colors should be used to draw the filled faces of the object. if less colors than faces are given, the colors are reused. ♻️
• -version — print program version information and exit. bye bestie 👋

---

🚪 PROGRAM TERMINATION 🚪

Pressing "q" will close a window.

if it was compiled with threads support, the program will stop only when all threads terminate — so don't panic if it lingers a sec, it's just waiting for the whole squad to finish. 🫶

you can also close an animation window using the ICCCM delete message (depending on your window manager, you'll have a decoration button or menu to send such message).

---

🛠️ ADDING POLYHEDRA 🛠️

if you have the source to ico, it is very easy to add more polyhedra. here's the tea:

each polyhedron is defined in an include file by the name of objXXX.h, where XXX is something related to the name of the polyhedron. the format of the include file is defined in the file polyinfo.h. look at the file objcube.h to see what the exact format of an objXXX.h file should be, then create your objXXX.h file in that format. 💖

after making the new objXXX.h file (or copying in a new one from elsewhere), simply do a 'make depend'. this will recreate the file allobjs.h, which lists all of the objXXX.h files. doing a 'make' after this will rebuild ico with the new object information. periodt. ✨

---

👀 SEE ALSO 👀

X(7)

---

💀 BUGS 💀

okay so, full transparency, no gatekeeping:

• Pyramids and tetrahedrons with filled faces do not display correctly. 🙈
• A separate color cell is allocated for each name in the -colors list, even when the same name may be specified twice. and color allocation fails in TrueColor displays and option -faces does not work well. it's giving tragic, honestly. 😭

---

and that's the whole page, bestie!! this was X Version 11, ico version 1.0.6 — go spin something pretty 💖✨🦋🌸💅