agentvfx 0.0.0-stage → 0.3.4

package/skills/agentvfx/templates/impact/speedline-burst/fx.json

@@ -0,0 +1,44 @@
+{
+  "DESCRIPTION": "Speed-line burst: hard radial wedge lines from a centre over a darkened, zoom-smeared frame, with a hot core; lines re-roll every frame and thin out as the hit decays",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["impact"],
+  "INPUTS": [
+    { "NAME": "hitFrames", "TYPE": "long", "MIN": 1, "MAX": 12, "DEFAULT": 5 },
+    { "NAME": "holdFrames", "TYPE": "long", "MIN": 0, "MAX": 6, "DEFAULT": 3 },
+    { "NAME": "decayCurve", "TYPE": "float", "MIN": 0.3, "MAX": 4, "DEFAULT": 1 },
+    { "NAME": "center", "TYPE": "point2D", "DEFAULT": [0.5, 0.5] },
+    { "NAME": "lines", "TYPE": "long", "MIN": 8, "MAX": 400, "DEFAULT": 150 },
+    { "NAME": "density", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.6 },
+    { "NAME": "thickness", "TYPE": "float", "MIN": 0.05, "MAX": 0.9, "DEFAULT": 0.42 },
+    { "NAME": "innerRadius", "TYPE": "float", "MIN": 0, "MAX": 1.2, "DEFAULT": 0.22 },
+    { "NAME": "innerRagged", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.6 },
+    { "NAME": "dim", "TYPE": "float", "MIN": 0, "MAX": 0.9, "DEFAULT": 0.5 },
+    { "NAME": "zoomSmear", "TYPE": "float", "MIN": 0, "MAX": 0.3, "DEFAULT": 0.08 },
+    { "NAME": "core", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.6 },
+    { "NAME": "mode", "TYPE": "long", "MIN": 0, "MAX": 3, "VALUES": [0, 1, 2, 3], "LABELS": ["white", "black", "accent", "negative"], "DEFAULT": 0 },
+    { "NAME": "lineColor", "TYPE": "color", "DEFAULT": [1, 1, 1, 1] },
+    { "NAME": "stepFrames", "TYPE": "long", "MIN": 1, "MAX": 4, "DEFAULT": 1 }
+  ],
+  "X_AGENTVFX": {
+    "id": "speedline-burst",
+    "family": "impact",
+    "input": "either",
+    "spdx": "LicenseRef-agentvfx",
+    "flash": "possible",
+    "fps": 30,
+    "palette": true,
+    "presets": {
+      "speed-white": { "mode": 0, "lines": 150, "dim": 0.5, "core": 0.6 },
+      "speed-manga": { "mode": 1, "lines": 110, "density": 0.7, "thickness": 0.5, "dim": 0, "core": 1, "innerRadius": 0.26, "zoomSmear": 0.04 },
+      "speed-accent": { "mode": 2, "lines": 190, "density": 0.55, "dim": 0.62, "core": 0.5 },
+      "speed-negative": { "mode": 3, "lines": 130, "density": 0.65, "thickness": 0.5, "dim": 0.25, "innerRadius": 0.3 },
+      "speed-tunnel": { "mode": 0, "lines": 260, "density": 0.5, "thickness": 0.3, "innerRadius": 0.12, "dim": 0.7, "zoomSmear": 0.14, "hitFrames": 6, "holdFrames": 3 }
+    },
+    "safeSubstitute": { "template": "punch-shake" },
+    "credits": [
+      "Speed lines (shuuchuusen) are wedges of constant angular width, https://en.wikipedia.org/wiki/Speed_lines",
+      "Radial zoom smear as a centre-weighted multi-tap blur, see GPU Gems 3 ch.13 for the radial-sample idea, https://developer.nvidia.com/gpugems/gpugems3/part-ii-light-and-shadows/chapter-13-volumetric-light-scattering-post-process"
+    ]
+  }
+}

package/skills/agentvfx/templates/impact/speedline-burst/main.frag

@@ -0,0 +1,68 @@
+// speedline-burst: a hit layer. The layer below is zoom-smeared and darkened; hard wedge-shaped
+// lines radiate from `center`. Each angular cell of the circle hashes (per step of frames) to
+// "line or not", a width and a ragged start radius, so lines re-roll like hand-drawn frames. As the
+// hit decays, fewer and thinner lines survive. Lines are crisp edges, never a soft overlay.
+float hitEnv(float n, float total, float hold, float curve) {
+  if (n >= total) return 0.0;
+  if (n < hold) return 1.0;
+  float k = (n - hold + 1.0) / (total - hold + 1.0);
+  return pow(clamp(1.0 - k, 0.0, 1.0), curve);
+}
+
+void main() {
+  vec3 src = texture(inputImage, vUv).rgb;
+  float n = floor(TIME / TIMEDELTA + 0.5);
+  float env = hitEnv(n, float(hitFrames), float(holdFrames), decayCurve);
+  if (env <= 0.0) {
+    fragColor = vec4(src, 1.0);
+    return;
+  }
+  float aspect = RENDERSIZE.x / max(RENDERSIZE.y, 1.0);
+  vec2 p = (vUv - center) * vec2(aspect, 1.0);
+  float r = length(p);
+
+  // zoom smear: average the frame sampled toward the centre
+  vec3 base = vec3(0.0);
+  const int TAPS = 10;
+  for (int k = 0; k < TAPS; k++) {
+    float s = 1.0 - zoomSmear * env * float(k) / float(TAPS - 1);
+    base += texture(inputImage, clamp(center + (vUv - center) * s, 0.0, 1.0)).rgb;
+  }
+  base /= float(TAPS);
+  base *= 1.0 - dim * env * smoothstep(0.05, 0.9, r);
+
+  // wedge lines
+  float step_ = floor(n / float(stepFrames));
+  float cells = float(lines);
+  float a = atan(p.y, p.x) / 6.28318530718 + 0.5;
+  float x = a * cells;
+  float id = floor(x);
+  float f = fract(x) - 0.5;
+  float h1 = hash12(vec2(id, step_ * 1.7 + 3.0));
+  float h2 = hash12(vec2(id + 91.0, step_ * 2.3 + 9.0));
+  float h3 = hash12(vec2(id + 177.0, step_ * 0.9 + 21.0));
+  float live = step(h1, density * env);
+  float width = thickness * mix(0.25, 1.0, h3) * (0.4 + 0.6 * env);
+  float aa = cells / (6.28318530718 * max(r, 1e-3) * RENDERSIZE.y) * 1.2;
+  float wedge = 1.0 - smoothstep(width * 0.5 - aa, width * 0.5 + aa, abs(f));
+  float startR = innerRadius * (1.0 + innerRagged * (h2 - 0.3));
+  float lineMask = wedge * live * smoothstep(startR, startR + 0.004, r);
+
+  vec3 lineCol;
+  if (mode == 1) {
+    lineCol = vec3(0.0);
+  } else if (mode == 2) {
+    lineCol = PALETTE[min(1 + int(h3 * float(max(PALETTE_COUNT - 1, 1))), PALETTE_COUNT - 1)];
+  } else if (mode == 3) {
+    lineCol = vec3(1.0) - clamp(base, 0.0, 1.0);
+  } else {
+    lineCol = lineColor.rgb;
+  }
+  vec3 col = mix(base, lineCol, lineMask);
+
+  // hot core: a hard-edged pure white starburst (radius ragged per wedge), never a soft glow
+  float coreR = innerRadius * core * (0.75 + 0.6 * h2) * (0.5 + 0.5 * env);
+  float aaR = 1.5 / RENDERSIZE.y;
+  col = mix(col, vec3(1.0), 1.0 - smoothstep(coreR - aaR, coreR + aaR, r));
+  fragColor = vec4(max(col, 0.0), 1.0);
+}

package/skills/agentvfx/templates/impact/strobe-burst/demo-strobe-white-16.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-thermal","params":{"blend":0},"palette":"brutal-acid","input":{"video":"test-media/clip-01.mp4","audio":"test-media/beat-132.mp3"},"durationSec":4,"seed":11,"hits":[{"beat":0,"template":"strobe-burst","preset":"strobe-white-16","params":{"tempo":135,"duty":0.4,"pulses":12},"durationFrames":16},{"beat":1,"template":"strobe-burst","preset":"strobe-accent-8","durationFrames":16},{"beat":2,"template":"strobe-burst","preset":"strobe-colour-16","params":{"tempo":135,"duty":0.4},"durationFrames":16},{"beat":3,"template":"strobe-burst","preset":"strobe-1bit-32","durationFrames":16},{"beat":4,"template":"strobe-burst","preset":"strobe-black-4","durationFrames":16}],"out":"strobe-burst-white-16"}

package/skills/agentvfx/templates/impact/strobe-burst/fx.json

