ico(1) [xfree86 man page]
ICO(1) General Commands Manual ICO(1) 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] [-objhelp] [-colors color-list] DESCRIPTION
Ico displays a wire-frame rotating polyhedron, with hidden lines removed, or a solid-fill polyhedron with hidden faces removed. There are a number of different polyhedra available; adding a new polyhedron to the program is quite simple. OPTIONS
-r Display on the root window instead of creating a new window. -d pattern Specify a bit pattern for drawing dashed lines for wire frames. -i Use inverted colors for wire frames. -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. Note that this requires twice as many bit planes as without double buffering. 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. -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. -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. -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. PROGRAM TREMINATION
Pressing "q" will close a window. If compiled with threads support, the program will stop only when all threads terminate. You can also close an animation window using the ICCCM delete message (depending on your window manager, you will 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. 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. SEE ALSO
X(7) BUGS
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. Color allocation fails in TrueColor displays and option -faces does not work well. COPYRIGHT
Copyright 1994 X Consortium See X(7) for a full statement of rights and permissions. XFree86 Version 4.7.0 ICO(1)
Check Out this Related Man Page
polyhedra(6x) XScreenSaver manual polyhedra(6x) NAME
polyhedra - draws the 80 uniform polyhedra and their duals SYNOPSIS
SYNOPSIS
polyhedra [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-speed float] [-duration seconds] [-no-wander] [-spin XYZ] [-wireframe] [-no-titles] [-which name] [-wireframe] [-fps] DESCRIPTION
This program renders 160 different 3D solids, and displays some information about each. A new solid is chosen every few seconds. There are 75 uniform polyhedra, plus an inifinite number of prisms and antiprisms: * Convex Uniform Polyhedra: * Platonic solids(5) * Archimedean solids(13) * Convex prisms and antiprisms (2 infinite families) * Nonconvex Uniform Polyhedra: * Kepler-Poinsot polyhedra(4) * Nonconvex uniform polyhedra(53) * Nonconvex prisms, antiprisms, and crossed antiprisms (3 infinite families) Representative samples of the prism sets brings the total to 80 solids. Including the dual of each brings the total up to 160. (To create the "dual" of a polyhedron, faces are replaced with vertices, and vertices with faces.) OPTIONS
-visual visual Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual. -window Draw on a newly-created window. This is the default. -root Draw on the root window. -delay number Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). -speed number Larger numbers mean run faster. Default: 1.0. -duration seconds How long before switching to a new polyhedron. Default 12 seconds. -wander | -no-wander Whether the objects should wander around the screen. -spin [XYZ] | -no-spin Which axes, if any, to spin around on. -titles | -no-titles Whether to display text describing each object. -which object-name Display only one particular object, identified by number, name, or Whthoff symbol. -wireframe | -no-wireframe Render in wireframe instead of solid. -fps Display the current frame rate, CPU load, and polygon count. KEY BINDINGS
When running in a window, you can rotate the object with the mouse. Also, the following keystrokes are defined: SPC or TAB Select a new polyhedron at random. + or > Select the next-higher-numbered polyhedron. - or < Select the next-lower-numbered polyhedron. ESC or ^C Quit. ENVIRONMENT
DISPLAY to get the default host and display number. XENVIRONMENT to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. SEE ALSO
X(1), xscreensaver(1) COPYRIGHT
Copyright (C) 1991-2002 Dr. Zvi Har'El. Copyright (C) 2004 Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any pur- pose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any pur- pose. It is provided "as is" without express or implied warranty. AUTHOR
Based on the program kaleido ("Kaleidoscopic construction of uniform polyhedra"), by Dr. Zvi Har'El <rl@math.technion.ac.il> http://www.math.technion.ac.il/~rl/ ftp://ftp.math.technion.ac.il/kaleido/ Adapted for OpenGL and XScreenSaver by Jamie Zawinski, 2004. X Version 11 5.15 (28-Sep-2011) polyhedra(6x)