rawTherapee/rtgui/ppversion.h
rom9 22eee9787e
Film negative stable multipliers (#5485)
* Added new feature to calculate channel multipliers from crop area. This also saves the crop area channel medians to the processing profiles, in order to get a more consistent color balance when batch-applying the same profile to multiple pictures from the same film roll.

* Fixed wrong initialization of array, and missing check for the result of `getFilmNegativeMedians()`.
Moved `ImProcCoordinator::translateCoord()` from private member to anonymous namespace.
Fixed some whitespace and formatting issues.

* Fixed some formatting issues

* Passed `ipf` parameter as const in `translateCoord`.
Narrowed `using namespace` to single class `Coord2D`.

* Added `scaleGain` entry to thumbnail metadata file, to make `scale_mul` multipliers available in thumbnail processing phase. This simplifies multiplier calculations, so that "faking" thumbnail multipliers in the main image processing is not necessary anymore. This way, output values are immune to slight variations of multipliers between successive shots taken with in-camera AWB turned on.
Shifted multipliers so that the output channel medians are balanced when "Camera WB" is selected. This way, just computing multipliers from crop and setting "Camera WB" (which is the default) gives a pretty well balanced image as a starting point.

* New channel scaling method, based on a film base color sample instead of crop area channel medians. Channels are scaled so that the converted film base values are equal to 1/512th of the output range (65k). This giver better black levels in the output, and more consistency when batch-processing multiple negatives.
The output is now compensated for a known fixed WB value, so that the film base will appear grey when WB is set to 3500K, Green=1.
Added PPVERSION 347 to preserve backwards compatibility: when a processing profile saved by RT 5.7 is loaded (PPVERSION=346), the new fields are initialized to the special value -1, which will instruct the main processing to follow the old channel scaling behaviour. The old channel scaling multipliers will then be converted to the new film base values so that the resulting image is the same, and the fields will be overwritten as soon as the PP is saved again. This will transparently upgrade the processing profile.
When the new behaviour is used, but the film base values are still unset, they are estimated based on channel medians, excluding a 20% border around the image. This should give a better result out-of-the-box for pictures containing a large film holder.

* Code cleanup from review

* Run astyle on film neg source files

* Fixed automated build failure caused by incompatible libraries on my dev PC.

* Simplified `Thumbnail::processFilmNegative` method signature. There is no need to pass in `rmi`,`gmi`,`bmi` multipliers from the caller, i can do the same with my own internal multipliers.

* Added `FilmNegListener` class to pass estimeted film base values to the GUI after first processing. Removed old `filmBaseValues` instance variable from RawImageSource.

* Code cleanup

* Forgot to set baseValues flag in `PartialPasteDlg::applyPaste`
Fixed `filmBaseValuesLabel` not updating when reading zero baseValues. Normally not needed (the label is updated later by the listener), but when the user is browsing through pictures the listener won't fire, so the label must be updated to show values are unset.

* Overwritten channel scaling multipliers by calling `get_colorsCoeff` with `forceAutoWB=false`.
Initially, in `RawImageSource::load`, channels are auto-balanced by averaging the whole picture when computing multipliers.
This can give different multipliers for multiple shots of the same camera, which will lead to inconsistent conversions when batch-processing multiple negatives.
This commit re-sets `scale_mul`, `ref_pre_mul`, etc., in order to "undo" the auto-WB and use the normal camera multipliers.

* Found an easier way to get stable overall multipliers, removed the (horrible) on-the-fly mutation of scaling instance variables.
2020-04-13 17:20:56 +02:00

87 lines
3.4 KiB
C

#pragma once
// This number has to be incremented whenever the PP3 file format is modified or the behaviour of a tool changes
#define PPVERSION 347
#define PPVERSION_AEXP 301 //value of PPVERSION when auto exposure algorithm was modified
/*
Log of version changes
347 2019-11-17
added special values in filmNegative for backwards compatibility with previous channel scaling method
346 2019-01-01
changed microcontrast uniformity
345 2018-10-21
dual demosaic auto contrast threshold
344 2018-10-04
added Lab/RGB color space selection for shadows/highlights
343 2018-09-06
raw auto ca correction avoid colour shift
342 2018-09-05
raw auto ca correction iterations
341 2018-07-22
[ICM] enhanced custom output profile
340 2018-07-08
store whether curve is from histogram matching
339 2018-07-04
added allowUpscaling to ResizeParams
338 2018-06-15
increased precision for the channel mixer
337 2018-06-13
new scales for the LabGrid color toning parameters
336 2018-06-01
new demosaic method combobox for pixelshift
335 2018-05-30
new contrast adjuster in Bayer process tool
334 2018-05-13
new contrast threshold adjuster in Microcontrast tool
333 2018-04-26
new Shadows/Highlights tool
332 2018-04-18
changed pixelShiftEperIso calculation
331 2018-02-14
changed wavelet.Lmethod to int
330 2018-01-20
Added 'Auto-matched Tone Curve' button, performing histogram matching
329 2017-09-12
Added 'Enabled' flag for Channel Mixer, RGB Curves, HSV Equalizer and L*a*b* Adjustments
328 2017-11-22
Fix wrong type of ff_clipControl
327 2017-09-15
[Profiled Lens Correction] Added Lensfun
326 2015-07-26
[Exposure] Added 'Perceptual' tone curve mode
325 2015-07-23
[Exposure] [RGB Curves] [B&W] Normalized RGB pipeline curve gammas to sRGB (before it was a mix between sRGB and 1.0 and depended on file format)
323 2015-10-05
[Exposure] Added 'Luminance' tone curve mode
322 2015-01-31
[Wavelet] new tool using wavelet levels
321 2014-08-17
[Film Simulation] new tool using HALDCLUT files
320 2014-07-02 (yes, same version number... this is an error due to a wrong version number set in comment of previous change)
New [RAW Bayer] and [RAW X-Trans] sections, with some parameters transferred from [RAW] to [RAW Bayer]
320 2014-03-29
[ColorToning] new tool for color toning
319 2014-02-11
Hue skin for Contrast by detail levels
318 2014-02-10
Vignetting Correction bug makes hard transitions for positive Amount values, Issue 2241
317 2014-01-19
changes to behaviour of LC curve, Issue 2209
315 2013-12-12
add LH et HH curve to lab mode
313 2013-11-19
add CL curve to lab mode
312 2013-11-08
added numerous changes to [channel mixer]
311 2013-11-07
[Gradient] new tool (gradient/graduated filter
[PCVignette] new tool (vignette filter)
310 2013-09-16
Defringing /Threshold - changed calculation, issue 1801
307 2013-03-16
[Perspective] Horizontal and Vertical changed from int to double
added [Directional Pyramid Denoising] Method, Redchro, Bluechro
added [RGB Curves] LumaMode
*/