@@ -0,0 +1,42 @@
+{
+  "DESCRIPTION": "Beat-locked full-frame strobe burst at 1/4 to 1/32 note divisions: white, colour, invert, 1-bit or black pulses with an accent pattern, over a dimmed layer below",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["impact", "strobe"],
+  "INPUTS": [
+    { "NAME": "division", "TYPE": "long", "MIN": 4, "MAX": 32, "VALUES": [4, 8, 16, 32], "LABELS": ["1/4", "1/8", "1/16", "1/32"], "DEFAULT": 16 },
+    { "NAME": "tempo", "TYPE": "float", "MIN": 0, "MAX": 300, "DEFAULT": 0 },
+    { "NAME": "pulses", "TYPE": "long", "MIN": 1, "MAX": 32, "DEFAULT": 8 },
+    { "NAME": "duty", "TYPE": "float", "MIN": 0.1, "MAX": 0.9, "DEFAULT": 0.5 },
+    { "NAME": "mode", "TYPE": "long", "MIN": 0, "MAX": 4, "VALUES": [0, 1, 2, 3, 4], "LABELS": ["white", "colour", "invert", "1-bit", "black"], "DEFAULT": 0 },
+    { "NAME": "accentMode", "TYPE": "long", "MIN": 0, "MAX": 4, "VALUES": [0, 1, 2, 3, 4], "LABELS": ["white", "colour", "invert", "1-bit", "black"], "DEFAULT": 2 },
+    { "NAME": "accentLen", "TYPE": "long", "MIN": 1, "MAX": 8, "DEFAULT": 4 },
+    { "NAME": "accentPattern", "TYPE": "long", "MIN": 0, "MAX": 255, "DEFAULT": 0 },
+    { "NAME": "level", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 1 },
+    { "NAME": "offDim", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.35 },
+    { "NAME": "color", "TYPE": "color", "DEFAULT": [0.78, 1, 0, 1] },
+    { "NAME": "useScorePalette", "TYPE": "bool", "DEFAULT": false }
+  ],
+  "X_AGENTVFX": {
+    "id": "strobe-burst",
+    "family": "impact",
+    "input": "either",
+    "spdx": "LicenseRef-agentvfx",
+    "flash": "strobe",
+    "fps": 30,
+    "palette": true,
+    "presets": {
+      "strobe-white-16": { "division": 16, "mode": 0, "pulses": 8, "accentPattern": 0 },
+      "strobe-accent-8": { "division": 8, "mode": 0, "accentMode": 2, "accentLen": 4, "accentPattern": 1, "pulses": 8, "offDim": 0.45 },
+      "strobe-colour-16": { "division": 16, "mode": 1, "accentMode": 0, "accentLen": 2, "accentPattern": 2, "pulses": 10, "useScorePalette": true },
+      "strobe-1bit-32": { "division": 32, "mode": 3, "accentMode": 0, "accentLen": 8, "accentPattern": 17, "pulses": 16, "duty": 0.6, "offDim": 0.2 },
+      "strobe-black-4": { "division": 4, "mode": 4, "accentMode": 0, "accentLen": 4, "accentPattern": 1, "pulses": 4, "duty": 0.5, "offDim": 0 }
+    },
+    "safeSubstitute": { "params": {"mode": 0, "accentPattern": 0, "level": 0.08, "offDim": 0, "pulses": 1 } },
+    "credits": [
+      "Strobe flash definitions and limits, WCAG 2.2 SC 2.3.1, https://www.w3.org/TR/WCAG22/#three-flashes-or-below-threshold",
+      "ITU-R BT.1702-3 flash and pattern guidance, https://www.itu.int/rec/R-REC-BT.1702",
+      "Note-division period = 4 / division beats, standard musical time"
+    ]
+  }
+}

package/skills/agentvfx/templates/impact/strobe-burst/main.frag

@@ -0,0 +1,43 @@
+// strobe-burst: a hit layer. Pulse k of the burst starts at frame k * period, where
+// period = fps * 60 / tempo * 4 / division frames (tempo 0 = the track's AUDIO_BPM, else 120).
+// A pulse is lit for round(period * duty) frames (at least one); unlit frames show the layer below
+// dimmed by offDim. The accent pattern picks pulses that use accentMode instead of mode. After the
+// last pulse the layer below passes through untouched. Stage mode renders every pulse at full level.
+vec3 pulseLook(int m, vec3 src, vec3 tint, float lvl) {
+  vec3 s = clamp(src, 0.0, 1.0);
+  if (m == 1) {
+    return mix(s, tint, lvl);
+  }
+  if (m == 2) {
+    return srgbToLinear(vec3(1.0) - linearToSrgb(s));
+  }
+  if (m == 3) {
+    return vec3(step(0.5, luma(linearToSrgb(s))));
+  }
+  if (m == 4) {
+    return vec3(0.0);
+  }
+  return mix(s, vec3(1.0), lvl);
+}
+
+void main() {
+  vec3 src = texture(inputImage, vUv).rgb;
+  float fps = 1.0 / TIMEDELTA;
+  float n = floor(TIME / TIMEDELTA + 0.5);
+  float bpm = tempo > 0.0 ? tempo : (AUDIO_BPM > 1.0 ? AUDIO_BPM : 120.0);
+  float period = fps * 60.0 / bpm * 4.0 / float(division);
+  float p = floor(n / period + 1e-4);
+  if (p >= float(pulses)) {
+    fragColor = vec4(src, 1.0);
+    return;
+  }
+  float pos = n - p * period;
+  float onFrames = max(1.0, floor(period * duty + 0.5));
+  bool lit = pos < onFrames - 1e-4;
+  int pi = int(p);
+  bool accent = ((accentPattern >> (pi % accentLen)) & 1) == 1;
+  int m = accent ? accentMode : mode;
+  vec3 tint = useScorePalette ? PALETTE[pi % max(PALETTE_COUNT, 1)] : color.rgb;
+  vec3 col = lit ? pulseLook(m, src, tint, level) : src * (1.0 - offDim);
+  fragColor = vec4(col, 1.0);
+}

package/skills/agentvfx/templates/light/anamorphic-streak/demo-anamorphic-cinema.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "template": "anamorphic-streak",
+  "preset": "anamorphic-cinema",
+  "input": { "video": "test-media/clip-02.mp4" },
+  "palette": "acid-data",
+  "durationSec": 4,
+  "seed": 12,
+  "out": "anamorphic-streak-anamorphic-cinema"
+}

package/skills/agentvfx/templates/light/anamorphic-streak/demo-data.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "template": "light-stage",
+  "preset": "emitters",
+  "stack": [{ "template": "anamorphic-streak", "preset": "data-flight" }],
+  "palette": ["#0b0b0c", "#39ff14"],
+  "durationSec": 4,
+  "seed": 12,
+  "out": "anamorphic-streak-data"
+}

package/skills/agentvfx/templates/light/anamorphic-streak/fx.json

@@ -0,0 +1,47 @@
+{
+  "DESCRIPTION": "Horizontal anamorphic highlight streak: threshold, then three Kawase passes in one direction",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["light"],
+  "INPUTS": [
+    { "NAME": "threshold", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.72 },
+    { "NAME": "knee", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.12 },
+    { "NAME": "streakScale", "TYPE": "float", "MIN": 0.2, "MAX": 3, "DEFAULT": 1.5 },
+    { "NAME": "streakFalloff", "TYPE": "float", "MIN": 0.8, "MAX": 0.999, "DEFAULT": 0.9 },
+    { "NAME": "streakAngle", "TYPE": "float", "MIN": -3.1416, "MAX": 3.1416, "DEFAULT": 0 },
+    { "NAME": "streakMix", "TYPE": "float", "MIN": 0, "MAX": 3, "DEFAULT": 1.7 },
+    { "NAME": "streakGain", "TYPE": "float", "MIN": 0.5, "MAX": 8, "DEFAULT": 2.6 },
+    { "NAME": "dashAmt", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0 },
+    { "NAME": "paletteMix", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.35 },
+    { "NAME": "tint", "TYPE": "color", "DEFAULT": [0.35, 0.78, 1, 1] },
+    { "NAME": "toneMap", "TYPE": "long", "MIN": 0, "MAX": 1, "VALUES": [0, 1], "LABELS": ["AgX", "ACES"], "DEFAULT": 1 }
+  ],
+  "PASSES": [
+    { "TARGET": "hi", "FLOAT": true },
+    { "TARGET": "s0", "FLOAT": true },
+    { "TARGET": "s1", "FLOAT": true },
+    { "TARGET": "s2", "FLOAT": true },
+    {}
+  ],
+  "X_AGENTVFX": {
+    "id": "anamorphic-streak",
+    "family": "light",
+    "input": "either",
+    "spdx": "LicenseRef-agentvfx",
+    "flash": "none",
+    "fps": 30,
+    "palette": true,
+    "presets": {
+      "anamorphic-cinema": { "streakAngle": 0, "streakScale": 1.35, "streakFalloff": 0.9, "threshold": 0.72, "knee": 0.1, "streakMix": 1.7, "streakGain": 3.4, "tint": [0.25, 0.82, 1, 1], "paletteMix": 0.2, "toneMap": 1 },
+      "vertical-cross": { "streakAngle": 1.5708, "streakScale": 0.85, "streakFalloff": 0.86, "threshold": 0.74, "knee": 0.1, "streakMix": 1.4, "paletteMix": 0.7, "toneMap": 1 },
+      "blue-slash": { "streakAngle": 0.28, "streakScale": 1.2, "streakFalloff": 0.88, "threshold": 0.7, "knee": 0.1, "streakMix": 1.8, "tint": [0.2, 0.7, 1, 1], "paletteMix": 0.15, "toneMap": 1 },
+      "data-flight": { "dashAmt": 1, "streakAngle": 0, "streakScale": 1.6, "streakFalloff": 0.93, "threshold": 0.78, "knee": 0.08, "streakMix": 1.5, "streakGain": 3.2, "paletteMix": 1, "toneMap": 1 }
+    },
+    "credits": [
+      "Kawase streak: stride 4^(p-1), weight a^(stride*j), about three passes, one direction, at quarter-res spacing",
+      "dual Kawase blur family, Masaki Kawase, GDC 2003; summary https://www.intel.com/content/www/us/en/developer/articles/technical/an-investigation-of-fast-real-time-gpu-based-image-blur-algorithms.html",
+      "ACES fitted tone map, Krzysztof Narkowicz, https://knarkowicz.wordpress.com/2016/01/06/aces-filmic-tone-mapping-curve/",
+      "AgX display fit, Troy Sobotka, https://github.com/sobotka/AgX"
+    ]
+  }
+}

