agentvfx 0.0.0-stage → 0.3.5

package/skills/agentvfx/templates/impact/impact-1bit/main.frag

@@ -0,0 +1,64 @@
+// impact-1bit: a hit layer. For hitFrames after its start the layer below becomes two flat colours
+// (ink and paper, default black and white) by a luminance threshold against a local mean, with an
+// optional ordered dither, then dissolves back by hashed chunky blocks (no grey mix frames).
+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);
+}
+
+float bayer8(vec2 p) {
+  ivec2 q = ivec2(mod(p, 8.0));
+  int v = 0;
+  for (int k = 0; k < 3; k++) {
+    int xb = (q.x >> k) & 1;
+    int yb = (q.y >> k) & 1;
+    v = v * 4 + 2 * (xb ^ yb) + yb;
+  }
+  return (float(v) + 0.5) / 64.0;
+}
+
+float sLuma(vec2 uv) {
+  return luma(linearToSrgb(clamp(texture(inputImage, uv).rgb, 0.0, 1.0)));
+}
+
+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 L = (sLuma(vUv) - 0.5) * preContrast + 0.5;
+  vec2 px = vec2(adaptRadius * RENDERSIZE.y / 1080.0) / RENDERSIZE;
+  float m = 0.0;
+  for (int i = 0; i < 8; i++) {
+    float a = 0.785398 * float(i);
+    m += sLuma(vUv + vec2(cos(a), sin(a)) * px);
+  }
+  m = (m / 8.0 - 0.5) * preContrast + 0.5;
+  float t = mix(threshold, clamp(m + (threshold - 0.5) * 0.5, 0.05, 0.95), adapt);
+  float d = 0.0;
+  vec2 pp = floor(vUv * RENDERSIZE / max(ditherPx * RENDERSIZE.y / 1080.0, 1.0));
+  if (dither == 1) {
+    d = (bayer8(pp) - 0.5) * ditherAmount;
+  } else if (dither == 2) {
+    d = (hash12(pp + n * 3.1) - 0.5) * ditherAmount;
+  }
+  bool bright = (L + d) > t;
+  if (flip) {
+    bright = !bright;
+  }
+  vec3 ink = inkColor.rgb;
+  vec3 paper = paperColor.rgb;
+  if (useScorePalette) {
+    ink = PALETTE[0];
+    paper = PALETTE[PALETTE_COUNT - 1];
+  }
+  vec3 o = bright ? paper : ink;
+  vec2 cell = floor(vUv * RENDERSIZE / max(blockPx * RENDERSIZE.y / 1080.0, 1.0));
+  bool hit = hash12(cell + vec2(n * 17.31, 3.7)) < env;
+  fragColor = vec4(hit ? o : src, 1.0);
+}

package/skills/agentvfx/templates/impact/impact-invert/demo-invert-snap.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-classic","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":"impact-invert","preset":"invert-snap","durationFrames":2},{"beat":1,"template":"impact-invert","preset":"invert-bars","durationFrames":5},{"beat":2,"template":"impact-invert","preset":"invert-acid","durationFrames":4},{"beat":3,"template":"impact-invert","preset":"invert-hue-keep","durationFrames":4},{"beat":4,"template":"impact-invert","preset":"invert-false-neg","durationFrames":3}],"out":"impact-invert-snap"}

package/skills/agentvfx/templates/impact/impact-invert/fx.json

@@ -0,0 +1,37 @@
+{
+  "DESCRIPTION": "Impact frame: the layer below snaps to a hard negative for 1-3 frames, then dissolves back in chunky blocks (never a milky fade)",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["impact"],
+  "INPUTS": [
+    { "NAME": "hitFrames", "TYPE": "long", "MIN": 1, "MAX": 12, "DEFAULT": 3 },
+    { "NAME": "holdFrames", "TYPE": "long", "MIN": 0, "MAX": 6, "DEFAULT": 2 },
+    { "NAME": "decayCurve", "TYPE": "float", "MIN": 0.3, "MAX": 4, "DEFAULT": 1 },
+    { "NAME": "mode", "TYPE": "long", "MIN": 0, "MAX": 3, "VALUES": [0, 1, 2, 3], "LABELS": ["negative", "value flip (hue kept)", "false negative", "palette negative"], "DEFAULT": 0 },
+    { "NAME": "contrast", "TYPE": "float", "MIN": 0.5, "MAX": 3, "DEFAULT": 1.45 },
+    { "NAME": "bands", "TYPE": "long", "MIN": 0, "MAX": 32, "DEFAULT": 0 },
+    { "NAME": "bandCoverage", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.65 },
+    { "NAME": "blockPx", "TYPE": "float", "MIN": 2, "MAX": 160, "DEFAULT": 40 }
+  ],
+  "X_AGENTVFX": {
+    "id": "impact-invert",
+    "family": "impact",
+    "input": "either",
+    "spdx": "Apache-2.0",
+    "flash": "possible",
+    "fps": 30,
+    "palette": true,
+    "presets": {
+      "invert-snap": { "hitFrames": 2, "holdFrames": 2, "mode": 0, "contrast": 1.45 },
+      "invert-bars": { "hitFrames": 5, "holdFrames": 2, "mode": 0, "bands": 11, "bandCoverage": 0.7, "contrast": 1.6 },
+      "invert-hue-keep": { "hitFrames": 4, "holdFrames": 2, "mode": 1, "contrast": 1.7 },
+      "invert-acid": { "hitFrames": 4, "holdFrames": 2, "mode": 3, "contrast": 1.3, "blockPx": 24 },
+      "invert-false-neg": { "hitFrames": 3, "holdFrames": 2, "mode": 2, "contrast": 1.5 }
+    },
+    "safeSubstitute": { "template": "punch-shake" },
+    "credits": [
+      "Impact-frame grammar (1-2 frame inversion on contact), sakugabooru wiki, https://www.sakugabooru.com/wiki/show?title=impact_frame",
+      "Dissolve by hashed block threshold instead of alpha blend, to avoid the stacked-exposure milky failure"
+    ]
+  }
+}

