ToDo.txt

====
==== audio ====
Should not do 60fps audio param update if it can be avoided; the quality is not good enough for fast changes
  ? What about power operator? [1:/200ms,0]e^2 etcetc? Needs to force to power 2? Unless both sides are currently power 0?
  ? Some things cancel segmentation: smooth{} etc, []r@f; what else? slider{}! also time modifiers! eg [0:1]e1{per:1/4}
   Need to find an efficient way of killing segmentation without having to make EVERY value into an {} just in case it needs to kill segs
  Set _nextSegment etc from []tlsn too
   Need to handle repeat and non-repeat correctly
   handle power 3 for []s
   ? What other things could set _nextSegment? []{time}???? Nope.
  ? How will segments work on a bus???
  Does :| operator work? Compared to :_ ?
  Optimise/refactor etc segmented audio-param code
  Minimise amount of per frame updates everywhere; especially for presets
   Why do we ALWAYS get per frame update for []t, this.level etc even when forced to per event?
    Find a way to stop this and force as much as possible to be per event
   When doing memoise per-event param in eval-params, remove any segment info there too?
  TEST TEST TEST
  Docs
   Time modifiers cancel segmenting, also smooth, slider etc
Pitch effects to use segments too???
?Replace all amp envelopes with []e in presets and examples
  ?Can do envelope=[]e ??
  ?Deprecate att, dec, sus, rel etc params and prefer envelope=[]e??
  ??Also deprecate other att/rel params; eg in pitchedperc etc???
Would be nice to have a unison param with stereo spread for many base synths?
?Treat db as units??? - compressor params in db; what else?
Delay or offset sub Param for glide
Should be a mix subparam on echo!
 Mix param for all filters, want to  s saw .75 crop 6 + 68, lpf={100,mix:1-envelope{d:500}}
Players can have an analyser
  Created on access
  All events connect to it (and disconnect)
  Use for player pulse
  What about buses that already have an anlyser?
  ??Use for external synth to detect and warn if mono
House lib
 Prodigy patches: https://www.youtube.com/watch?v=KwL2S5LRzFM&t=1272s
 Rave stab?
 Lately bass - https://youtu.be/b-DNUaekuEo?si=WGWg6XLMgBTmtCmo
 more...
Techno include lib
 psytrance lead
  DOCS
 Tinbass control for amount of amp modulation
 Reese bass
 HPF electric lead (phrack)
 Melodic techno lead
 Ambient techno pads
 Dark techno stuff
 Classic detroit techno stuff
 more...
