EuroBridge Widget Set (Version 4.0)
-----------------------------------

Major changes from previous version (3.1):

- X Printing support
- GNU autoconf based ./configure script (see INSTALL/INSTALL.html)
- more control over geometry (XtNvertical, XtNhorizontal resources)
- XtNuserData resource (if compiled without USING_MOTIF_122)
- XtNcolumns, XtNcolumnHeight, XtNpageSeparation, XtNcolumnSeparation (Text)
- XeTextChangeMode, XeTextChangeModeAndTag
- bug fixes (see CHANGELOG).

EuroBridge Widget Set contains a set of widgets for displaying and
presenting the basic information types, such as text, images,
graphics, audio and video. The following are currently implemented

- Text,TextEd: multinational mixed text based on ISO 2022 + ISO 6429
- Raster: images PBM, JPEG/JIF, TIFF, GIF
- Audio: basic 8kHz uLaw (only for Sun Sparc)
- Video: MPEG-1 (Based on Berkeley MPEG code)

Each widget is a container for information which is imported into
the widget in one of the specified interchange formats.

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	X11R6		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.html document will give more information about
the configuration/installation procedures.

Required packages:
------------------
Xew-4.0.tar.gz		Xew source code (including simple test progs) which
			unpacks into Xew-4.0/Xew and Xew-4.0/demo directories.
Recommended optionals:
----------------------
Xew-4.0-Xp.tar.gz	X Print Server prototype code modified for Xew
jpegsrc.v5.tar.Z	Independent JPEG group JPEG library (v5 or later)

Optional addons:
----------------
Xew-4.0.ps.gz		The Widget Set programmers reference
tiff.v3.2.tar.Z		Sam Leffler's TIFF library (tifflib-3.2beta?)
urt-3.1b.tar.Z 		Utah Raster Toolkit

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 only 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). TextEd widget is not intended for large text contents,
the response time in editing is directly proportional to the length of the
content.

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. Also responsible for getting
	me to implement the printing support.
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
