Function TriggerNote

From Uzebox Wiki
Jump to navigation Jump to search
Prototype

void TriggerNote(unsigned char channel,unsigned char patch,unsigned char note,unsigned char volume);

Description

Triggers a patch at the specified volume and pitch on a specific channel. You must avoid baking in the pitch of a patch via PC_PITCH for the note parameter to properly function.

Parameters
  • channel: The sound channel to play the patch (0 to 3).
  • patch: Patch number to play.
  • note: Pitch to play the patch. This corresponds to a 0-126 value (C-1 to F#-11) from the step table.
  • volume: Volume to play the patch, 0x00 to 0xff.
Returns

Void

Video Modes

All

Since

V1

Example:

//Play a C-6 on channel 1 with instrument 1 at 50% volume.
TriggerNote(1, 1, 60, 127);