home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #16 / NN_1992_16.iso / spool / comp / archives / 2995 < prev    next >
Encoding:
Internet Message Format  |  1992-07-29  |  5.1 KB

  1. Path: sparky!uunet!cis.ohio-state.edu!ucbvax!agate!agate!usenet
  2. From: kaleb@thyme.jpl.nasa.gov (Kaleb Keithley)
  3. Newsgroups: comp.archives
  4. Subject: [comp.windows.x] Xaw3d -- Three-D Athena Release 0.1 (beta)
  5. Message-ID: <158fl3INN5cc@agate.berkeley.edu>
  6. Date: 30 Jul 92 10:18:11 GMT
  7. References: <1992Jul28.165241.12529@thyme.jpl.nasa.gov>
  8. Followup-To: comp.windows.x,comp.windows.x.intrinsics
  9. Organization: Jet Propulsion Lab, Pasadena, CA
  10. Lines: 125
  11. Approved: adam@soda.berkeley.edu
  12. NNTP-Posting-Host: soda.berkeley.edu
  13. X-Original-Newsgroups: comp.windows.x,comp.windows.x.intrinsics
  14. X-Original-Date: Tue, 28 Jul 92 16:52:41 GMT
  15.  
  16. Archive-name: auto/comp.windows.x/Xaw3d-Three-D-Athena-Release-0-1-beta
  17.  
  18. Announcing Release 0.1 (beta) of a 3-D widget set based on Xaw.
  19.  
  20.  
  21.                    Three-D Athena Widgets (Xaw3d)
  22.                       kaleb@thyme.jpl.nasa.gov
  23.  
  24. Features:
  25.  
  26. This is Release 0.1 beta (28 July, 1992) of a set of 3-D widgets based 
  27. on the R5 Athena Widget set.  The Three-D Athena may be used as a general 
  28. replacement of the Athena (Xaw) Widget set.
  29.  
  30. In general, it is possible to relink any Athena Widget based application 
  31. with the Three-D Athena Widget set to obtain a three dimensional appearance.  
  32.  
  33. The Three-D Athena Widget set uses a ThreeD subclass to add the following 
  34. widget resources: top shadow color, bottom shadow color, shadow width, top 
  35. shadow contrast, bottom shadow contrast, user data, and a "be nice to the
  36. colormap" option.
  37.  
  38. In previous releases I have relinked all of the clients in the MIT sample 
  39. implementation release with the Three-D Athena Widget set, and with Brian V. 
  40. Smith's xfig.  In this release, due to time constraints, I have only tested
  41. editres and xfig.  I can assert that none of them "broke".
  42.  
  43. Top shadow color, bottom shadow color, shadow width, top shadow bright and 
  44. bottom shadow dim should be self explanatory, and may be set via the usual 
  45. and customary methods, e.g. app-defaults, .Xdefaults, programmatically, with 
  46. editres, etc.  The user data resource may be used to "hang" application 
  47. specific data on a widget, and is only settable programmatically.
  48.  
  49.  
  50. This release adds the following features:
  51.  
  52.     o pixmap shadows for 1-bit deep visuals 
  53.     o selection (on a per-widget basis) of "colormap friendly" versus
  54.       "colormap unfriendly" shadow drawing mode.
  55.     o use a tiled pixmap to create shadows colors in "colormap friendly"
  56.       mode.
  57.     o settable shadow contrast (intensity) when using "filled" shadows
  58.       in "colormap unfriendly" mode.
  59.     o allow Labels to have shadows (again), but you must over-ride the
  60.       default shadow width of zero.
  61.     o All 3d code linted clean with 'gcc -Wall -pedantic -traditional...'
  62.       and Sun lint.
  63.  
  64.  
  65. This release fixes the following bugs:
  66.  
  67.     o fixed shadow-draw and interior-draw bugs in scrollbar and stripchart.
  68.     o fixed Command enter hi-lighting.
  69.  
  70.  
  71. Known bugs:
  72.  
  73.     o I don't have any monochrome systems -- therefore I haven't tested
  74.       the 1-bit visual pixmap shadows.
  75.  
  76.  
  77. Getting:
  78.  
  79. Xaw3d may be found on export.lcs.mit.edu (18.24.0.12) and possibly other
  80. sites; check archie.  On export, it may be found in the file:
  81.  
  82.     ~ftp/contrib/Xaw3d/R5/Xaw3d-0.1.tar.Z
  83.  
  84.  
  85. Building:  
  86.  
  87. Untar the distribution from the base of your MIT source tree.  This will 
  88. create the directory .../mit/lib/Xaw3d.  'cd' there and:
  89.  
  90. 'make Makefile; make includes; make depend; make; make install'.  
  91.  
  92. The Imakefile uses the Xaw symbols in .../mit/config, so if you have 
  93. debugging, profiling, shared libs, etc. specified for Xaw, you'll get 
  94. them in Xaw3d too.
  95.  
  96.  
  97. Using:
  98.  
  99. It's okay to just relink your application with -lXaw3d.  I'll even go 
  100. so far as to say just hack your Imake generated Makefile and change the 
  101. Xaw to Xaw3d.  As an alternative, if you're using shared libraries,
  102. you may install libXaw3d.s?.5.0 as libXaw.s?.5.0, and your applications
  103. that are dynamically linked will inherit the 3-D appearance automatically
  104. the next time you run them.
  105.  
  106.  
  107. Extra Credit:
  108.  
  109. I recommend adding Xaw3d symbols to .../mit/config/Project.tmpl,
  110. and, if you're on a Sun or a SVR4 box, SunLib.tmpl or sv4Lib.tmpl too.
  111. You'll want to create parallel symbols for most of the Athena
  112. symbols.  Symbols you'll want 3d versions of might include:
  113.    AWIDGETSRC        ---> A3DWIDGETSRC
  114.    DEPXAWLIB         ---> DEPXAW3DLIB
  115.    XAWLIB            ---> XAW3DLIB
  116.    LINTXAW           ---> LINTXAW3D
  117.    XawClientLibs     ---> Xaw3dClientLibs
  118.    XawClientDepLibs  ---> Xaw3dClientLibs
  119.  
  120. I'll leave it as an exercise as to the values for those symbols.
  121.  
  122.  
  123. Credits, in no particular order:  
  124.           Achille Hui (eillihca@drizzle.stanford.edu)
  125.           Robert Withrow (witr@rwwa.com)
  126.           Malcolm Strickland (chuck-strickland@orl.mmc.com
  127.           David Flanagan (david@ora.com)
  128.           Jamie Zawinski (jwz%thalidomide@lucid.com
  129.           Frank Terhaar-Yonkers (fty@bizarre.trpnc.epa.gov)
  130.           Mike Schulze (mike@cs.curtin.edu.au)
  131.           Gustaf Neumann (neumann@dec4.wu-wien.ac.at
  132.  
  133.  
  134. Comments, fixes, etc. to: kaleb@thyme.jpl.nasa.gov
  135.  
  136. -- 
  137.  
  138. Kaleb Keithley                          kaleb@thyme.jpl.nasa.gov
  139.  
  140. Not authorized, in any way, shape, or form, to speak for anyone.
  141.