diff --git a/content/darkroom/masking-and-blending/masks/parametric.md b/content/darkroom/masking-and-blending/masks/parametric.md index a815252094..733d58c939 100644 --- a/content/darkroom/masking-and-blending/masks/parametric.md +++ b/content/darkroom/masking-and-blending/masks/parametric.md @@ -69,11 +69,11 @@ In this state a range select function selects the whole range of values giving a Conversely a range de-select function (enabled by toggling the polarity) by default deselects the whole range of values, giving an “all-zero” mask as a starting point. Moving the sliders inwards gradually includes more and more parts of the image except for the remaining narrow range. -# color pickers +# pickers -With the left-hand color picker button you can select a point or area probe from your image. The corresponding values for the real and virtual data channels are then displayed within each color channel slider. +With the left-hand [picker](../../processing-modules/module-controls.md#pickers) button you can select a point or area probe from your image. The corresponding values for the real and virtual data channels are then displayed within each color channel slider. -With the right-hand color picker button you can automatically set the slider's values based on the selected range. Click and drag to set the parameters for the input slider from the drawn rectangle; Ctrl+click and drag to set the parameters for the output slider. +With the right-hand picker button you can automatically set the slider's values based on the selected range. Click and drag to set the parameters for the input slider from the drawn rectangle; Ctrl+click and drag to set the parameters for the output slider. # invert @@ -82,4 +82,3 @@ Click the invert button above the sliders to invert the polarity of the entire p # reset Click the reset button above the sliders to revert all parametric mask parameters to their default state. - diff --git a/content/darkroom/processing-modules/module-controls.md b/content/darkroom/processing-modules/module-controls.md index 64fcfcd0e6..8235087615 100644 --- a/content/darkroom/processing-modules/module-controls.md +++ b/content/darkroom/processing-modules/module-controls.md @@ -49,9 +49,9 @@ Click on a combobox to show a list of available options which you can click to s As with sliders, you can double-click the combobox or its label to reset back to the default value, or Ctrl+double-click to reset back to any auto-applied preset. -# color pickers +# pickers -A number of modules allow parameters to be set using color pickers (identified by the ![color-picker-icon](./module-controls/color-picker.png#icon) icon). These use a standard interface and most can operate in either point or area mode. Point mode can be activated by clicking on the color picker icon. Area mode is activated with Ctrl+click or right-click. +A number of modules allow parameters to be set using pickers (identified by the ![picker-icon](./module-controls/color-picker.png#icon) icon). These use a standard interface and most can operate in either point or area mode. Point mode can be activated by clicking on the picker icon. Area mode is activated with Ctrl+click or right-click. # keyboard shortcuts diff --git a/content/guides-tutorials/batch-editing.md b/content/guides-tutorials/batch-editing.md index 2cadc1e70d..1dda9a2abe 100644 --- a/content/guides-tutorials/batch-editing.md +++ b/content/guides-tutorials/batch-editing.md @@ -69,7 +69,7 @@ If there was some variability in your lighting conditions, each image will need First, homogenize the exposure using your control sample and the [_area exposure mapping_](../module-reference/processing-modules/exposure.md#area-exposure-mapping) tool. -Then, adjust the _filmic rgb_ white relative exposure if needed, preferably using the color picker. The contrast should not require any adjustment since it does not depend on the dynamic-range of the image. +Then, adjust the _filmic rgb_ white relative exposure if needed, preferably using the [picker](../darkroom/processing-modules/module-controls.md#pickers). The contrast should not require any adjustment since it does not depend on the dynamic-range of the image. Finally, homogenize the chromatic adaptation, using your control sample and the [_color calibration area mapping_](../module-reference/processing-modules/color-calibration.md#area-color-mapping) tool. diff --git a/content/module-reference/processing-modules/basic-adjustments.md b/content/module-reference/processing-modules/basic-adjustments.md index 904791df4b..8b8d2f66d2 100644 --- a/content/module-reference/processing-modules/basic-adjustments.md +++ b/content/module-reference/processing-modules/basic-adjustments.md @@ -53,8 +53,7 @@ vibrance : Accentuate the colors of the image without adding unnatural colors, as it's often the case with the _saturation_ slider. It works by reducing the lightness of already saturated pixels to make the colors more vivid. You can also achieve some interesting effects by combining it with the saturation slider to target more or less saturated areas of the image. auto -: Automatically adjust the exposure, taking into account the entire image, or use the color picker to select a rectangular area of the image -- the exposure will be automatically adjusted based on the selected region. This allows you to prioritise which parts of the image should be well-exposed. +: Automatically adjust the exposure, taking into account the entire image, or use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to select a rectangular area of the image -- the exposure will be automatically adjusted based on the selected region. This allows you to prioritise which parts of the image should be well-exposed. clip : This affects the number of pixels that will be clipped to black or white during the auto-exposure calculation. Moving this slider to the right will allow more pixels to be clipped and increase the contrast; moving this slider to the left will compress the image more and lower the contrast. - diff --git a/content/module-reference/processing-modules/color-balance-rgb.md b/content/module-reference/processing-modules/color-balance-rgb.md index 236f1f6cb0..39368f9d70 100644 --- a/content/module-reference/processing-modules/color-balance-rgb.md +++ b/content/module-reference/processing-modules/color-balance-rgb.md @@ -84,7 +84,7 @@ Each of the settings in the 4 ways tab is composed of the same three components, Color input like this defines a color shift applied to the image globally or over the specified luminance range. -Each hue slider has a color picker, which may be used to compute the opponent color of the selected region. This is useful to revert unwanted color casts (e.g. skin redness), since shifting the color to its opponent cast neutralizes it. +Each hue slider has a [picker](../../darkroom/processing-modules/module-controls.md#pickers), which may be used to compute the opponent color of the selected region. This is useful to revert unwanted color casts (e.g. skin redness), since shifting the color to its opponent cast neutralizes it. ### global offset @@ -132,12 +132,12 @@ Luminance masks are computed at the input of the module, which means that they a white fulcrum : Set the white point luminance in EV. This is used to normalize the _power_ setting in the [_4 ways_](#4-ways-tab) tab. Display-referred implementations of power functions assume that white is at 100%, which removes the need for normalization. For scene-referred purposes this needs to be taken into account. -: The color picker to the right of the slider automatically sets the white fulcrum to the maximum luminance from the selected region, which should be sufficient in most cases. +: The [picker](../../darkroom/processing-modules/module-controls.md#pickers) to the right of the slider automatically sets the white fulcrum to the maximum luminance from the selected region, which should be sufficient in most cases. contrast gray fulcrum : Set the fulcrum for the _contrast_ setting in the [_master_](#master-tab) tab. This corresponds to the luminance value that will be left unchanged by the contrast adjustment. This setting usually matches the middle-gray linear value. If you followed the scene-referred workflow recommendations and set the global brightness early in the pipeline, using the _exposure_ module, the correct value should usually be around 18-20%. -: The color picker to the right of the slider automatically sets the contrast gray fulcrum to the average luminance from the selected region. This relies on the assumption that the average luminance is usually close to middle-gray, which is not true if you have specular highlights or primary light sources in the frame, or for low/high-key images. +: The [picker](../../darkroom/processing-modules/module-controls.md#pickers) to the right of the slider automatically sets the contrast gray fulcrum to the average luminance from the selected region. This relies on the assumption that the average luminance is usually close to middle-gray, which is not true if you have specular highlights or primary light sources in the frame, or for low/high-key images. ### saturation formula diff --git a/content/module-reference/processing-modules/color-balance.md b/content/module-reference/processing-modules/color-balance.md index b7d9e9c047..5bafd90965 100644 --- a/content/module-reference/processing-modules/color-balance.md +++ b/content/module-reference/processing-modules/color-balance.md @@ -81,19 +81,19 @@ shadows, mid-tones, highlights --- optimize luma -: The color picker beside the optimize luma label will select the whole image and optimize the factors for shadows, mid-tones and highlights so that the average luminance of the image is 50% Lab, the maximum is 100% and the minimum is 0%, at the output of this module. This is essentially histogram normalization, similar to that performed by the [_levels_](./levels.md) module. The optimizer is only really accurate when used in _slope, offset, power_ mode. +: The [picker](../../darkroom/processing-modules/module-controls.md#pickers) beside the optimize luma label will select the whole image and optimize the factors for shadows, mid-tones and highlights so that the average luminance of the image is 50% Lab, the maximum is 100% and the minimum is 0%, at the output of this module. This is essentially histogram normalization, similar to that performed by the [_levels_](./levels.md) module. The optimizer is only really accurate when used in _slope, offset, power_ mode. -: If you want more control, you can define three control patches by using the color pickers beside each factor slider to sample luminance in selected areas. The _shadows_ color picker samples the minimum luminance, the _mid-tones_ color picker samples the average luminance, and the _highlights_ color picker samples the maximum luminance. The most sensitive parameter is the mid-tones factor, since selecting a slightly different area can lead to dramatic parameter changes. Using the factors color pickers alone, without triggering the luma optimization, will allow you to perform adjustments without general optimization, but each parameter is always computed taking the other two into account. Once patches are selected, the label changes to read “optimize luma from patches”. To reset one patch, you can just redo the selection. Patches are not saved in the parameters and are retained only during the current session. +: If you want more control, you can define three control patches by using the pickers beside each factor slider to sample luminance in selected areas. The _shadows_ picker samples the minimum luminance, the _mid-tones_ picker samples the average luminance, and the _highlights_ picker samples the maximum luminance. The most sensitive parameter is the mid-tones factor, since selecting a slightly different area can lead to dramatic parameter changes. Using the factors pickers alone, without triggering the luma optimization, will allow you to perform adjustments without general optimization, but each parameter is always computed taking the other two into account. Once patches are selected, the label changes to read “optimize luma from patches”. To reset one patch, you can just redo the selection. Patches are not saved in the parameters and are retained only during the current session. : It is important to note that the luminance adjustment targets only the output of the _color balance_ module and does not account for adjustments performed in other modules later in the pixelpipe (e.g. [_filmic rgb_](./filmic-rgb.md), [_tone curve_](./tone-curve.md), [_color zones_](./color-zones.md), [_levels_](./levels.md)). Using the _color balance_ module to remap the luminance globally on the image is not recommended because it does not preserve the original colors -- modules such as [_tone curve_](./tone-curve.md) or [_filmic rgb_](./filmic-rgb.md) are better suited for this purpose. Luminance adjustments in _color balance_ are better performed, in combination with color adjustments, using masks. neutralize colors : In an image where some areas are exposed to direct sunlight and some areas are exposed to reflected light (shadows), or where several artificial light sources are present simultaneously, shadows and highlights often have different color temperatures. These images are particularly difficult to correct since no general white balance will match all the colors at once. The color neutralization optimizer aims at helping you find the complementary color for shadows, mid-tones, and highlights so that all the color casts are reverted, and the average color of the image is a neutral gray. -: As with the luma optimization, the color picker beside the neutralize colors label will trigger a general optimization over the whole image. This works fairly well in landscape photography, or for any photograph with a full spectrum of colors and luminances. +: As with the luma optimization, the [picker](../../darkroom/processing-modules/module-controls.md#pickers) beside the neutralize colors label will trigger a general optimization over the whole image. This works fairly well in landscape photography, or for any photograph with a full spectrum of colors and luminances. -: For night and events photography, this will most likely fail and you will need to manually input the sampling areas with the color pickers beside each hue slider. For the highlights sample, use a color exposed to spotlights that should be neutral white or light gray. For the shadows sample, use a color exposed to ambient light that should be neutral black or dark gray. For the mid-tones sample, use a color exposed by both ambient and spotlights. +: For night and events photography, this will most likely fail and you will need to manually input the sampling areas with the picker beside each hue slider. For the highlights sample, use a color exposed to spotlights that should be neutral white or light gray. For the shadows sample, use a color exposed to ambient light that should be neutral black or dark gray. For the mid-tones sample, use a color exposed by both ambient and spotlights. : The success of the optimization depends on the quality of the samples. Not every set of samples will converge to a good solution and you need to ensure that the color patches you choose are really a neutral color in real life. In many cases the optimizer will output the correct hue but an excessive saturation that will need some extra tweaking. In some cases, no valid optimization will be delivered and you will need to reset the saturation parameters and start over, or simply stop after the patches selection. Note that in the auto-optimization, the maximum saturation is 25%, which might not be enough in very few cases but will avoid inconsistent results in most. -: If you select color patches from the hue color pickers without triggering the optimization, the software will only perform one round of optimization and then stop. This allows you to control each luminance range separately and avoid divergence of the solution in corner cases. The hue and saturation corrections are computed taking into account the two other luminance ranges and three factors, and will always output the complementary color of the selected area. If you want to reinforce the color of the area instead, you can then add 180° to the computed hue. Once patches are selected, the label changes to read “neutralize colors from patches”. To reset one patch you can just redo the selection. Patches are not saved in the parameters and are retained only during the current session. The parameters found by the automatic neutralization are accurate only in _slope, offset, power_ mode, but can work to some extent in _lift, gamma, gain_ mode too. +: If you select color patches from the hue pickers without triggering the optimization, the software will only perform one round of optimization and then stop. This allows you to control each luminance range separately and avoid divergence of the solution in corner cases. The hue and saturation corrections are computed taking into account the two other luminance ranges and three factors, and will always output the complementary color of the selected area. If you want to reinforce the color of the area instead, you can then add 180° to the computed hue. Once patches are selected, the label changes to read “neutralize colors from patches”. To reset one patch you can just redo the selection. Patches are not saved in the parameters and are retained only during the current session. The parameters found by the automatic neutralization are accurate only in _slope, offset, power_ mode, but can work to some extent in _lift, gamma, gain_ mode too. diff --git a/content/module-reference/processing-modules/color-calibration.md b/content/module-reference/processing-modules/color-calibration.md index a9ddadbf91..4e8f647d44 100644 --- a/content/module-reference/processing-modules/color-calibration.md +++ b/content/module-reference/processing-modules/color-calibration.md @@ -48,7 +48,7 @@ To achieve this, create an instance of the _color calibration_ module to perform The default illuminant and color space used by the chromatic adaptation are initialised from the Exif metadata of the RAW file "as set in camera". -Alternatively you can use the color picker (to the right of the color patch) to select a neutral color from the image or, if one is unavailable, select the entire image. In this case, the algorithm finds the average color within the chosen area and sets that color as the illuminant. This method relies on the "gray-world" assumption, which predicts that the average color of a natural scene will be neutral. This method will not work for artificial scenes, for example those with painted surfaces. +Alternatively you can use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) (to the right of the color patch) to select a neutral color from the image or, if one is unavailable, select the entire image. In this case, the algorithm finds the average color within the chosen area and sets that color as the illuminant. This method relies on the "gray-world" assumption, which predicts that the average color of a natural scene will be neutral. This method will not work for artificial scenes, for example those with painted surfaces. - Select "_as shot in camera_" to restore the camera defaults and re-read the RAW Exif. @@ -91,7 +91,7 @@ illuminant : - _same as pipeline (D50)_: Do not perform chromatic adaptation in this module instance but just perform channel mixing, using the selected _adaptation_ color space. : - _CIE standard illuminant_: Choose from one of the CIE standard illuminants (daylight, incandescent, fluorescent, equi-energy, or black body), or a non-standard "LED light" illuminant. These values are all pre-computed -- as long as your camera sensor is properly profiled, you can just use them as-is. For illuminants that lie near the Planckian locus, an additional "temperature" control is also provided (see below). -: - _custom_: If a neutral gray patch is available in the image, the color of the illuminant can be selected using the color picker, or can be manually specified using hue and saturation sliders (in LCh perceptual color space). The color swatch next to the color picker shows the color of the calculated illuminant used in the CAT compensation. The color picker can also be used to restrict the area used for AI detection (below). +: - _custom_: If a neutral gray patch is available in the image, the color of the illuminant can be selected using the [picker](../../darkroom/processing-modules/module-controls.md#pickers), or can be manually specified using hue and saturation sliders (in LCh perceptual color space). The color swatch next to the picker shows the color of the calculated illuminant used in the CAT compensation. The picker can also be used to restrict the area used for AI detection (below). : - _(AI) detect from image surfaces_: This algorithm obtains the average color of image patches that have a high covariance between chroma channels in YUV space and a high intra-channel variance. In other words, it looks for parts of the image that appear as though they should be gray, and discards flat colored surfaces that may be legitimately non-gray. It also discards chroma noise as well as chromatic aberrations. : - _(AI) detect from image edges_: Unlike the _white balance_ module's auto-white-balancing which relies on the "gray world" assumption, this method auto-detects a suitable illuminant using the "gray edge" assumption, by calculating the Minkowski p-norm (p = 8) of the laplacian and trying to minimize it. That is to say, it assumes that edges should have the same gradient over all channels (gray edges). It is more sensitive to noise than the previous surface-based detection method. : - _as shot in camera_: Calculate the illuminant based on the white balance settings provided by the camera. @@ -261,7 +261,7 @@ The mapping process consists of two steps. There are two ways of setting the target chromaticity for your control sample: 1. if you know or expect an arbitrary color for the control sample (for example, a gray card, a color chart, a product or a logo of a specified color), you can set its L, h and c values directly, in Lch derived from CIE Lab 1976 space, -2. if you simply want to match the development of your reference image, set the _area mode_ to _measure_, then enable the color picker (to the right of the color patch) and draw a rectangle over your control sample. The _input_ column will then be updated with the L, h, c values of the control sample before the color correction, and the _target_ column will show the resulting L, h, c values of the control sample after the current calibration setting is applied. +2. if you simply want to match the development of your reference image, set the _area mode_ to _measure_, then enable the [picker](../../darkroom/processing-modules/module-controls.md#pickers) (to the right of the color patch) and draw a rectangle over your control sample. The _input_ column will then be updated with the L, h, c values of the control sample before the color correction, and the _target_ column will show the resulting L, h, c values of the control sample after the current calibration setting is applied. If you reset the L, h, c values, the default value is a neutral color at 50% lightness (middle-gray) -- this can be useful to quickly set the average white balance of any image. If you want to match the control sample against neutral gray, you only need to reset the chroma slider because the lightness and hue settings have no effect on chromaticity for neutral grays. @@ -277,7 +277,7 @@ The _take channel mixing into account_ option lets you choose where the target i ## step 2 : match the target -When you open a new image, the _area mode_ is automatically reset to _correction_. Using the color picker attached to the color patch, you can then directly reselect your control sample in the new image. The proper illuminant settings required for the control sample to match the memorized target chromaticity will be automatically computed, and the setting will be updated in the same operation. +When you open a new image, the _area mode_ is automatically reset to _correction_. Using the [picker](../../darkroom/processing-modules/module-controls.md#pickers) attached to the color patch, you can then directly reselect your control sample in the new image. The proper illuminant settings required for the control sample to match the memorized target chromaticity will be automatically computed, and the setting will be updated in the same operation. The _take channel mixing into account_ option will need to be set the same as when the measurement of the target was performed to ensure consistent results. Note that the target matching only defines the illuminant settings used in the Chromatic Adaptation Transform -- it does not alter the channel mixer settings, since the calibration is handled in the color checker calibration tool. However, the channel mixer settings can be used or discarded in the computation of the illuminant settings, depending on this option. @@ -332,7 +332,7 @@ In order to use this feature you will need to take a test shot of a supported co * frame the chart in the center 50% of the camera's field, to ensure that the image is free of vignetting, * ensure that the main light source is far enough from the chart to give an even lighting field over the surface of the chart, * adjust the angle between the light, chart and lens to prevent reflections and gloss on the color patches, -* for the best quality profile you should capture an image with the appropriate brightness. To achieve this, take a few bracketed images (between -1 and +1 EV) of your color checker and load them into darktable, ensuring that all modules between _color calibration_ and _output color profile_ are disabled. Choose the image where the white patch has a brightness L of 94-96% in CIE Lab space or a luminance Y of 83-88% in CIE XYZ space (use the global color picker). This step is not strictly necessary -- alternatively you can take a single image and apply the exposure compensation as recommended in the profile report. +* for the best quality profile you should capture an image with the appropriate brightness. To achieve this, take a few bracketed images (between -1 and +1 EV) of your color checker and load them into darktable, ensuring that all modules between _color calibration_ and _output color profile_ are disabled. Choose the image where the white patch has a brightness L of 94-96% in CIE Lab space or a luminance Y of 83-88% in CIE XYZ space (use the [global color picker](../utility-modules/darkroom/global-color-picker.md)). This step is not strictly necessary -- alternatively you can take a single image and apply the exposure compensation as recommended in the profile report. If the lighting conditions are close to a standard D50 to D65 illuminant (direct natural light, no colored bounced light), the color checker shot can be used to produce a generic profile that will be suitable for any daylight illuminant with only a slight adjustment of the white balance. @@ -432,5 +432,5 @@ It is possible to alleviate this issue, if you have a computer screen calibrated 1. Display a white surface on your screen, for example by opening a blank canvas in any photo editing software you like 2. Take a blurry (out of focus) picture of that surface with your camera, ensuring that you don't have any "parasite" light in the frame, you have no clipping, and are using an aperture between f/5.6 and f/8, -3. Open the picture in darktable and extract the white balance by using the color picker tool in the _white balance_ module on the center area of the image (non-central regions might be subject to chromatic aberrations). This will generate a set of 3 RGB coefficients. +3. Open the picture in darktable and extract the white balance by using the [picker](../../darkroom/processing-modules/module-controls.md#pickers) tool in the _white balance_ module on the center area of the image (non-central regions might be subject to chromatic aberrations). This will generate a set of 3 RGB coefficients. 4. [Save a preset](../../darkroom/processing-modules/presets.md#creating-and-editing-presets) for the _white balance_ module with these coefficients and auto-apply it to any color RAW image created by the same camera. diff --git a/content/module-reference/processing-modules/color-equalizer.md b/content/module-reference/processing-modules/color-equalizer.md index dc0669bef2..39c3f3b22c 100644 --- a/content/module-reference/processing-modules/color-equalizer.md +++ b/content/module-reference/processing-modules/color-equalizer.md @@ -12,7 +12,7 @@ This module is an attempt to recreate _some_ of the functionality of the [_color - a fixed number of equally-spaced adjustment nodes means a smoother adjustment curve - a guided filter is used, which attempts to smooth out changes by taking into account both the hue of the neighboring pixels and their overall saturation -The provided tabs can be used (either individually or in combination) to adjust the hue, saturation, and/or brightness at each of the color nodes. While the distance between nodes cannot be changed (see above), if you wish to target a specific hue that does not currently lie on a node, the "node placement" slider can be used to move all of the nodes simultaneously. The color picker can be used to display the color of a "picked" pixel or area on the curve adjustment section of the module to allow specific colors to be targeted. +The provided tabs can be used (either individually or in combination) to adjust the hue, saturation, and/or brightness at each of the color nodes. While the distance between nodes cannot be changed (see above), if you wish to target a specific hue that does not currently lie on a node, the "node placement" slider can be used to move all of the nodes simultaneously. The [picker](../../darkroom/processing-modules/module-controls.md#pickers) can be used to display the color of a "picked" pixel or area on the curve adjustment section of the module to allow specific colors to be targeted. --- @@ -30,7 +30,7 @@ You can also adjust the color nodes using sliders, which can be shown/hidden by As with sliders, you can also right-click on a node/slider to perform fine adjustments (see [module controls/sliders](../../darkroom/processing-modules/module-controls.md#sliders) for more details). -Use the color picker to choose a pixel or area on the image and show the hue of that pixel/area on the adjustment curve. +Use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to choose a pixel or area on the image and show the hue of that pixel/area on the adjustment curve. node placement : Adjust the position of all of the nodes simultaneously (move them left/right). diff --git a/content/module-reference/processing-modules/color-look-up-table.md b/content/module-reference/processing-modules/color-look-up-table.md index ace4f70470..deacf93c76 100644 --- a/content/module-reference/processing-modules/color-look-up-table.md +++ b/content/module-reference/processing-modules/color-look-up-table.md @@ -18,7 +18,7 @@ The input to this module is a list of source and target points and the complete color board : The color board grid shows a list of colored patches. The colors of the patches are the source points. The target color of the selected patch is shown as offsets which are controlled by sliders beneath the color board. An outline is drawn around patches that have been altered (where the source and target colors differ). -: Click a patch to select it, or use the combo box or color picker. The currently-selected patch is marked with a white square, and its number is displayed in the combo box below. +: Click a patch to select it, or use the combo box or [picker](../../darkroom/processing-modules/module-controls.md#pickers). The currently-selected patch is marked with a white square, and its number is displayed in the combo box below. : By default, the module will load the 24 patches of a classic color checker and initialise the mapping to identity (no change to the image). Configurations with more than 24 patches are shown in a 7x7 grid. @@ -27,6 +27,6 @@ interaction : Start with an appropriate palette of source colors (either from the presets menu or from a style you have downloaded). You can then change the lightness (L), green-red (a), blue-yellow (b), or saturation \(c\) of the patches' target values with the sliders. -: To change the source color of a patch you can select a new color from your image by using the color picker and Shift+click on the patch you want to replace. +: To change the source color of a patch you can select a new color from your image by using the [picker](../../darkroom/processing-modules/module-controls.md#pickers) and Shift+click on the patch you want to replace. : Double-click a patch to reset it; Right-click a patch to delete it; Shift+click on empty space to add a new patch (with the currently picked color as the source). diff --git a/content/module-reference/processing-modules/color-zones.md b/content/module-reference/processing-modules/color-zones.md index 1c9787885e..c48e7c73c8 100644 --- a/content/module-reference/processing-modules/color-zones.md +++ b/content/module-reference/processing-modules/color-zones.md @@ -67,11 +67,11 @@ Note that these examples are somewhat contrived in order to illustrate the modul # range selection -When adjusting the pixel manipulation curves, it can sometimes be difficult to judge exactly where on the horizontal axis pixels will fall. To the right of the tab controls are a pair of color pickers that can be used to assist with this. +When adjusting the pixel manipulation curves, it can sometimes be difficult to judge exactly where on the horizontal axis pixels will fall. To the right of the tab controls are a pair of [pickers](../../darkroom/processing-modules/module-controls.md#pickers) that can be used to assist with this. -If you click the left-hand color picker and choose a pixel in the image, you will see a dark vertical line showing where that pixel falls on the horizontal axis. If you Ctrl+click or right-click on the same color picker you can choose a rectangular area from the image -- the range of values represented within the selected rectangle will be shaded vertically, with a similar dark line showing the median value. +If you click the left-hand picker and choose a pixel in the image, you will see a dark vertical line showing where that pixel falls on the horizontal axis. If you Ctrl+click or right-click on the same picker you can choose a rectangular area from the image -- the range of values represented within the selected rectangle will be shaded vertically, with a similar dark line showing the median value. -If you click on the right-hand color picker, you can similarly choose a rectangular area on the image and the display will be shown as described above (a shaded area with a dark vertical line). However, in this case the color picker will also automatically add some control points to the curve for you, representing the highlighted range (see below). Simply drag on the center node to raise or lower the curve within the selected range. Alternatively, hold Ctrl while selecting a range to automatically create a positive curve (push up the selected range) or hold Shift while selecting to create a negative curve (pushed down). +If you click on the right-hand picker, you can similarly choose a rectangular area on the image and the display will be shown as described above (a shaded area with a dark vertical line). However, in this case the picker will also automatically add some control points to the curve for you, representing the highlighted range (see below). Simply drag on the center node to raise or lower the curve within the selected range. Alternatively, hold Ctrl while selecting a range to automatically create a positive curve (push up the selected range) or hold Shift while selecting to create a negative curve (pushed down). ![color zones overview](./color-zones/color-zones-overview.png#w33) @@ -99,4 +99,3 @@ mix interpolation method : Define how the curve is interpolated using the user-defined control points. See the [curves](../../darkroom/processing-modules/curves.md) section for more details. - diff --git a/content/module-reference/processing-modules/exposure.md b/content/module-reference/processing-modules/exposure.md index b901678075..3b17d2eab3 100644 --- a/content/module-reference/processing-modules/exposure.md +++ b/content/module-reference/processing-modules/exposure.md @@ -29,7 +29,7 @@ compensate camera exposure (manual mode) exposure (manual mode) : Increase (move to the right) or decrease (move to the left) the exposure value (EV). To adjust by more than the default limits shown on the slider, right click and enter the desired value up to +/-18 EV (see [module controls](../../darkroom/processing-modules/module-controls.md)). -: The color picker tool on the right sets the exposure such that the average of the selected region matches the target lightness defined in [area exposure mapping](#area-exposure-mapping) options. +: The [picker](../../darkroom/processing-modules/module-controls.md#pickers) tool on the right sets the exposure such that the average of the selected region matches the target lightness defined in [area exposure mapping](#area-exposure-mapping) options. percentile (automatic mode) : Define a location in the histogram to use for automatic exposure correction. A percentile of 50% denotes a position in the histogram where 50% of pixel values are above and 50% of pixel values are below that exposure. @@ -61,7 +61,7 @@ The mapping process consists of two steps. There are two ways of setting the target brightness for your control sample: 1. if you know or expect an arbitrary lightness for the control sample (for example, a gray card, a color chart, a product or a logo of a specified brightness), you can set its L value directly, in CIE Lab 1976 space, -2. if you simply want to match the development of your reference image, set the _area mode_ to _measure_, then enable the color picker (to the right of the _exposure_ slider) and draw a rectangle over your control sample. The _input_ column will then be updated with the lightness value of the control sample before the exposure correction, and the _target_ column will show the resulting lightness of the control sample after the current exposure setting is applied. +2. if you simply want to match the development of your reference image, set the _area mode_ to _measure_, then enable the [picker](../../darkroom/processing-modules/module-controls.md#pickers) (to the right of the _exposure_ slider) and draw a rectangle over your control sample. The _input_ column will then be updated with the lightness value of the control sample before the exposure correction, and the _target_ column will show the resulting lightness of the control sample after the current exposure setting is applied. If you reset the lightness value, the default value is 50% (middle-gray) -- this can be useful to quickly set the average exposure of any image. @@ -69,7 +69,7 @@ Note that the target value is not reset when you reset the module itself, but is ## step 2 : match the target -When you open a new image, the _area mode_ is automatically reset to _correction_. Using the color picker attached to the exposure slider, you can then directly reselect your control sample in the new image. The proper exposure setting required for the control sample to match the memorized target lightness will be automatically computed, and the setting will be updated in the same operation. +When you open a new image, the _area mode_ is automatically reset to _correction_. Using the [picker](../../darkroom/processing-modules/module-controls.md#pickers) attached to the exposure slider, you can then directly reselect your control sample in the new image. The proper exposure setting required for the control sample to match the memorized target lightness will be automatically computed, and the setting will be updated in the same operation. This operation can be repeated as many times as you have images in your series with no further work. diff --git a/content/module-reference/processing-modules/fill-light.md b/content/module-reference/processing-modules/fill-light.md index 55c3aaa308..84ab0b480f 100644 --- a/content/module-reference/processing-modules/fill-light.md +++ b/content/module-reference/processing-modules/fill-light.md @@ -25,7 +25,7 @@ exposure : The fill-light exposure (EV) center -: The median lightness impacted by the fill-light. The lightness must be set manually but a color picker can be used to provide a guide based on a sample from the image. The lightness of the selected point/area is displayed in the gradient bar. +: The median lightness impacted by the fill-light. The lightness must be set manually but a [picker](../../darkroom/processing-modules/module-controls.md#pickers) can be used to provide a guide based on a sample from the image. The lightness of the selected point/area is displayed in the gradient bar. width : The width of the Gaussian curve. This number is expressed in zones, with the full range being 10 zones. diff --git a/content/module-reference/processing-modules/filmic-rgb.md b/content/module-reference/processing-modules/filmic-rgb.md index 5ba64a5dbf..f78abdc2c8 100644 --- a/content/module-reference/processing-modules/filmic-rgb.md +++ b/content/module-reference/processing-modules/filmic-rgb.md @@ -116,7 +116,7 @@ dynamic range mapping The controls in the _scene_ tab are similar in principle to those of the [_levels_](./levels.md) module (black, gray, white). The difference is that _levels_ assumes display-referred pixels values (between 0 and 100%), whereas _filmic_ allows you to work on scene-referred pixels (between --infinity EV and +infinity EV), which forces the use of a different interface. middle-gray luminance (hidden by default) -: This setting allows you to decide what luminance in the scene should be considered the reference middle-gray (which will be remapped to 18% in display). Use the color picker tool to read the average luminance over the drawn area. If you have a photograph of a gray card or a color chart (IT8 chart or colorchecker) shot in the scene lighting conditions, then the gray color picker tool can be used to quickly sample the luminance of the gray patch on that image. In other situations, the color picker can be used to sample the average luminance of the subject. +: This setting allows you to decide what luminance in the scene should be considered the reference middle-gray (which will be remapped to 18% in display). Use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) tool to read the average luminance over the drawn area. If you have a photograph of a gray card or a color chart (IT8 chart or colorchecker) shot in the scene lighting conditions, then the gray picker tool can be used to quickly sample the luminance of the gray patch on that image. In other situations, the picker can be used to sample the average luminance of the subject. : This has an effect on the picture that is analogous to a brightness correction. Values close to 100% do not compress the highlights but fail to recover shadows. Values close to 0% greatly recover the shadows but compress the highlights more harshly and result in local-contrast losses. @@ -129,17 +129,17 @@ middle-gray luminance (hidden by default) --- white relative exposure -: The number of stops (EV) between the scene middle-gray luminance and the scene luminance to be remapped to display white (peak-white). This is the right bound of the scene dynamic range that will be represented on the display -- everything brighter than this value on the scene will be clipped (pure white) on the display. The color picker tool reads the maximum luminance in RGB space over the drawn area, assumes it is pure white, and sets the white exposure parameter to remap the maximum to 100% luminance. +: The number of stops (EV) between the scene middle-gray luminance and the scene luminance to be remapped to display white (peak-white). This is the right bound of the scene dynamic range that will be represented on the display -- everything brighter than this value on the scene will be clipped (pure white) on the display. The [picker](../../darkroom/processing-modules/module-controls.md#pickers) tool reads the maximum luminance in RGB space over the drawn area, assumes it is pure white, and sets the white exposure parameter to remap the maximum to 100% luminance. black relative exposure -: The number of stops (EV) between the scene middle-gray luminance and the scene luminance to be remapped to display black (maximum density). This is the left bound of the scene dynamic range that will be represented on the display -- everything darker than this value on the scene will be clipped (pure black) on the display. The color picker tool reads the minimum luminance in RGB space over the drawn area, assumes it is pure black, and sets the black exposure parameter to remap the minimum to 0% luminance. The black color picker measurement is very sensitive to noise, and cannot identify whether the minimum luminance is pure black (actual data) or just noise. It works better on low ISO pictures and with high quality demosaicing. When the color picker puts the black exposure at --16 EV, this is a sign that the measurement has failed and you will need to adjust it manually. +: The number of stops (EV) between the scene middle-gray luminance and the scene luminance to be remapped to display black (maximum density). This is the left bound of the scene dynamic range that will be represented on the display -- everything darker than this value on the scene will be clipped (pure black) on the display. The [picker](../../darkroom/processing-modules/module-controls.md#pickers) tool reads the minimum luminance in RGB space over the drawn area, assumes it is pure black, and sets the black exposure parameter to remap the minimum to 0% luminance. The black picker measurement is very sensitive to noise, and cannot identify whether the minimum luminance is pure black (actual data) or just noise. It works better on low ISO pictures and with high quality demosaicing. When the picker puts the black exposure at --16 EV, this is a sign that the measurement has failed and you will need to adjust it manually. : The black relative exposure allows you to choose how far you want to recover lowlights. dynamic range scaling and auto-tune -: The auto-tune color picker combines the above color pickers, and allows you to set the white and black exposures at the same time, using the maximum of the drawn region as the white and the minimum as the black. This gives good results in landscape photography but usually fails for portraits and indoor scenes. +: The auto-tune [picker](../../darkroom/processing-modules/module-controls.md#pickers) combines the above pickers, and allows you to set the white and black exposures at the same time, using the maximum of the drawn region as the white and the minimum as the black. This gives good results in landscape photography but usually fails for portraits and indoor scenes. -: When no true white and black are available on the scene, the maximum and minimum RGB values read on the image are not valid assumptions any more. Dynamic range scaling symmetrically shrinks or enlarges the detected dynamic range and the current parameters. This works with both color pickers, and adjusts the current values of white and black relative exposures. +: When no true white and black are available on the scene, the maximum and minimum RGB values read on the image are not valid assumptions any more. Dynamic range scaling symmetrically shrinks or enlarges the detected dynamic range and the current parameters. This works with both pickers, and adjusts the current values of white and black relative exposures. --- diff --git a/content/module-reference/processing-modules/framing.md b/content/module-reference/processing-modules/framing.md index 8c7fcc146c..fc93e3b353 100644 --- a/content/module-reference/processing-modules/framing.md +++ b/content/module-reference/processing-modules/framing.md @@ -34,8 +34,7 @@ frame line offset : The position of the frame line, relative to the underlying image. Choose 0% for a frame line that touches the image. Choose 100% for a frame line that touches the outer border. border color / frame line color -: A pair of color selectors which allow the border and frame line colors to be defined. Clicking on the colored field will open a color selector dialog which offers a choice of commonly-used colors, or allows you to define a color in RGB color space. You can also activate a color picker to take a color probe from the image. +: A pair of color selectors which allow the border and frame line colors to be defined. Clicking on the colored field will open a color selector dialog which offers a choice of commonly-used colors, or allows you to define a color in RGB color space. You can also activate a [picker](../../darkroom/processing-modules/module-controls.md#pickers) to take a color probe from the image. show guides : Tick the box to show guide overlays whenever the module is activated. Click the icon on the right to control the properties of the guides. See [guides & overlays](../utility-modules/darkroom/guides-overlays.md) for details. - diff --git a/content/module-reference/processing-modules/invert.md b/content/module-reference/processing-modules/invert.md index be9fc8095b..238c7454bc 100644 --- a/content/module-reference/processing-modules/invert.md +++ b/content/module-reference/processing-modules/invert.md @@ -20,4 +20,4 @@ Invert scanned negatives. # module controls color of film material -: Clicking on the colored field will open a color selector dialog which offers you a choice of commonly used colors, or allows you to define an RGB color. You can also activate the color picker to take a color probe from your image – preferably from the unexposed border of your negative. +: Clicking on the colored field will open a color selector dialog which offers you a choice of commonly used colors, or allows you to define an RGB color. You can also activate the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to take a color probe from your image – preferably from the unexposed border of your negative. diff --git a/content/module-reference/processing-modules/levels.md b/content/module-reference/processing-modules/levels.md index 3cb51426c9..e9e02c5966 100644 --- a/content/module-reference/processing-modules/levels.md +++ b/content/module-reference/processing-modules/levels.md @@ -26,7 +26,7 @@ manual : Moving the middle bar will modify the mid-tones. Move it to the left to make the image look brighter and move it to the right to make it darker. This is often referred to as changing the image's gamma. -: Three color pickers are available for sampling the black, white and gray points from the image. The "auto" button auto-adjusts the black and white point and puts the gray point exactly in the mean between them. +: Three [pickers](../../darkroom/processing-modules/module-controls.md#pickers) are available for sampling the black, white and gray points from the image. The "auto" button auto-adjusts the black and white point and puts the gray point exactly in the mean between them. automatic : The module automatically analyses the histogram of the image, detects the left and right histogram borders, and lets you define the black point, the gray point and the white point in terms of [percentiles](http://en.wikipedia.org/wiki/Percentile) relative to these borders. diff --git a/content/module-reference/processing-modules/monochrome.md b/content/module-reference/processing-modules/monochrome.md index d2193c1ce4..7c9499c88b 100644 --- a/content/module-reference/processing-modules/monochrome.md +++ b/content/module-reference/processing-modules/monochrome.md @@ -26,8 +26,7 @@ Although this module is easy to use, better results can usually be obtained by u filter size/position : The default central location of the filter has a neutral effect but dragging it to an alternate position applies a filter analogous to taking a b&w photograph through a conventional color filter. -: A color picker can be activated to automatically set the position and size of the filter based on the selected portion of the image. Scroll the mouse wheel to change the filter size, making the filter's range of hues more or less selective. +: A [picker](../../darkroom/processing-modules/module-controls.md#pickers) can be activated to automatically set the position and size of the filter based on the selected portion of the image. Scroll the mouse wheel to change the filter size, making the filter's range of hues more or less selective. highlights : Control how much to retain highlights. - diff --git a/content/module-reference/processing-modules/negadoctor.md b/content/module-reference/processing-modules/negadoctor.md index 4281136448..32a8de09c2 100644 --- a/content/module-reference/processing-modules/negadoctor.md +++ b/content/module-reference/processing-modules/negadoctor.md @@ -43,7 +43,7 @@ The _working profile_ parameter in darktable's [_input color profile_](input-col It is strongly recommended that you set the parameters following the order in which they are presented in the GUI. Start by setting the _film stock_, then work through each of the tabs ([_film properties_](#film-properties), [_corrections_](#corrections), [_print properties_](#print-properties)) in order, working from top to bottom in each tab. -When using color pickers, be careful to avoid including dust and scratches, which can skew the data taken from the sampled region. +When using ,[pickers](../../darkroom/processing-modules/module-controls.md#pickers) be careful to avoid including dust and scratches, which can skew the data taken from the sampled region. film stock : The first step is to choose "color" or "black and white" in the _film stock_ drop-down. If you select "black and white", any sliders that are only used for color will be hidden from view. @@ -53,16 +53,16 @@ film stock This tab contains a number of basic settings. If, after adjusting these settings, your image is still not quite as you would like it, you can make further adjustments on the [_corrections_](#corrections) tab. These are technical settings, and serve a similar purpose to the _scene_ tab in the [_filmic rgb_](filmic-rgb.md) module, in that they adjust the black and white points and hence define the dynamic range of the negative. color of the film base -: Sample an area of the base film stock from your scan. This is the area just outside of the image (an unexposed part of the film). If you are working with black and white negatives, you can leave this slider at its default value (white). If working on color film, click the color picker to the right of the color bar, which will create a bounding box covering about 98% of your image. Then, click and drag across an area of your negative which contains only unexposed film stock. This will automatically calculate values for the _D min_ slider(s). It is likely at this point that your image will still look too dark, but you can correct this later. +: Sample an area of the base film stock from your scan. This is the area just outside of the image (an unexposed part of the film). If you are working with black and white negatives, you can leave this slider at its default value (white). If working on color film, click the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to the right of the color bar, which will create a bounding box covering about 98% of your image. Then, click and drag across an area of your negative which contains only unexposed film stock. This will automatically calculate values for the _D min_ slider(s). It is likely at this point that your image will still look too dark, but you can correct this later. D min : If the _film stock_ is set to "black and white", this slider indicates the minimum value corresponding to the unexposed film stock. If the _film stock_ is set to "color", this control will consist of 3 separate sliders, one for each of the red, green and blue channels. D max -: This slider represents the dynamic range of your film, and it effectively sets the film's white point. Dragging this slider to the left will make the negative brighter. Dragging it to the right will make the negative darker. When adjusting this slider manually, it's a good idea to closely watch your histogram to ensure that you don't clip the highlights (where the histogram has been pushed over too far off the right hand side of the graph). If you click the color picker icon (on the right) negadoctor will automatically calculate this value to ensure maximal use of the histogram without clipping. To use the color picker, click and drag to draw a rectangle across only the exposed parts of the negative. Don't include the unexposed film stock, as this will skew the result. +: This slider represents the dynamic range of your film, and it effectively sets the film's white point. Dragging this slider to the left will make the negative brighter. Dragging it to the right will make the negative darker. When adjusting this slider manually, it's a good idea to closely watch your histogram to ensure that you don't clip the highlights (where the histogram has been pushed over too far off the right hand side of the graph). If you click the [picker](../../darkroom/processing-modules/module-controls.md#pickers) icon (on the right) negadoctor will automatically calculate this value to ensure maximal use of the histogram without clipping. To use the picker, click and drag to draw a rectangle across only the exposed parts of the negative. Don't include the unexposed film stock, as this will skew the result. scan exposure bias -: This slider allows you to set the black point. It is a technical adjustment that ensures a proper zeroing of the RGB values and a spreading of the histogram between [0, 1] values for robustness in the operations that follow. Dragging this to the left will make the negative brighter. Dragging to the right will make the negative darker. When adjusting this slider manually, it's a good idea to closely watch your histogram to ensure that you don't clip the shadows (where the histogram is pushed too far off the left hand side of the graph). If you click the color picker negadoctor will automatically calculate any required offset. To use the color picker, select a region in the darkest lowlights, or select the entire image without including any unexposed film stock. Double-check the histogram to ensure the left part of it doesn't clip. +: This slider allows you to set the black point. It is a technical adjustment that ensures a proper zeroing of the RGB values and a spreading of the histogram between [0, 1] values for robustness in the operations that follow. Dragging this to the left will make the negative brighter. Dragging to the right will make the negative darker. When adjusting this slider manually, it's a good idea to closely watch your histogram to ensure that you don't clip the shadows (where the histogram is pushed too far off the left hand side of the graph). If you click the [picker](../../darkroom/processing-modules/module-controls.md#pickers) negadoctor will automatically calculate any required offset. To use the picker, select a region in the darkest lowlights, or select the entire image without including any unexposed film stock. Double-check the histogram to ensure the left part of it doesn't clip. ## corrections @@ -73,10 +73,10 @@ The settings on this tab should not be needed for most well-preserved negatives. The other case where these color cast corrections may be needed is if the white balance properties of the light used to scan the film negative are significantly different to the light source under which the original film camera took the shot. For example, if you illuminate the film with an LED light, but the original shot was taken under daylight, this may require some additional color cast corrections. shadows color cast -: These three sliders allow you to correct for color casts in the shadows by adjusting the _red_, _green_ and _blue_ channels individually. Use the color picker to set the sliders automatically by selecting a neutral gray shadow region requiring correction. Because the shadows sliders can also affect color casts in the highlights, it is important to finish setting the shadows sliders before moving on to the highlights sliders. +: These three sliders allow you to correct for color casts in the shadows by adjusting the _red_, _green_ and _blue_ channels individually. Use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to set the sliders automatically by selecting a neutral gray shadow region requiring correction. Because the shadows sliders can also affect color casts in the highlights, it is important to finish setting the shadows sliders before moving on to the highlights sliders. highlights white balance -: These three sliders allow you to correct the white balance in the highlights by adjusting the _red_, _green_ and _blue_ channels individually. Use the color picker to set the sliders automatically by selecting a neutral gray region in the highlights that is not properly balanced. +: These three sliders allow you to correct the white balance in the highlights by adjusting the _red_, _green_ and _blue_ channels individually. Use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to set the sliders automatically by selecting a neutral gray region in the highlights that is not properly balanced. ## print properties @@ -87,7 +87,7 @@ The _print exposure_, _paper black_ and _paper grade_ are analogous to the _slop _RGB_out_ = ( _RGB_in_ × _exposure_ + _black_ ) ᵍʳᵃᵈᵉ paper black (density correction) -: For this slider, select the color picker and click and drag to select a region that encompasses only the exposed part of the film negative. If you can see unexposed film stock around the edges of your image, ensure that these areas are excluded from the drawn rectangle when calculating the _paper black_ setting. Paper black represents the density of the blackest silver-halide crystal available on the virtual paper. In the analog development process, this black density always results in non-zero luminance, but the digital pipeline usually expects black to be encoded with a zero RGB value. This slider setting lets you remap paper black to pipeline black via an offset. You can use the color picker to select a region of the image that should be mapped to black in the final image. +: For this slider, select the [picker](../../darkroom/processing-modules/module-controls.md#pickers) and click and drag to select a region that encompasses only the exposed part of the film negative. If you can see unexposed film stock around the edges of your image, ensure that these areas are excluded from the drawn rectangle when calculating the _paper black_ setting. Paper black represents the density of the blackest silver-halide crystal available on the virtual paper. In the analog development process, this black density always results in non-zero luminance, but the digital pipeline usually expects black to be encoded with a zero RGB value. This slider setting lets you remap paper black to pipeline black via an offset. You can use the picker to select a region of the image that should be mapped to black in the final image. paper grade (gamma) : This slider is your gamma (contrast) control, and it defaults to a value of 4. If all has gone well, this value (4) minus the value of D max (from the “film properties” tab) should normally leave you with a value between 2 and 3. @@ -96,5 +96,4 @@ paper gloss (specular highlights) : This slider is essentially a highlights compression tool. As you drag this slider to the left, you will see in the histogram that the highlight values are being compressed (pushed to the left). Adjust this accordingly, so that your highlights are not clipped in the histogram. You can also use this to simulate a matte photo print with low-contrast highlights. print exposure adjustment -: This slider offers one final opportunity to correct any clipping of the highlights. If you have followed all the previous instructions carefully, you shouldn't need to adjust this setting. Note that you can increase the print exposure while at the same time decreasing the paper gloss, which allows you to brighten the mid-tones without losing any highlights. You can use the color picker to select the brightest highlights, or select the entire image without including any unexposed film stock. This will set the exposure so that the brightest part of the selected region is not clipped. Double-check the histogram to make sure that the right part of the histogram doesn't clip. - +: This slider offers one final opportunity to correct any clipping of the highlights. If you have followed all the previous instructions carefully, you shouldn't need to adjust this setting. Note that you can increase the print exposure while at the same time decreasing the paper gloss, which allows you to brighten the mid-tones without losing any highlights. You can use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to select the brightest highlights, or select the entire image without including any unexposed film stock. This will set the exposure so that the brightest part of the selected region is not clipped. Double-check the histogram to make sure that the right part of the histogram doesn't clip. diff --git a/content/module-reference/processing-modules/retouch.md b/content/module-reference/processing-modules/retouch.md index f59dc9f950..956fdc7820 100644 --- a/content/module-reference/processing-modules/retouch.md +++ b/content/module-reference/processing-modules/retouch.md @@ -161,7 +161,7 @@ fill mode : If the _fill_ algorithm has been chosen for the currently-selected shape, choose whether to "erase" or fill the selected shape with a chosen "color". fill color -: If a _fill mode_ of "color" has been chosen, select the color to fill the shape with. You can click to select or enter a custom rgb value or use the color picker to take a sample from the image. +: If a _fill mode_ of "color" has been chosen, select the color to fill the shape with. You can click to select or enter a custom rgb value or use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to take a sample from the image. brightness : If the _fill_ algorithm has been chosen for the currently-selected shape, fine-tune the color's brightness. This slider also works in "erase" mode. diff --git a/content/module-reference/processing-modules/rgb-curve.md b/content/module-reference/processing-modules/rgb-curve.md index 64ff25e6b4..45851a45f4 100644 --- a/content/module-reference/processing-modules/rgb-curve.md +++ b/content/module-reference/processing-modules/rgb-curve.md @@ -13,9 +13,9 @@ A classic digital photography tool to alter an image's tones using curves. This module is very similar to the [_tone curve_](./tone-curve.md) module but works in RGB color space. -Activate the color picker on the left to show the picked values in the graph (Ctrl+click or right-click to use the picker in area mode). Numerical (Lab) values of the input and output (see below) at the selected spot or area are shown at the top left of the widget. +Activate the [picker](../../darkroom/processing-modules/module-controls.md#pickers) on the left to show the picked values in the graph (Ctrl+click or right-click to use the picker in area mode). Numerical (Lab) values of the input and output (see below) at the selected spot or area are shown at the top left of the widget. -A second color picker to the right can be used to automtaically create new nodes based on the sampled area. Ctrl+click+drag to alter the created nodes to have a positive curve for the selected area; Shift+click+drag to create a negative curve. +A second [picker](../../darkroom/processing-modules/module-controls.md#pickers) to the right can be used to automtaically create new nodes based on the sampled area. Ctrl+click+drag to alter the created nodes to have a positive curve for the selected area; Shift+click+drag to create a negative curve. # module controls diff --git a/content/module-reference/processing-modules/rgb-levels.md b/content/module-reference/processing-modules/rgb-levels.md index f5c719cb0f..504abf277a 100644 --- a/content/module-reference/processing-modules/rgb-levels.md +++ b/content/module-reference/processing-modules/rgb-levels.md @@ -17,7 +17,7 @@ Moving the black and white bars to match the left and right borders of the histo Moving the middle bar will modify the mid-tones. Move it to the left to make the image look brighter and move it to the right to make it darker. This is often referred to as changing the image's gamma. -Three color pickers are available for sampling the black, white and gray points from the image. +Three [pickers](../../darkroom/processing-modules/module-controls.md#pickers) are available for sampling the black, white and gray points from the image. --- @@ -31,7 +31,7 @@ mode : The mode of operation. "RGB, linked channels" (default) provides a single levels tool which updates all channels, taking into account the selected color preservation method (see "preserve colors" below). "RGB, independent channels" provides separate levels controls for each of the R, G and B channels. auto -: Auto-adjust the black and white point and put the gray point exactly in the mean between them. Use the color picker to auto-adjust based on a selected region of the image. +: Auto-adjust the black and white point and put the gray point exactly in the mean between them. Use the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to auto-adjust based on a selected region of the image. preserve colors : Choose a color preservation method when using "RGB, linked channels" mode (default "luminance"). diff --git a/content/module-reference/processing-modules/tone-curve.md b/content/module-reference/processing-modules/tone-curve.md index 152f890859..9b5579f4d5 100644 --- a/content/module-reference/processing-modules/tone-curve.md +++ b/content/module-reference/processing-modules/tone-curve.md @@ -13,7 +13,7 @@ A classic digital photography tool to alter the tones of an image's using curves This module is very similar to the [_rgb curve_](./rgb-curve.md) module but works in Lab color space. -Activate the color picker to show the picked values on the displayed histogram (Ctrl+click or right-click to use the picker in area mode). Numerical (Lab) values of the input and output (see below) at the selected spot or area are shown at the top left of the graph. +Activate the [picker](../../darkroom/processing-modules/module-controls.md#pickers) to show the picked values on the displayed histogram. Numerical (Lab) values of the input and output (see below) at the selected spot or area are shown at the top left of the graph. # module controls diff --git a/content/module-reference/utility-modules/darkroom/global-color-picker.md b/content/module-reference/utility-modules/darkroom/global-color-picker.md index 9419d71f66..1797ff391b 100644 --- a/content/module-reference/utility-modules/darkroom/global-color-picker.md +++ b/content/module-reference/utility-modules/darkroom/global-color-picker.md @@ -8,9 +8,9 @@ view: darkroom Take color samples from the current darkroom image, display their values in multiple ways and compare colors from different locations. -The color picker is activated by pressing the color picker icon. The module's parameters will remain in effect until you leave the darkroom mode. +The color picker is activated by pressing the [picker](../../darkroom/processing-modules/module-controls.md#pickers) icon. The module's parameters will remain in effect until you leave the darkroom mode. -Besides the global color picker described here, many darktable modules (e.g. [_tone curve_](../../processing-modules/tone-curve.md)) also contain local color pickers which are used to set individual module parameters. You should be aware that these two forms of color picker do not always work in the same color space. The global color picker works in the histogram color space and takes its samples after the complete pixelpipe has been processed. Local color pickers run in the color space of the module in which they are activated and reflect the input or output data of that module within the pixelpipe. +Besides the global color picker described here, many darktable modules (e.g. [_tone curve_](../../processing-modules/tone-curve.md)) also contain local pickers which are used to set individual module parameters. You should be aware that these two forms of picker do not always work in the same color space. The global color picker works in the histogram color space and takes its samples after the complete pixelpipe has been processed. Local pickers run in the color space of the module in which they are activated and reflect the input or output data of that module within the pixelpipe. You can right-click on the sampled color values to copy them to the clipboard. @@ -21,7 +21,7 @@ Hover over any of the color values to show a tooltip containing more detailed in # module controls point/area mode -: The global color picker can be activated in point or area mode by clicking or Ctrl+clicking on the color picker icon, respectively (you can also right-click to enable area mode). In point mode only a small spot under your cursor is taken as a sample. In area mode darktable samples the area within a drawn rectangle. +: The global color picker can be activated in point or area mode with the [picker](../../darkroom/processing-modules/module-controls.md#pickers) icon. In point mode only a small spot under your cursor is taken as a sample. In area mode darktable samples the area within a drawn rectangle. mean/min/max : If samples are taken in area mode, darktable will calculate mean, minimum and maximum color channel values. This combobox allows you to select which of those are displayed. For obvious statistical reasons mean, min and max are identical for the single sample of point mode. @@ -42,5 +42,4 @@ display samples on image/vectorscope : When this checkbox is ticked, live sample locations are visually indicated on the image and the vectorscope view of the [scopes](../shared/scopes.md#vectorscope) module. restrict scope to selection -: When this checkbox is ticked, only the values of the selected area or point are taken into account by the regular and waveform views of the [scopes](../shared/scopes.md) module. This allows you to see what tonal values are present in the selected area. When using a color picker in a processing module, this option restricts the scope to the picked area from the processing module instead of the global color picker. - +: When this checkbox is ticked, only the values of the selected area or point are taken into account by the regular and waveform views of the [scopes](../shared/scopes.md) module. This allows you to see what tonal values are present in the selected area. When using a picker in a processing module, this option restricts the scope to the picked area from the processing module instead of the global color picker. diff --git a/content/overview/workflow/process.md b/content/overview/workflow/process.md index 6ea40808b9..b1e5de8012 100644 --- a/content/overview/workflow/process.md +++ b/content/overview/workflow/process.md @@ -100,7 +100,7 @@ As you will be adjusting the tones and colors of the image, start by enabling [c --- -2. **Set white and black points**: The next two steps use the [_filmic rgb_](../../module-reference/processing-modules/filmic-rgb.md) module to define how the tones in your image will be mapped to the dynamic range of your display. Start by setting the _white_ and _black_ relative exposure sliders in the [_scene tab_](../../module-reference/processing-modules/filmic-rgb.md#scene). These are purely technical settings, defining white and black relative to the mid-gray point you set in the previous step. If your image contains tones you want to treat as pure white or pure black you can use the color pickers beside the sliders to set these values (using the maximum and minimum brightness of the image). Otherwise set the values manually using the color assessment frames as a reference. +2. **Set white and black points**: The next two steps use the [_filmic rgb_](../../module-reference/processing-modules/filmic-rgb.md) module to define how the tones in your image will be mapped to the dynamic range of your display. Start by setting the _white_ and _black_ relative exposure sliders in the [_scene tab_](../../module-reference/processing-modules/filmic-rgb.md#scene). These are purely technical settings, defining white and black relative to the mid-gray point you set in the previous step. If your image contains tones you want to treat as pure white or pure black you can use the [pickers](../../darkroom/processing-modules/module-controls.md#pickers) beside the sliders to set these values (using the maximum and minimum brightness of the image). Otherwise set the values manually using the color assessment frames as a reference. 3. **Adjust the contrast**: Now move to the [_look tab_](../../module-reference/processing-modules/filmic-rgb.md#look) in _filmic rgb_ (for now we will skip the [_reconstruct tab_](../../module-reference/processing-modules/filmic-rgb#reconstruct)). Enable the [_look only_ view](../../module-reference/processing-modules/filmic-rgb.md#graphic-display) at the top of the module to see a representation of the filmic tone curve, which consists of a straight section in the middle (used to set the contrast of the mid-tones) and curved sections at the top and bottom (where the shadows and highlights are compressed to fit the dynamic range of the display). diff --git a/content/preferences-settings/shortcuts.md b/content/preferences-settings/shortcuts.md index d8c09935df..4ba8761244 100644 --- a/content/preferences-settings/shortcuts.md +++ b/content/preferences-settings/shortcuts.md @@ -78,7 +78,7 @@ widget : Each visible part of the user interface is known as a _widget_. For example the darktable application window is a widget, containing side panel widgets, each of which contains module widgets, each of which contains button, slider and dropdown list widgets etc... When assigning a shortcut to an action, you must first decide which widget it is to be applied to. element -: An _element_ is the part of a UI widget that is affected by your shortcut. For example, for a slider that has a color picker, you can make a shortcut activate the color picker _button_ element or change the _value_ element of the slider. For a row of tabs (the row is a single widget) you can select which tab element to activate or use your mouse scroll wheel to scroll through the tabs. +: An _element_ is the part of a UI widget that is affected by your shortcut. For example, for a slider that has a [picker](../darkroom/processing-modules/module-controls.md#pickers), you can make a shortcut activate the picker _button_ element or change the _value_ element of the slider. For a row of tabs (the row is a single widget) you can select which tab element to activate or use your mouse scroll wheel to scroll through the tabs. effect : A shortcut can sometimes have multiple possible _effects_ on a given _element_. For example, a button can be activated as if it was pressed with a plain mouse-click or as if it was pressed with Ctrl+click. A slider's value can be edited, increased/decreased or reset. @@ -218,7 +218,7 @@ _zoom_ : Allows you to change the upper and lower bounds of the visual slider without altering the current value. _button_ -: A standard _button_ element that allows the button to the right of the slider (if present) to be activated. For example, a slider may include a color picker to visually set its value based on selected elements of the image. +: A standard _button_ element that allows the button to the right of the slider (if present) to be activated. For example, a slider may include a [picker](../darkroom/processing-modules/module-controls.md#pickers) to visually set its value based on selected elements of the image. You can alter the value of a slider more quickly or slowly than normal by defining the _speed_ of the action in the shortcut mapping screen. By default a _value_ (or _force_) effect is given a speed of 1.0, which means that it is changed at the default rate defined by the given slider. You can alter the slider more quickly by increasing the speed (a speed of 10 makes the action 10x faster) or more slowly by decreasing it (a speed of 0.1 makes the action 10x slower).