91 lines
2 KiB
Text
91 lines
2 KiB
Text
---
|
|
title: Pattern Factories
|
|
description: Strudel Tutorial
|
|
layout: ../../layouts/MainLayout.astro
|
|
---
|
|
|
|
import { MiniRepl } from '../../docs/MiniRepl';
|
|
import { JsDoc } from '../../docs/JsDoc';
|
|
|
|
# Pattern Factories
|
|
|
|
The following functions will return a pattern.
|
|
Most of these are also used by the Mini Notation:
|
|
|
|
| function | mini |
|
|
| ------------------------------ | ---------------- |
|
|
| `cat(x, y)` | `"<x y>"` |
|
|
| `seq(x, y)` | `"x y"` |
|
|
| `stack(x, y)` | `"x,y"` |
|
|
| `timeCat([3,x],[2,y])` | `"x@2 y@2"` |
|
|
| `polymeter([a, b, c], [x, y])` | `"{a b c, x y}"` |
|
|
| `polymeterSteps(2, x, y, z)` | `"{x y z}%2"` |
|
|
|
|
## cat
|
|
|
|
<JsDoc client:idle name="cat" h={0} />
|
|
|
|
You can also use cat as a chained function like this:
|
|
|
|
<JsDoc client:idle name="Pattern.cat" h={0} hideDescription />
|
|
|
|
## seq
|
|
|
|
<JsDoc client:idle name="seq" h={0} />
|
|
|
|
Or as a chained function:
|
|
|
|
<JsDoc client:idle name="Pattern.seq" h={0} hideDescription />
|
|
|
|
## stack
|
|
|
|
<JsDoc client:idle name="stack" h={0} />
|
|
|
|
As a chained function:
|
|
|
|
<JsDoc client:idle name="Pattern.stack" h={0} hideDescription />
|
|
|
|
## timeCat
|
|
|
|
<JsDoc client:idle name="timeCat" h={0} />
|
|
|
|
## polymeter
|
|
|
|
<JsDoc client:idle name="polymeter" h={0} />
|
|
|
|
## polymeterSteps
|
|
|
|
<JsDoc client:idle name="polymeterSteps" h={0} />
|
|
|
|
# Combining Patterns
|
|
|
|
You can freely mix JS patterns, mini patterns and values! For example, this pattern:
|
|
|
|
<MiniRepl
|
|
client:idle
|
|
tune={`cat(
|
|
stack(g3,b3,e4),
|
|
stack(a3,c3,e4),
|
|
stack(b3,d3,fs4),
|
|
stack(b3,e4,g4)
|
|
).note()`}
|
|
/>
|
|
|
|
...is equivalent to:
|
|
|
|
<MiniRepl
|
|
client:idle
|
|
tune={`cat(
|
|
"g3,b3,e4",
|
|
"a3,c3,e4",
|
|
"b3,d3,f#4",
|
|
"b3,e4,g4"
|
|
).note()`}
|
|
/>
|
|
|
|
... as well as:
|
|
|
|
<MiniRepl client:only="react" tune={`note("<[g3,b3,e4] [a3,c3,e4] [b3,d3,f#4] [b3,e4,g4]>")`} />
|
|
|
|
While mini notation is almost always shorter, it only has a handful of modifiers: \* / ! @.
|
|
When using JS patterns, there is a lot more you can do.
|