[digikam-doc] digikam: polish

Gilles Caulier caulier.gilles at gmail.com
Sun Aug 28 13:31:35 UTC 2016


Git commit 04286ca835af6f544b74c5c6a1a8207a1a2a4ff0 by Gilles Caulier.
Committed on 28/08/2016 at 13:31.
Pushed by cgilles into branch 'master'.

polish

M  +186  -137  digikam/editor-color.docbook

http://commits.kde.org/digikam-doc/04286ca835af6f544b74c5c6a1a8207a1a2a4ff0

diff --git a/digikam/editor-color.docbook b/digikam/editor-color.docbook
index 41fd81b..4078aaa 100644
--- a/digikam/editor-color.docbook
+++ b/digikam/editor-color.docbook
@@ -4,7 +4,8 @@
         <para>
             Here you can change the encoding depth per color channel of the edited image.
             8 bit encoding is the common JPEG format, 16 bit encoding is better suited for high quality images,
-            but this format needs more storage space, calculation time and is currently available with PNG, PNM, TIFF, and DNG formats only.
+            but this format needs more storage space, calculation time and is currently available with 
+            PNG, PGF, TIFF, and JPEG-2000 formats only.
         </para>
     </sect3>
 
@@ -14,7 +15,7 @@
             Its use is the change and assignment of color profiles. 
             Tone mapping can also be done from the lightness adjustment tab (bottom tab). 
             For detailed instructions on the use of color profiles, 
-            please refer to <ulink url="help:/digikam/using-setup.html#setup-iccprofiles">CM chapter</ulink>.
+            please refer to <ulink url="help:/digikam/using-setup.html#setup-iccprofiles">Color Management chapter</ulink>.
         </para>
     </sect3>
 
@@ -24,22 +25,35 @@
         <anchor id="bcgadjusttool.anchor"/>
 
         <para>
-            The simplest tool to use is the Brightness/Contrast/Gamma tool. It is also the least powerful, but in many cases it does everything you need. This tool is often useful for images that are overexposed or underexposed; it is not useful for correcting color casts. The tool gives you three sliders to adjust, for "Brightness", "Contrast" and "Gamma". You can see any adjustments you make reflected in the preview image. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect.
+            The simplest tool to use is the Brightness/Contrast/Gamma tool. 
+            It is also the least powerful, but in many cases it does everything you need. 
+            This tool is often useful for images that are overexposed or underexposed; 
+            it is not useful for correcting color casts. The tool gives you three sliders to adjust, for "Brightness", "Contrast" and "Gamma". 
+            You can see any adjustments you make reflected in the preview image. 
+            When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect.
         </para>
 
-        <example>  <title>The Brightness Contrast Gamma Tool in Action</title>
-            <screenshot><screeninfo>The Brightness Contrast Gamma Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editor-bcgadjust.png" format="PNG" /> </imageobject></mediaobject></screenshot>
+        <example>
+
+            <title>The Brightness Contrast Gamma Tool in Action</title>
+            <screenshot>
+                <screeninfo>The Brightness Contrast Gamma Tool in Action</screeninfo>
+                <mediaobject><imageobject><imagedata fileref="&path;editor-bcgadjust.png" format="PNG" />
+                </imageobject></mediaobject>
+            </screenshot>
+
         </example>
 
         <para>
-        Another important tool is called
-        <menuchoice><guimenu>Color</guimenu>
-        <guimenuitem>Levels Adjust</guimenuitem></menuchoice>. This tool provides an integrated way of seeing the results of adjusting multiple levels and also enables you to save level settings for application to multiple photographs. This can be useful if your camera or scanner often makes the same mistakes and you want to apply the same corrections. See the dedicated <link linkend="using-adjustlevels">Adjust Levels manual</link> for more information.
+            Another important tool is called <menuchoice><guimenu>Color</guimenu><guimenuitem>Levels Adjust</guimenuitem></menuchoice>.
+            This tool provides an integrated way of seeing the results of adjusting multiple levels and also enables you to save level 
+            settings for application to multiple photographs. This can be useful if your camera or scanner often makes the same mistakes 
+            and you want to apply the same corrections. See the dedicated <link linkend="using-adjustlevels">Adjust Levels manual</link> for more information.
         </para>
 
         <para>
-        A very powerful way of correcting exposure problems is to use the Adjust Curves tool available by <menuchoice><guimenu>Color</guimenu>
-        <guimenuitem>Curves Adjust</guimenuitem></menuchoice> menu entry.
+            A very powerful way of correcting exposure problems is to use the Adjust Curves tool available by <menuchoice><guimenu>Color</guimenu>
+            <guimenuitem>Curves Adjust</guimenuitem></menuchoice> menu entry.
         </para>
 
     </sect3>
