elias/strudel-docker
1
0
Fork 0
mirror of https://github.com/eliasstepanik/strudel-docker.git synced 2026-01-24 12:08:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: chop + loopAt

Browse Source
This commit is contained in:
Felix Roos 2022-09-22 23:20:15 +02:00
parent 0d179f2042
commit df2c7ec1a1
2 changed files with 32 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
packages/core/pattern.mjs
View File

@ -787,6 +787,20 @@ export class Pattern {
return this.fmap((x) => pure(x)._fast(factor))._squeezeJoin(); return this.fmap((x) => pure(x)._fast(factor))._squeezeJoin();
} }
/**
* Cuts each sample into the given number of parts, allowing you to explore a technique known as 'granular synthesis'.
* It turns a pattern of samples into a pattern of parts of samples.
* @name chop
* @memberof Pattern
* @returns Pattern
* @example
* samples({ p: 'https://cdn.freesound.org/previews/648/648433_11943129-lq.mp3' })
* s("p")
* .chop(128)
* .loopAt(32,1)
* .jux(rev)
* .out()
*/
_chop(n) { _chop(n) {
const slices = Array.from({ length: n }, (x, i) => i); const slices = Array.from({ length: n }, (x, i) => i);
const slice_objects = slices.map((i) => ({ begin: i / n, end: (i + 1) / n })); const slice_objects = slices.map((i) => ({ begin: i / n, end: (i + 1) / n }));
@ -1242,7 +1256,17 @@ export class Pattern {
return this._withContext((context) => ({ ...context, velocity: (context.velocity || 1) * velocity })); return this._withContext((context) => ({ ...context, velocity: (context.velocity || 1) * velocity }));
} }
// move this to controls? (speed and unit are controls) /**
* Makes the sample fit the given number of cycles by changing the speed.
* @name loopAt
* @memberof Pattern
* @returns Pattern
* @example
* samples({ p: 'https://cdn.freesound.org/previews/648/648433_11943129-lq.mp3' })
* s("p")
* .loopAt(8,1)
* .out()
*/
_loopAt(factor, cps = 1) { _loopAt(factor, cps = 1) {
return this.speed((1 / factor) * cps) return this.speed((1 / factor) * cps)
.unit('c') .unit('c')

8
tutorial/tutorial.mdx
View File

@ -365,7 +365,13 @@ note("g2!2 <bb2 c3>!2, <c4@3 [<eb4 bb3> g4 f4]>")
The sampler will always pick the closest matching sample for the current note! The sampler will always pick the closest matching sample for the current note!
## Effects ## Sampler Effects
{{ 'Pattern.loopAt' | jsdoc }}
{{ 'Pattern.chop' | jsdoc }}
## Audio Effects
Wether you're using a synth or a sample, you can apply these effects: Wether you're using a synth or a sample, you can apply these effects: