sfx

sfx id [note] [duration=-1] [channel=0] [volume=15] [speed=0]

Parameters:

id : The sfx id, from 0 to 63
note : The note number or name
duration : Duration (-1 by default)
channel : Which channel to use, 0..3
volume : Volume (15 by default)
speed : Speed (0 by default)

Description:

This function will play the sound with id created in the sfx editor. Calling the function with id set to -1 will stop playing the channel.

The note can be supplied as an integer between 0 and 95 (representing 8 octaves of 12 notes each) or as a string giving the note name and octave. For example, a note value of '14' will play the note 'D' in the second octave. The same note could be specified by the string 'D-2'. Note names consist of two characters, the note itself (in upper case) followed by '-' to represent the natural note or '#' to represent a sharp. There is no option to indicate flat values. The available note names are therefore: C-, C#, D-, D#, E-, F-, F#, G-, G#, A-, A#, B-. The octave is specified using a single digit in the range 0 to 8.

The duration specifies how many ticks to play the sound for; since TIC-80 runs at 60 frames per second, a value of 30 represents half a second. A value of -1 will play the sound continuously.

The channel parameter indicates which of the four channels to use. Allowed values are 0 to 3.

Volume can be between 0 and 15.

Speed in the range -4 to 3 can be specified and means how many 'ticks+1' to play each step, so speed==0 means 1 tick per step.

Example:

-- title:  sfx example
-- author: PaulR
-- script: lua

local t=0
function TIC()
	t=t+1
	-- play note 14 (D in octave 2)
	-- every half second with a duration of 
	-- 20 ticks
	if t%30==0 then sfx(0,14,20) end
	-- play D in octave 4 every second
	-- with a duration of 20 ticks
	-- use channel 1 and volume 10
	if t%60==0 then sfx(0,'D-4',20,1,10) end
	-- every 2 seconds
	-- play D quietly in octave 5
	if t%120==0 then sfx(0,'D-5',20,1,4) end
end