package/skills/agentvfx/templates/impact/impact-invert/main.frag

@@ -0,0 +1,44 @@
+// impact-invert: a hit layer. For hitFrames after its start it replaces the layer below with a hard
+// negative (in display/sRGB space), full strength for holdFrames, then it dissolves back by hashed
+// chunky blocks: each block is either fully negative or fully the original, so no frame is a grey mix.
+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);
+}
+
+vec3 negativeOf(vec3 s, int m) {
+  if (m == 1) {
+    vec3 h = rgb2hsv(s);
+    h.z = 1.0 - h.z;
+    return hsv2rgb(h);
+  }
+  if (m == 2) {
+    return (vec3(1.0) - s).gbr;
+  }
+  if (m == 3) {
+    return linearToSrgb(paletteRamp(1.0 - luma(srgbToLinear(s))));
+  }
+  return vec3(1.0) - s;
+}
+
+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;
+  }
+  vec3 s = linearToSrgb(clamp(src, 0.0, 1.0));
+  vec3 o = negativeOf(s, mode);
+  o = clamp((o - 0.5) * contrast + 0.5, 0.0, 1.0);
+  vec2 cell = floor(vUv * RENDERSIZE / max(blockPx * RENDERSIZE.y / 1080.0, 1.0));
+  bool hit = hash12(cell + vec2(n * 17.31, 3.7)) < env;
+  if (bands > 0) {
+    float b = floor(vUv.y * float(bands));
+    hit = hit && hash12(vec2(b, floor(n * 0.5) + 7.0)) < bandCoverage;
+  }
+  fragColor = vec4(srgbToLinear(hit ? o : s), 1.0);
+}

package/skills/agentvfx/templates/impact/punch-shake/demo-punch-hard.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-thermal","input":{"video":"test-media/clip-01.mp4","audio":"test-media/beat-132.mp3"},"durationSec":4,"seed":11,"hits":[{"beat":0,"template":"punch-shake","preset":"punch-hard","durationFrames":6},{"beat":1,"template":"punch-shake","preset":"punch-heavy","durationFrames":9},{"beat":2,"template":"punch-shake","preset":"punch-micro","durationFrames":4},{"beat":3,"template":"punch-shake","preset":"punch-roll","durationFrames":8},{"beat":4,"template":"punch-shake","preset":"punch-hard","durationFrames":6}],"out":"punch-shake-hard"}

package/skills/agentvfx/templates/impact/punch-shake/fx.json

@@ -0,0 +1,36 @@
+{
+  "DESCRIPTION": "Camera punch: the layer below snaps in 5-15% and shakes with a decaying random kick, with shutter smear along the motion and a little chroma split",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["impact"],
+  "INPUTS": [
+    { "NAME": "hitFrames", "TYPE": "long", "MIN": 1, "MAX": 12, "DEFAULT": 6 },
+    { "NAME": "holdFrames", "TYPE": "long", "MIN": 0, "MAX": 6, "DEFAULT": 1 },
+    { "NAME": "decayCurve", "TYPE": "float", "MIN": 0.3, "MAX": 4, "DEFAULT": 1.8 },
+    { "NAME": "punch", "TYPE": "float", "MIN": 0, "MAX": 0.4, "DEFAULT": 0.12 },
+    { "NAME": "shake", "TYPE": "float", "MIN": 0, "MAX": 0.15, "DEFAULT": 0.035 },
+    { "NAME": "roll", "TYPE": "float", "MIN": 0, "MAX": 0.3, "DEFAULT": 0.025 },
+    { "NAME": "shutter", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.8 },
+    { "NAME": "split", "TYPE": "float", "MIN": 0, "MAX": 0.05, "DEFAULT": 0.012 },
+    { "NAME": "edge", "TYPE": "long", "MIN": 0, "MAX": 2, "VALUES": [0, 1, 2], "LABELS": ["mirror", "clamp", "black"], "DEFAULT": 0 }
+  ],
+  "X_AGENTVFX": {
+    "id": "punch-shake",
+    "family": "impact",
+    "input": "either",
+    "spdx": "Apache-2.0",
+    "flash": "none",
+    "fps": 30,
+    "presets": {
+      "punch-hard": { "punch": 0.12, "shake": 0.035, "roll": 0.025, "hitFrames": 6 },
+      "punch-heavy": { "punch": 0.22, "shake": 0.07, "roll": 0.06, "hitFrames": 9, "decayCurve": 1.4, "split": 0.02 },
+      "punch-micro": { "punch": 0.06, "shake": 0.015, "roll": 0.008, "hitFrames": 4, "split": 0.006 },
+      "punch-roll": { "punch": 0.1, "shake": 0.02, "roll": 0.16, "hitFrames": 8, "decayCurve": 1.3 },
+      "punch-dutch": { "punch": 0.15, "shake": 0.05, "roll": 0.1, "hitFrames": 7, "edge": 2, "shutter": 1 }
+    },
+    "credits": [
+      "Zoom/shake punch grammar (2-6 frames), impact-frame notes in the L5 research",
+      "Shutter integration over the frame interval (analytic motion blur), https://en.wikipedia.org/wiki/Motion_blur"
+    ]
+  }
+}

package/skills/agentvfx/templates/impact/punch-shake/main.frag

@@ -0,0 +1,62 @@
+// punch-shake: a hit layer. The frame is scaled about its centre by 1 + punch*env, rolled and shifted
+// by a decaying random kick that flips sign every frame. The kick is integrated over the shutter
+// interval (previous frame's pose to this frame's pose) so a fast punch smears along its motion.
+float hitEnv(float n, float total, float hold, float curve) {
+  if (n < 0.0 || 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);
+}
+
+// pose: x = zoom, y = roll, zw = offset (uv units)
+vec4 poseAt(float n, float aspect) {
+  float env = hitEnv(n, float(hitFrames), float(holdFrames), decayCurve);
+  float a = hash12(vec2(n, 11.0)) * 6.28318;
+  float sgn = mod(n, 2.0) < 1.0 ? 1.0 : -0.8;
+  vec2 off = vec2(cos(a) / aspect, sin(a)) * shake * env * sgn;
+  float rl = roll * env * sgn * (hash12(vec2(n, 5.0)) > 0.5 ? 1.0 : -1.0);
+  return vec4(1.0 + punch * env, rl, off);
+}
+
+vec2 edgeUv(vec2 uv) {
+  if (edge == 0) {
+    return 1.0 - abs(1.0 - mod(uv, 2.0));
+  }
+  return clamp(uv, 0.0, 1.0);
+}
+
+vec3 tap(vec4 pose, float aspect, float zk) {
+  vec2 c = vUv - 0.5;
+  c.x *= aspect;
+  c = rot(pose.y) * c;
+  c /= pose.x * zk;
+  c.x /= aspect;
+  vec2 uv = c + 0.5 + pose.zw;
+  vec3 col = texture(inputImage, edgeUv(uv)).rgb;
+  if (edge == 2 && (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0)) {
+    col = vec3(0.0);
+  }
+  return col;
+}
+
+void main() {
+  float aspect = RENDERSIZE.x / max(RENDERSIZE.y, 1.0);
+  float n = floor(TIME / TIMEDELTA + 0.5);
+  float env = hitEnv(n, float(hitFrames), float(holdFrames), decayCurve);
+  if (env <= 0.0) {
+    fragColor = vec4(texture(inputImage, vUv).rgb, 1.0);
+    return;
+  }
+  vec4 now = poseAt(n, aspect);
+  vec4 prev = poseAt(n - 1.0, aspect);
+  vec3 acc = vec3(0.0);
+  const int TAPS = 14;
+  for (int k = 0; k < TAPS; k++) {
+    float u = float(k) / float(TAPS - 1) * shutter;
+    vec4 pose = mix(now, prev, u);
+    float zr = 1.0 + split * env;
+    float zb = 1.0 - split * env;
+    acc += vec3(tap(pose, aspect, zr).r, tap(pose, aspect, 1.0).g, tap(pose, aspect, zb).b);
+  }
+  fragColor = vec4(acc / float(TAPS), 1.0);
+}

