Sound Library Reference

Procedures and command families for FreeBASIC's built-in sound library.

Description
	The sound library, or sfxlib, provides generated tones, PLAY-string 
	music, sample playback, streaming audio, MIDI control, audio device 
	selection, and capture support.  Programs that use these commands link 
	the sound library automatically.

	If a program intentionally does not use the sound command surface and 
	needs selected sfxlib command words as normal identifiers, define 
	KeyPgFbNoSfxlibFb_No_Sfxlib before those names are parsed.

#GENERATEDGenerated Sound
	Commands for tones, notes, PLAY strings, generated waveforms, and mix 
	state.
#MEDIADigital Audio and MIDI
	Commands for loaded samples, music, streams, and MIDI.
#DEVICEDevices and Capture
	Commands for selecting output drivers and recording input.

GENERATEDGenerated Sound
	KeyPgBeepBeep
		Produces a beep or a short pitched note.
	KeyPgSfxGeneratedGenerated Sound Commands
		Documents SOUND, TONE, NOISE, NOTE, REST, PLAY, TEMPO, CHANNEL, 
		OCTAVE, VOICE, VOL, VOLUME, BALANCE, PAN, WAVE, ENVELOPE, and 
		INSTRUMENT.
	KeyPgSfxGeneratedSound
		Plays a generated tone.
	KeyPgSfxGeneratedTone
		Plays a generated tone on a channel.
	KeyPgSfxGeneratedNoise
		Plays generated noise on a channel.
	KeyPgSfxGeneratedNote
		Plays a named note.
	KeyPgSfxGeneratedRest
		Waits for generated-sound playback timing.
	KeyPgSfxGeneratedPlay
		Plays BASIC PLAY strings.
	KeyPgSfxGeneratedTempo
		Sets or returns the generated-sound tempo.
	KeyPgSfxGeneratedChannel
		Sets or returns the generated-sound channel.
	KeyPgSfxGeneratedOctave
		Sets or returns the default note octave.
	KeyPgSfxGeneratedVoice
		Sets or returns the default instrument.
	KeyPgSfxGeneratedVol
		Sets the master volume.
	KeyPgSfxGeneratedVolume
		Sets or returns master or channel volume.
	KeyPgSfxGeneratedBalance
		Sets or returns the master stereo balance.
	KeyPgSfxGeneratedPan
		Sets or returns channel stereo pan.
	KeyPgSfxGeneratedWave
		Defines a generated waveform.
	KeyPgSfxGeneratedEnvelope
		Defines an ADSR envelope.
	KeyPgSfxGeneratedInstrument
		Defines or assigns an instrument.

Digital Audio and MIDI
	KeyPgMusicMusic
		Loads, plays, loops, pauses, resumes, stops, and queries music 
		assets.
	KeyPgSfxSfx
		Loads and controls short sound effects by id or channel.
	KeyPgAudioAudio
		Plays or loops an audio file through the simple one-stream interface.
	KeyPgStreamStream
		Opens, plays, seeks, and stops the streaming-audio interface.
	KeyPgMidiMidi
		Opens MIDI output, plays MIDI files, and sends MIDI messages.

Devices and Capture
	KeyPgDeviceDevice
		Lists, selects, and queries sfxlib output devices.
	KeyPgCaptureCapture
		Starts, pauses, resumes, stops, reads, and saves audio capture.

