makepad/apps/vj/resources/effects/64_june_field.splash
Admin f44616b2a7 makepad-vj effects: the effect renderstack, with the shaders inside the documents
The VJ's EFFECT surface is a small renderer of its own. An effect is a
`.splash` DOCUMENT — engine choice, stages, fields, parameters and now the
SHADERS THEMSELVES live in the document rather than in Rust. That is the
shape this commit introduces (dev has never seen an intermediate one): a
document is the whole effect, and the Rust side is the engine families that
documents draw with.

The engine families: particles and emitters, GPU sim swarms and fluid, static
meshes (firefly synchrony, harmonograph loom, domino liturgy), tiles, flock,
clouds, city, pipes, stock charts, an SDF raymarcher with a subclassable
`scene_sdf`, and a mountain-jet endless range with a beat-pulsed fighter.

Three things make them a system rather than a demo reel:

  - SIM FIELDS — a float simulation-texture primitive, so an engine can carry
    GPU state across frames (wind, particles, fluid) instead of being a pure
    function of the clock.
  - CONTENT COUPLING — `content:` in a document and `input0` on every engine's
    tex0, so an effect can consume the program video: drapes, backdrops,
    mirrors, billboards, chrome, frescoes, canopy, glass, silk, wall, swarm,
    pen and mosaic families all take the picture playing behind them.
  - MUSIC BINDING — shaders read the beat, so the whole library moves with the
    track rather than on its own clock.

Roughly a hundred seeded preset documents ship with it, each with a lazily
rendered animated thumbnail (rendered 4x and box-downscaled, 16-tap SSAA);
the thumbnail pass went from four minutes to eleven seconds. CONTRACT.md is
the document contract and its verify recipe; IDEAS.md is the campaign tracker.
2026-08-23 01:35:44 +02:00

91 lines
3.2 KiB
Text

// JUNE FIELD — a dark summer meadow of fireflies pulled into sync by the
// music. Pattern taught: the firefly engine's ONE emotional lever — blink
// phase = mix(own clock, beat phase, sync) — driven by a binding: `p0`
// ADDS to the base sync, so `env(bar)` makes the field snap together at
// every bar start and dissolve back into chaos as the bar runs out.
{
name: "June Field"
engine: "firefly"
seed: 61
flies: 900
blades: 8000
area: 9.0
fly_height: 1.8
fly_size: 0.11
sync: 0.18 // base: mostly chaos…
p0: "clamp(0.15 + 0.75 * env(bar), 0.0, 0.9)" // …until the bar hits
blink_rate: 0.5
blink_sharp: 6.0
wander: 0.6
moon: 0.3
grass_height: 0.85
clump: 0.6
beat_pulse: 0.5
beat_rate: 1.0
sway: 0.5
sway_freq: 0.7
// PERFORMANCE DIALS — SYNC/WANDER are the engine's own p0/p1 levers
// (touching SYNC overrides the bar-swell binding above with a held
// sync level); GLOW routes p2 through the glow binding. Untouched
// knobs leave every doc binding in charge.
p2: 0.5
glow: "1.1 * (0.25 + 1.5*p2)"
dials: [
{name: "SYNC", bind: "p0", default: 0.5},
{name: "WANDER", bind: "p1", default: 0.0},
{name: "GLOW", bind: "p2", default: 0.5}
]
color_bg: #x040a06
color_a: #x0a2412
color_b: #xaaff44
color_c: #xf8ffd0
cam_orbit: 0.05
cam_height: 1.4
fog: 0.05
stages: [
{kind: "bloom", threshold: 0.35, strength: 1.6, levels: 3}
]
// THE LOOK LIVES HERE. This block is not a reference to the
// engine's shader — it IS the pixel math this effect runs.
// Rewrite it and the effect looks different; everything else
// (geometry, motion, the content coupling, the beat) keeps
// working, because the block SUBCLASSES the engine shader.
// Inputs: blades (attr.y < 1.5) and flies (attr.y >= 2) share one hook.
// Signals: self.time_beat (time, beat, phase, pulse),
// self.sig (bar, bpm, energy, dt), self.user (p0..p3),
// self.col_a/b/c/bg, self.fog (density, glow, content, -).
shader: draw.DrawVjFxFirefly {
fx_color: fn(t: float, attr: vec4, content: vec4, cmix: float) -> vec4 {
if attr.y > 1.5 {
let mut body = self.col_b.mix(self.col_c, t * t).xyz
if cmix > 0.001 {
body = mix(
body,
content.xyz * (0.75 + 0.85 * t),
clamp(cmix * 1.6, 0.0, 1.0)
)
}
return vec4(body, 1.0)
}
let base = self.col_a.mix(self.col_b, t * 0.7 + attr.z * 0.15)
let moon = self.shape.w * (0.25 + 0.75 * t)
let breath = 1.0 + self.time_beat.w * 0.18
return vec4(base.xyz * ((0.16 + moon) * breath * self.fog.y), 1.0)
}
fx_sprite: fn(uv: vec2, tint: vec4) -> vec4 {
let d = length(uv - vec2(0.5, 0.5)) * 2.0
let core = 1.0 - smoothstep(0.0, 0.35, d)
let halo = 1.0 - smoothstep(0.08, 1.0, d)
let a = clamp(core + halo * 0.6, 0.0, 1.0)
return vec4(tint.xyz * a, 0.0)
}
}
}