package/skills/agentvfx/templates/light/anamorphic-streak/main.frag

@@ -0,0 +1,45 @@
+// Add the three streak levels in linear light, then the display fit.
+
+vec3 acesFit(vec3 x) {
+  x = max(x, 0.0);
+  return clamp((x * (2.51 * x + 0.03)) / (x * (2.43 * x + 0.59) + 0.14), 0.0, 1.0);
+}
+
+vec3 agxFit(vec3 x) {
+  vec3 y = log2(max(x, 0.0) + 0.001);
+  vec3 u = clamp((y + 7.5) / 11.0, 0.0, 1.0);
+  vec3 s = u * u * (3.0 - 2.0 * u);
+  return clamp(s * 1.2 - 0.05, 0.0, 1.0);
+}
+
+vec3 addLight(vec3 scene, vec3 light) {
+  vec3 base = max(scene, 0.0);
+  vec3 hdr = base + max(light, 0.0);
+  vec3 curved = toneMap == 1 ? acesFit(hdr) : agxFit(hdr);
+  vec3 curvedBase = toneMap == 1 ? acesFit(base) : agxFit(base);
+  return base + max(curved - curvedBase, 0.0);
+}
+
+void main() {
+  vec3 tight = texture(s0, vUv).rgb;
+  vec3 streak = tight + texture(s1, vUv).rgb * 0.38 + texture(s2, vUv).rgb * 0.14;
+  vec3 accent = mix(tint.rgb, paletteRamp(0.92), paletteMix);
+  float hot = smoothstep(0.12, 0.7, luma(tight));
+  vec3 light = mix(accent, vec3(1.0), hot) * streak * streakMix * streakGain;
+  if (dashAmt > 0.5) {
+    for (int i = 0; i < 7; i++) {
+      float fi = float(i);
+      float row = 0.18 + 0.1 * fi;
+      float shift = hash12(vec2(fi + 1.0, 2.7));
+      float x = fract(vUv.x - TIME * (0.22 + 0.08 * fi) + shift);
+      float len = 0.04 + 0.035 * fract(shift * 5.0);
+      float on = 1.0 - step(len, x);
+      float yy = abs(vUv.y - row) * RENDERSIZE.y;
+      float dashCore = exp(-0.5 * yy * yy / 0.7) * on;
+      float dashHalo = exp(-0.5 * yy * yy / 5.0) * on * (1.0 - dashCore);
+      light += vec3(dashCore) * 2.4 + accent * dashHalo * 1.3;
+    }
+  }
+  vec3 scene = HAS_INPUT ? texture(inputImage, vUv).rgb : vec3(0.0);
+  fragColor = vec4(addLight(scene, light), 1.0);
+}

package/skills/agentvfx/templates/light/anamorphic-streak/pass0.frag

@@ -0,0 +1,22 @@
+// Highlight extract plus a 1px box so the first wide stride still catches small lamps.
+
+vec3 softKnee(vec3 c) {
+  float br = luma(max(c, 0.0));
+  float kneeW = max(threshold * knee, 1e-4);
+  float soft = clamp(br - threshold + kneeW, 0.0, 2.0 * kneeW);
+  soft = (soft * soft) / (4.0 * kneeW);
+  float contrib = max(soft, br - threshold);
+  return max(c, 0.0) * max(contrib / max(br, 1e-4), 0.0);
+}
+
+void main() {
+  vec2 px = vec2(1.0) / RENDERSIZE;
+  vec3 acc = vec3(0.0);
+  for (int j = -1; j <= 1; j++) {
+    for (int i = -1; i <= 1; i++) {
+      vec3 src = HAS_INPUT ? texture(inputImage, vUv + px * vec2(float(i), float(j))).rgb : vec3(0.0);
+      acc += softKnee(src);
+    }
+  }
+  fragColor = vec4(acc / 9.0, 1.0);
+}

package/skills/agentvfx/templates/light/anamorphic-streak/pass1.frag

