Hyacinth
Shallow depth of field, bokeh and lens flare, for Resolume

What it does
An FFGL effect for Resolume Arena and Avenue: SW Hyacinth. A lens focused at one distance blurs a point at another into a disc whose radius is linear in the difference of their nearnesses, one over the distance. Hyacinth keeps every depth as nearness and works from that line, so the background's blur levels off while the foreground's keeps growing, a defocused highlight carries its light spread over the aperture, and in front of focus the aperture shows upside down.
Depth From says where the depth comes from: a Plane to a horizon for anything shot over a floor or a stage, Radial round the focus point, Luma, Haze for landscapes and smoke, Subject for whatever matches the colours under the focus point, the clip's alpha, or a depth map made elsewhere and packed Side by Side or Over Under. Estimated depths are snapped to the picture's own edges, so the blur stops where the subject does. Focus sits at a set distance, at a point, or on whatever the tracker is following, and eases into place like a focus pull.
The aperture has blades, a mirror lens's ring, a star or a heart, and the faults that make bokeh look like a real lens's: a cat's eye towards the corners, swirl, anamorphic squeeze, soap-bubble rims, onion rings and colour fringes that swap sides across focus. Bokeh Only leaves the picture sharp and draws only the highlights' discs. Orbs, a lens flare with ghosts, halo, starburst and streak, and dirt on the front element all use the same aperture.
- Depth from a Plane, Radial, Luma, Haze, Subject, Clip Alpha, or a packed Side by Side or Over Under depth map
- Focus Manual, at a Point, or on a tracked subject, with an eased focus pull
- Iris with 3 to 12 blades, Mirror, Star and Heart apertures, upside down in front of focus
- Cat's eye, swirl, anamorphic squeeze, bubble, onion rings and chromatic fringe
- Bokeh Only: the picture stays sharp and only its highlights grow discs
- Orbs, lens flare (ghosts, halo, starburst, streak) and lens dirt in the same aperture
- Show Depth, Blur and Tracker views for finding out why something is or isn't sharp
Where it stands
Released at v0.1.0, the first release. On Windows it's been in Resolume: the release workflow's build loads in Resolume Arena 7.27.1 on a test machine with no GPU, all 47 of its parameters arrive as declared, it renders with a clean log, and every control that can act on a still picture changed Arena's picture. Everything else is checked offline, by a harness that drives the plugin's own code at two resolutions and on Apple's software renderer. A defocused point's disc is the size a thin lens says to 0.03 px, it carries its highlight's light to within 0.4 % whatever the aperture's shape, the blade corners point where the blades are, a ground plane's depth matches a pinhole camera's to three parts in ten million, the tracker follows a moving subject to 0.06 px, and at zero Mix the clip comes through bit for bit. Sixteen deliberately wrong models and 21 one-character mutants are all caught, and all 42 controls change the picture. Still open: it's never been loaded into Resolume on a Mac, the estimated depths and the tracker have only met synthetic pictures, and nobody has held it up beside a real lens.
Watch it running
Nothing loads from YouTube until you press play.Watch it there instead