!Look at reducing GC for 909: single osc/shaper for bd etc..??
 !! Claves cl808 cause breakdown after a while; why??
  Made sure everything gets disconnected, but still breaking up :-(
808 lib docs don't have control params
Legato Tie
 !? Consider if a monophonic synth type would help, even if that's the only thing that would support legato..??
 Allows multiple pattern notes to be played without envelope retrigger
 Should allow 303 slide
 Either do by extending one note across all tied notes and changing pitch along the way
  ?But how to calculate pitch changes? And what about other paramas and flags on the tied notes
 Or, do by playing multiple notes in such a way that their envelope, envelope{} and []e play subsections
  ?Nut the timing becomes very complex...
TB303 realism
 slide - fixed 88ms
  ! slide should cause envelopes to NOT retrigger... legato...
  ? should really start Before the end of the first note...??? THIS IS NOT TRUE?
  ! But it SHOULD really be specified on the note BEFORE! Is 0s2.. slides the 0 into the 2...
 Compare to a real 303 - recreate some famous 303 lines
  https://www.youtube.com/watch?v=KwL2S5LRzFM&t=1107s
   3#3#ds3#ua3#d3#us3#d3#a3as  - but needs legato slide
  https://www.audiorealism.se/audiorealism-bass-line-2.html
Half wave rectifier shaper
 Symmetric but center half at zero then rise up
 Really want user functions and define your own shape
Try a convolution reverb with an envelope where the sound builds then fades instead of just dying away
??can set high/mid/low params on reverb to EQ signal prior to reverb - Also on entry to all waveeffects?
Legato Eg on a 303, When 2 notes slide they are legato, and the amp and filter envelopes do Not reset for the second note...
? Feedback for chorus?
? Freeze delay, or sample recorder, or looper?
!Add=slider still only grabs one value per beat for audio synths (works for visual)
!Calculating pulse from analyser should involve a perceptual loudness curve
!Why does convolver reverb cause stereo bias?
Other audio player pulse should come from an actual FFT same as bus (only create on first read though)
!Pan should be equal power when panned?
Impulse destructor should be snappier? It probably waits too long to clean up
 ?Same for play???
?Ability to apply effects like compress, drive, reverb etc in bands - So you can compress low, mid and high independantly
 ?EQ sub Params on input to reverb etc? Eg reverb={2,high:4db,low:-4db}
Allow non-chord multiple bus outputs from one player; (bus1, bus2) etc
 Bus subparam for mix level (per frame); eg   p ping 0, bus={bus1,mix:1/2}
  Also want to be able to split multiband too
In-page example with percussion bus
Cache/transfer bus effect nodes if unchanged?
Should be able to have multiple bandpass and notch filters
?Inline bus param Eg p ping 0, bus={reverb:1}
?Setting to push analyser node FFT size up from 1024
Synthwave preset buses?
External player should be a bus-like player, with no events ?? Will this still have an fxMixChain??
More options for setting up the convolution reverb
 Mono/stereo: how much difference between L and R
 Some real impulse responses as options??
??? Could use very short loop that moves stepwise on a carefully prepared sample to do wave table synthesis???
!echo={1,feedback:0} should still produce a single delayed echo
!Chop/ring LFO Freq should be per frame
Also use nonchord find: nf (series) and bpf (parallel) for all audio
 Docs
!FM operator should support all wave types
Pattern char to set glide?
Percussion player for single sample; value is velocity Eg  p playv 90520070, sample=':'
 ?Or go whole hog and patterns should become expressions and all params should be {} 'info' on the player?
  Eg  P saw {\0246\, oct=5, lpf=\3<52>4\*1000}  or something?
303 synth preset
Pitch shifter effect
 Can use https://github.com/Tonejs/Tone.js/blob/c313bc672bcc09a8cee4df97a07ba80155fd1946/Tone/effect/PitchShift.ts
 See http://msp.ucsd.edu/techniques/v0.11/book-html/node115.html
 Should also be able to insert this into the reverb loop...
Allow adding filters in the room/echo loops eg echo={3/4,lpf:523} - but dont use existing filter handlers as must be per event only!
 Pitch shift up an octave to give shimmer reverb (pitch shifter: https://tonejs.github.io/docs/14.7.77/PitchShift.html)
Stereo widener effect: https://www.soundonsound.com/techniques/classic-stereo-widening
envelope exp (exponent) subparam, eg att={1/2,exp:2} ?? Or name it 'pow'? Default to nonzero?
?Really/ideally, everything that uses an lfo (ambi, phaser, prophet etc) etc should just use a parameter so the lfo behaviour is defined in the code
Can specify media stream device
 Print list of all devices with IDs
 device param to specify required device ID to be used - need to store one stream per device
 Same for webcam
echo={1/2,pingpong:1} for stereo ping pong echo; use splitter and merger
Convert pwm and ?noise to webassembly, performance is terrible compared to native oscs
Reverb gate: room={1,gate:1/4}
Multiple unnecessary gain nodes even from default effects chain (that has no effects)
this.freq should also respond to addc
Envelope follower? Pitch follower? for external synth
choke param for play synth to choke one sound off when the next plays (eg hihats)
Env=reverse (slow attack / fast release)
formant/vowel effects for vocal aaa/ooo/choir effects
Is it possible to control rate per frame?
fmpluck
 test fm 070604_[21], att=0, dur=1/2, echo=0, oct=4, amp=1, op1target='out', op1ratio=1, op2target=1, op2ratio=1, op2depth=1024, op2att=0, op2rel=8, op3target=1, op3ratio=2, op3depth=768, op3att=0, op3rel=8, op4target=1, op4ratio=3, op4depth=3072, op4att=0, op4rel=1/4, op4wave='sawtooth'
Is play rate per frame?
Allow setting main reverb room size
Look into improving quality of samples playing at slow rates?
AudioWorklet freeverb with webassembly
Drive should be per frame
Constant envelope type to allow specifying per frame envelope with amp?
reverb param allowing to use a convolution reverb with specified duration (at users own risk :-)
Pluck/guitar synths
 https://fazli.sapuan.org/blog/electric-guitar-synth-in-html5/
 https://github.com/ronkot/ks-guitar-synth/blob/master/src/js/guitar-string.js
 https://github.com/mohayonao/pluck-string-node/blob/master/index.js
Nice gentle pads
FM krunchy bass - https://www.youtube.com/watch?v=1XbrTC0NndM
Preload samples immediately after parsing
'add' param for play synth?
AudioWorklet FM operator supporting feedback with webassembly
speech synth
soprano synth - use vib effect - aaah synth: https://github.com/AppGeo/web-audio-examples/blob/master/formant.html
support -ve rate for reverse playback
Normal bass synth
FM ambient synth - https://www.youtube.com/watch?v=_xL3qr-9-ZE
FM wood synth - https://www.youtube.com/watch?v=dXo_493fEpU


====
==== visual ====
!Buffer freezes on code update
?Proper detailed gradients, not just fore/mid/back
 ?Based on user defined functions populating a lookup texture? or piecewise translating into gradient segments?
 ?recol=fmb that leaves all pixels white but with fb set, to allow recolouring with fore/mid/back. check it for webcam/image etc too
 ?Shader palettes from https://github.com/Erkaman/glsl-cos-palette
?A visual synth routed to a buffer should not play at all if the buffer is not there?
 Right now, it works except the synth pauses..??
Would be nice for buffer feedback to keep playing until its finished when do StopAll?
!What happens to buffer when it uses eg loc=tile_b ??
 It works fine, but should the buffer rez be changed to compensate??
Filter param for all texture based synths (including buffer feedback)
 Image and buffer and webcam shader texture lookup supports a filter kernel with controlled size
  Kernel options for blur, sharpen, max... etc
 Option for additive blur (ie glow/bloom)
?Some kind of antialiasing for perspective distance; even if its user configurable
 ? point sampled antialiasing? will be very inefficient/slow?
 ? some kind of hinting to the actual shader?
!Should really multiply feedback params by dt, otherwise the rate of feedback motions will be framerate dependent
 Tricky to do; have to eval params first them multiply, and it's very param dependent; eg zoom vs scroll
Generative visual synth
 Complementary colours?
 Shapes? Noise? NN Dreams?
Digital JPEG corruption filter param - https://www.shadertoy.com/view/Md2GDw
 Takes square blocks and maps them to adjacent parts of the image, or colours them randomly green or gray or pixellated
 Main param value determines the amount of corruption
 Subparam for block scale
 Subparam for extremity of effect within corrupted blocks?
Make buffer param work per frame
 !!This fails at the moment because the synths are added to only one buffers renderList, and its done per event not per frame
Can set texture repeat for text and image etc synths? Subparam or not?
 ? Not needed now we have repeat param?
Starfield shader; https://www.shadertoy.com/view/WdyXDm
Should the coord system for text positionin not be -1:1 like for normal loc?
slitscan param for 2001 style slitscan, subparams for shape, rotation
Gradient values should give different types of gradients eg radial etc
video synth (use video element to load video file; don't try and target eg youtube)
 can play audio through external audio synth??
Antialias param?? Subpixel supersampling??
Nice shader idea? https://tanck.nl/wallpaper/
Spiral and noise and shimmer predistortions
Possible nice shader https://twitter.com/zozuar/status/1438117355746377728?s=03
Consider pushing data of each event into a texture so a shader could display all events, eg as 2D patterns or voxels or 3D shapes
Disco glowing geometric shapes shader
make vignette work with window
Some form of anti aliasing eg for grid shader in perspective distance?
Add rotate to loc
 Handle: aspect ratio, off centre x/y, window
Start image download on parse not on first use
Support echo for visuals? Additive but dimmed, time turned back? Move down??
noise/film grain
Sprites duration should include rel? Or not??
shadertoy synth support textures - MtGSzh
 NO CORS!! https://www.shadertoy.com/media/a/f735bee5b64ef98879dc618b016ecf7939a5756040c2cde21ccb15e69a6e1cfb.png
shadertoy synth multiple channels


====
==== things to test/consider ====
// pattern features (), [], <>, #b, v^, single event pattern
// (), follow, complex durs, simple durs, delay, stutter, overrides, +=, |=, []
// [], []t, []l/s, []e, []n, []r []{}, segmented audioparams
// operators + - * / ^ % | .
// var, player.var, this.param, this.voice, var{params}, slider{}, floor{}, .floor{to:}, accum{}, this.time, time, rand, slider
// (...).1, (...).max, max{...}, {foo:...}.foo, (pk,ps).pulse
// modifiers {seed,per,step,0:0}, @e, @f
// subparams {2,mix:1/2}, presets, buses, buffers
!!!!Remember to update breaking changes link on index when doing a release!!!!

====
==== other ====
!! floor doesn't work with delay:  r readout 1234, delay=floor{[0:1]l3@f,to:1/4}
More time modifiers
 offset
 rate
 time - set time directly to an expression
 Random noise rewrite to use piecewise
  []n:  []n1  =>  [ rand{step:2} ,~1; rand{step:2,offset:1} ,~1; ]time*1
Syntax to allow use of clamp and normalise for []{}?
Main bpm param time units
stutter subparam, to set time between stutter events
?Is it possible for addc=[0,[-12,-24]t1/8@f]r@e to still allow the per frame motion, while the r@e selects it per event?
 []r used to select per event by fixing the seed per event rather than by stepping time, so it used to work
!([{x:[1,2]t1/4@f}]t2).x never get a 2 unless add @f to the []t2
!Delayed events appear in the wrong getEventsForBeat, and get the wrong voice assigned
 p readout, dur=1/4, delay|=[(),{1,add:5}]r, loc={y:this.voice/2}
!Ordering of players makes this fail; readout doesnt get a chord when it should
  r readout, add=p.add, loc={y:this.voice/2}
  p readout, oct=(4,4), add=floor{[]r*7}, fore=0
!Not getting the SAME random values that the other player got; eg:
  p ping, oct=(3,3), add=floor{[0,14]r}, dur=2
  r readout, add=p.add, loc={y:this.voice/2}, dur=1/8
!!Dont get actual values from random on another player
 p ping, oct=(3,3), add=[0,14]r, dur=2
 r readout, add=p.add, loc={y:this.voice/2}
!Should have operator support for units; eg [0.001s,1hz]e
Voice leading
 !!!IDEA: each event should be able to access the previous event (in its voice), and others in its chord? Then could calculate leading?
 ? Very clever or just noodles with random walks? Experiment...
 --- Voice leading experiment
  set root=[0,2,3,1]t8
  set ch=voice{root+[(0,2,4),(0,2,4,6)]t4}
  b techbass .00 crop 16, add=root, cutoff/=4
  sp softpad, add=ch
  ld chime 070., add=ch.[0,rand,rand,rand], amp*=3/2
Should be able to parse top heavy fractions; eg `1+1/4` is same as 5/4. Parse as number, not operator?
range function eg (0,2,4,6).range{0,to:riser*3}
 IOW range{a,to:b} === (a,a+1,a+2,...,b)
!this var lookup failing in various ways:
 // m ping 0, bar={'tri',detune:(12,this.foo)}, foo=2
 // m ping 0, bar={'tri',detune:(12,-12)}, bar+={detune:this.foo}, foo=1
 r readout 0, add=m.bar.detune, loc=sparkle
!Too much recursion: should we either prevent this or support it somehow?: r readout, add=1, delay=(0,{3/4,add:this.add*2/3})
!Readout doesn't work here:  p ping 0, foo=[0,1,2,3]t1, add=this.foo \ r readout 0, add=p.add
 It's specifically the this.foo that makes it fail; it's using *r*'s event for this, not p's event
!Duration should be calculated on every step, not every beat: cf play t, dur=[1/16:1/128]l[4,0]
!Cannot override dur using `set`, it only changes the sus
root{chord} function that takes a chord and returns the root
?sound param can be overridden, so it defaults to pitch/oct/scale etc but you can override so the pattern can specify chord index etc
 ?Not necessary because [0,1,2] is effectively a pattern that can be used to select from chords?
Really time{} and b and so on should all return values in beats, not unitless
Should be able to:  v gradient 0, fore.g=0  And it navigates or creates maps as needed. or  t trance 0, reverb.hpf=0
 Needs to work for overrides too eg  body.boost+=100
!v readout 0, add=[0,(1,2)]r, loc={y:this.voice/2}
 Should get either 1 event with `0` OR 2 events with `1` and `2`, but get all kinds of mixtures
?New timevar for "advance every time its read" eg  p ping (00), add=[0,2,1,3]??  same as  p ping (02)(13)  ?
User defined functions
 Eg shape={x}->sgn{x}*max{abs{x}-1/2,0}
  !But the default behaviour for our existing functions is to be evalled even without {}, so how to pass the functions as values?
   ?Can we default to non eval without {}, but do the eval if necessary in context? Eg operators can't act on function, so eval? etc
 Or set riser={dur}->(time%dur)/dur
  Allow riser={dur?32}->(time%dur)/dur ?
 ?If functions are values, how do they interact with other values? What if you add functions etc? Eg ({}->0) + ({}->1) ?
 ?What about chords eg {x} -> x*(1,2,3) ?
 !Should be able to access the default e and b params
 !Should be able to eval functions as well as pass them; eg ({}->3){}
 Rewrite envelope{} as a user defined function
Should be able to [0:1]n{per:'event',seed:0} ie so the sequence repeats on every event
Pattern update
 Generative features:
 • brackets for precedence
  ( 0 + 1 * 2 ) crop 16 - 0110110110110110
 • p ping 01 pad 4  - 01..
  1234 pad 3 - 123
 • p ping 01 prepad 4  - ..01
 • Mirror
  mirror 012 * 2  - 012210012210
  mirror (012 * 2)  - 012012210210
  mirror 012 crop 16 - 0122100122100122
 • p ping choose 01 , 23[45] , . , 7  - Chooses a different subpattern each repeat
 • p ping shuffle 01 , [23] , 4 , 5  - Random shuffling of subpatterns every repeat
 • sometimes/often/rarely/every before an operator; eg:  often mirror 0123   0123 sometimes * 2   every 4 shuffle 0 1 2 3
  Eg  p ping 0 + ( choice 017 2[34] 52 . ) * 5 crop 5 + [21]7
 • Control numbers are not const, they are expressions? Eg  p ping 0 + 54 * [2,3]r
  Eg  p ping 0 + 234 * 3 cropif delta{ch}  - when var 'ch' changes value, crop and restart the pattern from 0
 !!Need to know this will support more generative operations; eg Schenkerian infill, voice leading..?
  ?Would define new pattern operators?
  ?Can the existing pattern syntax support what would be needed?
  ?What arguments would be passed to a pattern operator definition?
  ?Probably want voice leading on expressions not patterns anyway??
?P ping 01, add=2 should really be p ping 01, value+=2 ?
 ALSO, really would like to be able to be able to  P ping 0123, value=ch[this.pattern_value]  but nicer somehow...
Support continuations inside chords in pattern literals
 Continuation in chord means take up that "voice slot" in the chord by continuing the previous event
 So all continuations in a chord are initial continuations
 Have to add extra "timing rests" to keep the timing lined up in stepToCount
 Test cases:  0(_1__)  0(__)  0(_(_1_))  0[(_1_)2]  0[(__)2]  0<(_1_)2>  (01)(_2)  (0[12])(_3_)  <[(0)]><[(_)]>
!Follow player event params should be evaluated at the time of the _original_ event for canons
Should support dur chords for polyrythms
?Want pattern language that expresses things like "2 beats anticipation of every 16" etc
?How's about a slider that only gives output when you click/hold it? So you control note duration/rest as well as pitch?
Should be able to stutter={4,dur:1}
!Syntax colouring is case sensitive; eg  `Set` does not get coloured correctly
?Can print out list of all current player types to console
 Syntax???
 Split by audio vs visual
 Additional info?
Follow player sort-out
 !If we take any params from the original event, then really want them to just work and not be overridden by follow player base events, or be at the wrong time due to follow player delay
 !Follow player chooses different random values so it does not copy the original player properly
  Need all randoms to be seeded, and the seed to vary between players but be the same for a follow player
   OR!! Should the follow player keep a queue of the events from the main player, delayed as needed?
  ?Do other things like timevars get followed correctly with correct delay?
!`p1 ping 0, dur=4, foo=[100,1000,100]e \n p2 kal 0, dur=1, amp=p1.foo/1000` the []e is evalled in the WRONG players dur
!add=(0,2,4,6)[rand]{per:2,seed:0} doesn't work; rand chord indexer needs to respect time modifiers and seed etc
!Really need a complete audit of time vs count. Need the code to be clear and unambiguous which is which. There will be issues to fix. Look at []e and []e{per}
!Pattern does not have correct timing: <3[45]>_
Really REALLY want to be able to modify from delay overrides:  p saw 0, add=[0:7]r, delay=(0,{1/2,add+:2})
 !Actually, this is already possible using  delay=(0,{1/2,add:this.add+2}) . but this is ugly :-/
 But not sure of syntax
  The only other syntax option is to switch to (or allow) = and += for map entries; but this is visually confusing?
"on next 4 " / "on next 28 of 32 " syntax to execute a line on the next beat count
  - but how not to repeat this if rerun? replace now/next in source with actual count?
"every 4 " / "every 28 of 32 "
"until next 16 set (bass,kd) amp=0" ? - but how not to repeat this if rerun?
"by next 16 set bass amp=0" - lerps to the new value - but how not to repeat this if rerun?
!().accum should work - why doesn't it? I guess the chord voices haven't been split yet?
 r readout 0, loc={y:2/3-this.voice/2}, add=([0,1]t1,[0,1]t2).accum
Variable rate expressions somehow EG  addc=[-1,1]s[1/8:1]e  Or  addc=sin{[1/8:1]e*6.28}  or something
floor{1.5,2.5} should work??? Or should it?? Probably not? But then it should give an error? But sum{1,2} works?
? (0,2:8) syntax?
!Handle 'cookie blocking' https://blog.tomayac.com/2022/08/30/things-not-available-when-someone-blocks-all-cookies/
Advance param to specify how far in advance events should be generated - Would allow for negative delays
For breakbeats, need a param to switch the pattern step used for an event
 This seems tricky with a param, as we don't even know what the params are until the pattern is evalled
 Will have to be a pattern syntax instead..?
  Unless some params are stored per player? And can be used to modify pattern evaluation? Arguably, dur is already like that?
 !Actually apply shuffle in the pattern?
?Functions for making chords?
Some sort of matching or booleans would be handy; eg  rel=2+6*(this.value<0)  or maybe  rel=match{this.value,default:2,-7:8}
?Should be able to stutter with euclidean (or other?) patterns??
?stutter subparam for overriding interval between stuttered notes?
!v glow 0, loc=sparkle, fore=(red,blue)[max]
Allow mixing , and :   Eg  [0,2:4,5]r  meaning 0 or 2 to 4 or 5  Or  [0:4,7,9:10]t1  meaning [0,1,2,3,4,7,9,10]t1
!root change using []t is 1 beat late in changing
stutter={4,amp:1/2}  - apply overrides
 ?How to provide overrides per stuttured notes?
  stutter={4,dur:1/8,i=>{amp:1/i}}
?Do delayed events have any cost? Do we process them per frame?
 I guess we might process any per-frame callbacks every frame while waiting for the event?
allow root param on player to override global root (add or replace?)
?slider{max:(1,2)} should work
!`d dsaw 0 | p ping follow d` the ping is played using the saw wave!!
Pattern: should allow (024)^etc
Fullscreen not working on safari
[0,1]n should randomly choose one of 0 or one then smooth between them, [0:1]n should pick random values between 0 and 1...
 In which case, rewrite it as the main random, but then smoothed
Complex durs
 overrides - need to apply overrides earlier? Should apply to delay overrides too
 chords
 var lookup (& player var lookup)
Ignore rests . when setting event.idx (so that `0.1., amp=[1/2,1]` does as expected) - is that expected? It wouldnt be for dur..?
multiline command fix: // should only comment out that one line
Need an additional eval interval; eg @i for 'per instance', so for each individual 'note' instance (each call to play)
 Useful for providing variation between (1,2,3,4) multiplied out sub-events without having to go full-on per frame, expecially for eg []r
 ? Isn't that what @e should be? And then we could have @t for 'eval once for all chord values'
Better syntax highlighting for {} brackets; maybe bracket match highlighting??
Weighted random: nice syntax?:  [1,2,{3,weight:1/2}]r
ma{v,window:1} - calculate the moving average of a value over a given time window
Can specify params for all players except those in group 'set !bass amp=0' 'set ![kd,sd] amp=0'
? rl, rt (==r), rs (==n); el (==e), es, et ?
 ?[1,3,5]n syntax to smoothly transition between randomly chosen values or should be [1,3,5]rs?
 []w for random walk?
Per can default to repeat of thing being modified?
 Eg [0:1]l4{0:0} per defaults to 8?
Should Eg [0:1]e{per:1/4,1/2:-1} work??
Sliders
 Remember last value even when not shown
 Display slider value on UI, instead of logging
Support range overrides? Eg add=[0,1]l2{per:4,0-1:0}
WebMidi
 Outputs (to control external synths)
 Inputs (like sliders)
 Beat sync input?
Have a [0,1][2,3] syntax to apply values to multiple events in a row
Tutorials
 ? Can automate the copy to clipboard paraphernalia?
 Link on this page
 Link on README
Can't override dur from set command
Can set value param to override the pattern value
syntax coloring: colour for patterns
Allow variable durations eg [0:1]l(3+[1:2]t4) etc
extending patterns like every/sometimes/offadd/stutter etc
_ extends all notes properly, even across brackets (eg <1[.3]>_ etc)
rests in params


===
===== Interesting shadertoys
-- working
Nixie digits: 4dc3zr
swirl shader 4dX3Rn
scaly shader MdSXzz
bubbles shader 4dl3zn
Fractal: MlGfDG
Fractal zoom: XtlGR2
Fractal tiling: Ml2GWy
3d supershape: 4llGWM
glitchy space patrol: ltlGD8
vector field: MdcyRs
Star tunnel: MdlXWr
dusty nebula: lslyRn
smoke lights: MdyGzR
laser show: MdjyzG
smoke laser: 3lSGDK
nebula smoke: 4ltSRS
disco tunnel: XstfzB
disco balls: lllXWr
sky swoop: lldSWN
Flux core: ltlSWf
candy core: 4sVXDz
core engine: Wsc3W4
warp core: 4lGXzG
80s synthwave: 4t33D2
-- needs textures
synthwave driving shader tsScRK
power sphere MtGSzh
furry shader 4dlGDN
gem tunnel shader ld3Szs
-- needs channels
forge shader based on: llK3Dy
-- extensions
Mechanical: XslXW2
-- shader not found (not published with 'public+api' option)
Raindrops: https://www.shadertoy.com/view/tlVGWK
plant wind https://www.shadertoy.com/view/4lf3Rj
star shader https://www.shadertoy.com/view/4dXGR4
plasma ball https://www.shadertoy.com/view/XsjXRm
Galaxy: https://www.shadertoy.com/view/llSGR1
electric shader https://www.shadertoy.com/view/ldlXRS
lattice shader   https://www.shadertoy.com/view/4dsGD7
fireball shader https://www.shadertoy.com/view/lsf3RH
Space: https://www.shadertoy.com/view/lslSDS
Spiral flow: https://www.shadertoy.com/view/MdlXRS
Fractal https://www.shadertoy.com/view/lslGWr
Colour tunnel: https://www.shadertoy.com/view/XdSGzR
Cell flow: https://www.shadertoy.com/view/MlsGWX
---
test fm 020406[79]5, oct=5, att=1/16,
  op1={target:'out',ratio:1},
  op2={target:1, 		ratio:1, depth:128, att:0, rel:8},
  op3={target:'out',ratio:2, depth:512, att:0, rel:2},
  op4={target:3,    ratio:2.02, depth:256, att:1/4, rel:2},
  op5={target:'out',ratio:1, depth:512, att:1/16, rel:1/4},
  op6={target:5,    ratio:1, depth:1024, att:0, rel:1/4},
------
- V2 concepts
NOT using WebAudio
Maybe use electron + supercollider ?
Language features
 Signals for continuous time variation
 Events for discrete actions
 Routing
User defined functions can be evaluated or translated (eg into shaders)
 So user functions for wave shaping, colour mapping, shader cores, convolution impulses, etc
Debug any signal by visualising time or frequency domain
Sources and effects and routing, with default routing
Units for everything Hz, bts (beats), ms etc
Build velocity in
Player has an event generator with its own routing
Global metronome providing events, can be used or ignored by event generator
 `. 7 2`  -  defaults to global metronome
 bpm*4>>`. 7 2`  -  global metronome quarter beats
 125bpm*4>>`. 7 2`  -  local metronome at 125bpm, *4 to give quarter beats at 125bpm
`. 0a 1(lpf:300Hz)`  -  flags and extra params per note
`0 (24)`  -  chord
Syntax for routing splits and joins Eg defining a multiband compressor or a mixer
?What about monophonc and glides?
Pipeline: metronome >> event generator >> pitch/coord generator >> source >> direct effects >> indirect effects >> buses >> destination
 This still doesn't address how monophonic / glide make sense. Are the pitches events or signals?
?What about overrides? Don't want +=, want something to apply any function as an override; eg add:=(a)->a+7

* IDEA: time vars and gradients and waveshapes are really just 1D functions of different variables
  What is missing from normal syntax is the ability to easily define functions piecewise
  So what is really needed is a generic syntax for defining piece-wise 1D functions cleanly
[red:/1/8,yellow:-1/8,white:/1/4,green:~1/4,blue:/1/4]
[0,2,1,3]t4 - [0,2,1,3]:4
[0,1]t[3,1] - [0:3,1:1]
[0:1]l4 - [0,1]:/4
[0:1]s4 - [0,1]:~4
[0:1]l1@f - [0,1]:/1@f
[0,1]r - [0,1]:?
[0,1]n2 - [0,1]:?~2
[8,1]e - [8:\e,1:.]
envelope{d:250} - [1:^250ms,0]
[0:/20ms, 1:^1/4, this.sus.level:-(this.sus?this.dur-1/2, this.sus.level:/1/4, 0:.]
p saw, shape=x->[0:/1/4, sin{x*20}:1/2, 1:/1/4]x
??What about discontinuity? Eg hold at 1 for 1, then go from 0 to 1/2 for 1 then repeat [1:1,0:0,1/2:/1] - is that good enough?
----
* Actually, ideally need a syntax that supports all this:
Per value: value, additional info, how to progress to this from the previous value (shape, time)
Per bitwise function group: How to choose the next value (sequence, random, index by value), defaults for the per-value data
---
Actually the transition should be separate from the values, eg
 adsr - [0 ,/10ms; 1 ,^100ms; this.sus.level ,-this.sus; this.sus.level ,^250ms; 0]e
And this could be added to the existing syntax by making the comma into a "clever" operator
 How does this work for a random selector though? [0,~; 1,/10ms;]r

Examples

// Defining effects
let lpf = effect.biquad coeffs=(v) -> a0=,a1=,a2=,b0=...etc, priority=2
let bf = effect.color (in,v) -> back + in * fore, priority=1
let scroll = effect.warp (in,v) -> in+v, priority=1

// Audio preset and player
let saw = source.wavetable wave=(x) -> [-1 ,/1; 1,;].x, f=pitch(note:this.value+this.add, oct:this.oct)+this.addc
let b = bpm*4 >> `. 7 2` >> crop(16) >> saw, lpf=(env(r:100ms)*440Hz*tri(8beats)), add=[0,3,2,4].time/4

// Visual preset and player
let lines = source.shader shader=(x,y) -> (r:1,g:1,b:1)*(x%0.1 < 0.05) + (a:1)
play l = scroll=(x:time), bf=(back:(r:1,g:0,b:0,a:1),fore:#f0f)