instantshader 0.2.0 → 0.3.0

package/dist/index.js

@@ -192,6 +192,7 @@ float grain(vec2 uv, float time) {
 //#region src/shaders/flow.ts
 const FRAGMENT$1 = `
 uniform float u_scale;
+uniform float u_curl;
 uniform float u_drift;
 uniform float u_openness;
 uniform float u_grain;
@@ -236,11 +237,22 @@ void main() {
   // composition reorganized every ~3 seconds, measured as more pixel change
   // over 3.5s than the beam prototype showed over 7.5s.
   //
-  // The curl field is sampled at 0.55x the fbm's frequency (see below), so
-  // the visible frame spans curlScale units of noise. The tile has to be at
-  // least twice that or the field repeats inside a single frame, which looks
-  // like wallpaper; ceil keeps it integral, which pnoise requires.
-  float curlScale = u_scale * 0.55;
+  // Curl field frequency, relative to the fbm's. Below 1.0 the currents are
+  // LARGER than the colour masses they carry, which is the look: sampled at
+  // the same frequency each mass sits inside its own little eddy, the
+  // advection only roughens mass edges, and the result is indistinguishable
+  // from a plain warped fbm.
+  //
+  // u_curl replaces what was a hardcoded 0.55, and its default is 1.05
+  // because the potential is pnoise now. Classic Perlin's lattice is a unit
+  // grid while simplex's skewed cells are roughly 0.7 units, so the same
+  // input scale yields visibly coarser features -- fewer closed eddies. 1.05
+  // was matched by eye against a reference render of the pre-pnoise look.
+  //
+  // The visible frame spans curlScale units of noise, so the tile has to be
+  // at least twice that or the field repeats inside a single frame, which
+  // looks like wallpaper; ceil keeps it integral, which pnoise requires.
+  float curlScale = u_scale * u_curl;
   float tile = max(2.0, ceil(curlScale * 2.0));
 
   // Straight-line travel through a tiling field: the direction never changes,
@@ -264,18 +276,18 @@ void main() {
   // the NUMBER of steps that turns advection into rotation: one step is a
   // plain directional shove, and at two the point still travels an almost
   // straight chord. The third is where it curves enough to close visible
-  // eddies, which is the whole point of the look. Step gain is dropped from
-  // 0.08 to 0.055 to keep the total travel about where it was.
+  // eddies, which is the whole point of the look.
   //
-  // The curl field is sampled at 0.55x the fbm's frequency, i.e. the
-  // currents are deliberately LARGER than the colour masses they carry.
-  // Sampled at the same frequency (as it was) each mass sat inside its own
-  // little eddy, so the advection only roughened mass edges and the result
-  // was indistinguishable from a plain warped fbm.
+  // Step gain 0.19, up from the 0.055 that was tuned against a simplex
+  // potential. pnoise carries shallower gradients, so the old gain advected
+  // the point far too little and the eddies stopped closing -- the frame went
+  // to soft diagonal bands. The gain absorbs that difference rather than the
+  // default of u_drift, which stays at 0.5 in its published 0-1 range so the
+  // knob means the same thing it always did.
   vec2 advected = uv;
-  advected += curl(advected * curlScale + u_seed + drift, tile) * u_drift * 0.055;
-  advected += curl(advected * curlScale + u_seed + drift, tile) * u_drift * 0.055;
-  advected += curl(advected * curlScale + u_seed + drift, tile) * u_drift * 0.055;
+  advected += curl(advected * curlScale + u_seed + drift, tile) * u_drift * 0.19;
+  advected += curl(advected * curlScale + u_seed + drift, tile) * u_drift * 0.19;
+  advected += curl(advected * curlScale + u_seed + drift, tile) * u_drift * 0.19;
 
   float t = fbm2(advected * u_scale + u_seed);
 
@@ -325,6 +337,14 @@ const flow = {
 			step: .05,
 			default: 1.7
 		},
+		{
+			key: "curl",
+			label: "Curl",
+			min: .3,
+			max: 1.6,
+			step: .05,
+			default: 1.05
+		},
 		{
 			key: "drift",
 			label: "Drift",
@@ -353,7 +373,8 @@ const flow = {
 	randomParams(rand) {
 		return {
 			scale: .6 + rand() * 2,
-			drift: rand() * 1,
+			curl: .6 + rand() * .7000000000000001,
+			drift: .25 + rand() * .75,
 			openness: rand() * 1,
 			grain: .08
 		};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instantshader",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Animated WebGL gradient shaders. Zero dependencies.",
   "type": "module",
   "license": "MIT",