From: kaleb@JPL-DEVVAX.JPL.NASA.GOV (Kaleb Keithley)
Newsgroups: comp.windows.x.announce
Subject: Xaw3d Version 0.5
Date: 17 Dec 92 22:07:55 GMT
Distribution: inet

Version 0.5 of Xaw3d incorporates the fixes to the Xaw Widget Set that 
were distributed recently in X Consortium Public Fix #20.

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

Features:

This is Release 0.5 beta (14 Dec, 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 some of the clients distributed on the R5 MIT 
source tape.

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 Incorporated the fixes to the SimpleMenu and Text widgets that 
      were distributed as part of the X Consortium's public fix #20.

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.5.tar.Z


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):
          All the people at the X Consortium
          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@jpl-devvax.jpl.nasa.gov

-- 

Kaleb Keithley                               kaleb@jpl-devvax.jpl.nasa.gov