You are here:

QuickMusic::Load

Load details about a piece of music in memory. This does not automatically start it.

Incoming

X & Y: Address (X High), The piece to load.

Outgoing

Negative

Set if there are problems loading details for the music.

A

Byte, The error code. See QUICKMUSIC_ERRORCODE::* for a list of possibilities.

X & Y

2 byte, Some errors have additional values in X and or Y. See the specific errors for details.

NOTE: Additional details are only available if QuickMusic_Config::ERRORTESTTYPE is non-zero!

All other registers are lost.

Example

; Loads details about the music in memory at MusicAddress LoadXYImmediate #MusicAddress JSR QuickMusic::Load ; Starts playing the music ; To actually have the music play, a VBI handler must JSR QuickMusic::HandleVBI each VBlank JSR QuickMusic::Play