@@ -348,167 +362,203 @@
         <anchor id="colorbalancetool.anchor"/>
 
         <para>
-        Digital cameras often have problems with lighting conditions and it is not unusual to want to correct the color contrast and brightness of a photograph. You can experiment with altering the levels of different aspects of your photographs using the tools under the
-        <menuchoice><guimenu>Color</guimenu>
-        </menuchoice> menu.
-        You can see any adjustments you make reflected in the preview. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect.
+            Digital cameras often have problems with lighting conditions and it is not unusual to want to correct the color contrast and brightness of a photograph. 
+            You can experiment with altering the levels of different aspects of your photographs using the tools under the
+            <menuchoice><guimenu>Color</guimenu></menuchoice> menu.
+            You can see any adjustments you make reflected in the preview. When you are happy with the results, 
+            press <guilabel>Ok</guilabel> and they will take effect.
         </para>
 
-        <example>  <title>The Color Balance Tool in Action</title>
-            <screenshot><screeninfo>The Color Balance Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editor-colorbalance.png" format="PNG" /> </imageobject></mediaobject></screenshot>
+        <example>
+
+            <title>The Color Balance Tool in Action</title>
+            <screenshot><screeninfo>
+                    The Color Balance Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editor-colorbalance.png" format="PNG" />
+            </imageobject></mediaobject>
+            </screenshot>
+
         </example>
 
         <anchor id="hsladjusttool.anchor"/>
 
         <para>
-        If your image is washed out (which can easily happen when you take images in bright light) try the Hue/Saturation/Lightness tool, which gives you three sliders to manipulate, for Hue, Saturation, and Lightness. Raising the saturation will probably make the image look better. In some cases, it is useful to adjust the lightness at the same time. ("Lightness" here is similar to "Brightness" in the Brightness/Contrast/Gamma tool, except that they are formed from different combinations of the red, green, and blue channels).
+            If your image is washed out (which can easily happen when you take images in bright light) try the Hue/Saturation/Lightness tool, 
+            which gives you three sliders to manipulate, for Hue, Saturation, and Lightness. 
+            Raising the saturation will probably make the image look better. In some cases, it is useful to adjust the lightness at the same time. 
+            ("Lightness" here is similar to "Brightness" in the Brightness/Contrast/Gamma tool, except that they are formed from different combinations 
+            of the red, green, and blue channels).
         </para>
 
         <para>
-        When you take images in low light conditions, you could get the opposite problem: too much saturation. In this case the Hue/Saturation tool is again a good one to use, only by reducing the saturation instead of increasing it. You can see any adjustments you make reflected in the preview image. When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect.
+            When you take images in low light conditions, you could get the opposite problem: too much saturation. 
+            In this case the Hue/Saturation tool is again a good one to use, only by reducing the saturation instead of increasing it. 
+            You can see any adjustments you make reflected in the preview image. 
+            When you are happy with the results, press <guilabel>Ok</guilabel> and they will take effect.
         </para>
 
-        <example>  <title>The Hue Saturation Lightness Tool in Action</title>
-            <screenshot><screeninfo>The Hue Saturation Lightness Tool in Action</screeninfo><mediaobject><imageobject><imagedata fileref="&path;editor-hsladjust.png" format="PNG" /> </imageobject></mediaobject></screenshot>
+        <example>
+
+            <title>The Hue Saturation Lightness Tool in Action</title>
+            <screenshot>
+                <screeninfo>The Hue Saturation Lightness Tool in Action</screeninfo>
+                    <mediaobject><imageobject><imagedata fileref="&path;editor-hsladjust.png" format="PNG" />
+                </imageobject></mediaobject>
+            </screenshot>
+
         </example>
 
     </sect3>
 
     <sect3 id="adjustlevels">
-    <sect3info>
+        <sect3info>
 
-    <title>Adjust Levels</title>
+        <title>Adjust Levels</title>
 
