Autograph Hub

Wiki · Autograph / Alpha / Compositing

Autograph alpha and premultiplication troubleshooting checklist

A practical checklist for diagnosing dark fringes, bright halos, dirty transparent pixels, broken glows, and inconsistent edges when media moves through Autograph, OpenFX plug-ins, EXR files, and downstream compositing tools.

Why this page exists

Alpha problems are often misdiagnosed as color-management, antialiasing, or codec problems. The image may look correct over black and fail over a bright background, or it may survive inside one host and break after an OpenFX effect, resize, blur, color correction, or EXR handoff. The core question is whether RGB values are stored independently from alpha or already multiplied by alpha, and whether every stage treats that relationship consistently.

Establish the alpha contract

Fast diagnostic test

  1. Place the element over black, middle gray, white, and a saturated color.
  2. Inspect a soft edge at 200–400% zoom and compare RGB and alpha separately.
  3. Temporarily unpremultiply, inspect or process the RGB, then premultiply again before the final over operation.
  4. Render a short test to the intended delivery format and re-import it into Autograph and one receiving application.
  5. If the fringe changes with the background, suspect alpha association or hidden RGB before blaming the display transform.

Symptom map

OpenFX and effect-order checks

EXR handoff checks

Color-management boundary

Alpha is normally coverage or opacity data, not display-referred color. Color transforms should generally affect RGB, while the alpha relationship must remain coherent before and after the transform. When debugging, separate two questions: whether the RGB values are in the intended color space, and whether those RGB values are straight or premultiplied. Solving only one can leave the edge wrong.

Minimum handoff note

Practical rule

Do not fix a fringe by crushing, eroding, or color-correcting the edge until the alpha association is known. First identify the representation, process RGB in the appropriate state, restore the intended association, and verify the written file over more than one background.

Useful next pages

Sources checked