[gimp-help] Fix #60: update documentation for Compose/Decompose plugins
- From: Jacob Boerema <jboerema src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help] Fix #60: update documentation for Compose/Decompose plugins
- Date: Thu, 22 Sep 2022 02:35:48 +0000 (UTC)
commit 3eba67a1a625f8dc94c68b7d428597a28a04f8f6
Author: Jacob Boerema <jgboerema gmail com>
Date: Wed Sep 21 22:27:11 2022 -0400
Fix #60: update documentation for Compose/Decompose plugins
(cherry picked from commit 497c755f40930e27362f77e87eea90793308acea)
src/menus/colors/components/compose.xml | 14 ++--
src/menus/colors/components/decompose.xml | 129 +++++++++++++++++-------------
2 files changed, 80 insertions(+), 63 deletions(-)
---
diff --git a/src/menus/colors/components/compose.xml b/src/menus/colors/components/compose.xml
index a3e188060..edff968d0 100644
--- a/src/menus/colors/components/compose.xml
+++ b/src/menus/colors/components/compose.xml
@@ -56,8 +56,8 @@
</figure>
<para>
This command constructs an image from several grayscale images or
- layers, for instance from extracted RGB, HSV... components. You can also
- build an image from grayscale images or layers created independently.
+ layers, for instance from extracted RGB, HSV, etc. components. You can
+ also build an image from grayscale images or layers created independently.
</para>
</sect3>
@@ -94,8 +94,8 @@
<term>Compose Channels</term>
<listitem>
<para>
- You can select there the color space to be used: RGB, HSV...
- The options are described in the following
+ Here you can select the color space to be used: RGB, HSV...
+ The available options are described in the
<link linkend="plug-in-decompose-registered">Decompose</link>
command.
</para>
@@ -105,7 +105,7 @@
<term>Channel Representation</term>
<listitem>
<para>
- Allows you to select which channel will be affected to each image
+ Allows you to select which layer or image will be used for each
channel. You may use this option, for example, to exchange color
channels:
</para>
@@ -161,8 +161,8 @@
</variablelist>
<tip>
<para>
- If Compose options are different from Decompose ones, for
- instance an image decomposed to
+ If you use different settings in Compose than when you used Decompose,
+ for instance an image decomposed to
<link linkend="glossary-rgb">RGB</link> then re-composed to
<link linkend="glossary-lab">LAB</link>, you will get
interesting color effects. Test it!
diff --git a/src/menus/colors/components/decompose.xml b/src/menus/colors/components/decompose.xml
index 8196b9590..2510c745d 100644
--- a/src/menus/colors/components/decompose.xml
+++ b/src/menus/colors/components/decompose.xml
@@ -13,9 +13,18 @@
<indexterm>
<primary>CMYK</primary>
</indexterm>
+ <indexterm>
+ <primary>HSL</primary>
+ </indexterm>
<indexterm>
<primary>HSV</primary>
</indexterm>
+ <indexterm>
+ <primary>LAB</primary>
+ </indexterm>
+ <indexterm>
+ <primary>LCH</primary>
+ </indexterm>
<indexterm>
<primary>RGB</primary>
</indexterm>
@@ -139,16 +148,21 @@
<term>RGB</term>
<listitem>
<para>
- If the RGB radio button is clicked, a grey level image is
- created with three layers (Red, Green and Blue), and two
- channels (Grey and Alpha).
+ If the RGB option is chosen, a gray level image is created
+ with three layers (Red, Green and Blue), and two channels
+ (Gray and Alpha).
</para>
<para>
- This function is interesting when using Threshold tool. You
- can also perform operations like cutting, pasting or moving
- selections in a single RBG channel. You can use an
- extracted grayscale as a selection or mask by saving it in
- a channel (right-click>Select>Save to a channel).
+ This function is interesting when using the Threshold tool.
+ You can also perform operations like cutting, pasting or
+ moving selections in a single RBG channel. You can use an
+ extracted grayscale layer as a selection or mask by saving it
+ in a channel (select the whole or a part of the layer, then
+ <menuchoice>
+ <guimenu>Select</guimenu>
+ <guimenuitem>Save to a channel</guimenuitem>
+ </menuchoice>
+ ).
</para>
</listitem>
</varlistentry>
@@ -156,28 +170,41 @@
<term>RGBA</term>
<listitem>
<para>
- If the RGBA radio button is clicked, an image is created
+ If the RGBA option is chosen, an image is created
similar to the RGB Decomposing with an additional Alpha
- layer filled with the transparencies values of the source
- image. Full transparent pixels are black and the full
+ layer filled with the transparency values of the source
+ image. Fully transparent pixels are black and fully
opaque pixels are white.
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>Alpha</term>
+ <listitem>
+ <para>
+ This option extracts the image transparency stored in the
+ Alpha channel in the
+ <link linkend="gimp-channel-dialog">Channel dialog</link>
+ in a separate image. The fully transparent pixels are Black
+ the fully opaque pixels are white. The graytones are smooth
+ transitions of the transparency in the source image.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term>HSV</term>
<listitem>
<para>
- This option decomposes image into three greyscaled layers,
+ This option decomposes image into three grayscale layers,
one for Hue, one for Saturation and another for Value.
</para>
<para>
- Although <guilabel>Hue</guilabel> is greyscaled, it does
+ Although <guilabel>Hue</guilabel> is grayscale, it does
represent hues. In color circle, white and black are
starting and arrival points and are superimposed. They
- represent Red color at top of circle. Grey intermediate
+ represent Red color at top of circle. Gray intermediate
levels are corresponding to intermediate hues on circle:
- dark grey to orange, mid grey to green and light grey to
+ dark gray to orange, mid gray to green and light gray to
magenta.
</para>
<para><guilabel>Saturation</guilabel> and
@@ -197,50 +224,25 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term>CMY</term>
- <listitem>
- <para>
- This option decomposes image into three greyscaled layers,
- one for Yellow, one for Magenta and another for Cyan.
- </para>
- <para>
- This option might be useful to transfer image into printing
- software with CMY capabilities.
- </para>
- </listitem>
- </varlistentry>
<varlistentry>
<term>CMYK</term>
<listitem>
<para>
- This option is similar to the <guilabel>CMY Decomposing
- </guilabel> with an additional layer for Black.
+ This option decomposes an image into four grayscale layers,
+ one for Yellow, one for Magenta, one for Cyan, and one for
+ Black.
</para>
<para>
- This option might be useful to transfer image into printing
+ This option can be useful to transfer an image into printing
software with CMYK capabilities.
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term>Alpha</term>
- <listitem>
- <para>
- This option extracts the image transparency stored in the
- Alpha channel in
- <link linkend="gimp-channel-dialog">Channel dialog</link>
- in a separate image. The full transparent pixels are Black
- the full opaque pixels are white. The graytones are smooth
- transitions of the transparency in the source image.
- </para>
- </listitem>
- </varlistentry>
<varlistentry>
<term>LAB</term>
<listitem>
<para>
- This option decomposes image into three greyscaled layers,
+ This option decomposes image into three grayscale layers,
layer <quote>L</quote> for Luminance, layer
<quote>A</quote> for colors between green and red, layer
<quote>B</quote> for colors between blue and yellow.
@@ -254,22 +256,38 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>YCbCr</term>
+ <term>LCH</term>
+ <listitem>
+ <para>
+ This option decomposes image into three grayscale layers,
+ layer <quote>L</quote> for Luminance, layer <quote>C</quote>
+ for Chroma, and layer <quote>H</quote> for Hue.
+ </para>
+ <para>
+ The LCH Decomposing is a color model of the Luminance-Color
+ family.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>YCbCr ITU R470, YCbCr ITU R470 256, YCbCr ITU R709,
+ YCbCr ITU R709 256</term>
<listitem>
<para>
- In <acronym>GIMP</acronym> there is four YCbCr
+ In <acronym>GIMP</acronym> there are four YCbCr
decompositions with different values.
- Each option decomposes image in three greyscaled layers, a
- layer for Luminance and two other for blueness and redness.
+ Each option decomposes an image in three grayscale layers, a
+ layer for Luminance and the other two layers for blueness
+ and redness.
</para>
<para>
- The YCbCr color model also called YUV is now used for
+ The YCbCr color model, also called YUV, is now used for
digital video (initially for PAL analog video). It's based
on the idea that the human eye is most sensitive to
- luminosity, next to colors. The YCbCr Decomposing use a
+ luminosity, next to colors. The YCbCr Decomposing uses a
transformation matrix and the different options are
different values recommended by ITU (International
- Telecommunication Union) applied to the matrix .
+ Telecommunication Union) applied to the matrix.
</para>
</listitem>
</varlistentry>
@@ -282,11 +300,10 @@
<term>Decompose to Layers</term>
<listitem>
<para>
- If this option is checked, a new grey-scaled image is created,
+ If this option is checked, a new grayscale image is created,
with each layer representing one of the channels of the selected
- mode. If this option is not checked, every channel is represented
- with a specific image automatically and clearly named in the name
- bar.
+ mode. If this option is unchecked, every channel is represented
+ in its own image and clearly named in the name bar.
</para>
</listitem>
</varlistentry>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
