8.8.4

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)
  As an alternative to Motif you can use Athena (and its variants):
    sudo apt-get install xaw7-dev
    (Also could use XAW3D xaw3d-1.6.3-3-x86_64.pkg.tar.zst)
  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.

  Note: if using Athena and want the popups to be able to be closed when
    using a close window button in top bar, uncomment translations stuff
    in app-defaults file (.ad file) prior to "make install".  This may
    lead to warnings if for example the Motif version also exists.

  Try editing the file XThreed.ad to get a certain feature and then
  copying to $(HOME)/XThreed (where XThreed 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 (maybe because of gimbal
     lock?).

Updates:
  [Aug 15, 2024]  V8.8.4:
    Fix for frame color.
    Added a frame (with stippling for X version) to give it more of a
      bamboo or a wooden look.
  [May 31, 2024]  V8.8.1:
    Moving resource file from Threed to XThreed to follow standard.
    Revamped default install to install for Gnome/KDE.
  [Aug 09, 2023]  V8.7.1:
    Fixing configure to not use -std=c89 as it may not always work with
      installed includes.
  [Dec 16, 2022]  V8.6.2:
    Athena: Simplified menu code and fixed check.
  [Dec 14, 2022]  V8.6.1:
    Updating Athena libs as seen in xterm build and adding XawPlus.
    Fixing up and down bitmaps.
  [Dec 09, 2022]  V8.6.0:
    Redesign gui parts as getting too unwieldy.  Ripping out xgui.h
      xgui.c from main file.
    Athena: Adding new spinner, updating old slider and toggle.
  [Oct 31, 2022]  V8.5.6:
    Updating for Xaw3dxft and neXtaw.
  [Oct 14, 2022]  V8.5.5:
    Athena: Added label for pulldowns.
  [Oct 04, 2022]  V8.5.4:
    Windows: Fixed for Great Icosahedron in menu.
    Motif/Athena: Updated menus and popup titles.
    Motif/Athena: Added sound toggle in menu.
  [Sep 01, 2022]  V8.5.3:
    Fixed Windows version broken after V8.3.1
    Updated to use XtAppInitialize from XtInitialize.  This helped fix
      Athena issue when killing dialog by window exit and bringing
      down application (WM_PROTOCOLS nonsense).
    Athena: popup window title bar close handled better.
    Athena: added scroll bar dialog box for features.
  [Jul 30, 2022]  V8.5.2:
    Athena scrolling added and menus added.
    Added Cuboctahedron and the Square Antiprism from mxico.
  [Jul 11, 2022]  V8.5.1:
    Cleanup and configuration updates.
  [Jul 07, 2022]  V8.5.0:
    Athena version, because I got complaints about Motif being old.
  [May 27, 2021]  V8.3.7:
    Setting in data file stopped options from working, like -z.
  [Apr 06, 2020]  V8.3.5:
    Set edges to border color so you can see the edges when two
      faces come together of the same color.
  [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.
