8.3.1

wthreed
=======

A Three D Widget

Web: https://www.sillycycle.com/puzzles.html

Download: Primary site: https://www.sillycycle.com/puzzles
          Secondary site: http://ibiblio.org/pub/Linux/games/strategy

Maintainer: David A. Bagley <bagleyd AT verizon.net>

  To build you need at minimum both of these, X11 and Xt (unless you are
  looking to build win32).
    sudo apt-get install libx11-dev
    sudo apt-get install libxt-dev
  You may need to install one of these to build Motif version:
    sudo apt-get install libmotif-dev (strongly recommended)
    sudo apt-get install lesstif2-dev (defunct)
  You need to install XPM if you want color icons:
    sudo apt-get install libxpm-dev (strongly recommended)
  To install XMU if you want editres:
    sudo apt-get install libxmu-dev (probably not useful)
  To install sound libraries (defunct):
    sudo apt-get install librplay3-dev
    sudo apt-get install libesd0-dev
    sudo apt-get install libaudiofile-dev
    sudo apt-get install nas-dev
    sudo apt-get install pulse-dev
      In place of these it is just configured by default with
      --enable-def-play=play.sh
  Then should be a simple
    configure; make

  Try resizing Threed.  Notice the image resizes to take advantage of
  the "room" available.

  Try editing the file Threed.ad to get a certain feature and then copying
  to $(HOME)/Threed (where Threed is the file name) and running xthreed
  again.  There is also a Windows port (wthreed).

  Keep in mind that Threed is a widget that can be simply stuck in
  other X programs. (If you find a use for this, let me know).

  Refer to the man page for detailed command line options and instructions
  on how to operate.

FILE FORMAT

  The format is pretty standard.  I got it mostly from PHIGS.  I added
  a few things.  The "threed.comm" file has some comments that may help
  in understanding the "threed.dat", that's the only reason it is
  included.  The program will crash if data file is corrupted.  Please
  note that the ordering of the data matters.

FOUND A BUG?

  Send bugs reports and fixes to the author. For bugs, please include
  as much information as to their location as possible, since I may not
  be able to duplicate them.

other stuff to do
  1. Handle multiple objects better.
  2. Tracking of rotation does not seem correct.

