NAME:
	echo
DESCRIPTION:
	adds a series of repeated, decaying echoes to a sound
ARGUMENTS:
	leftlength - length of echo for left channel (ms)
	rightlength - length of echo for right channel (ms)
	leftvolume - volume of echo for left channel (0-1)
	rightvolume - volume of echo for right channel (0-1)
	leftdecay - amount of decay for left channel (0-1)
	rightdecay - amount of decay for right channel (0-1)
	

NAME:
	flange
DESCRIPTION:
	digital flanging
ARGUMENTS:
	initial - how far behind the original the delayed signal starts (ms)
	final - how far behind the original the delayed signal end (ms)
	phase - amount of stereo phasing (0-360)
	speed - length of one cycle (ms)
	feedback - amount of feedback (0-1)
	invert - invert the delayed signal (flag)
	triangle - use a triangle wave instead of a sine (flag)
	
	
NAME:
	spatialpan
DESCRIPTION:
	spatial panning (for headphones)
ARGUMENTS:
	length - length of one cycle (ms)
	amount - spatial depth (0-100)
	phase - starting position (0-360)
	
	
NAME:
	vibrato
DESCRIPTION:
	warble the pitch
ARGUMENTS:
	frequency - frequency of vibrato (Hz)
	depth - depth of vibrato (0-INF)


NAME:
	delay
DESCRIPTION:
	delay can be used to create single echoes, as well as a number of other effects
ARGUMENTS:
	delay, leftdelay, rightdelay - length of delay (ms)
	mix, leftmix, rightmix - mixing of delayed signal and the original (0-1)
	invert, leftinvert, rightinvert - invert channel(s) (flag)
	feedback, leftfeedback, rightfeeback - amount of feedback (0-1)
	frequency, leftfrequency, rightfrequency - length of delay (Hz)


NAME:
	brainwave
DESCRIPTION:
	DISCLAIMER - By using this program, you agree that the author of this program will not be responsible for any damage as a result, direct or indirect, of using this program.
	WARNING - Sounds generated by this effect are not suitable for epileptics or persons undergoing psychiatric treatment since it does alter ones state of consciousness.
ARGUMENTS:
	frequency - brainwave frequency (Hz)
	intensity - brainwave intensity (0-100)
	delta - use a delta frequency (flag)
	theta - use a theta frequency (flag)
	alpha - use an alpha frequency (flag)
	beta - use a beta frequency (flag)


NAME:
	phaser
DESCRIPTION:
	sweeping phaser
ARGUMENTS:
	cutoff - cutoff frequency (Hz) 
	resonance - filter resonance (sqrt(2) to ~ 0.1)
	depth - depth of phaser (1-INF)
	speed - length of one cycle (ms)
	phase - amount of stereo phasing (0-360)
	low - use a low pass filter (flag)
	high - use a high pass filter (flag)
	band - use a band pass filter (flag)
	notch - use a notch filter (flag)


NAME:
	filter
DESCRIPTION:
	low pass, high pass, band pass, or notch filter
ARGUMENTS:
	cutoff - cutoff frequency (Hz) 
	resonance - filter resonance (sqrt(2) to ~ 0.1)
	low - use a low pass filter (flag)
	high - use a high pass filter (flag)
	band - use a band pass filter (flag)
	notch - use a notch filter (flag)


NAME:
	noise
DESCRIPTION:
	generate random noise
ARGUMENTS:
	volume - amplitude of noise (0-1)
	shape - 'chaos' of noise (0-1)
	white - use white noise (flag)
	pink - use pink noise (flag)
	brown - use brown noise (flag)
	envelope - amplitude envelope of noise (audio)
	shape.envelope - shape envelope of noise (audio)
	size - length of noise (ms)
	match_envelope_size - use the length of the envelope audio as the size (flag)

NAME:
	noiseband
DESCRIPTION:
	generate random frequencies
ARGUMENTS:
	frequency - center frequency of noise (Hz)
	volume - volume of noise (0-1)
	length - length of noise (ms)
	depth - 'chaos' of noise (1-INF)


NAME:
	generate
DESCRIPTION:
	generate simple waveform
