1.3.1 2012-01-02 DWF

   Xaw3dxft is now packaged with the popular and portable GNU automake, so
   all usual GNU tricks should work.  Help on configuration options can be
   found in the INSTALL file or obtained by entering ./configure --help.

   The following configure options replace manual edits to Imakefile:

     --enable-multiplane-pixmaps
			     enable color pixmaps and add dependency on libXpm
			     (default disabled)
     --enable-gray-blkwht-stipples
			     enable grayed stipple shadows (default enabled)
     --enable-arrow-scrollbars
			     enable scrollbars with arrows (default enabled)

   DWF
     _________________________________________________________________

XAW3DXFT ENHANCEMENTS WITH RESPECT TO XAW3D

   Xaw3dxft is an extended version of xaw3d with support for UTF8 input
   and UTF8 encoding of text, and rendering text with the Freetype
   library and Truetype fonts. It should be mostly compatible with the
   original xaw3d library, except for font management : everything
   using the old X11 core font routines should be replaced by their
   freetype equivalents.

   The main advantage of using libxaw3dxft over libxaw3d or libxaw is
   that all text will appear nicely antialiasedd when using truetype fonts
   in the menu widgets. Also, the use of UTF8 makes it easier to
   internationalize applications in arbitrary languages.

   The following new parameters have been introduced. They can be accessed
   by using an
   #include <X11/Xaw3dxft/Xaw3dXft.h>
   or by specifying equivalent "extern ..." declarations; check also
   Xaw3dXft.c in the library source code for more details.

   int Xaw3dXftEncoding;
   /* value = 0 (default), 8, 16 (resp. UTF8, 8bit, 16bit) */

   int Xaw3dXftStringHilight;
   /* default = 0 ; color twist for hilighting menu items */

   int Xaw3dXftStringUsePixmap;
   /* 0 or 1 : write directly (resp. use a pixmap) for writing strings
      with the Xft library */

   int Xaw3dXftMenuSpacing;
   /* extra vertical space between menu lines ; default value = 1 */

   int Xaw3dXftShowTips;
   /* 0 or 1 : globally disable/enable showing tips ; default value = 1 */

   int Xaw3dXftTipDoGrab;
   /* 0 or 1 : don't grab / grab while showing a tip ; default value = 1 */

   int Xaw3dXftBorderHack;
   /* 0 or 1 ; use hack to improve drawing of borders ; default value = 1 */

   int Xaw3dXftNoHilitReverse;
   /* 0 or 1 ; if set, hilighting is through old style color inversion;
      default value = 0 */

   Pixel Xaw3dXftTipBackgroundColor;
   /* as it name indicates, background color to be shown in tips
      (disabled by default as value -1, light yellow is quite usual) */

   unsigned char * Xaw3dXftHilitColor;
   /* pixel shift value used for highlighting; "#332211" is usually not bad */

   unsigned short Xaw3dXftInsensitiveTwist[4];
   /* default value { 0, 0, 0, 0} */
   /* this is used to slightly change the color of insensitive items,
      so that they become visually apparent; these somewhat obscure
      values should normally be set only via ad hoc routine below */

   char * Xaw3dXftDefaultFontName;
   /* as its name indicates; default is "Liberation-9" */

   Those parameters can also be set via the following routines :

   void Xaw3dXftSetDefaultHilitColor();

   void Xaw3dXftSetHilitColor(char * value);

   void Xaw3dXftSetDefaultFontName(char *name);

   void Xaw3dXftSetInsensitiveTwist(char *value);
   /* value "#a00000" is not bad, gives a red brick color */

   J.-P. Demailly
   (over a period going from September 2009 to mid 2011)
