Document Lockable Color Picker

[Beep6581]

The Lockable Color Picker needs to be documented. I don't know how to change the displayed values to L*a*b* or how to make the patches larger - this info should go into both RawPedia and the tooltip.

[iliasg]

@Beep6581 https://github.com/Beep6581/RawTherapee/issues/1812#issuecomment-251541179

now you can resize the Picker by using CTRL+Mouse wheel or CTRL+B1 to decrease size and CTRL+B3 to increase size. You can also change the displayed values type (between RGB/HSV/Lab) by cycling them using SHIFT+B1. The units are fixed though

[iliasg]

Tip, .. the circle keeps constant size when changing preview size .. so the area it covers is related to the preview size. When the size of the circle is smaller/larger than desired even after increasing/decreasing it at the largest/smallest size supported, to cover a larger/smaller area we have to decrease/increase preview size.

[Hombre57]

@Beep6581 Here is the documentation for the Lockable Color Pickers, I'll let you rephrase them in correct english ;) :

Locakble Color Pickers are graphical element that you can add on the preview image to report back the mean color at its location, providing RGB, HSL or L*a*b values. To add, move or delete them, you have to enter the Lockable Color Picker mode by clicking on its icon on the top toolbar of the preview window. Once done with placing and sizing the color pickers, you can go back to the Hand tool for normal operation of the preview window. Those graphical elements will help you having more consistent colors across your multiple edited image, e.g. by targeting specific values from a reference image.

How to operate them once in the Lockable Color Picker mode:

• Adding a picker: left-click on the target location in the preview window.
• Move a picker: move the mouse over the picker (preferably the circular part if you want better control) and drag it with the left mouse button.
• Resize a picker: move the mouse over a picker and hold down the control key and use the left mouse button to make it smaller, or the right mouse button to make it bigger. Alternatively, still over a picker, hold down the control key and use the scroll wheel.
• Switching between RGB, HSL and L*a*b values: move the mouse over a picker and use shift + left click on it
• Delete a picker: right-click over a picker
• Delete all pickers: control+shift+right-click over a picker. This has to be done on each detail window as well.
• Revert to hand tool: right-click anywhere else than over a picker

Please note that the pickers has a constant size across zoom rates. Therefore, the mean value will be different because of the resize function that "compress" the data.

[Beep6581]

Thanks @Hombre57 ! Will add that soon.