ARGUMENTS:
	frequency - frequency to generate, starting frequency if using final (Hz)
	frequency.final - final frequency to slide to (Hz)
	frequency.modulator - modulator for FM (audio)
	amplitude.modulator - modulator for AM of ring (audio)
	volume - volume of sound (0-1)
	length - length of sound (ms)
	match_modulator_length - use the length of the modulator audio as the length (flag)
	phase - phase to start at (0-360)
	absolute - generate audio with all postive samples (flag)
	SEE osc FOR MORE ARGUMENTS
	
	
NAME:
	reverb
DESCRIPTION:
	reverb is an effect used to simulate acoustic space
ARGUMENTS:
	length - total length of reverberation (ms)
	attack - amount of time for reverb to gain full strength (ms)
	amount - volume of wet signal (0-1)
	original - volume of dry signal (0-1)
	echoes - amount of echoes to limit the reverb to (0-INF)
	feedback - amount of feedback, too much will cause silence (0-1)
	impulse - get echoes from a sample instead of generating them (audio)
	mono - use mono reverb (flag)
	stereo - use stereo reverb (flag)
	spatial - use spatial reverb, on by default (flag)


NAME:
	loadwave
DESCRIPTION:
	load a wave file
ARGUMENTS:
	name - name of wavefile to load (string)
	volume - volume of sound (0-1)


NAME:
	channelmixer
DESCRIPTION:
	channel mixer will enables you to create new stereo mixes using the existing right and left channels
ARGUMENTS:
	left.left - amount of the old left channel to be in the new left channel (0-1)
	left.right - amount of the old right channel to be in the new left channel (0-1)
	right.left - amount of the old left channel to be in the new right channel (0-1)
	right.right - amount of the old right channel to be in the new right channel (0-1)
	left.invert - invert left channel (flag)
	right.invert - invert right channel (flag)
	both_left - both new channels are the same as the old left channel (flag)
	both_right - both new channels are the same as the old right channel (flag)
	swap - left channel becomes right and right becomes left (flag)
	average - average both channels together (flag)
	inverted_average - average both channels together and invert the right channel (flag)
	vocal_cut - sum the left channel with the inverse of the right, and place into both channels (flag)


NAME:
	expand
DESCRIPTION:
	expand the length of the audio by adding silence to the end of it
ARGUMENTS:
	length - new length to expand audio to (ms)
	add - if length isn't specified this much silence will be added to the end of the audio (ms)


NAME:
	reverse
DESCRIPTION:
	causes audio to play backwards by reversing the order of its samples
ARGUMENTS:
	mix - mix original with reversed (flag)


NAME:
	amplify
DESCRIPTION:
	amplify increases or decreases the volume of a waveform
ARGUMENTS:
	volume, leftvolume, rightvolume - amount to amplify audio (0-1)
	initial, leftinitial, rightinitial - initial amplification (0-1)
	final, leftfinal, rightfinal - final amplification (0-1)
	bias_adjust - DC bias adjust (0-1)
	invert - invert audio (flag)
	normalize - normalize audio (flag)
	fadein - fade in audio from start to end (flag)
	fadeout - fade out audio from start to end (flag)
	start - when to start amplification (ms)
	end - when to stop amplification (ms)
	fromend - when to start amplication, from the end (ms)
	

NAME:
	normalize
DESCRIPTION:
	amplifies audio to its maximum amount
ARGUMENTS:
	stereo - normalize each channel seperately (flag)
	bipolar - normalize positive samples and negative samples seperately (flag)


NAME:
	copy
DESCRIPTION:
	copy selected portion
ARGUMENTS:
	start - start of selected portion (ms)
	end - end of selected portion (ms)
	name - name to copy selected portion under, 'clipboard' by default (string)


NAME:
	paste
DESCRIPTION:
	insert audio
ARGUMENTS:
	start - where to insert the audio (ms)
	name - name of audio to insert, 'clipboard' by default (string)


NAME:
	trim
DESCRIPTION:
	remove all audio outside the selected portion
ARGUMENTS:
	start - start of selected portion (ms)
	end - end of selected portion (ms)
	

