Rules for Tools/loadsong()
loadsong()
SYNOPSIS
long loadsong(long file, struct Environment *environment)
ARGUMENTS
`long file'
Fast io file pointer.
`struct Environment *environment'
Environment to load.
DESCRIPTION
Give `loadsong()' the pointer to a valid Bars&Pipes song file along
with an Environment structure and it loads the song into the
Environment.
When used in conjunction with `installenvironment()', `loadsong()'
provides a mechanism for loading songs in the background, then
installing them when ready to play.
SEE
See clearenvironment(), installenvironment(), savesong().