package/skills/agentvfx/templates/impact/rgb-hit/demo-rgb-slam.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-classic","params":{"blend":0},"input":{"video":"test-media/clip-01.mp4","audio":"test-media/beat-132.mp3"},"durationSec":4,"seed":11,"hits":[{"beat":0,"template":"rgb-hit","preset":"rgb-slam","durationFrames":6},{"beat":1,"template":"rgb-hit","preset":"rgb-radial","durationFrames":7},{"beat":2,"template":"rgb-hit","preset":"rgb-tear","durationFrames":5},{"beat":3,"template":"rgb-hit","preset":"rgb-spin","durationFrames":8},{"beat":4,"template":"rgb-hit","preset":"rgb-diagonal-hard","durationFrames":4}],"out":"rgb-hit-slam"}

package/skills/agentvfx/templates/impact/rgb-hit/fx.json

@@ -0,0 +1,39 @@
+{
+  "DESCRIPTION": "RGB hit: red and blue channels slam apart (linear, radial or spinning) with row tears, then snap back with a decay",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["impact"],
+  "INPUTS": [
+    { "NAME": "hitFrames", "TYPE": "long", "MIN": 1, "MAX": 12, "DEFAULT": 6 },
+    { "NAME": "holdFrames", "TYPE": "long", "MIN": 0, "MAX": 6, "DEFAULT": 1 },
+    { "NAME": "decayCurve", "TYPE": "float", "MIN": 0.3, "MAX": 4, "DEFAULT": 1.5 },
+    { "NAME": "amount", "TYPE": "float", "MIN": 0, "MAX": 0.2, "DEFAULT": 0.045 },
+    { "NAME": "angle", "TYPE": "float", "MIN": -3.1416, "MAX": 3.1416, "DEFAULT": 0 },
+    { "NAME": "style", "TYPE": "long", "MIN": 0, "MAX": 2, "VALUES": [0, 1, 2], "LABELS": ["linear", "radial", "spin"], "DEFAULT": 0 },
+    { "NAME": "center", "TYPE": "point2D", "DEFAULT": [0.5, 0.5] },
+    { "NAME": "tearRows", "TYPE": "long", "MIN": 0, "MAX": 64, "DEFAULT": 14 },
+    { "NAME": "tearAmount", "TYPE": "float", "MIN": 0, "MAX": 0.3, "DEFAULT": 0.05 },
+    { "NAME": "jitter", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.5 },
+    { "NAME": "pop", "TYPE": "float", "MIN": 1, "MAX": 2.5, "DEFAULT": 1.5 },
+    { "NAME": "taps", "TYPE": "long", "MIN": 1, "MAX": 16, "DEFAULT": 8 }
+  ],
+  "X_AGENTVFX": {
+    "id": "rgb-hit",
+    "family": "impact",
+    "input": "either",
+    "spdx": "Apache-2.0",
+    "flash": "none",
+    "fps": 30,
+    "presets": {
+      "rgb-slam": { "amount": 0.045, "style": 0, "tearRows": 14, "hitFrames": 6 },
+      "rgb-radial": { "amount": 0.07, "style": 1, "tearRows": 0, "hitFrames": 7, "pop": 1.7 },
+      "rgb-spin": { "amount": 0.09, "style": 2, "tearRows": 0, "hitFrames": 8, "decayCurve": 1.2 },
+      "rgb-tear": { "amount": 0.03, "style": 0, "tearRows": 32, "tearAmount": 0.14, "angle": 0.5, "hitFrames": 5, "jitter": 1 },
+      "rgb-diagonal-hard": { "amount": 0.11, "style": 0, "angle": 0.7854, "tearRows": 6, "tearAmount": 0.08, "hitFrames": 4, "holdFrames": 2 }
+    },
+    "credits": [
+      "Chromatic aberration as per-channel sampling offsets, https://en.wikipedia.org/wiki/Chromatic_aberration",
+      "Decay grammar (2-6 frame RGB split) from the L5 impact research"
+    ]
+  }
+}

package/skills/agentvfx/templates/impact/rgb-hit/main.frag

