Contents page

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().