getBeatTime()

Description

Function to obtain the current song position as number of beats (quarter notes) since the start of the song.

Available in: Processor.

Return Values

When the host is in playback, the function returns a decimal with the number of beats (quarter notes) since the start of the song. The function returns -1, if the host is not in playback.

Example

--print the song position
function onNote(event)
	songPos = getBeatTime()
	if (songPos ~= -1) then
        print(getBeatTime())
    else
        print("Playback is stopped.") 
    end
end

See Also: list of links to related functions and pages