@@ -0,0 +1,62 @@
+// rgb-hit: a hit layer. Red is sampled at +offset, blue at -offset, green stays; each channel is
+// integrated along its offset (taps) so the split smears into a prism instead of three ghosts.
+// Rows can tear sideways, and chroma pops while the hit is live. Offsets decay to zero by hitFrames.
+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);
+}
+
+// Split direction in aspect-corrected (isotropic) space; the caller scales x back to uv.
+vec2 splitDir(float aspect) {
+  if (style == 1 || style == 2) {
+    vec2 d = vUv - center;
+    d.x *= aspect;
+    float l = length(d);
+    vec2 u = l > 1e-5 ? d / l : vec2(1.0, 0.0);
+    if (style == 2) {
+      u = vec2(-u.y, u.x);
+    }
+    return u * (0.35 + l * 1.4);
+  }
+  return vec2(cos(angle), sin(angle));
+}
+
+float chan(int c, vec2 uv, vec2 o) {
+  float acc = 0.0;
+  for (int k = 0; k < 16; k++) {
+    if (k < taps) {
+      float u = taps > 1 ? float(k) / float(taps - 1) : 1.0;
+      vec2 q = clamp(uv + o * u, 0.0, 1.0);
+      vec3 s = texture(inputImage, q).rgb;
+      acc += c == 0 ? s.r : (c == 1 ? s.g : s.b);
+    }
+  }
+  return acc / float(taps);
+}
+
+void main() {
+  float aspect = RENDERSIZE.x / max(RENDERSIZE.y, 1.0);
+  float n = floor(TIME / TIMEDELTA + 0.5);
+  float env = hitEnv(n, float(hitFrames), float(holdFrames), decayCurve);
+  if (env <= 0.0) {
+    fragColor = vec4(texture(inputImage, vUv).rgb, 1.0);
+    return;
+  }
+  float jit = 1.0 + jitter * (hash12(vec2(n, 29.0)) - 0.5) * 1.2;
+  vec2 o = splitDir(aspect) * amount * env * jit * vec2(1.0 / aspect, 1.0);
+  vec2 uv = vUv;
+  if (tearRows > 0) {
+    float row = floor(vUv.y * float(tearRows));
+    float r = hash12(vec2(row, n * 1.37 + 5.0));
+    if (r > 0.55) {
+      float sgn = hash12(vec2(row, n + 71.0)) > 0.5 ? 1.0 : -1.0;
+      uv.x += sgn * (r - 0.55) / 0.45 * tearAmount * env;
+    }
+  }
+  vec3 col = vec3(chan(0, uv, o), chan(1, uv, vec2(0.0)), chan(2, uv, -o));
+  float l = luma(col);
+  col = vec3(l) + (col - vec3(l)) * mix(1.0, pop, env);
+  fragColor = vec4(max(col, 0.0), 1.0);
+}

package/skills/agentvfx/templates/impact/signal-cut/demo-lime-hold.json

@@ -0,0 +1 @@
+{"version":1,"template":"signal-cut","preset":"lime-hold","input":{"video":"test-media/clip-01.mp4","audio":"test-media/beat-132.mp3"},"durationSec":4,"seed":11,"labels":{"stamp":"90"},"out":"concept-signal-cut-lime-hold"}

package/skills/agentvfx/templates/impact/signal-cut/demo-lime.json

@@ -0,0 +1 @@
+{"version":1,"template":"signal-cut","preset":"lime","input":{"video":"test-media/clip-01.mp4","audio":"test-media/beat-132.mp3"},"durationSec":4,"seed":11,"labels":{"stamp":"90"},"out":"concept-signal-cut-lime"}

package/skills/agentvfx/templates/impact/signal-cut/demo-orange.json

@@ -0,0 +1 @@
+{"version":1,"template":"signal-cut","preset":"orange","input":{"video":"test-media/clip-01.mp4","audio":"test-media/beat-132.mp3"},"durationSec":4,"seed":5,"labels":{"stamp":"90"},"out":"concept-signal-cut-orange"}

package/skills/agentvfx/templates/impact/signal-cut/demo-ultramarine.json

@@ -0,0 +1 @@
+{"version":1,"template":"signal-cut","preset":"ultramarine","input":{"video":"test-media/clip-01.mp4","audio":"test-media/beat-132.mp3"},"durationSec":4,"seed":23,"labels":{"stamp":"90"},"out":"concept-signal-cut-ultramarine"}

package/skills/agentvfx/templates/impact/signal-cut/fx.json