@@ -0,0 +1,16 @@
+// Kawase streak, pass p=0. Quarter-res stride unit is 1; full-res step is 4px at 1080p, scaled by height.
+
+void main() {
+  float unit = 1.0;
+  float stepPx = unit * 4.0 * streakScale * (RENDERSIZE.y / 1080.0);
+  vec2 dir = vec2(cos(streakAngle), sin(streakAngle));
+  vec3 acc = texture(hi, vUv).rgb;
+  float wsum = 1.0;
+  for (int j = 1; j <= 6; j++) {
+    float w = pow(streakFalloff, unit * float(j));
+    vec2 o = dir * (stepPx * float(j)) / RENDERSIZE;
+    acc += w * (texture(hi, vUv + o).rgb + texture(hi, vUv - o).rgb);
+    wsum += 2.0 * w;
+  }
+  fragColor = vec4(acc / wsum, 1.0);
+}

package/skills/agentvfx/templates/light/anamorphic-streak/pass2.frag

@@ -0,0 +1,16 @@
+// Kawase streak, pass p=1. Stride unit 4.
+
+void main() {
+  float unit = 4.0;
+  float stepPx = unit * 4.0 * streakScale * (RENDERSIZE.y / 1080.0);
+  vec2 dir = vec2(cos(streakAngle), sin(streakAngle));
+  vec3 acc = texture(s0, vUv).rgb;
+  float wsum = 1.0;
+  for (int j = 1; j <= 6; j++) {
+    float w = pow(streakFalloff, unit * float(j));
+    vec2 o = dir * (stepPx * float(j)) / RENDERSIZE;
+    acc += w * (texture(s0, vUv + o).rgb + texture(s0, vUv - o).rgb);
+    wsum += 2.0 * w;
+  }
+  fragColor = vec4(acc / wsum, 1.0);
+}

package/skills/agentvfx/templates/light/anamorphic-streak/pass3.frag

@@ -0,0 +1,16 @@
+// Kawase streak, pass p=2. Stride unit 16. This is the long cinema tail.
+
+void main() {
+  float unit = 16.0;
+  float stepPx = unit * 4.0 * streakScale * (RENDERSIZE.y / 1080.0);
+  vec2 dir = vec2(cos(streakAngle), sin(streakAngle));
+  vec3 acc = texture(s1, vUv).rgb;
+  float wsum = 1.0;
+  for (int j = 1; j <= 5; j++) {
+    float w = pow(streakFalloff, unit * float(j));
+    vec2 o = dir * (stepPx * float(j)) / RENDERSIZE;
+    acc += w * (texture(s1, vUv + o).rgb + texture(s1, vUv - o).rgb);
+    wsum += 2.0 * w;
+  }
+  fragColor = vec4(acc / wsum, 1.0);
+}

package/skills/agentvfx/templates/light/bloom-glow/demo-clip01-low.json

@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "template": "bloom-glow",
+  "preset": "tight-specular",
+  "params": { "plateExposure": 0.5, "threshold": 0.78, "toneMap": 1 },
+  "input": { "video": "test-media/clip-01.mp4" },
+  "palette": "brutal-acid",
+  "durationSec": 4,
+  "seed": 12,
+  "out": "bloom-glow-clip01-low"
+}

package/skills/agentvfx/templates/light/bloom-glow/demo-neon-night.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "template": "bloom-glow",
+  "preset": "neon-night",
+  "input": { "video": "test-media/clip-02.mp4" },
+  "palette": "brutal-acid",
+  "durationSec": 4,
+  "seed": 12,
+  "out": "bloom-glow-neon-night"
+}

package/skills/agentvfx/templates/light/bloom-glow/demo-phosphor.json

@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "template": "light-stage",
+  "preset": "emitters",
+  "params": { "pointScale": 4 },
+  "stack": [{ "template": "bloom-glow", "preset": "phosphor" }],
+  "palette": ["#0b0b0c", "#39ff14"],
+  "durationSec": 4,
+  "seed": 12,
+  "out": "bloom-glow-phosphor"
+}

package/skills/agentvfx/templates/light/bloom-glow/fx.json