-    <abstract>
-    <para>
-    The &digikam; <emphasis>Adjust Levels</emphasis> is a tool to manually adjust the histogram channels of an image.
-    </para>
-    </abstract>
-
-    </sect3info>
-
-    <title>Introduction</title>
-
-    <para>
-    Situated between the more sophisticated Adjust Curves tool and the simpler Brightness/Contrast/Gamma Image Editor tool is this Adjust Levels tool for improving exposure. Although the dialog for this tool looks very complicated, for the basic usage we have in mind here, the only part you need to deal with is the
-    <guilabel>Input Levels</guilabel> area, concretely the 3 sliders that appear below the histogram.
-    </para>
-
-    <para>
-    This widget contains a visual graph of the intensity values of the active layer or selection (histogram).
-    Below the graph are five sliders that can be clicked into and dragged to constrain and change the intensity
-    level for the image. The left sliders position represents the dark areas and similarly,
-    the right position represents the light areas.
-    </para>
-
-    <sect4 id="using-adjustlevels">
-    <title>Using the Adjust Levels tool</title>
-
-    <para><inlinemediaobject><imageobject>
-        <imagedata fileref="&path;editor-levelsadjust.png" format="PNG" /> </imageobject>
-        <textobject><phrase>The Adjust Levels Tool Dialog</phrase></textobject></inlinemediaobject>
-    </para>
-
-    <para>
-    Actually the easiest way to learn how to use it is to experiment by moving the three sliders around,
-    and watching how the image is affected.
-    </para>
-
-    <para>
-    On the right, both an original and a target preview image is available. The target preview is updated dynamically according to the slider positions. On the left, the following options are available:
-
-    <itemizedlist>
-
-    <listitem><para>
-    Modify levels for <guilabel>Channel</guilabel> : this combo box allows the selection of the specific
-    channel that will be modified by the tool:
-
-        <itemizedlist>
-            <listitem><para><guilabel>Luminosity</guilabel>: this option makes intensity changes against
-            all pixels in the image.</para></listitem>
-            <listitem><para><guilabel>Red</guilabel>: this option makes Red saturation changes against
-            all pixels in the image.</para></listitem>
-            <listitem><para><guilabel>Green</guilabel>: this option makes Green saturation changes against
-            all pixels in the image.</para></listitem>
-            <listitem><para><guilabel>Blue</guilabel>: this option makes Blue saturation changes against
-            all pixels in the image.</para></listitem>
-            <listitem><para><guilabel>Alpha</guilabel>: this option makes transparency changes against
-            all pixels in the image.</para></listitem>
-        </itemizedlist>
+        <abstract>
+        <para>
+            The &digikam; <emphasis>Adjust Levels</emphasis> is a tool to manually adjust the histogram channels of an image.
+        </para>
+        </abstract>
 
-    </para></listitem>
+        </sect3info>
 
-    <listitem><para>Set <guilabel>Scale</guilabel> for channel : this combo controls whether the histogram
-    will be displayed using a linear or logarithmic amplitude. For images taken with a digital camera, the linear
-    mode is usually the most useful. However, for images that contain substantial areas of constant color a
-    linear histogram will often be dominated by a single bar. In this case a logarithmic histogram will often
-    be more useful.</para></listitem>
+        <title>Introduction</title>
 
-    <listitem><para><guilabel>Input Levels</guilabel>: the input levels allow manual adjustments to
-    be selected for each of the ranges. The main area is a graphic representation of image dark, mid and light tones content. They are on abscissa from level 0 (black) to level 255 (white).
-    Pixel number for a level is on ordinate axis. The curve surface represents all the pixels of the image for the selected channel (histogram). A well balanced image is an image with levels
-    (tones) distributed all over the whole range. An image with a predominant blue color, for example,
-    will produce a histogram shifted to the left in Green and Red channels, manifested by green and
-    red color lacking on highlights. The level ranges can be modified in three ways:
-        <itemizedlist>
-            <listitem><para>
-            Three sliders: the first on the top for dark tones, the second one for light tones, and the last one on the bottom for midtones (often called Gamma value).
-            </para></listitem>
-            <listitem><para>
-            Three input boxes to enter values directly.
-            </para></listitem>
-            <listitem><para>
-            Three Color Picker buttons using the original photo preview to automatically adjust inputs levels settings for shadow, midtone and highlights. There is also a fully automated adjustment button available next to the reset button.
-            </para></listitem>
-        </itemizedlist>
-    </para></listitem>
+        <para>
+            Situated between the more sophisticated Adjust Curves tool and the simpler Brightness/Contrast/Gamma Image Editor tool 
+            is this Adjust Levels tool for improving exposure. Although the dialog for this tool looks very complicated, 
+            for the basic usage we have in mind here, the only part you need to deal with is the
+            <guilabel>Input Levels</guilabel> area, concretely the 3 sliders that appear below the histogram.
+        </para>
 
-    <listitem><para><guilabel>Output Levels</guilabel>: the output levels allow manual selection
-    of a narrowed-down output level range. There are also two sliders located here that can be used
-    to interactively change the output levels like <guilabel>Input Levels</guilabel>.
-    This output level compression may, for example, be used to create a bleached image as a background for some other subject to put into the foreground.</para></listitem>
+        <para>
+            This widget contains a visual graph of the intensity values of the active layer or selection (histogram).
+            Below the graph are five sliders that can be clicked into and dragged to constrain and change the intensity
+            level for the image. The left sliders position represents the dark areas and similarly,
+            the right position represents the light areas.
+        </para>
 