@@ -0,0 +1,83 @@
+{
+  "DESCRIPTION": "Signal-cut: the frame is the instrument. Spectrum bands are full-height vertical slabs whose widths follow their energy and that slide, invert or turn field-colour inside the footage; on every beat the frame hard-cuts to one solid acid, ultramarine or orange field with the loud slabs as holes, and a giant cropped numeral stamps in",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["impact", "audio", "brutal"],
+  "INPUTS": [
+    { "NAME": "fieldColor", "TYPE": "color", "DEFAULT": [0.784, 1, 0, 1] },
+    { "NAME": "inkColor", "TYPE": "color", "DEFAULT": [0.043, 0.043, 0.047, 1] },
+    { "NAME": "paperColor", "TYPE": "color", "DEFAULT": [0.914, 0.914, 0.894, 1] },
+    { "NAME": "slabs", "TYPE": "long", "MIN": 4, "MAX": 32, "DEFAULT": 16 },
+    { "NAME": "startFreq", "TYPE": "float", "MIN": 30, "MAX": 400, "DEFAULT": 55 },
+    { "NAME": "endFreq", "TYPE": "float", "MIN": 2000, "MAX": 16000, "DEFAULT": 9000 },
+    { "NAME": "release", "TYPE": "float", "MIN": 0.01, "MAX": 1, "DEFAULT": 0.06 },
+    { "NAME": "floorLevel", "TYPE": "float", "MIN": 0, "MAX": 0.6, "DEFAULT": 0.2 },
+    { "NAME": "ceilLevel", "TYPE": "float", "MIN": 0.2, "MAX": 1, "DEFAULT": 0.7 },
+    { "NAME": "levelGain", "TYPE": "float", "MIN": 0, "MAX": 1.5, "DEFAULT": 0.4 },
+    { "NAME": "riseGain", "TYPE": "float", "MIN": 0, "MAX": 12, "DEFAULT": 6 },
+    { "NAME": "minWidth", "TYPE": "float", "MIN": 0.05, "MAX": 3, "DEFAULT": 0.5 },
+    { "NAME": "widthGain", "TYPE": "float", "MIN": 0, "MAX": 12, "DEFAULT": 3.5 },
+    { "NAME": "shiftY", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.45 },
+    { "NAME": "shiftX", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.18 },
+    { "NAME": "slabContrast", "TYPE": "float", "MIN": 0.5, "MAX": 3, "DEFAULT": 1.35 },
+    { "NAME": "idleDim", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.5 },
+    { "NAME": "actAt", "TYPE": "float", "MIN": 0.01, "MAX": 1, "DEFAULT": 0.05 },
+    { "NAME": "invAt", "TYPE": "float", "MIN": 0.05, "MAX": 1.5, "DEFAULT": 0.5 },
+    { "NAME": "duoAt", "TYPE": "float", "MIN": 0.05, "MAX": 1.5, "DEFAULT": 0.85 },
+    { "NAME": "slitPx", "TYPE": "float", "MIN": 0, "MAX": 16, "DEFAULT": 3 },
+    { "NAME": "fieldCut", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 1 },
+    { "NAME": "cutFrames", "TYPE": "long", "MIN": 1, "MAX": 4, "DEFAULT": 2 },
+    { "NAME": "cutKeep", "TYPE": "float", "MIN": 0, "MAX": 0.95, "DEFAULT": 0.35 },
+    { "NAME": "stampFrames", "TYPE": "long", "MIN": 0, "MAX": 30, "DEFAULT": 6 },
+    { "NAME": "stampZoom", "TYPE": "float", "MIN": 1, "MAX": 3, "DEFAULT": 1.35 },
+    { "NAME": "stampPivotX", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.1 },
+    { "NAME": "stampPivotY", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.1 }
+  ],
+  "PASSES": [
+    { "TARGET": "sigState", "PERSISTENT": true, "FLOAT": true },
+    {}
+  ],
+  "X_AGENTVFX": {
+    "id": "signal-cut",
+    "family": "impact",
+    "input": "footage",
+    "spdx": "Apache-2.0",
+    "flash": "strobe",
+    "fps": 30,
+    "palette": false,
+    "presets": {
+      "lime": {},
+      "lime-hold": { "release": 0.12 },
+      "ultramarine": {
+        "fieldColor": [0.078, 0.078, 1, 1],
+        "slabs": 24,
+        "widthGain": 5,
+        "slitPx": 2,
+        "stampPivotX": 0.9
+      },
+      "orange": {
+        "fieldColor": [1, 0.55, 0, 1],
+        "slabs": 10,
+        "minWidth": 0.3,
+        "widthGain": 3,
+        "slitPx": 6,
+        "cutFrames": 1,
+        "stampFrames": 10,
+        "stampZoom": 1.7
+      }
+    },
+    "audioBind": {
+      "widthGain": "bands",
+      "fieldCut": "beat"
+    },
+    "safeSubstitute": {
+      "params": { "fieldCut": 0, "invAt": 1.5, "duoAt": 1.5, "stampFrames": 0, "idleDim": 1, "shiftY": 0, "shiftX": 0.06 }
+    },
+    "text": [
+      { "key": "stamp", "default": "90", "x": -0.03, "y": 0.3, "size": 0.85, "font": "grotesk", "align": "left" }
+    ],
+    "credits": [
+      "Original composition; band-to-slab mapping, instant-attack follower with exponential release and the beat clock are written fresh for this template"
+    ]
+  }
+}

package/skills/agentvfx/templates/impact/signal-cut/main.frag