@@ -0,0 +1,53 @@
+{
+  "DESCRIPTION": "Stage bloom: soft-knee highlights, 13-tap Karis downsample, tent upsample, deep-glow tail, AgX or ACES",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["light"],
+  "INPUTS": [
+    { "NAME": "threshold", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.7 },
+    { "NAME": "knee", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.16 },
+    { "NAME": "plateExposure", "TYPE": "float", "MIN": 0.25, "MAX": 1.5, "DEFAULT": 1 },
+    { "NAME": "bloomRadius", "TYPE": "float", "MIN": 0.02, "MAX": 0.5, "DEFAULT": 0.2 },
+    { "NAME": "bloomMix", "TYPE": "float", "MIN": 0.03, "MAX": 0.15, "DEFAULT": 0.14 },
+    { "NAME": "bloomGain", "TYPE": "float", "MIN": 0.5, "MAX": 16, "DEFAULT": 7 },
+    { "NAME": "levelGain", "TYPE": "float", "MIN": 0.4, "MAX": 1.6, "DEFAULT": 0.9 },
+    { "NAME": "coreTrim", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.45 },
+    { "NAME": "paletteMix", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.8 },
+    { "NAME": "tint", "TYPE": "color", "DEFAULT": [1, 1, 1, 1] },
+    { "NAME": "toneMap", "TYPE": "long", "MIN": 0, "MAX": 1, "VALUES": [0, 1], "LABELS": ["AgX", "ACES"], "DEFAULT": 1 },
+    { "NAME": "probeDot", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0 },
+    { "NAME": "spread", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0 }
+  ],
+  "PASSES": [
+    { "TARGET": "hi", "FLOAT": true },
+    { "TARGET": "b0", "FLOAT": true },
+    { "TARGET": "b1", "FLOAT": true },
+    { "TARGET": "b2", "FLOAT": true },
+    { "TARGET": "b3", "FLOAT": true },
+    { "TARGET": "b4", "FLOAT": true },
+    {}
+  ],
+  "X_AGENTVFX": {
+    "id": "bloom-glow",
+    "family": "light",
+    "input": "either",
+    "spdx": "LicenseRef-agentvfx",
+    "flash": "none",
+    "fps": 30,
+    "palette": true,
+    "presets": {
+      "deep-glow": { "levelGain": 0.78, "bloomRadius": 0.18, "coreTrim": 0.7, "bloomMix": 0.14, "bloomGain": 8, "threshold": 0.7, "knee": 0.14, "toneMap": 1, "paletteMix": 0.9 },
+      "halation": { "tint": [1, 0.16, 0.02, 1], "paletteMix": 0.25, "threshold": 0.72, "bloomRadius": 0.08, "coreTrim": 0.85, "levelGain": 0.55, "bloomMix": 0.1, "bloomGain": 6, "knee": 0.12, "toneMap": 1 },
+      "neon-night": { "threshold": 0.6, "knee": 0.2, "bloomRadius": 0.2, "bloomMix": 0.15, "bloomGain": 12, "levelGain": 0.9, "paletteMix": 1, "coreTrim": 0.75, "toneMap": 1 },
+      "tight-specular": { "threshold": 0.82, "knee": 0.1, "bloomRadius": 0.06, "coreTrim": 0.92, "levelGain": 0.5, "bloomMix": 0.1, "bloomGain": 7, "paletteMix": 0.55, "toneMap": 1 },
+      "phosphor": { "threshold": 0.55, "knee": 0.2, "bloomRadius": 0.28, "bloomMix": 0.15, "bloomGain": 16, "levelGain": 1.45, "coreTrim": 0.9, "paletteMix": 1, "toneMap": 1, "spread": 1 }
+    },
+    "credits": [
+      "13-tap downsample and Karis average, Jorge Jimenez, Call of Duty: Advanced Warfare; LearnOpenGL Physically Based Bloom, https://learnopengl.com/Guest-Articles/2022/Phys.-Based-Bloom",
+      "3x3 tent upsample, same bloom chain",
+      "soft-knee prefilter as used in UE4 bloom",
+      "ACES fitted tone map, Krzysztof Narkowicz, https://knarkowicz.wordpress.com/2016/01/06/aces-filmic-tone-mapping-curve/",
+      "AgX display fit, Troy Sobotka, https://github.com/sobotka/AgX"
+    ]
+  }
+}

package/skills/agentvfx/templates/light/bloom-glow/main.frag

