If the shot contains a trustworthy object that should be white, start with Kdenlive’s White Balance effect and sample that object. If it does not, Grayworld is a possible estimate, not an automatically more accurate choice: first confirm that the input is linearized and correctly tagged as needed. If you cannot establish the input’s linear-light state, do not treat Grayworld’s result as verified white balance.
Decide and apply the correction
Kdenlive documents White Balance as a source-image adjustment with a Neutral Color picker for choosing a color that should be white, plus a Green Tint control. Grayworld is a separate color-constancy filter based on the gray-world assumption. These are different routes: one uses a chosen reference; the other estimates from the image under an assumption about its overall color distribution.
Use this sequence for a clip with an uncertain cast:
- Look for a plausible neutral object in the shot. It should be intended to appear white, not merely look white on a display. If it is absent, damaged by clipping, or lit differently from the subject, do not treat it as a dependable sample.
- If the reference is credible and shares the subject’s illumination, apply White Balance and sample a representative area. Inspect the rest of the shot too; a plausible-looking sampled patch does not establish that every light in a mixed-light scene is neutralized.
- If no credible reference exists, consider Grayworld only after checking the available media-processing or color-management records for evidence that the image entering the effect has been linearized. The documentation also says the input may need to be correctly tagged, so check that condition when it is relevant to the input and the available records identify it; do not infer either state from the image’s appearance.
- If the required linearization cannot be confirmed, pause that route. If the relevant tagging state is also unavailable or unclear, keep the result provisional for the same reason. You may compare a cautious visual correction as an unverified creative adjustment, but do not label it a validated white balance.
- Compare the chosen result with the uncorrected clip and inspect both neutral-looking and strongly colored areas. If the correction makes the scene less plausible, revisit the reference or input assumptions rather than increasing correction by habit.
The Kdenlive White Balance documentation specifies the picker’s purpose and the Green Tint parameter. The Grayworld documentation identifies its assumption and says the LAB algorithm uses linear light, so input should be linearized beforehand and may need correct tagging.
Acceptance worksheet
The entries below are a planning example, not a software test or a promise about Kdenlive’s output. They show how to record evidence before deciding whether a correction is trustworthy.
| Case and observed evidence | Decision | What must be confirmed next |
|---|---|---|
| A white balance card is visible beside the subject; both appear to receive the same window light. | Try White Balance with a representative card area. | Check that the sampled area is not clipped and that other important parts of the shot remain plausible. |
| No neutral object is visible; project notes identify the effect input as linearized and the relevant color tagging is confirmed. | Grayworld is an eligible estimate to compare. | Inspect the result across the frame; the gray-world assumption may not suit the scene. |
| No neutral object is visible; the clip has a warm cast, but its linearization status is unknown. | Do not count Grayworld output as verified white balance. | Confirm the upstream transform and media tagging, or keep any visual adjustment explicitly unverified. |
| A pale wall is present, but it is visibly colored or lit by a different lamp than the subject. | Do not use it as a reliable neutral sample. | Seek a better reference or treat the correction as an aesthetic judgment. |
Limits and what to do when it fails
A reference-based picker depends on choosing a color that genuinely should be white; the documentation does not say that the effect can determine whether a sampled object is neutral. Grayworld depends on a scene-wide assumption and on suitable input conditions. Neither route is proof of accurate color reproduction, and a single global correction may not resolve different illuminants in one shot.
If the sample fixes the reference but makes the subject look wrong, check whether the object and subject share the same light and whether the sampled patch is representative. If Grayworld produces an implausible cast, first question the scene assumption and whether the input was linearized as required; also review the tagging state when that condition is relevant to the input. Do not infer a correction formula or a required numerical threshold from the manual. If the input state remains unknown, stop treating the result as a verified correction and seek project or media-pipeline information. The documentation does not prescribe a specific method for confirming linearization or, where relevant, the tagging state, so the check depends on available metadata and upstream processing records.
Three quick questions
Does Grayworld work without a neutral object? It can be considered as an estimate because it uses the gray-world assumption. The absence of a neutral reference does not make that assumption true for every scene.
Is a white-looking object enough for the picker? No. The object must be a credible color that should be white, and its illumination should represent the subject. Screen appearance alone is not evidence of neutrality.
What if I cannot confirm linear input? Do not present Grayworld’s result as verified white balance. Confirm the upstream processing and tagging first, or keep the visual result explicitly provisional.
Sources and next step
- Grayworld — Kdenlive 26.08 Manual 26.08 documentation
- White Balance — Kdenlive 26.08 Manual 26.08 documentation
This guide interprets public documentation and uses explicitly hypothetical acceptance examples, not application tests. Controls and availability can change; verify the cited manual against your installed version.
For work created in Imagild, carry the input requirements and acceptance checklist into the film workspace. The external software controls discussed above belong to their respective products.