Skip to content

Update as shot to reference documentation #789

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
+4 −2
Open

Update as shot to reference documentation #789

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions content/module-reference/processing-modules/white-balance.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,15 +38,17 @@ tint
setting
: Choose from a predetermined list of white balances. The available settings are derived from the presets available in the camera used to take the photograph. The following options are provided in addition to any camera-defined white balance presets.

: - _as shot_ (default): The white balance as reported by the camera
: - _as shot_: The white balance as reported by the camera

: - _from image area_: Draw a rectangle over a neutral color in the image to calculate white balance from that area.

: - _user modified_: The most recently modified setting. Manual adjustment of temperature, tint or r/g/b channel coefficients will automatically select this option. Choose this setting after selecting any other preset to return parameters to the most recent user-modified state

: - _camera reference_: Set the temperature to the camera reference white point, which is assumed to be D65 (or ~6502K). The white balance channel multipliers are calculated such that pure white in the camera colorspace is converted into pure white in sRGB D65 (where pure white means that each color channel has an equal value).

For convenience the final four modes can also be set by clicking on one of the buttons in the [button bar](#button-bar) above the _setting_ drop-down.
: - _as shot to reference_: (default) The white balance as reported by the camera is used in processing modules before _colorin_ for slightly better results in [_highlights reconstruction_](./highlight-reconstruction.md), [_raw chromatic aberrations_](./raw-chromatic-aberrations.md), [_demosaic_](./demosaic.md) or [_denoise profiled_](./denoise-profiled.md). This is correcter later in the pipe in [_colorin_](./colorin.md) to the camera reference white point as in _camera reference_. Please note: In a few cases the coefficients reported by the camera for 'as shot' are bad so you might prefer _camera reference_ in those cases.
Copy link
Contributor

@elstoc elstoc Nov 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You make reference to the colorin documentation here. I assume you mean input color profile?

Copy link
Contributor Author

@jenshannoschwalm jenshannoschwalm Nov 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You make reference to the colorin documentation here. I assume you mean input color profile?

I was intentionally referring to colorin as thats the place in the pipe where the data are finally corrected to D65. Thats the only difference compared to 'camera reference'

Copy link
Contributor

@elstoc elstoc Nov 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sure, I'm just saying that no user will no what "colorin" mean

Copy link
Contributor Author

@jenshannoschwalm jenshannoschwalm Nov 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will they know what a profile is? :-) I just take your word on this ...

Copy link
Contributor

@elstoc elstoc Nov 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, but they can look at the documentation for input color profile if you give them the correct link


For convenience the final five modes can also be set by clicking on one of the buttons in the [button bar](#button-bar) above the _setting_ drop-down.

finetune
: Finetune a camera-specific white balance preset. This is only shown if it is available for the camera in question. The direction of adjustment is dependent on the provided presets. If your camera doesn't have white balance presets available, check [this guide](https://github.com/darktable-org/darktable/wiki/White-balance-presets) to see how you can submit your own.
Expand Down