@@ -0,0 +1,101 @@
+// signal-cut: the whole frame is the instrument. Frequency bands are full-height vertical slabs whose
+// widths come from their energy; each slab slides, inverts or turns into a field-colour duotone by its own
+// level. On a beat the frame hard-cuts to one solid field colour for cutFrames frames with the loud slabs
+// left as holes (negative space), and a giant engine-text numeral stamps in for stampFrames frames.
+// Original design; no algorithm is borrowed beyond the stock helpers of the prelude.
+const int MAXS = 32;
+const int STATE_BEAT_X = 40;
+
+float edgeAt(int k) { return texelFetch(sigState, ivec2(k, 1), 0).r; }
+
+// The contrast curve below works per channel, so on warm footage it crushes green and blue to zero and invents a
+// saturated red (R / (R + G + B) >= 0.8, colours here are linear) that a scene cut turns into a red flash. Pixels the
+// curve pushes that far keep the footage's own colour at the graded brightness; the rest take the curve unchanged.
+const vec2 RED_SHARE = vec2(0.7, 0.78);
+vec3 gradeFootage(vec3 c) {
+  vec3 graded = max((c - 0.12) * slabContrast + 0.12, 0.0);
+  float share = graded.r / max(graded.r + graded.g + graded.b, 1e-4);
+  vec3 o = mix(graded, c * luma(graded) / max(luma(c), 1e-4), smoothstep(RED_SHARE.x, RED_SHARE.y, share));
+  // Footage that is itself deep red (a lit red dress) still reads as saturated red, and the cut shows it for only a
+  // frame or two between field states, so it flashes red. Lift green and blue just enough to cap the red share.
+  float lift = max(o.r * (1.0 / RED_SHARE.y - 1.0) - o.g - o.b, 0.0) * 0.5;
+  return o + vec3(0.0, lift, lift);
+}
+
+// footage frame (any aspect) cover-fitted into the output frame; vertical wrap, mirrored horizontal wrap
+vec3 footAt(vec2 uv) {
+  uv.y = fract(uv.y);
+  uv.x = 1.0 - abs(1.0 - mod(uv.x, 2.0));
+  vec2 tex = IMG_SIZE(inputImage);
+  float ta = tex.x / tex.y;
+  float fa = RENDERSIZE.x / RENDERSIZE.y;
+  vec2 vis = fa > ta ? vec2(1.0, ta / fa) : vec2(fa / ta, 1.0);
+  return gradeFootage(texture(inputImage, 0.5 + (uv - 0.5) * vis).rgb);
+}
+
+void main() {
+  float U = RENDERSIZE.y / 1080.0;
+  float xf = gl_FragCoord.x / RENDERSIZE.x;
+  vec4 beatSt = texelFetch(sigState, ivec2(STATE_BEAT_X, 0), 0);
+  float since = beatSt.r;
+  float cnt = beatSt.g;
+
+  int idx = slabs - 1;
+  float eL = 0.0;
+  float eR = 1.0;
+  float prevEdge = 0.0;
+  for (int i = 0; i < MAXS; i++) {
+    if (i >= slabs) break;
+    float r = edgeAt(i + 1);
+    if (xf < r) { idx = i; eL = prevEdge; eR = r; break; }
+    prevEdge = r;
+    eL = r;
+  }
+  float e = texelFetch(sigState, ivec2(idx, 0), 0).r;
+
+  // slab content: slides vertically and jumps sideways by its own quantised energy; directions reshuffle per beat
+  float qe = floor(e * 10.0 + 0.5) / 10.0;
+  float dirY = hash12(vec2(float(idx), cnt)) > 0.5 ? 1.0 : -1.0;
+  float jx = hash12(vec2(float(idx) + 11.0, cnt + 3.0)) - 0.5;
+  vec2 uv = vUv;
+  bool live = e >= actAt;
+  if (live) {
+    float amt = pow(qe, 0.6);
+    uv.y += dirY * amt * shiftY;
+    uv.x += jx * amt * shiftX;
+  }
+  vec3 foot = HAS_INPUT ? footAt(uv) : vec3(0.0);
+  float sL = sqrt(clamp(luma(foot), 0.0, 1.0));
+
+  // tiers: dim idle, bright sliding, negative, field-colour duotone
+  vec3 col = foot * (live ? 1.0 : idleDim);
+  if (e >= invAt) col = max(vec3(1.0) - col, 0.0);
+  float onField = 0.0;
+  if (e >= duoAt) { col = mix(inkColor.rgb, fieldColor.rgb, sL); onField = 1.0; }
+
+  // hairline slits between slabs, never at the frame edge
+  float dpx = min(idx > 0 ? (xf - eL) : 1e3, idx < slabs - 1 ? (eR - xf) : 1e3) * RENDERSIZE.x;
+  if (dpx < slitPx * U * 0.5) col = inkColor.rgb;
+
+  // beat cut: solid field colour, loud slabs are the holes; second frame inverts the roles
+  if (fieldCut > 0.001 && since < float(cutFrames) - 0.5) {
+    bool second = since > 0.5;
+    float u = (xf - eL) / max(eR - eL, 1e-4);
+    float open = clamp((e - cutKeep) / max(1.0 - cutKeep, 0.01), 0.0, 1.0);
+    bool hole = abs(u - 0.5) <= 0.5 * open;
+    vec3 holeCol = second ? mix(inkColor.rgb, fieldColor.rgb, sL) : mix(inkColor.rgb, paperColor.rgb, sL);
+    vec3 cutCol = hole ? holeCol : (second ? inkColor.rgb : fieldColor.rgb);
+    col = mix(col, cutCol, fieldCut);
+    onField = (hole ? (second ? 1.0 : 0.0) : (second ? 0.0 : 1.0));
+  }
+
+  // stamp: a giant numeral from the engine text layer, hard cut in on the beat, alternate beats punch in
+  if (HAS_TEXT && since < float(stampFrames) - 0.5) {
+    float zoom = mod(cnt, 2.0) < 0.5 ? 1.0 : stampZoom;
+    vec2 piv = vec2(stampPivotX, stampPivotY);
+    float m = smoothstep(0.35, 0.65, texture(TEXTMASK, piv + (vUv - piv) / zoom).r);
+    vec3 sc = onField > 0.5 ? inkColor.rgb : fieldColor.rgb;
+    col = mix(col, sc, m);
+  }
+  fragColor = vec4(col, 1.0);
+}

