Skip to main content

transcribe​

transcribe(
    @buffer ? ## llll (required)
    @onset 0
    @pan null
    @gain null
    @detune null
    @voice 1
    @pitchkey 'pitch'
    @keepduration 1
    @metadata 1
    @annotation 1
) -> null

Adds input buffer to the rendering sequence. See render function.

Arguments​

  • @buffer ? [llll]: buffer to add to rendering sequence. (required)
  • @onset [int/float]: buffer onset in milliseconds. (default: 0).
  • @pan [int/float/list/llll]: normalized panning value or envelope. (default: null).
  • @gain [int/float/llll]: linear gain value or envelope. Use the gain function for values greater than 1. (default: null).
  • @detune [int/float]: detuning amount in cents. (default: null).
  • @voice [int]: voice assignment in score. See scoreconfig function. (default: 1).
  • @pitchkey [symbol]: key to use for pitch value in score transcription. (default: 'pitch').
  • @keepduration [int]: keep buffer's nominal duration value when detuning buffer via @detune. (default: 1).
  • @metadata [anything]: data to associate with buffer. Useful when exporting roll in llll format. (default: 1).
  • @annotation [symbol/null]: optional label to display next to transcribed buffer. (default: 1).

Usage​

$buffer = importaudio('guitar.wav');
for $x in (0...12) * 100 do (
    $buffer.transcribe(@onset $x @detune $x @pan $x / 1200.)
);
render(@play 1)