more work

index.html

@@ -163,11 +163,11 @@
                 <details class="space-y-2" open=false>
                   <summary class="ml-2 lg:text-xl pb-1 pt-1 text-white">Audio Engine</summary>
                   <div class="flex flex-col">
-                    <p rel="noopener noreferrer" id="docs_audio_basics" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Basics</p>
+                    <p rel="noopener noreferrer" id="docs_audio_basics" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Playing a sound</p>
                     <p rel="noopener noreferrer" id="docs_amplitude" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Amplitude</p>
                     <p rel="noopener noreferrer" id="docs_sampler" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Sampler</p>
-                    <p rel="noopener noreferrer" id="docs_reverb_delay" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Reverb & Delay</p>
-                    <p rel="noopener noreferrer" id="docs_distortion" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Distortion</p>
+                    <p rel="noopener noreferrer" id="docs_synths" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Synths</p>
+                    <p rel="noopener noreferrer" id="docs_reverb_delay" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Effects</p>
                   </div>
                 </details>
 
@@ -175,14 +175,12 @@
                 <details class="space-y-2" open=false>
                   <summary class="ml-2 lg:text-xl pb-1 pt-1 text-white">Samples</summary>
                   <div class="flex flex-col">
-                    <p rel="noopener noreferrer" id="docs_sample_list" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Samples List</p>
+                    <p rel="noopener noreferrer" id="docs_sample_list" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">List of samples</p>
                     <p rel="noopener noreferrer" id="docs_loading_samples" class="ml-8 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Loading Samples</p>
                   </div>
                 </details>
 
                 <p rel="noopener noreferrer" id="docs_patterns" class="pl-2 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Patterns</p>
-                <p rel="noopener noreferrer" id="docs_samples" class="pl-2 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Samples</p>
-                <p rel="noopener noreferrer" id="docs_synths" class="pl-2 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">Synths</p>
                 <p rel="noopener noreferrer" id="docs_midi" class="pl-2 pr-2 lg:text-xl text-sm hover:bg-neutral-800 py-1 my-1 rounded-lg">MIDI</p>
 							</div>
 						</details>

src/Documentation.ts

@@ -3,7 +3,6 @@ import { type Editor } from "./main";
 import { introduction } from "./documentation/basics/welcome";
 import { loading_samples } from "./documentation/samples/loading_samples";
 import { amplitude } from "./documentation/audio_engine/amplitude";
-import { distortion } from "./documentation/audio_engine/distortion";
 import { reverb } from "./documentation/audio_engine/reverb_delay";
 import { sampler } from "./documentation/audio_engine/sampler";
 import { sample_banks } from "./documentation/samples/sample_banks";
@@ -99,7 +98,6 @@ export const documentation_factory = (application: Editor) => {
     reference: reference(),
     shortcuts: shortcuts(application),
     amplitude: amplitude(application),
-    distortion: distortion(application),
     reverb_delay: reverb(application),
     sampler: sampler(application),
     mouse: mouse(application),

src/InterfaceLogic.ts

@@ -485,7 +485,6 @@ export const installInterfaceLogic = (app: Editor) => {
     "amplitude",
     "audio_basics",
     "reverb_delay",
-    "distortion",
     "interface",
     "interaction",
     "code",

src/documentation/audio_engine/audio_basics.ts

@@ -67,7 +67,7 @@ Try to remove <ic>.out</ic>. You will see that no sound is playing at all!
 - Sounds are **composed** by adding qualifiers/parameters that modify the sound or synthesizer you have picked (_e.g_ <ic>sound('...').blabla(...)..something(...).out()</ic>. Think of it as _audio chains_. 
 	
 ${makeExample(
-    '"Composing" a complex sonic object by making a sound chain',
+    'Complex sonic object',
     `
 beat(1) :: sound('pad').n(1)
   .begin(rand(0, 0.4))

src/documentation/audio_engine/reverb_delay.ts

@@ -4,7 +4,11 @@ import { makeExampleFactory } from "../../Documentation";
 export const reverb = (application: Editor): string => {
   // @ts-ignore
   const makeExample = makeExampleFactory(application);
-  return `# Reverberation and delay
+  return `
+
+# Audio effects
+
+There is a growing collection of audio effects you can use directly baked in the engine. You can create a wide variety of sonic effects by being creative with the parameters they offer.
 
 ## Reverb
 	
@@ -27,7 +31,6 @@ beat(2)::snd('cp').room(0.5).size(4).out()
     true
   )};
 	
-	
 ## Delay
 	
 A good sounding delay unit that can go into feedback territory. Use it without moderation.
@@ -39,14 +42,45 @@ A good sounding delay unit that can go into feedback territory. Use it without m
 | <ic>delayfeedback</ic> | delayfb | Delay feedback (between <ic>0</ic> and <ic>1</ic>) |
 	
 ${makeExample(
-    "Who doesn't like delay?",
-    `
+    "Who doesn't like delay?", `
 beat(2)::snd('cp').delay(0.5).delaytime(0.75).delayfb(0.8).out()
 beat(4)::snd('snare').out()
-beat(1)::snd('kick').out()
+beat(1)::snd('kick').out()`, true)}
+
+## Phaser
+
+| Method     | Alias     | Description                     |
+|------------|-----------|---------------------------------|
+| <ic>phaser</ic> | <ic>phas</ic>  | Phaser speed, between <ic>1</ic> and <ic>n</ic> |
+| <ic>phaserDepth</ic> | <ic>phasdepth</ic>  | How much of the signal goes through phaser (<ic>0</ic> to <ic>1</ic>) |
+| <ic>phaserSweep</ic> | <ic>phassweep</ic>  | Phaser frequency sweep (in hertz) |
+| <ic>phaserCenter</ic> | <ic>phascenter</ic>  | Phaser center frequency (default to 1000) |
+
+${makeExample("Super cool phaser lick", `
+rhythm(.5, 7, 8)::sound('wt_stereo')
+  .phaser(0.75).phaserSweep(3000)
+  .phaserCenter(1500).phaserDepth(1)
+  .note([0, 1, 2, 3, 4, 5, 6].scale('pentatonic', 50).beat(0.25))
+  .room(0.5).size(4).out()
+`, true)}
+
+## Distorsion, saturation, destruction
+
+Three additional effects that are easy enough to understand. These effects are deteriorating the signal, making it easy to get digital or gritty audio sample playback or synthesizers destroyed beyond recognition. Be careful with your signal level!
+	
+| Method     | Alias     | Description                     |
+|------------|-----------|---------------------------------|
+| <ic>coarse</ic>     |           | Artificial sample-rate lowering |
+| <ic>crush</ic>      |           | bitcrushing. <ic>1</ic> is extreme, the more you go up, the less it takes effect.  |
+| <ic>shape</ic>      |           | Waveshaping distortion (between <ic>0</ic> and <ic>1</ic>)          |
+	
+	
+${makeExample(
+      "Crunch... crunch... crunch!",
+      `
+beat(.5)::snd('pad').coarse($(1) % 16).clip(.5).out(); // Comment me
+beat(.5)::snd('pad').crush([16, 8, 4].beat(2)).clip(.5).out()
 	`,
       true
     )};
-	
-
 `}