From: kaleb@thyme.Jpl.Nasa.Gov (Kaleb Keithley)
Newsgroups: fj.mail-lists.x-window
Subject: Xaw3d-0.3 -- Three-D Athena Widgets
Date: 9 Nov 92 17:44:03 GMT
Distribution: fj
Organization: Workstation Div., Supermicro Systems Group, Sony Corporation

Date: Mon, 9 Nov 92 11:32:33 -0500
Message-Id: <9211091632.AA06806@expo.lcs.mit.edu>


                   Three-D Athena Widgets (Xaw3d)
                      kaleb@thyme.jpl.nasa.gov

Features:

This is Release 0.3 beta (4 Nov, 1992) of a set of 3-D widgets based 
on the R5 Athena Widget set.  The Three-D Athena may be used as a general 
replacement of the Athena (Xaw) Widget set.

In general, it is possible to relink any Athena Widget based application 
with the Three-D Athena Widget set to obtain a three dimensional appearance.  

The Three-D Athena Widget set uses a ThreeD subclass to add the following 
widget resources: top shadow color, bottom shadow color, shadow width, top 
shadow contrast, bottom shadow contrast, user data, and a "be nice to the
colormap" option.

In this release, I have tested all the clients distributed on the R5 MIT 
source tape, plus xfig.

Top and bottom shadow colors, shadow width, top and bottom shadow contrast
should be self explanatory, and may be set via the usual and customary 
methods, e.g. app-defaults, .Xdefaults, programmatically, with editres, 
etc.  The user data resource may be used to "hang" application specific 
data on a widget, and is only settable programmatically.


This release changes the following features:

    o Different shadow pixmaps provide a more 3-D look on 1-bit visuals.

    o 3-D added to SmeBSB gadgets.  Pulldown menus are more M*tif-like.

    o 3-D removed from the List widget.  Probably never should have been.


This release fixes the following bugs:

    o There are no known bugs.


Known problems:

    o There have been some reports to the effect that renaming and 
      replacing Xaw shared libraries with Xaw3d shared libraries tends 
      to produce erratic results on SVR4 systems.  Try it and see; if
      you experience problems, then you should explicitly relink against 
      Xaw3d.

    o Renaming and replacing Xaw shared libraries with Xaw3d shared
      libraries will definitely break aXe and xarchie; they won't even 
      compile against Xaw3d because they subclass the Xaw widgets.
      Because the aXe and xarchie subclass hierarchies don't match the 
      Xaw3d subclass hierarchy, they don't work together.

      There are two possible solutions:  Change aXe and xarchie subclasses 
      to conditionally include the Xaw3d subclass, or merge the 3d stuff 
      into the Xaw Simple and Xaw SmeBSB subclasses.  I'm not inclined to 
      do the latter, but I may do the former if I ever get enough time, in 
      which case I will feed them back to the authors.


Getting:

Xaw3d may be found on export.lcs.mit.edu (18.24.0.12) and possibly other
sites; check archie.  On export, it may be found in the file:

    ~ftp/contrib/Xaw3d/R5/Xaw3d-0.3.tar.Z

There is no patch file to go from 0.2 to 0.3.  I tried to create one, but
when I tested it, it consistently rejected changes in two files.  Sorry.


Building:  

Untar the distribution from the base of your MIT source tree.  This will 
create the directory .../mit/lib/Xaw3d.  'cd' there and:

'make Makefile; make includes; make depend; make; make install'.  

The Imakefile uses the Xaw symbols in .../mit/config, so if you have 
debugging, profiling, shared libs, etc. specified for Xaw, you'll get 
them in Xaw3d too.


Using:

Just relink your Xaw based application with -lXaw3d.

To obtain an appearance similar to another well know widget set, use the 
following resources:
    *background:        LightSkyBlue
    *shapeStyle:        Rectangle
    *beNiceToColorMap:  False

If you'd like labels to be "shadowed", use:
    *Label*shadowWidth: 2

If you'd like the default behavior (i.e. not 3-D) on pulldown menus, use:
    *SmeBSB*shadowWidth: 0


Credits (in no particular order):
          Achille Hui (eillihca@drizzle.stanford.edu)
          Robert Withrow (witr@rwwa.com)
          Malcolm Strickland (chuck-strickland@orl.mmc.com
          David Flanagan (david@ora.com)
          Jamie Zawinski (jwz%thalidomide@lucid.com
          Frank Terhaar-Yonkers (fty@bizarre.trpnc.epa.gov)
          Mike Schulze (mike@cs.curtin.edu.au)
          Gustaf Neumann (neumann@dec4.wu-wien.ac.at)
          Jerry Whelan (guru@stasi.bradley.edu)
          Mark Rawling (mwr@mel.dit.csiro.au)


Comments, fixes, etc. to: 
          kaleb@thyme.jpl.nasa.gov

-- 

Kaleb Keithley                          kaleb@thyme.jpl.nasa.gov

Not authorized, in any way, shape, or form, to speak for anyone.