


ICO(1)                                                                 ICO(1)



NAME
  ico - animate an icosahedron or other polyhedron

SYNOPSIS
  iiccoo [-display display] [-geometry geometry] [-r] [-d pattern] [-i] [-dbl]
  [-faces] [-noedges] [-sleep n] [-obj object] [-objhelp] [-colors color-
  list]

DESCRIPTION
  _I_c_o 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r   Display on the root window instead of creating a new window.

  --dd ppaatttteerrnn
       Specify a bit pattern for drawing dashed lines for wire frames.

  --ii   Use inverted colors for wire frames.

  --ddbbll 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.

  --ffaacceess
       Draw filled faces instead of wire frames.

  --nnooeeddggeess
       Don't draw the wire frames.  Typically used only when -faces is used.

  --sslleeeepp _n
       Sleep n seconds between each move of the object.

  --oobbjj _o_b_j_e_c_t
       Specify what object to draw.  If no object is specified, an
       icosahedron is drawn.

  --oobbjjhheellpp
       Print out a list of the available objects, along with information
       about each object.

  --ccoolloorrss _c_o_l_o_r _c_o_l_o_r ...
       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.


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 else-
  where), 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(1)

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.

COPYRIGHT
  Copyright 1988, Massachusetts Institute of Technology.
  See _X(_1) for a full statement of rights and permissions.













































