Safeguarding the past, present and future of RISC OS for everyone
Sound Voice Generator Instantiate
SoundChannels
» SWI Calls
» Sound_InstallVoice
» Sound Voice Generator
Voice Generator Instantiate
The Instantiate entry is called to inform the Voice Generator of a request to attach a channel to it.
| Entry | |
|---|---|
| R0 | Channel number |
| R5 | Pointer to Voice Generator |
| Exit | |
|---|---|
| R0 | Preserved if the Instantiation was successful, else it is altered. |
| R1-R4 | Preserved |
| R5 | May be corrupted |
| R6-R12 | Preserved |
Notes
The Voice Generator is entered in SVC mode.
To return to the Channel Handler use LDR PC,[R13],#4
A Voice Generator should ideally be able to support eight channels. The request can either be accepted (R0 preserved on exit), or rejected (R0 altered on exit).
The usual reason for rejection is that an algorithm is slow and is already filling as many channels as it can within each buffer period: for example very complex algorithms, or ones that read long samples off disc.
See also
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.