From e25c520ba3a955bcc7f43d2bbd7ad71d3351fc29 Mon Sep 17 00:00:00 2001
From: Jack Armitage <jack.armitage@me.com>
Date: Wed, 20 Mar 2019 23:12:07 +0000
Subject: [PATCH] examples

---
 docs/funcs_geometry.md   | 36 +++++++++++++++++++
 docs/funcs_modulators.md | 74 +++++++++++++++++++++++++++++++++++++++-
 2 files changed, 109 insertions(+), 1 deletion(-)

diff --git a/docs/funcs_geometry.md b/docs/funcs_geometry.md
index 557b49c..f7e4bc4 100644
--- a/docs/funcs_geometry.md
+++ b/docs/funcs_geometry.md
@@ -17,6 +17,12 @@ Functions for manipulating geometry.
 
 Kaleidoscope effect with `nSides` repetition.
 
+#### Example
+
+```javascript
+osc(25,-0.1,0.5).kaleid(50).out(o0)
+```
+
 ### pixelate
 
 `.pixelate( x, y )`
@@ -26,6 +32,12 @@ Kaleidoscope effect with `nSides` repetition.
 
 Pixelate texture with `pixelX` segments and `pixelY` segments.
 
+#### Example
+
+```javascript
+
+```
+
 ### rotate
 
 `.rotate( angle, speed )`
@@ -35,6 +47,12 @@ Pixelate texture with `pixelX` segments and `pixelY` segments.
 
 Rotate texture.
 
+#### Example
+
+```javascript
+
+```
+
 ### scale
 
 `.scale( size, xMult, yMult )`
@@ -45,6 +63,12 @@ Rotate texture.
 
 Scale texture.
 
+#### Example
+
+```javascript
+
+```
+
 ### scrollX
 
 `.scrollX( scrollX, speed )`
@@ -52,9 +76,21 @@ Scale texture.
 * `scrollX` :: float (default `0.5`)
 * `speed` :: float (default `0.0`)
 
+#### Example
+
+```javascript
+
+```
+
 ### scrollY
 
 `.scrollY( scrollY, speed )`
 
 * `scrollY` :: float (default `0.5`)
 * `speed` :: float (default `0.0`)
+
+#### Example
+
+```javascript
+
+```
diff --git a/docs/funcs_modulators.md b/docs/funcs_modulators.md
index b9d1d0e..c58d295 100644
--- a/docs/funcs_modulators.md
+++ b/docs/funcs_modulators.md
@@ -24,6 +24,21 @@ Functions for describing modulations of sources.
 Modulate texture. 
 More about modulation at: https://lumen-app.com/guide/modulation/
 
+#### Example
+
+```javascript
+// chocolate whirlpool
+voronoi()
+  .color(0.9,0.25,0.15)
+  .rotate(({time})=>(time%360)/2)
+  .modulate(osc(25,0.1,0.5)
+            .kaleid(50)
+            .scale(({time})=>Math.sin(time*1)*0.5+1)
+            .modulate(noise(0.6,0.5)),
+            0.5)
+  .out(o0)
+```
+
 ### modulateHue
 
 `.modulateHue( color, amount )`
@@ -37,6 +52,12 @@ More about modulation at: https://lumen-app.com/guide/modulation/
 Changes coordinates based on hue of second input. 
 Based on:https://www.shadertoy.com/view/XtcSWM
 
+#### Example
+
+```javascript
+
+```
+
 ### modulateKaleid
 
 `.modulateKaleid( nSides )`
@@ -49,6 +70,17 @@ Based on:https://www.shadertoy.com/view/XtcSWM
 
 See also: [`kaleid`](#kaleid).
 
+#### Example
+
+```javascript
+osc(9,-0.1,0.1)
+  .modulateKaleid(osc(11,0.5,0),50)
+  .scale(0.1,0.3)
+  .modulate(noise(5,0.1))
+  .mult(solid(1,1,0.3))
+  .out(o0)
+```
+
 ### modulatePixelate
 
 `.modulatePixelate( multiple, offset )`
@@ -62,9 +94,18 @@ See also: [`kaleid`](#kaleid).
 
 See also: [`pixelate`](#pixelate)
 
+#### Example
+
+```javascript
+// what lies beneath
+voronoi(10,1,5).brightness(()=>Math.random()*0.15)
+  .modulatePixelate(noise(25,0.5),100)
+  .out(o0)
+```
+
 ### modulateRotate
 
-`.modulateRotate( multiple, offset )`
+`.modulateRotate( texture, multiple, offset )`
 
 * `texture`
   * `color` :: see [color `vec4`](#color-vec4)
@@ -75,6 +116,16 @@ See also: [`pixelate`](#pixelate)
 
 See also: [`rotate`](#rotate)
 
+#### Example
+
+```javascript
+// wormhole
+voronoi(100,3,5)
+  .modulateRotate(osc(1,0.5,0).kaleid(50).scale(0.5),15,0)
+  .mult(osc(50,-0.1,8).kaleid(9))
+  .out(o0)
+```
+
 ### modulateScale
 
 `.modulateScale( multiple, offset )`
@@ -88,6 +139,15 @@ See also: [`rotate`](#rotate)
 
 See also: [`scale`](#scale)
 
+#### Example
+
+```javascript
+// cosmic radiation
+gradient(5).repeat(50,50).kaleid([3,5,7,9].fast(0.5))
+  .modulateScale(osc(4,-0.5,0).kaleid(50).scale(0.5),15,0)
+  .out(o0)
+```
+
 ### modulateScrollX
 
 `.modulateScrollX( multiple, scrollX, speed )`
@@ -101,6 +161,12 @@ See also: [`scale`](#scale)
 
 See also: [`scrollX`](#scrollx)
 
+#### Example
+
+```javascript
+
+```
+
 ### modulateScrollY
 
 `.modulateScrollY( multiple, scrollX, speed )`
@@ -113,3 +179,9 @@ See also: [`scrollX`](#scrollx)
 * `speed` :: float (default `0.0`)
 
 See also: [`scrollY`](#scrollY)
+
+#### Example
+
+```javascript
+
+```