EuroBridge Widget Set (Version 3.1)
-----------------------------------

Major changes from previous version (3.0):

- XeTextEd behaviour speeded up and improved for programmatic updates,
- activate() callback, XeLocateTag added, changes in XeFrame layout logic,
- some other bug fixes (see CHANGELOG).
- note also the change of the WWW address (at end)

EuroBridge Widget Set is planned to contain a set of basic tools for
displaying and presenting the basic information types, such as text,
images, graphics, audio and video. Each widget is a container for
information which can be imported into the widget in one of the
specified interchange formats: multinational mixed text through use of
ISO 2022 + ISO 6429, images through PBM + JPEG/JIF + TIFF, basic 8kHz
uLaw audio, MPEG-1 video. The work on this set is being done for the
needs of the RACE project R2008 (EuroBridge), but as it relies heavily
on the freely available existing software from the net, it has been
decided that this widget set will also be freely usable.

Xew has been compiled on following configurations:
--------------------------------------------------
SunIPX		SunOS 4.1.3	X11R5,R6	Gnu C 2.5.8 (ANSI C)
SunIPX(*)	SunOS 4.1.3	openwin		cc
Sun (Sparc) (*)	Solaris 2.3	openwin		Gnu C 2.5.8
HP 9000/750(*)	HPUX 8.07	X11R5		HP CC (K&R C)
HP 9000/750	HPUX 9.x	X11R5		HP CC (also with ANSI C)
Apollo DN3500	SR10.2		X11R4		Apollo C 6.6 (almost ANSI C)
IBM RS6000(*)	3.2?		?		?
DEC Alpha(*)	DEC/OSF1 v1.2	X11R5		DEC C for OSF/1 AXP (ANSI C)
Linux PC	Linux 1.1.75	XFree3.1	Gnu C

It should compile in other environments, but Imakefiles may require
more or less tuning. The (*) configurations have only been tested with
earlier releases. INSTALL document will give more information about the
installation procedures.

Required packages:
------------------
Xew-3.1.tar.gz		Xew source code (including simple test progs) which
			unpacks into Xew-3.1/Xew and Xew-3.1/demo directories.
Optional addons:
----------------
Xew-3.0.ps.gz		The Widget Set programmers reference
tiff.v3.2.tar.Z		Sam Leffler's TIFF library (tifflib-3.2beta?)
jpegsrc.v5.tar.Z	Independent JPEG group JPEG library
urt-3.1b.tar.Z 		Utah Raster Toolkit

The widget library contains five basic widgets: Text, TextEd, Raster,
Audio and Video and a layout widget Frame. Audio and Video still have
a very limited implementation. There is also a stub for Geometric
widget, which currently does not do anything (still undecided about
which CGM library to use as a base).

The package includes simple sample programs which demonstrate the
basics of the widgets.  The program 'viewer' activates a Xew widget(s)
into Athena Porthole widget and controls it with Athena Panner widget
(X11R5 required, uses Viewport for X11R4).  'simple' activates the
widget(s) into separate shells and doesn't have any controls.
'texted' is a raw low level interface to the XeTextEd widget and can
be used to test the features. The program 'audio' demonstrates use of
Audio widget (Audio widget has driver only for Sun SPARC /dev/audio).
'video' is similar to 'audio', but plays MPEG stream.

Final comments
--------------
There is room for many optimizations. The Video widget is currently just
a "proof of concept", that it can be done. It is slower than the original
Berkeley mpeg_play (for fastest responce you have to disable dithering and
select colorMode=gray). [Warning: Video does not support TrueColor or
DirectColor visuals.] TextEd widget is not intended for large text contents,
the response time in editing is directly proportional to the length of the
content.

If you retrieve this software and have any difficulties in getting it
to work, don't hesitate to mail me, even if you solved the problem.
Some information might be found from files BUGS, TODO and HINTS.

I am more than eager to fix all bugs that are found, if I only can.
All portability issues are of interest also. If you have any wishes
about new features and support, give me a hint and I may implement it.

I wish to thank the people who have sent me bug reports, fixes and
modifications (in rather random order, determined by scanning my
mailbox backwards):

Susan Liebeskind <shl@cc.gatech.edu>
	for MOTIF subclassing and for pushing me to actually do the
	composite/constraint change.
You Shung-I <daniel@info1.csie.nctu.edu.tw>
	for pushing me to enable the use of BIG5 in text widget,
	and for XCIN changes.
Sangeok Kim <sekim@platon.postech.ac.kr>
	for having used the widgets in voice commanded Korean text editor.
Jim Wight <J.K.Wight@newcastle.ac.uk>
	for testing the XeTextEd and bug reports.
James Barber <barberjd@cs.curtin.edu.au>
	for the first version of the RLE support.

and many others for just sending me feedback about usage.

-------------------------------------
Mail comments to Markku.Savela@vtt.fi
-------------------------------------

More information also be found from
	http://www.vtt.fi/tte/EuroBridge/Xew/

An Xew mailing list has been setup at

	xew-list@hemuli.tte.vtt.fi

send join/remove requests to 

	xew-list-request@hemuli.tte.vtt.fi
