mirror of
https://github.com/eliasstepanik/strudel.git
synced 2026-01-11 21:58:37 +00:00
68 lines
1.8 KiB
Plaintext
68 lines
1.8 KiB
Plaintext
---
|
|
title: Tonal Functions
|
|
layout: ../../layouts/MainLayout.astro
|
|
---
|
|
|
|
import { MiniRepl } from '../../docs/MiniRepl';
|
|
import { JsDoc } from '../../docs/JsDoc';
|
|
|
|
# Tonal Functions
|
|
|
|
These functions use [tonaljs](https://github.com/tonaljs/tonal) to provide helpers for musical operations.
|
|
|
|
### voicing()
|
|
|
|
<JsDoc client:idle name="voicing" h={0} />
|
|
|
|
### scale(name)
|
|
|
|
<JsDoc client:idle name="scale" h={0} />
|
|
|
|
### transpose(semitones)
|
|
|
|
Transposes all notes to the given number of semitones:
|
|
|
|
<MiniRepl client:only="react" tune={`"c2 c3".fast(2).transpose("<0 -2 5 3>".slow(2)).note()`} />
|
|
|
|
This method gets really exciting when we use it with a pattern as above.
|
|
|
|
Instead of numbers, scientific interval notation can be used as well:
|
|
|
|
<MiniRepl client:only="react" tune={`"c2 c3".fast(2).transpose("<1P -2M 4P 3m>".slow(2)).note()`} />
|
|
|
|
### scaleTranspose(steps)
|
|
|
|
Transposes notes inside the scale by the number of steps:
|
|
|
|
<MiniRepl
|
|
client:idle
|
|
tune={`"-8 [2,4,6]"
|
|
.scale('C4 bebop major')
|
|
.scaleTranspose("<0 -1 -2 -3 -4 -5 -6 -4>")
|
|
.note()`}
|
|
/>
|
|
|
|
### voicings(range?)
|
|
|
|
Turns chord symbols into voicings, using the smoothest voice leading possible:
|
|
|
|
<MiniRepl client:only="react" tune={`stack("<C^7 A7 Dm7 G7>".voicings('lefthand'), "<C3 A2 D3 G2>").note()`} />
|
|
|
|
### rootNotes(octave = 2)
|
|
|
|
Turns chord symbols into root notes of chords in given octave.
|
|
|
|
<MiniRepl client:only="react" tune={`"<C^7 A7b13 Dm7 G7>".rootNotes(3).note()`} />
|
|
|
|
Together with layer, struct and voicings, this can be used to create a basic backing track:
|
|
|
|
<MiniRepl
|
|
client:idle
|
|
tune={`"<C^7 A7b13 Dm7 G7>".layer(
|
|
x => x.voicings('lefthand').struct("~ x").note(),
|
|
x => x.rootNotes(2).note().s('sawtooth').cutoff(800)
|
|
)`}
|
|
/>
|
|
|
|
So far, we've stayed within the browser. [MIDI and OSC](/learn/input-output) are ways to break out of it.
|