Updates:
  [Nov 30, 2020]  V8.3.1:
    Added the Small Stellated Dodecahedron, Great Stellated
      Dodecahedron, and Great Icosahedron.
  [Nov 28, 2020]  V8.3.0:
    Added 2 more colors.
    Added the Great Dodecahedron with ideas from
      http://www.georgehart.com/virtual-polyhedra/colorings.html
  [Apr 04, 2020]  V8.2.6:
    Lots of spelling errors fixed due to codespell
      https://manpages.debian.org/testing/codespell/codespell.1.en.html
    Updated references to website to https.  https://www.sillycycle.com
  [Feb 15, 2019]  V8.2.1:
    Fixed spinner to not wrap where unappropriate.
  [Oct 02, 2018]  V8.2.0:
    Removing strcpy call by migrating to strncpy.
      Added HAVE_SNPRINTF compile-time option.
  [Jul 21, 2018]  V8.1.8:
    Fixing sound installation.
  [Apr 03, 2018]  V8.1.7:
    Updated slider format.
  [Oct 15, 2017]  V8.1.4:
    Removed gcc 7 warnings.
  [Oct 01, 2017]  V8.1.3:
    Updates for 64 bit compilation in Windows.
  [Aug 01, 2017]  V8.1.1:
    Valgrind helped find some definite memory leaks.
  [Jul 17, 2017]  V8.1.0:
    Updated sound configuration for X version.  Uses a simple included
      script play.sh, that is now used by default.
  [Sep 13, 2016]  V8.0.5:
    Old website http://www.tux.org/~bagleyd died, shifted code base to
      new website http://www.sillycycle.com
  [Feb 24, 2015]  V8.0.0:
    Sound and install fixes.
  [May 19, 2014]  V7.7.5:
    Fixed windows version for truncated octahedron. 
  [Jan 20, 2014]  V7.7.3:
    Reorganized pixmap directory.
  [Jan 10, 2013]  V7.7.1:
    Added scroll to feature help dialog.
    New bold fontlist in resource file, so things are easier to read.
  [Oct 06, 2010]  V7.6.4:
    Added truncated octahedron.
  [Jun 29, 2010]  V7.6.3:
    Added extra keys F12 for CW and F11 for CCW.
  [Jan 21, 2010]  V7.6:
    Version handling changed to a single version.h (and man page).
    Sound fixed for esound.
  [Nov 10, 2009]  V7.5.1:
    Windows version: added accelerator for references.
  [Jun 05, 2009]  V7.5:
    Cleaned up menu look.
    Fixed again for NAS sound.
  [Dec 14, 2008]  V7.4.3:
    Fixed for NAS sound.
  [Jul 21, 2008]  V7.4.1:
    Changed format of edges to conform to ico, I subtracted 1.
    Strange character at end of help title removed.
    Change for edge input to be consistent with ico.
    Added pyramid and stella octangula.
    Fixed default choice is visible in Motif list.
    For stella octangula, made it so that all 3 face segments are
      highlighted when pressed.
  [Jul 11, 2008]  V7.4:
    Leading function names in lowercase.
  [May 30, 2008]  V7.3.5:
    Modified select so that it gives full outline of selected item.
    Fixed background on Windows version.
    Made 's' a toggle of surface for Windows version.
    Made 'b' to let you go through all objects for Windows version.
  [Feb 29, 2008]  V7.3.4:
    Changed pointer from crosshair to hand2.
  [Dec 24, 2007]  V7.3.2:
    Constants changed.
    Added 3d look to frame.
    Fixed select motion bug in X.
  [Nov 06, 2007]  V7.3.1:
    Updated action codes and synchronized Java and C code.
    Various small changes.
  [Feb 23, 2007]  V7.3:
    Html no longer corrupted.
  [Dec 12, 2006]  V7.2.3:
    Now use http://netpbm.sourceforge.net to generate images from xpm.
  [Dec 05, 2006]  V7.2.2:
    Sorting is now done for wireframe.
  [Apr 01, 2006]  V7.2:
    Made usage string compatible with versions of Motif and screen.
  [Oct 05, 2005]  V7.1.5:
    -version added
    Common option help for X and X-Motif
  [May 31, 2005]  V7.1.4:
    Separated out compatible components.
  [Feb 8, 2005]  V7.1.3:
    3d viewer made slightly less primitive.
    Mouse wheel for Windows now works.
    Rotating now mouse motion sensitive.
    Mouse can now find a face of polyhedron.
  [Aug 23, 2004]  V7.1:
    Hide functionality should now work again.
  [Dec 20, 2003]  V7.0.2:
    Added help for Motif.
  [Dec 15, 2003]  V7.0.1:
    The Hide functionality of the Escape key now iconifies or drops in
      task bar.
    Added help for Windows.
    Accelerator Keys (F keys and regular keys) in Windows now work.
  [Nov 15, 2003]  V7.0:
    Added color icon.
    Integrated winpuz6.5 (Windows 3.1/95) into X source tree.
  [Oct 26, 2003]  V5.7.4:
    Mouse wheel scrolling added.
  [Aug 28, 2003]  V5.7.2:
    Added some installation options and reorganized installation.
  [Jul 07, 2003]  V5.7:
    'Esc' will hide the puzzle (actually osfCancel did the trick)
  [Mar 21, 2003]  V5.6.2:
    Installation fixes for Motif and X versions.
    configure if around 2nd AC_CHECK_FUNC
    removed Sun CC (char *) warnings
    removed hard coding of program name
    Cygwin changes ./, -lSM -lICE
    allow more arrow keys (osf)
    handed some nulls from core dumping
    fixed up sliders not to give warnings
  [Dec 15, 95]	V5.1: Minor updates, finally got around to publicly
    releasing it..
  [Oct 02, 95]	V5.0: Xt/Motif.
  [Nov 11, 94]	V4.0: Xt version.
  [May 17, 93]	V3.0: Motif version.
    I got some good ideas from Douglas A. Young's book:
    "The X Window System Programming and Applications with
    Xt OSF/Motif Edition", particularly his dial widget.
    I got some good ideas on presentation from Q. Zhao's
    tetris.
  [May 14, 93]	V2.0: XView version.
  [Mar 01, 93]	V1.0: MS Windows by Thomas W. Olsen "The C Users Journal"
    pp 53-61.
