THREED(6)

💖 THREED(6) — ok bestie, let's talk about xthreed 💖

so this is THREED(6) from the Games Manual, and no cap it's a whole vibe. it's the man page for the Threed X widget and I'm gonna walk you through every single line of it so nothing gets lost. periodt. 🦋

---

✨ NAME ✨

xthreed — the Threed X widget. that's it, that's the name, slay. 👑

---

🌸 SYNOPSIS 🌸

lowkey it's a long one, here's the whole thing verbatim, don't skip:

/usr/games/xthreed [-geometry
[{width}][x{height}][{+-}{xoff}[{+-}{yoff}]]] [-display [{host}]:[{vs}]]
[-{foreground|fg} {color}] [-{background|bg} {color}] [-{border|bd}
{color}] [-white {color}] [-[lt|dk|ltlt|dkdk]gray {color}] [-black
{color}] [-another {color}] [-select {color}] [-frame {color}]
[-[no]stippleFrame] [-delay msecs] [-[no]sound] [-bumpSound {filename}]
[-moveSound {filename}] [-[no]surface] [-object {int}] [-x {int}] [-y
{int}] [-z {int}] [-theta {int}] [-phi {int}] [-psi {int}] [-version]

yes the real one runs from /usr/games/xthreed, and yes we're keeping every bracket exactly where it was, don't touch it, she's sensitive. 🎀

---

🫶 DESCRIPTION 🫶

it's a simple 3D viewer 💅 — though, and I'm quoting the page here, it may need some work. we love an honest queen.

the roll part doesn't seem to be quite right and may not track well 😭. of note is the mouse to 3D surface detection ✨ (that's the part the page itself wants you to clock).

in the sample data, Boxes and F16 are big, so the polyhedrons are scaled up to them in the data file. iykyk. 📏

now the keyboard tea, take notes bestie:

• press L or l to move the shape left ⬅️
• press R or r to move the shape right ➡️
• press U or u to move the shape up ⬆️
• press D or d to move the shape down ⬇️
• press I or i to move the shape in 🫧
• press O or o to move the shape out 🌈
• press S or s to change surface
• press B or b to change object
• press @ to toggle the sound 🔊
• press Esc to hide the program 🙈
• Q, q, or Ctrl+C kill the program 💀

use the key pad or arrow keys to rotate the object 🌀. the key pad is defined for Threed like this, keeping the diagram exactly as it is:

   /      Counterclockwise

   8      Up
   ^
 4<5>6  Left, Clockwise, Right
   v
   2      Down

so like, / is counterclockwise, 8 is up, 4 is left, 5 is clockwise, 6 is right, 2 is down. three guesses what the arrows do and the first two don't count. 🎯

---

💅 OPTIONS 💅

one bullet per option, every resource name intact, we do not play about resource names.

• -geometry {+|-}X{+|-}Y — sets the initial position of the threed window (resource name "geometry").
• -display host:dpy — specifies the X server to contact. 📡
• -{foreground | fg} color — specifies the foreground of the threed window (resource name "foreground").
• -{background | bg} color — specifies the background of the threed window (resource name "background"). 🎨
• -{border|bd} color — specifies the color of the surface border (resource name "surfaceBorder").
• -white color — specifies the color of the white paintbrush (resource name "whiteBrush"). 🤍
• -[lt|dk|ltlt|dkdk]gray color — specifies the color of the gray the paintbrush (resource name "[lt|dk|ltlt|dkdk]grayBrush"). 🩶
• -black color — specifies the color of the black of the paintbrush (resource name "blackBrush").
• -another color — specifies the of color of the a paintbrush (resource name "anotherBrush").
• -select color — specifies the color for selected item (resource name "selectColor").

ok bestie so here's the situation: in the original page the -select entry runs straight into the frame option and there's a literal TP 8 -frame color sitting in the middle of that paragraph. no cap. so I'm giving -frame its own bullet so you can actually read it:

• -frame color — specifies the color of the frame (resource name "frameColor").

🙈 that's just how the page is written, we're reporting it faithfully. don't come for me, come for the TP 8.

• -[no]stippleFrame — toggle the frame stippling (resource name "stippleFrame").
• -delay msecs — specifies the number of milliseconds it takes to move (1-50) (resource name "delay"). ⏱️
• -[no]sound — specifies if a sliding tile should make a sound or not (resource name "sound"). 🔊
• -bumpSound filename — specifies the file for the bump sound for the clicking of a new surface (resource name "bumpSound").
• -moveSound filename — specifies the file for the move sound (not used yet) (resource name "moveSound"). not used yet, bestie, she's decorative for now.
• -[no]surface — lets you access the hidden surface removal mode and wire mode (resource name "surface").
• -object <int> — lets you set the object to be viewed (resource name "object").
• -distance <int> — lets you set the distance of the object to be viewed (resource name "distance").
• -theta <int> — lets you set the angle of the to be viewed in degrees (resource name "thetaDegrees"). this one corresponds to yaw. 🌀
• -phi <int> — lets you set the angle of the to be viewed in degrees (resource name "phiDegrees"). this one corresponds to pitch. 📐
• -psi <int> — lets you set the angle of the to be viewed in degrees (resource name "psiDegrees"). this one corresponds to roll. 🎢
• -version — tells you what version of xthreed you have. 🏷️

💀 quick note for the detail girlies: the synopsis also lists -x {int}, -y {int} and -z {int}, which don't get their own descriptions down here, and -distance <int> lives down here without showing up in the synopsis. I'm not changing a single character of either list — just clocking it, iykyk.

---

🌈 SEE ALSO 🌈

go be nosy, the whole friend group is here:

X(1), xcubes(6), xtriangles(6), xhexagons(6), xmlink(6), xbarrel(6), xpanex(6), xmball(6), xpyraminx(6), xoct(6), xrubik(6), xskewb(6), xdino(6), xbevel(6), xabacus(6)

---

👑 COPYRIGHTS 👑

® Copyright 1995-2024, David A. Bagley

---

🐛 BUG REPORTS AND PROGRAM UPDATES 🐛

got bugs? got reports of bugs? got fixes?? icon behaviour, send them all to the author:

David A. Bagley, <bagleyd AT verizon.net>

the latest version is currently hanging out at:

https://www.sillycycle.com/threed.html

---

and that's the whole page bestie, we ate and left no crumbs 🍓✨. this was THREED(6), version V8.9.1, dated 18 Apr 2025 — mwah, go rotate something, you're the main character 💖🦋🎀🫶👑