@@ -0,0 +1,85 @@
+// 3x3 tent per level, summed with per-level gains, then AgX or ACES.
+// Output is display-linear; the engine encodes sRGB.
+
+vec2 bloomTexel(float level) {
+  float last = max(bloomRadius * RENDERSIZE.y / 3.0, 4.0);
+  float s = level <= 0.0 ? 1.0 : max(pow(last, level / 4.0), 1.0);
+  if (spread > 0.5) {
+    float unit = max(bloomRadius * RENDERSIZE.y / 48.0, 1.0);
+    s = level <= 0.0 ? 1.0 : unit * pow(2.0, level - 1.0);
+  }
+  return vec2(s) / RENDERSIZE;
+}
+
+vec3 tent(sampler2D tex, vec2 texel) {
+  vec2 uv = vUv;
+  vec3 c = texture(tex, uv).rgb * 4.0;
+  c += texture(tex, uv + texel * vec2(-1.0,  0.0)).rgb * 2.0;
+  c += texture(tex, uv + texel * vec2( 1.0,  0.0)).rgb * 2.0;
+  c += texture(tex, uv + texel * vec2( 0.0, -1.0)).rgb * 2.0;
+  c += texture(tex, uv + texel * vec2( 0.0,  1.0)).rgb * 2.0;
+  c += texture(tex, uv + texel * vec2(-1.0, -1.0)).rgb;
+  c += texture(tex, uv + texel * vec2( 1.0, -1.0)).rgb;
+  c += texture(tex, uv + texel * vec2(-1.0,  1.0)).rgb;
+  c += texture(tex, uv + texel * vec2( 1.0,  1.0)).rgb;
+  return max(c / 16.0, 0.0);
+}
+
+vec3 acesFit(vec3 x) {
+  x = max(x, 0.0);
+  return clamp((x * (2.51 * x + 0.03)) / (x * (2.43 * x + 0.59) + 0.14), 0.0, 1.0);
+}
+
+vec3 agxFit(vec3 x) {
+  vec3 y = log2(max(x, 0.0) + 0.001);
+  vec3 u = clamp((y + 7.5) / 11.0, 0.0, 1.0);
+  vec3 s = u * u * (3.0 - 2.0 * u);
+  return clamp(s * 1.2 - 0.05, 0.0, 1.0);
+}
+
+// Shoulder on the sum, then the base plate is put back. No added light means the source pixel.
+vec3 addLight(vec3 scene, vec3 light) {
+  vec3 base = max(scene, 0.0);
+  vec3 hdr = base + max(light, 0.0);
+  vec3 curved = toneMap == 1 ? acesFit(hdr) : agxFit(hdr);
+  vec3 curvedBase = toneMap == 1 ? acesFit(base) : agxFit(base);
+  return base + max(curved - curvedBase, 0.0);
+}
+
+void main() {
+  vec3 bloom = vec3(0.0);
+  if (probeDot > 0.5) {
+    // Normalised separable gaussian of one pixel. Scale by sigma^2 so the halo
+    // peak stays visible as the radius grows with the frame.
+    float sigma = max(bloomRadius, 0.08) * RENDERSIZE.y * 0.5;
+    bloom = max(texture(b4, vUv).rgb, 0.0) * (0.014 * 6.28318 * sigma * sigma);
+  }
+
+  vec3 scene = HAS_INPUT ? texture(inputImage, vUv).rgb : vec3(0.0);
+  scene *= plateExposure;
+  if (probeDot > 0.5) {
+    vec2 mid = floor(RENDERSIZE * 0.5) + vec2(0.5);
+    if (all(lessThan(abs(gl_FragCoord.xy - mid), vec2(0.5)))) scene = vec3(1.0);
+  }
+  // Wide levels carry the palette. The tight level stays white so the core clips hot.
+  vec3 accent = mix(tint.rgb, paletteRamp(0.92), paletteMix);
+  vec3 light;
+  if (probeDot > 0.5) {
+    light = bloom;
+  } else {
+    float g0 = max(coreTrim, 0.0);
+    vec3 core = tent(b0, bloomTexel(0.0)) * g0;
+    float g = g0 * levelGain;
+    vec3 halo = tent(b1, bloomTexel(1.0)) * g;
+    g *= levelGain;
+    halo += tent(b2, bloomTexel(2.0)) * g;
+    g *= levelGain;
+    halo += tent(b3, bloomTexel(3.0)) * g;
+    g *= levelGain;
+    halo += tent(b4, bloomTexel(4.0)) * g;
+    float hot = smoothstep(0.55, 0.88, luma(scene));
+    light = vec3(luma(core)) + accent * max(halo - core, 0.0) * (1.0 - hot);
+    light *= bloomMix * bloomGain;
+  }
+  fragColor = vec4(addLight(scene, light), 1.0);
+}

package/skills/agentvfx/templates/light/bloom-glow/pass0.frag

@@ -0,0 +1,21 @@
+// Soft-knee highlight extract. Light stays linear; the display fit is the last pass.
+// probeDot plants one white pixel at the frame centre for the falloff test.
+
+vec3 softKnee(vec3 c) {
+  float br = luma(max(c, 0.0));
+  float kneeW = max(threshold * knee, 1e-4);
+  float soft = clamp(br - threshold + kneeW, 0.0, 2.0 * kneeW);
+  soft = (soft * soft) / (4.0 * kneeW);
+  float contrib = max(soft, br - threshold);
+  return max(c, 0.0) * max(contrib / max(br, 1e-4), 0.0);
+}
+
+void main() {
+  vec3 src = HAS_INPUT ? texture(inputImage, vUv).rgb : vec3(0.0);
+  src *= plateExposure;
+  if (probeDot > 0.5) {
+    vec2 mid = floor(RENDERSIZE * 0.5) + vec2(0.5);
+    if (all(lessThan(abs(gl_FragCoord.xy - mid), vec2(0.5)))) src = vec3(1.0);
+  }
+  fragColor = vec4(softKnee(src), 1.0);
+}