Match colors to a reference image
Contents
Use this guide when shots in your story do not look like they belong together. You will make one picture or clip take on the colors of a reference image.
Before you start#
You need an image or video on the canvas, and a second image with the look you want. A still from another shot of the same scene works well.
Match the colors#
- Add Color correction from Toolbox, under Editing.
- Wire the picture or clip you want to change into the File input.
- Wire the reference image into the Reference input.
- Look at the card. A Match menu and a Strength slider show above the color sliders.
- Choose a method in Match:
- Mean moves the average and the spread of each color channel to the reference. Use it for a gentle change.
- Histogram moves the whole spread of each color channel to the reference. Use it for a closer match.
- Set Strength from 0 to 100. At 100 the match is full. At 0 the picture does not change.
You should see the matched picture on the card after a short wait. Download and the next node receive the matched file.
For a clip, Canvas reads the colors of the middle frame once. Every frame then gets the same change, so the colors do not flicker.
Fine-tune the result#
The sliders work on the matched picture. Use Exposure, Contrast and the other sliders to adjust it further. Reset sets the sliders back to zero. It does not remove the match.
To stop matching, remove the wire from Reference, or set Strength to 0.
Read the histograms#
Under the picture, the card shows two histograms: Input for the file wired into the card, and Result for the file Download and the next node receive. Each one draws the brightness (filled) and the red, green and blue channels (lines) from dark on the left to bright on the right. The text under each says how much of the picture is pure black and pure white.
- A large share of black or white means detail is lost there. Lower Exposure or Highlights for white, and raise Shadows for black.
- Result says Waiting for the bake until the new file is ready.
- For a clip, both histograms read the middle frame, the same frame the match reads.
An agent reads the same numbers from media_measure with the color group: histogram holds 64 bins each of luma, red, green and blue, and the black and white shares.
Check and fix#
If the card shows the original colors, wait for the bake to finish. If the card says the file did not save, select Retry.
If the colors look too strong, lower Strength or change Match to Mean.
Reference takes only an image. To match a clip to another clip, first take one frame from the reference clip with Extract Frame, then wire that frame into Reference.
Ask your agent#
Help me match the colors of my second shot to my first shot. First, inspect the File for the two video nodes and a frame I can use as a reference. Explain the proposed changes and ask before you change any node.
Your agent can wire Reference and set the match settings. node_run bakes a matched still or clip on the server. For a clip it reads the same middle frame Canvas reads, so both give the same colors. A Reference that is not a PNG or JPEG still (a clip, WebP or AVIF) is refused with reference-not-picture.
Review the matched picture on the card before you continue.