Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation



On 03/26/2017 04:21 PM, Julien Hardelin wrote:
In a tutorial, we use only some features of a dialog.

Gimp-help menus are not tutorials. They are references, and so, each
feature of a dialog must be described. Some are common to several
commands; they can be grouped in a common-features file.

You can't leave the Advanced option unexplained; you must explain, as
you did here, why you can't develop explanations nor give an example. Or
what will users think?

The Advanced options, along with Split View, Presets, and Preview, are common to *all* Color and Filter operations.

I don't think it's appropriate to add an explanation about the Advanced options to each and every Color and Filter page in gimp help.

To speak as plainly and clearly as possible, I will not add documentation regarding the Advanced options to the patch I'm working on for the desaturate menu.


In your file, we don't see that Luminance, Luma... belong to Mode.

I don't understand what you mean. Do you want a screenshot of the expanded desaturate drop down menu? Will this suffice to show that "Luminance, Luma . . . belong to Mode"? Or do you mean something else altogether?


No, it is not necessary to do more about these Mode options: "Five
options are available " is enough

I don't understand what you mean. Do you want me to remove something that appears in the following file, and perhaps move it to a tutorial?

http://ninedegreesbelow.com/files/desaturate/8-18-desaturate.html

If you do want me to remove something from what appears in the above link, please be very, very specific, as I'm having a difficult time grasping what you are trying to say. My apologies, my communications skills seem to be at an all-time low.

Best regards,
Elle


Julien


Le 26/03/2017 à 18:22, Elle Stone a écrit :
On 03/26/2017 10:58 AM, Elle Stone wrote:

    2- Mode
            * Luminance
            * Luma
            * Lightness
            * Average
            * Value
    3- Advanced options
            * Apply filter to the layer's RAW pixels: with an example

If the above means that there should be documentation for the five
Modes and *also* for "Advanced options/Apply filter to the layer's RAW
pixels", I don't think adding documentation for "Advanced options
Apply filter to the layer's RAW pixels" to the desaturate help (or any
other help page for a specific editing option) is a good idea.

Just one example wouldn't do as it would be misleading. Between the
gamma hack and the "color managed" option there are four possible
combinations for the user to choose among, for each desaturate mode:

* The precise effect of each combination of "mode+using or not using
the advanced options" does vary depending on whether the operation in
question requests linearized RGB or RGB encoded using the sRGB TRC. So
for example the effect when choosing Luminance is different from the
effect when using Luma.

*The precise effect also varies depending on whether the image is at
"linear" or "perceptual" precision.

* It seems, though I'm not 100% certain, that the effect also depends
on whether there has been any previous "making of a new profile from a
pre-existing non-GIMP-built-in profile", which in turn depends on
whether the image had an embedded linear gamma ICC profile and whether
the image has been promoted to 32f with linear precision and then
possibly back to gamma precision, and on whether the user has chosen
to automatically promote to 32f in Preferences.

In other words, accurately explaining the possible results from using
the Advanced Color Options in the Desaturate dialog would require a
flow chart in order to explain what happens when using which
combination of the Advanced Color Options given X current precision, Y
previous precision changes and Z original non-sRGB embedded ICC
profile, combined with the choice amongst the various modes for
converting to black and white that the user has made.

I'd very much prefer to not create such a flow chart, especially since
the code for the relevant factors affecting the outcome of any given
set of choices+previous-precision-changes is still in a state of flux.

Best,
L
_______________________________________________
gimp-docs-list mailing list
gimp-docs-list gnome org
https://mail.gnome.org/mailman/listinfo/gimp-docs-list


_______________________________________________
gimp-docs-list mailing list
gimp-docs-list gnome org
https://mail.gnome.org/mailman/listinfo/gimp-docs-list



--
http://ninedegreesbelow.com
Color management and free/libre photography


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]