SCALE(1)						  The Canonical Csound Reference						  SCALE(1)

NAME

       scale - Scale the amplitude of a sound file. .

DESCRIPTION

       Takes a sound file and scales it by applying a gain, either constant or variable. The scale can be specified as a multiplier, a maximum or
       a percentage of 0db.

SYNTAX

	   scale [OPTIONS ... ] infile

INITIALIZATION

       Flags:

       o   -A = Generate an AIFF outout file.

       o   -W = Generate an WAV outout file.

       o   -h = Generate an outout file with no header.

       o   -c = Generate 8-bit signed_char sound samples.

       o   -a = Generate alaw sound samples.

       o   -u = Generate ulaw sound samples.

       o   -s = Generate short integer sound samples.

       o   -l = Generate long (32 bit) integer sound samples.

       o   -f = Generate floating point samples.

       o   -F arg = Specifies the gain to be applied. If arg is a floating point number that gain is applied uniformly to the input. Alternatively
	   it could be a file name which specifies a breakpoint file for varying the gain for different periods.

       o   -M fpnum = Scales the input so the maximum absolute displacement is the value given.

       o   -P fpnum = Scales the input so the maximum absolute displacement is the pencentage given of 0db.

       o   -R = Continually rewrite the header while writing soundfile (WAV/AIFF).

       o   -H integer = Show a "heart-beat" to indicate progress, in style 1, 2 or 3.

       o   -N = Alert call (usually ringing the bell) when finished.

       o   -o fname = output file name (default: test.wav)

EXAMPLES

	       scale -s -W -F 0.96 -o out.wav sound.wav

       This creates a new sound file with a constant gain of 0.96. It is particularly useful if the input file is in floating point format.

CREDITS

       Author: John ffitch

       1994

AUTHORS

       Barry Vercoe
       MIT Media Lab

	   Author.

       Dan Ellis
       MIT Media Lab,
		 Cambridge
		 Massachussetts

	   Author.

COPYRIGHT

5.07								    06/23/2009								  SCALE(1)