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

[Elle Stone <ellestone ninedegreesbelow com>]

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