package/skills/agentvfx/templates/impact/signal-cut/pass0.frag

@@ -0,0 +1,68 @@
+// signal-cut pass 0: slab energies, slab edges and the beat clock, all persistent in sigState.
+// Texel map (row 0 is the bottom row):
+//   (i, 0) i < 32 : r = slab energy (instant attack, exponential release), g = previous raw spectrum value
+//   (i, 1) i <= 32: r = right-hand edge fraction of slab i-1 (edge 0 = 0.0, edge n = 1.0), widths follow energy
+//   (40, 0)       : r = frames since the last beat (255 = none yet), g = beat counter
+// Energy per slab = max(level, rise): the raw per-frame spectrum (audioFFT, no attack filter) of the slab's
+// log-spaced band. Rise is the frame-to-frame jump, so an onset lands on the frame it happens.
+const int MAXS = 32;
+
+float specAtHz(float hz) {
+  float s = (hz - 29.3) / 46.875;
+  return texture(audioFFT, vec2(clamp((s + 0.5) / 512.0, 0.0, 1.0), 0.5)).r;
+}
+float bandRaw(int i) {
+  float ratio = endFreq / startFreq;
+  float f0 = startFreq * pow(ratio, float(i) / float(slabs));
+  float f1 = startFreq * pow(ratio, float(i + 1) / float(slabs));
+  float v = 0.0;
+  for (int k = 0; k < 3; k++) v = max(v, specAtHz(mix(f0, f1, (float(k) + 0.5) / 3.0)));
+  return v;
+}
+// follower: instant attack, release in seconds
+float follow(int i, out float raw) {
+  raw = bandRaw(i);
+  vec4 prev = texelFetch(sigState, ivec2(i, 0), 0);
+  float lvl = clamp((raw - floorLevel) / max(ceilLevel - floorLevel, 0.01), 0.0, 1.0) * levelGain;
+  float rise = clamp((raw - prev.g) * riseGain, 0.0, 1.0);
+  float target = max(lvl, rise);
+  float held = prev.r * exp(-TIMEDELTA / max(release, 0.001));
+  return max(target, held);
+}
+float weight(int i) {
+  float raw;
+  return minWidth + widthGain * follow(i, raw);
+}
+
+void main() {
+  ivec2 px = ivec2(gl_FragCoord.xy);
+  vec4 prev = texelFetch(sigState, px, 0);
+  if (px.y == 0 && px.x < MAXS) {
+    if (px.x >= slabs) { fragColor = vec4(0.0, 0.0, 0.0, 1.0); return; }
+    float raw;
+    float e = follow(px.x, raw);
+    fragColor = vec4(e, raw, 0.0, 1.0);
+    return;
+  }
+  if (px.y == 1 && px.x <= MAXS) {
+    float total = 0.0;
+    float upto = 0.0;
+    for (int i = 0; i < MAXS; i++) {
+      if (i >= slabs) break;
+      float w = weight(i);
+      total += w;
+      if (i < px.x) upto += w;
+    }
+    fragColor = vec4(px.x >= slabs ? 1.0 : upto / max(total, 1e-4), 0.0, 0.0, 1.0);
+    return;
+  }
+  if (px.y == 0 && px.x == 40) {
+    bool beat = AUDIO_BEAT > 0.5;
+    float since = FRAMEINDEX == 0 ? 255.0 : min(prev.r + 1.0, 255.0);
+    float cnt = prev.g;
+    if (beat) { since = 0.0; cnt = mod(cnt + 1.0, 1024.0); }
+    fragColor = vec4(since, cnt, 0.0, 1.0);
+    return;
+  }
+  fragColor = vec4(0.0, 0.0, 0.0, 1.0);
+}

package/skills/agentvfx/templates/impact/speedline-burst/demo-speed-white.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-classic","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":"speedline-burst","preset":"speed-white","durationFrames":5},{"beat":1,"template":"speedline-burst","preset":"speed-manga","durationFrames":5},{"beat":2,"template":"speedline-burst","preset":"speed-accent","durationFrames":5},{"beat":3,"template":"speedline-burst","preset":"speed-negative","durationFrames":5},{"beat":4,"template":"speedline-burst","preset":"speed-tunnel","durationFrames":6}],"out":"speedline-burst-white"}