Skip to content

Color Chart

The Color Chart feature enables Color Finale 2 to match a video clip to a color chart that was recorded within the clip.

Supported charts

The Edit Chart menu offers three built-in charts:

  • ColorChecker Video
  • ColorChecker Passport Video
  • ColorChecker Classic (Macbeth) — the classic 24-patch chart

Any custom charts you have added appear below the built-in ones. See Custom charts below.

Matching a chart

Select a chart in the Edit Chart menu. An on-screen overlay for the chart is displayed over the viewer. Click into the viewer to pin the four corners around the visible chart in the video clip. Once you have aligned the blocks of the chart overlay with the on-screen chart, click Match Chart. Color Finale 2 will automatically correct the image based on matching the charts. Enable Match will then change to Disable Match in the HUD. If you don’t like the automatic correction, click Disable Match or Reset Chart and start over. You can also uncheck the Match Enabled box within the Color Chart segment of the inspector panel.

The Match Mode menu in the Color Chart section selects how the correction is computed:

  • Classic — the original matching behavior from earlier versions.
  • Per Channel — matches each color channel individually and usually produces a more accurate result on well-exposed charts.

Chart-matched corrections may be stored and applied as a Chart Preset.

Chart-matched corrections are applied under the hood. The corrections made are not visible in the Corrections settings nor in the Layers panel.

Overlay styles

The appearance of the on-screen chart overlay can be changed in Preferences → Settings under Chart Overlay Style:

  • Frame (Legacy) — the outline-only overlay from earlier versions
  • Thin Outline — a lighter outline around each patch
  • Filled Patches — each cell is filled with its reference color for direct visual comparison
  • Split Comparison — each cell shows the reference color and the sampled image side by side

Custom charts

You can add your own charts in Preferences → Settings under Custom Charts. Click the plus symbol (+) and select a chart description file (JSON). The file is copied into the Color Finale 2 charts folder, so the original can be moved or deleted afterwards. To remove a chart, highlight it in the list and click the minus symbol (−).

Added charts appear at the bottom of the Edit Chart menu and work exactly like the built-in ones.

A chart description is a small JSON file:

{
    "name": "My Chart",
    "rows":    [ [0.03, 0.22], [0.27, 0.45] ],
    "columns": [ [0.02, 0.14], [0.18, 0.30], [0.33, 0.46] ],
    "edgeWidth": 0.02,
    "patches": [
        { "X": 6.12,  "Y": 5.89,  "Z": 4.56, "name": "Dark Skin" },
        { "r": 255, "g": 255, "b": 255, "name": "White" }
    ]
}
  • rows / columns — the normalized [start, end] position of each row and column band within the chart, from 0 to 1
  • patches — one entry per cell, listed row by row; the count must equal rows × columns. Each patch is specified either as CIE XYZ reference values (×100) or as sRGB values (r, g, b, 0–255)
  • edgeWidth (optional) — the sampling margin inside each cell

Exporting sampled data

After a successful match, choose Export Sampled Data… from the action menu of the Color Chart section to save a CSV file with the reference and sampled values for every patch. This is useful for verifying a camera or lighting setup against the chart’s reference values.