-    <listitem><para><guilabel>Auto</guilabel>: this button performs an automatic setting of the
-    levels based on the pixel intensities of the image.</para></listitem>
+        <sect4 id="using-adjustlevels">
+            <title>Using the Adjust Levels tool</title>
 
-    <listitem><para><guilabel>Save As</guilabel> and <guilabel>Load</guilabel>: these buttons are used
-    to do just that. Any Levels that you have set can be saved to the filesystem and loaded later.
-    The used file format is The Gimp Levels format.</para></listitem>
+            <para>
+                <inlinemediaobject><imageobject>
+                    <imagedata fileref="&path;editor-levelsadjust.png" format="PNG" /> </imageobject>
+                    <textobject><phrase>The Adjust Levels Tool Dialog</phrase></textobject>
+                </inlinemediaobject>
+            </para>
 
-    <listitem><para><guilabel>Reset All</guilabel>: this button reset all
-    <guilabel>Input Levels</guilabel> and <guilabel>Output Levels</guilabel> values for all
-    channels.</para></listitem>
+            <para>
+                Actually the easiest way to learn how to use it is to experiment by moving the three sliders around,
+                and watching how the image is affected.
+            </para>
 
-    </itemizedlist>
-    </para>
+            <para>
+                On the right, both an original and a target preview image is available. 
+                The target preview is updated dynamically according to the slider positions. On the left, the following options are available:
+
+                <itemizedlist>
+
+                <listitem><para>
+                Modify levels for <guilabel>Channel</guilabel> : this combo box allows the selection of the specific
+                channel that will be modified by the tool:
+
+                    <itemizedlist>
+                        <listitem><para><guilabel>Luminosity</guilabel>: this option makes intensity changes against
+                        all pixels in the image.</para></listitem>
+                        <listitem><para><guilabel>Red</guilabel>: this option makes Red saturation changes against
+                        all pixels in the image.</para></listitem>
+                        <listitem><para><guilabel>Green</guilabel>: this option makes Green saturation changes against
+                        all pixels in the image.</para></listitem>
+                        <listitem><para><guilabel>Blue</guilabel>: this option makes Blue saturation changes against
+                        all pixels in the image.</para></listitem>
+                        <listitem><para><guilabel>Alpha</guilabel>: this option makes transparency changes against
+                        all pixels in the image.</para></listitem>
+                    </itemizedlist>
+
+                </para></listitem>
+
+                <listitem><para>Set <guilabel>Scale</guilabel> for channel : this combo controls whether the histogram
+                will be displayed using a linear or logarithmic amplitude. For images taken with a digital camera, the linear
+                mode is usually the most useful. However, for images that contain substantial areas of constant color a
+                linear histogram will often be dominated by a single bar. In this case a logarithmic histogram will often
+                be more useful.</para></listitem>
+
+                <listitem><para><guilabel>Input Levels</guilabel>: the input levels allow manual adjustments to
+                be selected for each of the ranges. The main area is a graphic representation of image dark, mid and light tones content. They are on abscissa from level 0 (black) to level 255 (white).
+                Pixel number for a level is on ordinate axis. The curve surface represents all the pixels of the image for the selected channel (histogram). A well balanced image is an image with levels
+                (tones) distributed all over the whole range. An image with a predominant blue color, for example,
+                will produce a histogram shifted to the left in Green and Red channels, manifested by green and
+                red color lacking on highlights. The level ranges can be modified in three ways:
+                    <itemizedlist>
+                        <listitem><para>
+                        Three sliders: the first on the top for dark tones, the second one for light tones, and the last one on the bottom for midtones (often called Gamma value).
+                        </para></listitem>
+                        <listitem><para>
+                        Three input boxes to enter values directly.
+                        </para></listitem>
+                        <listitem><para>
+                        Three Color Picker buttons using the original photo preview to automatically adjust inputs levels settings for shadow, midtone and highlights. There is also a fully automated adjustment button available next to the reset button.
+                        </para></listitem>
+                    </itemizedlist>
+                </para></listitem>
+
+                <listitem><para><guilabel>Output Levels</guilabel>: the output levels allow manual selection
+                of a narrowed-down output level range. There are also two sliders located here that can be used
+                to interactively change the output levels like <guilabel>Input Levels</guilabel>.
+                This output level compression may, for example, be used to create a bleached image as a background for some other subject to put into the foreground.</para></listitem>
+
+                <listitem><para><guilabel>Auto</guilabel>: this button performs an automatic setting of the
+                levels based on the pixel intensities of the image.</para></listitem>
+
+                <listitem><para><guilabel>Save As</guilabel> and <guilabel>Load</guilabel>: these buttons are used
+                to do just that. Any Levels that you have set can be saved to the filesystem and loaded later.
+                The used file format is The Gimp Levels format.</para></listitem>
+
+                <listitem><para><guilabel>Reset All</guilabel>: this button reset all
+                <guilabel>Input Levels</guilabel> and <guilabel>Output Levels</guilabel> values for all
+                channels.</para></listitem>
+
+                </itemizedlist>
+            </para>
 
