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)