NAME:
	cut
DESCRIPTION:
	remove all audio inside the selected portion
ARGUMENTS:
	start - start of selected portion (ms)
	end - end of selected portion (ms)
	

NAME:
	mix
DESCRIPTION:
	mix multiple waveforms together
ARGUMENTS:
	name - audio to mix (audio)
	volume - volume of audio (0-1)


NAME:
	multiply
DESCRIPTION:
	multiply each sample with each sample of the modulator
ARGUMENTS:
	modulator - multiply each sample with each sample of this (audio)   


NAME:
	graph
DESCRIPTION:
	create a waveform by 'drawing a line' between each x,y point
ARGUMENTS:
	list - list of x and y values (ms,0-1)


NAME:
	tremolo
DESCRIPTION:
	modulate the amplitude
ARGUMENTS:
	depth - depth of tremolo (0-1)
	speed - length of one cycle (ms)
	phase - starting phase (0-360)


NAME:
	pan
DESCRIPTION:
	stereo panning
ARGUMENTS:
	depth - depth of panning (0-1)
	speed - length of one cycle (ms)
	phase - starting position (0-360)


NAME:
	dontnormalize
DESCRIPTION:
	cancel out the automatic normalizing when writing the audio to a file
ARGUMENTS:


NAME:
	zerosynth
DESCRIPTION:
	makes audio sound as if it were made from a synth
ARGUMENTS:
	dual - process half a cycle at a time instead a whole cycle (flag)
	SEE osc FOR MORE ARGUMENTS


NAME:
	phasesynth
DESCRIPTION:
	use each sample of the audio as the phase of the oscillator
ARGUMENTS:
	SEE osc FOR MORE ARGUMENTS


NAME:
	overdrive
DESCRIPTION:
	simple distortion
ARGUMENTS:
	threshold - threshold of overdrive (0-1)
	level - level of overdrive (0-1)
	noise_gate - effects below threshold instead of above (flag)

NAME:
	plasticate
DESCRIPTION:
	makes audio sound if it were poorly stretch out with out changing the length
ARGUMENTS:
	size - size of chunk (ms)
	amount - times a chunk is repeated (0-INF)
	grate - replace chunk with silence (flag)

NAME:
	loop
DESCRIPTION:
	create a loop from audio using start, end, and crossfade, or repeat or trim a loop using length
ARGUMENTS:
	length - length of loop (ms)
	trim - cut everything after length (flag)
	wrap - remove everything after length and mix it at the start of the loop (flag)
	repeat - number of times loop will repeat, if not using trim or wrap (0-INF)
	start - where loop will start, if not using trim, wrap, or repeat (ms)
	end - where loop will end, if not using trim, wrap, or repeat (ms)
	crossfade - length of crossfade, if not using trim, wrap, or repeat (ms)


NAME:
	stretch
DESCRIPTION:
	change the length of the audio with out changing the pitch
	use original_tempo to change the tempo of the audio to the tempo of the song
ARGUMENTS:
	original_tempo - tempo of the audio (bpm)
	scale - ratio of the stretch (0-INF)
	length - length to stretch the audio to (ms)


NAME:
	beatify
DESCRIPTION:
	create a beat from the audio by modulating the amplitude
ARGUMENTS:
	attack - length it will take each beat to reach it peak amplitude (ms)
	sustain - how long to sustain the peak amplitude (ms)
	decay - length it will take the amplitude of each beat to reach zero (ms)
	loop - wether to loop the pattern if the audio is longer (flag)
	size - length of each beat in the pattern (ms)
	pattern - series of amplitudes for each beat (0-1)
	stop - when to stop the pattern if it's looping (ms)
	
	
NAME:
	pitchshift
DESCRIPTION:
	change the pitch of the audio
ARGUMENTS:
	transpose - amount of semi-tones to shift to (-INF-INF)
	preservespeed - use a pitchshift method that won't change the length of the audio (flag)


NAME:
	harmony
DESCRIPTION:
	add different version of the audio with different pitches together
