***************************************************************************
***************************************************************************

svgafft example configuration files

***************************************************************************
***************************************************************************


svgafft configuration files are nothing more than text files contain
command-line parameters, one one each line.  However, they can greatly
ease tedious setup of the programs options.

To create one, run svgafft with the desired options (as well as
configuring during runtime), then hit the `s' key.  When a filename is
prompted for, enter one and it will be saved in the current directory.

To use a configuration file, have your shell cat the arguments to
svgafft.  For example, say your configuration file name is
"myanalyzer".  To retrieve the options, you could type:

svgafft `cat myanalyzer`            (these are backquotes)

The included short `analyze' script will automatically run the above
command with an argument on the command-line.  To run the
configuration file `segments1' (see below) with the analyze script,
you would type

analyze /dev/dsp segments1

where /dev/dsp is your dsp device.  Any options can be overrided by
appending them after the configuration file name.  In this manner, a
new configuration can be created by starting from an existing one,
sort of "cheap inheritance."  The analyze script can be put into a bin
directory, and the script also prepends the environment variable
DSPCONFIGS, if it exists, to the configuration file.  If you are using
bash, you could use something like (providing that the directory
existed) in your .profile:

export DSPCONFIGS=/home/drewvel/dspconfigs

This variable is only needed if you have a different directory than
/usr/local/dspconfigs.  If you define this variable, make sure to
append a '/' to it since it is simple substitution.


***************************************************************************
Description of Example Configuration Files
***************************************************************************

THESE ARE PURELY EXAMPLES, so you should really play around with the
program and create your own configuration files, but use these as a
start, and make sure to read the man page.

Before trying any of these, make sure to read ../INSTALL and ../README
before proceeding, and make sure you've done a `make all' in the
svgafft directory.

Since individual machine characteristics differ, you may have to
adjust some parameters even after running with one of these files.
Usually the attenuation and the vertical position will have to be
adjusted for viewing.  If you don't see anything (sort of common with
the logarithmic y scale), you can try hitting the - key to tone down
the attenuation (hit ? anytime when running for help).

Also, you must currently use an external mixer to set the dsp device
to a specific sound source and recording level.  I use xmix under X
windows to do this, but there are others that will probably do just as
well.


Once you setup the environment above and installed both svgafft and
the analyze script, you can just type something like

analyze /dev/dsp bars1

from anywhere.

***************************************************************************
Example Configuration Files
***************************************************************************

***************************************************************************

------------------------------------------
Bar Graph Display Based Configurations ---
------------------------------------------

Filename      Description
---------------------------------------------------------------------------

bars1       	sample that is reminiscent of a home stereo + log y scale
                these are not stereo as in 2 channels; svgafft doesn't
                do that yet ;-(


bars2       	another home stereo variation, but this with bartype 4
                size transform buffer + log y scale 

segments1      	another home stereo variation, but this with a 2048 byte 
                size transform buffer + log y scale

fire            sort of looks like dancing flames

wireframe1	log x & y wireframe

wireframe2	similar to 1 with a lower attenuation and vpos

wireframe3	hi-res (1024x768) rotated linear y scale wireframe


***************************************************************************



***************************************************************************

	Enjoy!

	Andrew Veliath
	drewvel@eideti.com
	1/28/95

***************************************************************************
