hacklab/strudel
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

try renaming to per / perx / cyclesPer

Browse source
This commit is contained in:
alex 2025-12-13 16:30:51 +00:00
parent c7789a09e3
commit 8eeebf1e4f
3 changed files with 151 additions and 148 deletions
Download patch file Download diff file Expand all files Collapse all files

39
packages/core/signal.mjs
View file

@ -884,45 +884,48 @@ export const keyDown = register('keyDown', function (pat) {
});
/**
* A pattern giving the 'looseness' of events, or in other words, the duration of pattern events,
* in cycles per event. `loose` doesn't have structure itself, but takes structure, and therefore
* A pattern measuring the duration of events,
* in cycles per event. `cyclesPer` doesn't have structure itself, but takes structure, and therefore
* event durations, from the pattern that it is combined with.
* For example `loose.struct("1 1 [1 1] 1")` would give the same as `"0.25 0.25 [0.125 0.125] 0.25"`.
* See also its inverse, `tight`.
* For example `cyclesPer.struct("1 1 [1 1] 1")` would give the same as `"0.25 0.25 [0.125 0.125] 0.25"`.
* See also its reciprocal, `per`, also known as `perCycle`.
* @example
* // Shorter events are lower in pitch
* sound("saw saw [saw saw] saw")
* .note(loose.range(50, 100))
* .note(cyclesPer.range(50, 100))
* @example
* sound("bd sd [bd bd] sd*4 [- sd] [bd [bd bd]]")
* .note(tight.add(20))
* .note(cyclesPer.add(20))
*/
export const loose = new Pattern(function (state) {
export const cyclesPer = new Pattern(function (state) {
return [new Hap(undefined, state.span, state.span.duration)];
});
/**
* A pattern giving the 'tightness' of events, or in other words, the duration of pattern events,
* in events per cycle. `tight` doesn't have structure itself, but takes structure, and therefore
* A pattern measuring the 'shortness' of events, or in other words, the duration of pattern events,
* in events per cycle. `per` doesn't have structure itself, but takes structure, and therefore
* event durations, from the pattern that it is combined with.
* For example `tight.struct("1 1 [1 1] 1")` would give the same as `"4 4 [8 8] 4"`.
* See also its inverse, `loose`.
* For example `per.struct("1 1 [1 1] 1")` would give the same as `"4 4 [8 8] 4"`.
* See also its reciprocal, `cyclesPer`.
* @synonyms perCycle
* @example
* // Shorter events are more distorted
* n("0 0*2 0 0*2 0 [0 0 0]@2").sound("bd")
* .distort(tight.div(2))
* .distort(per.div(2))
*/
export const tight = new Pattern(function (state) {
export const per = new Pattern(function (state) {
return [new Hap(undefined, state.span, Fraction(1).div(state.span.duration))];
});
export const perCycle = per;
/**
* Like `tight` but gives the tightness of events according to an exponential curve. In
* particular, where the event tightness doubles (i.e. where an event duration halves), the
* returned value increases by one. `tightx.struct("1 1 1 [1 [1 1]]")` would therefore be
* the same as `"3 3 3 [4 [5 5]]"`.
* Like `per` but measures the shortness of events according to an exponential curve. In
* particular, where the event duration halves, the
* returned value increases by one. `perx.struct("1 1 [1 [1 1]] 1")` would therefore be
* the same as `"3 3 [4 [5 5]] 3"`.
*/
export const tightx = new Pattern(function (state) {
export const perx = new Pattern(function (state) {
const n = Fraction(1).div(state.span.duration);
return [new Hap(undefined, state.span, Math.log(n) / Math.log(2) + 1)];
});

14
packages/core/test/signal.test.mjs
View file

@ -8,7 +8,7 @@ import Fraction from 'fraction.js';
import { describe, it, expect, vi } from 'vitest';
import { saw, saw2, isaw, isaw2, tight, tightx, loose } from '../signal.mjs';
import { saw, saw2, isaw, isaw2, per, perx, cyclesPer } from '../signal.mjs';
import { fastcat, sequence, State, TimeSpan, Hap } from '../index.mjs';
const st = (begin, end) => new State(ts(begin, end));
@ -37,24 +37,24 @@ describe('signal()', () => {
});
});
describe('loose', () => {
describe('cyclesPer', () => {
it('gives cycles per hap', () => {
sameFirst(
loose.struct(true, true, true, fastcat(true, true)),
cyclesPer.struct(true, true, true, fastcat(true, true)),
sequence(0.25, 0.25, 0.25, fastcat(0.125, 0.125)).fmap(Fraction),
);
});
});
describe('tight', () => {
describe('per', () => {
it('gives haps per cycle', () => {
sameFirst(tight.struct(true, true, true, fastcat(true, true)), sequence(4, 4, 4, fastcat(8, 8)).fmap(Fraction));
sameFirst(per.struct(true, true, true, fastcat(true, true)), sequence(4, 4, 4, fastcat(8, 8)).fmap(Fraction));
});
});
describe('tightx', () => {
describe('perx', () => {
it('gives exponential haps per cycle', () => {
sameFirst(
tightx.struct(true, true, true, fastcat(true, fastcat(true, true))),
perx.struct(true, true, true, fastcat(true, fastcat(true, true))),
sequence(3, 3, 3, fastcat(4, fastcat(5, 5))),
);
});