-    <para>
-    The Adjust Levels tool has several features to facilitate the positioning input levels sliders. Clicking the mouse button in the original image preview area produces a vertical doted bar in the graph area of the histogram. The bar position corresponds to the pixel value under the mouse cursor in the image window. Clicking and dragging the mouse button interactively updates the position of the vertical bar. In this way it is possible to see where different pixel values in the image are located on the input levels sliders and helps to discover the locations of shadow, midtone, and highlight pixels.
-    </para>
+            <para>
+                The Adjust Levels tool has several features to facilitate the positioning input levels sliders. 
+                Clicking the mouse button in the original image preview area produces a vertical doted bar in the graph area of the histogram. 
+                The bar position corresponds to the pixel value under the mouse cursor in the image window. Clicking and dragging the mouse button 
+                interactively updates the position of the vertical bar. In this way it is possible to see where different pixel values in the image 
+                are located on the input levels sliders and helps to discover the locations of shadow, midtone, and highlight pixels.
+            </para>
 
-    <para>
-    Using in this mode and the three <guilabel>Color Picker</guilabel> buttons will automatically adjust input levels settings in all channels for shadow, middle, and highlight tones. Enable the color picker button that you want use, and click on the original image preview area to set input levels on each of the Red, Green, Blue, and Luminosity histogram channels.
-    </para>
+            <para>
+                Using in this mode and the three <guilabel>Color Picker</guilabel> buttons will automatically adjust input levels settings in all channels for 
+                shadow, middle, and highlight tones. Enable the color picker button that you want use, and click on the original image preview area to set input 
+                levels on each of the Red, Green, Blue, and Luminosity histogram channels.
+            </para>
 
-    <para>
-    <guilabel>Over Exposure Indicator</guilabel> option checks all color channel to see if more than one channel in a pixel is over-exposed, and you will see the combined color resulting of channel level settings. This feature is available as an indicator in the target preview area and has no effect on final rendering.
-    </para>
+            <para>
+                <guilabel>Over Exposure Indicator</guilabel> option checks all color channel to see if more than one channel in a pixel is over-exposed, 
+                and you will see the combined color resulting of channel level settings. 
+                This feature is available as an indicator in the target preview area and has no effect on final rendering.
+            </para>
 
-    </sect4>
+            </sect4>
 
-    <sect4 id="inaction-adjustlevels">
-    <title>The Adjust Levels tool in action</title>
+        <sect4 id="inaction-adjustlevels">
+        <title>The Adjust Levels tool in action</title>
 
-    <para>
-    Below, you can see an <guilabel>Input levels</guilabel> adjustment example applied to a color image for the Red/Green/Blue channels. Intensity/Alpha channels and <guilabel>Output Levels</guilabel> are unchanged. The original image is (1), the corrected image (2).
-    </para>
+        <para>
+            Below, you can see an <guilabel>Input levels</guilabel> adjustment example applied to a color image for the Red/Green/Blue channels. Intensity/Alpha channels and <guilabel>Output Levels</guilabel> are unchanged. The original image is (1), the corrected image (2).
+        </para>
 
-    <para><inlinemediaobject><imageobject>
-        <imagedata fileref="&path;editor-levels-preview.png" format="PNG" /> </imageobject>
-        <textobject><phrase>The Adjust Levels Tool in Action</phrase></textobject></inlinemediaobject>
-    </para>
+        <para>
+            <inlinemediaobject>
+                <imageobject><imagedata fileref="&path;editor-levels-preview.png" format="PNG" /> </imageobject>
+                <textobject><phrase>The Adjust Levels Tool in Action</phrase></textobject>
+            </inlinemediaobject>
+        </para>
 
-    </sect4>
+        </sect4>
     </sect3>
 
     <sect3 id="adjustcurves">
@@ -949,4 +999,3 @@ sgml-omittag: nil
 sgml-shorttag: t
 End:
 -->
-


More information about the kde-doc-english mailing list