ARGUMENTS:
	notes - amount of semi-tones each voice will be from the original (-INF-INF)
	detune - amount of cents each voice will be from the original (-INF-INF)
	preservespeed - use a pitchshift method that won't change the length of the audio (flag)


NAME:
	melody
DESCRIPTION:

ARGUMENTS:
	sample - instrument sample for the melody (audio)
	pitch - frequency of the instrument sample (Hz)
	attack - length it will take each note to reach it peak amplitude (ms)
	decay - length it will take the amplitude of each note to reach zero (ms)
	preservespeed - use a pitchshift method that won't change the length of the sample (flag)
	loop - loop the sample (flag)
	reverse_loop - ping pong loop the sample (flag)
	size - length that each space represents in the pattern (ms)
	notes - series of frequencies and strings of note lengths (Hz,string)

NAME:
	beat
DESCRIPTION:

ARGUMENTS:
	size - length that each space represents in the pattern (ms)
	pan - numbers in pattern will represent panning position instead of volume (flag)
	pattern - series of samples and pattern strings (audio,string)

NAME:
	synth
DESCRIPTION:

ARGUMENTS:
	osc.type - sine, square, sawtooth, reversesawtooth, triangle, pulse, or waveform (string)
	osc.amp - amplitude for each oscillator (0-1)
	osc.phase - phase (0-360)
	osc.oct - octaves added to pitch of oscillator (-INF-INF)
	osc.semi - semi-tones added to pitch of oscillator (-INF-INF) 
	osc.cent - cents added to pitch of oscillator (-INF-INF)
	osc.mult - multiply pitch of oscillator by this (-INF-INF)
	osc.mod - add, sub, mul, div, mod, or pow (string)
	filter.attack - length it will take filter to reach its highest frequency (ms)
	filter.decay - length it will take the filter to reach its lowest frequency (ms)
	filter.cutoff - cutoff frequency (Hz) 
	filter.resonance - filter resonance (sqrt(2) to ~ 0.1)
	filter.envmod - how much the envelope effects the filter (1-INF)
	filter.type - low, high, band, or notch (string)
	filter.lfo - audio sample to modulate the cutoff frequency
	filter.depth - how much the lfo effects the filter (1-INF)
	filter.gate - series of values representing filter peaks (0-1)
	attack - length it will take each note to reach it peak amplitude (ms)
	decay - length it will take the amplitude of each note to reach zero (ms)
	size - length that each space represents in the pattern (ms)
	slidelength - amount of time it takes a slide to complete (ms)
	slide_retrigger - retrigger the note even in a slide (flag)
	pattern - series of frequencies or commands, r=rest, s=slide, h=hold (string)
	gate - series of values representing amplitude peaks (0-1)
	leftonly - put audio in left channel only (flag)
	rightonly - put audio in right channel only (flag)
	

NAME:
	song
DESCRIPTION:

ARGUMENTS:
	bar - number of quarter notes in a bar (1-INF)
	loops - series of names, volumes, panning position, and length in quarter notes (string,0-1,0-1,1-INF)
	fadein - series of names, bar when fade in starts, bar when fade in stops (string,1-INF,1-INF)
	fadeout - series of names, bar when fade out starts, bar when fade out stops (string,1-INF,1-INF)
	sequence - series of names and pattern strings (string,string)


NAME:
	osc
DESCRIPTION:
	this is not an effect itself, but these arguments can be used with any effect that uses osc
	which include flange, spatialpan, phaser, generate, vibrato, tremolo, zerosynth, phasesynth, synth
ARGUMENTS:
	sine - use a sine wave (flag)
	square - use a square wave (flag)
	sawtooth - use a sawtooth wave (flag)
	reversesawtooth - use an inverted sawtooth wave (flag)
	triangle - use a triangle wave (flag)
	pulse - use a pulse wave (flag)
	waveform - use a waveform (flag)
	pulse.speed - time it takes to go from initial to final and back (ms)
	pulse.initial - intial width of the pulse, 0 by default (0-1)
	pulse.final - final width of the pulse, 1 by default (0-1)
	pulse.width - width of the pulse if not using pulse.speed (0-1)
	waveform.sample - sample to use as the waveform, entire length of sample is one cycle (audio)