
  Copyright 1994 - 2013  David A. Bagley, bagleyd@tux.org

  All Rights Reserved

  Permission to use, copy, modify, and distribute this software and
  its documentation for any purpose and without fee is hereby granted,
  provided that the above copyright notice appear in all copies and
  that both that copyright notice and this permission notice appear in
  supporting documentation, and that the name of the author not be
  used in advertising or publicity pertaining to distribution of the
  software without specific, written prior permission.

  This program is distributed in the hope that it will be "useful",
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

8.0.0

wthreed
=======

A Three D Widget

Web: http://www.tux.org/~bagleyd/puzzles.html

Download: Primary site: ftp://ftp.tux.org/pub/tux/bagleyd/xpuzzles
          Secondary site: ftp://ibiblio.org/pub/Linux/games/strategy

Maintainer: David A. Bagley <bagleyd@tux.org>

  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
    sudo apt-get install lesstif2-dev
  You need to install XPM if you want color icons:
    sudo apt-get install libxpm-dev
  You need to install rplay if you want sound (also available esd or nas):
    sudo apt-get install librplay3-dev
  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", thats 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.

  [Feb 24, 2015]  V8.0.0:
    Sound and install fixes.
  [May 19, 2014]  V7.7.5:
    Fixed winodows 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.

Version 7: 03/11/15 X/Windows
Version 5: 95/10/02 Xt/Motif
Version 4: 94/11/17 Xt
Version 3: 93/05/17 Motif
Version 2: 93/05/14 XView
Version 1: 93/03/01 MS Windows by Thomas W. Olsen "The C Users Journal"
