🚀 go-pugleaf

Archive-name: auto/comp.windows.x.announce/Xaw3d-0-2-Three-D-Athena-Widgets


Announcing the 0.2 release of Xaw3d. 

If you already have Xaw3d-0.1, a patch file is available from:

    export:/contrib/Xaw3d/R5/Xaw3d.diff-0.1-0.2

This patch represents a small change from 0.1.  I'm making this release
primarily because of the time elapsed since 0.1.

The following is the README:


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

Features:

This is Release 0.2 beta (22 Oct, 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 and xarchie.  

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 adds no new features.


This release fixes the following bugs:

    o Stripchart shadow drawing
    o Command shadow drawing when highlight thickness <= 0


Known problems:

    o Renaming and replacing Xaw shared libraries with Xaw3d shared
      libraries tends to produce erratic results on SVR4 systems.
      You should explicitly relink against Xaw3d for reliable results.

    o Renaming and replacing Xaw shared libraries with Xaw3d shared
      libraries will definitely break aXe; and it certainly won't even 
      compile against Xaw3d.  

      aXe subclasses many of the Xaw widgets.  Because the aXe subclass 
      hierarchy doesn't match the Xaw3d subclass hierarchy, they don't 
      work together.

      There are two possible solutions:  Change aXe subclasses to
      conditionally include the Xaw3d subclass, or merge the 3d stuff 
      into the Xaw Simple subclass.  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 author(s) of aXe.

    o It's been reported that long scrolled lists are noticibly slower
      in Xaw3d than in Xaw.  This is due, I believe in part, because List 
      widgets, as a class, don't compress exposures, and the 3-D shadows 
      are redrawn unnecessarily.  

      Only a few applications on the MIT tape use the List widget, and 
      those that do, don't scroll them.  xfig uses a scrolled List in its 
      File Selection Dialog, but its lists aren't very long.  This might
      be a tough nut to crack.


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.2.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 that other 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


Extra Credit:

I recommend adding Xaw3d symbols to .../mit/config/Project.tmpl,
and, if you're on a Sun or a SVR4 box, SunLib.tmpl or sv4Lib.tmpl too.
You'll want to create parallel symbols for most of the Athena
symbols.  Symbols you'll want 3d versions of might include:
   AWIDGETSRC        ---> A3DWIDGETSRC
   DEPXAWLIB         ---> DEPXAW3DLIB
   XAWLIB            ---> XAW3DLIB
   LINTXAW           ---> LINTXAW3D
   XawClientLibs     ---> Xaw3dClientLibs
   XawClientDepLibs  ---> Xaw3dClientLibs

I'll leave it as an exercise as to the values for those symbols.


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.