Command Line

Documentation / Icosahedra

• Overview of Icosahedra
  • What It Does
  • What It Is Not
• Using Icosahedra
  • Under CySaver
  • Windowed On The Desk
  • Fullscreen Without CySaver
  • Embed And Prefs Preview
  • Modes At A Glance
• Command Line
  • Draw Modes
  • Scene
  • Colour And Motion
  • Window And Saver
• Copyright

Command Line

icosahedra [OPTION]...

OpenGL icosahedron hack. No Motif. Needs a display except for --selftest.

Draw Modes

Pick one with -mode NAME, or the short flag of the same name (-solid, -wire, -mesh, -blur, -mixed, -cycle, -pipes).

• solid -- filled rainbow faces (default)
• wire -- edge wireframe, rainbow
• mesh -- dense hatched face wireframe
• blur -- solid plus motion trails
• mixed -- per-body solid or wire
• cycle -- auto-cycle solid, blur, mesh, wire, mixed
• pipes -- Cyanotype silver tubes

Scene

• -bounce -- multi-body bounce (default scene)
• -single -- one icosahedron, tumble and drift
• -count N / -n N -- body count (default 20, Octahedra pack size)

Fewer bodies draw larger (~1.5x at 3 versus 20).

Colour And Motion

Rainbow is on by default (SGI look).

• -color SPEC -- mono tint; turns rainbow off (wire and tinted solid)
• -wire-color SPEC -- mono wire colour
• -tint SPEC -- pipes / mono solid tint
• -rainbow / -no-rainbow -- force rainbow on or off
• -trail F -- blur fade per frame, 0..1 (default 0.18)
• -rotate / -no-rotate -- spin bodies (default: rotate on)
• -rate N -- motion coefficient 1..10 (default 5 = nominal)

Window And Saver

• -window -- ordinary framed window (default)
• -fullscreen -- override-redirect full screen; exit on key or pointer
• -geometry WxH -- windowed size
• -window-id / -parent 0xWIN -- embed in an existing window
• -fps N -- frame rate
• -no-input-exit -- keep running on key/mouse (preview and embed)

CySaver preview uses -window-id plus -no-input-exit. Idle and Test Full Screen use -fullscreen so activity can end the hack for lock.

Housekeeping

• -h -- help
• -V -- version
• --selftest -- geometry checks; no display required

Examples

icosahedra -mode solid -bounce -count 20
icosahedra -wire -single -geometry 640x480
icosahedra -cycle -fullscreen
icosahedra -pipes -no-rainbow -tint c0c0d0
icosahedra -window-id 0x2000003 -no-input-exit -mesh

See Also

• Using Icosahedra
• Overview of Icosahedra