readme.sony

speech signal process tools

               Entropic Research Laboratory, Inc. 

          Unix Signal Processing Software Demonstration

INTRODUCTION
============

This demonstration software provides a brief introduction to
Entropic's signal processing software -- the Entropic Signal
Processing System (ESPS), and the waves+ graphics interface.

The demo has two parts: "waves+ intro" and "slide show". The waves+
intro is a live demo that shows the software in action. The slide show
is a sequence of fixed ESPS and waves+ images.  The demo has an
optional voice narrative that describes what you see on the screen.  
This option may not be supported on all systems (and it can be turned 
off even on systems that support it).  Note that the text of the
narrative is contained at the end of the file that is displayed 
when the "About this demo..." button is pressed.  (This file usually
is erldemos/edemo.about).  

SETTING UP THE DEMO
===================

The tape contains a single tar image: the directory "entropic".  This
can be loaded anywhere; root privileges are not required.  Extract the
directory with "tar xv".

By setting your umask to 022 ("umask 022") before reading the tar
tape, anyone may execute the demo, but this is not necessary for a
single user.  The demo only requires write permission in the directory
/tmp, so changing the modes on the files to global read-and-execute
permission only ("chmod -R 555 entropic") will not break the demo.

Requirements and recommendations are as follows:

	1) SONY RISC machine running NEWS-OS release 3.9R

	2) 8 plane color display for "slide show" (must).  A color display
	   is highly desirable for the "waves+ intro" portion, as many things 
	   will not work without one.  If the monitor is monochrome, on 
	   some systems the spectrogram displays will come up with 
	   high-energy regions light instead of dark.  In this case, 
	   un-comment "#invert_dither 1" (remove the "#") in the 
	   ".wave_pro" file located in the directory erldemos/esps/lib/waves".

	3) 25 MB disk space (must) 

	4) 16 MB memory highly recommneded. You can try it with only 12 MB,
	   but the audio and slides may loose sync. With less than 12 MB,
	   things become sluggish and sometimes confusing; turn the audio off.

	5) SONY's X11 stuff

	6) swap space of at least 20 MB, preferably 30MB

A user must be standing in the "entropic" directory in order to run the demo. 
If you want to make it easy for anyone to run the demo, put a script in
/usr/local or /usr/local/bin that "cd"s to the "entropic" directory and 
runs ENTROPIC. 

RUNNING THE DEMO
=================

To start the demo, change into the entropic directory ("cd entropic")
and run the program ENTROPIC.  This will put up a command window from
which the user can operate the demo. If the control panel does not appear,
check the file "ENTROPIC.log" on /tmp for error messages. 

The top part of the control panel has buttons that present information
about the demo, ESPS, waves+, and the Entropic Research Laboratory.

The bottom part of the control panel allows you to select various demo
and audio options. By using the check boxes, you can select the live
part, the slide show or both.  The "Single" and "Continuous" buttons
determine whether the "Start Demo" button runs the demo once or 
continuously.  The "Audio Output" buttons control the play back 
options.  Once the options have been selected, clicking on the 
"Start demo" button starts the demo.

For more information about the demo, see the file displayed 
when the "About this demo..." button is pressed.  (This file usually
is erldemos/edemo.about).

CONFIGURATION CONSIDERATIONS
============================

This demo has been tested on a SONY NEWS-3860 machine running X-windows. 
The CPU should have at least 16 MB of memory and 25-30 MB of swap space.  
The demo will run on some systems with as little as 12 MB of memory, but 
it can be slow.

The OpenLook fonts (supplied here) must be on your path before the demo
will run. The ENTROPIC demo script tries to do this for you, but if the
demo won't run and you see error messages in the ENTROPIC.log file (found
on /tmp) about fonts, move to the "xview" directory and do the following 
before running the ENTROPIC command:

	source setxview.

Note that the command "xset" must be on your path before sourcing the
setxview script.

The demo has been tested with the twm and mwm window managers. Note that the 
placement and positioning of the windows during the demo can be affected by 
various parameters in both the window manager "rc" files and the ".Xdefaults" 
files. Versions of files that worked for us are in the "xconfig" directory. 
If you are having problems with placesment or positioning, copy the appropriate
"rc" and  ".Xdefaults" files to your home directory, logout, and log back in. 

For example, if you are running under the MOTIF window manager (mwm), first 
save your ".mwmrc" and .Xdefaults" files. Next, copy ".mwmrc" and 
"mwm.Xdefaults" in our "xconfig" directory to your home directory, and in your 
home directory copy "mwm.Xdefaults" to ".Xdefaults". Now log out and log 
back in.

The demo should run with any ICCCM compliant window manager, but you may
have to experiment with your X-windows and window manager configuration
files to get the automatic placement and positioning to work properly.

In general, the performance of the demo varies as a function of the
system configuration and load (CPU speed, disk speed, available
memory, role of NFS, network traffic, swap space, other processes,
etc.).  Since there is no foolproof method of synchronizing speech
output with the actual appearance of particular windows; inadequate
system resources may result not just in a slower demo, but in a
confusing demo.

If the demo is not smooth, try running it without speech output, as it
is most reliable in this mode (it is also faster).  If there is
considerable trouble, some system adjustments may be necessary - 
additional swap space, additional memory, additional processors, etc.

For each loop through the demo, a log file is written in /tmp/erldemo.log.
Problems can often be tracked down by looking at this file. Errors detected
during the creation of the demo control panel are logged in /tmp/ENTROPIC.log.

A single run of the demo takes between 5 and 8 minutes, depending
on the system.  

For more information or for help, please contact us:

  Entropic Research Laboratory    Voice:     202-547-1420
  600 Pennsylvania Ave., S.E. 	  FAX:       [phone]
  Suite 202                       Internet:  [e-mail]
  Washington, D.C. 20003          uucp:	     ...uunet!epiwrl!esps-info
  USA

Particular contacts are:

	David Burton ([e-mail])
	Alan Parker ([e-mail])
	John Shore ([e-mail])         

COPYRIGHT NOTICE
================

The programs (except xloadimage and next_slide), data files, and text
files in this demo directory (and subdirectories) are the property of
Entropic Research Laboratory, Inc.  (Copyright (c) 1986-1990, Entropic
Speech, Inc.  and Entropic Research Laboratory, Inc.; All rights
reserved).  The demo may be freely distributed and used by prospective
customers to evaluate Entropic Software products, or by Sun
Microsystems employees to demonstrate the capabilities of workstations
and windowing software.

Xloadimage was originally written by Jim Frost Copyright (c) 1989,
1990.  Rod Johnson of Entropic modified xloadimage and wrote
next_slide in order to enhance the capabilities for showing a series
of slides.  Both xloadimage and next_slide are in the public domain.
If anyone wants copies of these, please contact us.

---
(@(#)README.sony	1.4 1/17/91)