After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 767482 - Posterize help says it reduces to 2^LEVELS instead of less than LEVELS^3 total colours
Posterize help says it reduces to 2^LEVELS instead of less than LEVELS^3 tota...
Status: RESOLVED OBSOLETE
Product: GIMP-manual
Classification: Other
Component: English
2.8
Other All
: Normal normal
: 2.8
Assigned To: Róman Joost
GIMP Bugs
https://docs.gimp.org/en/gimp-tool-po...
Depends on:
Blocks:
 
 
Reported: 2016-06-10 07:14 UTC by Carl
Modified: 2018-05-24 10:33 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Posterize this with 3 levels to demonstrate a 27-colour result. (140.66 KB, image/png)
2016-06-10 07:14 UTC, Carl
Details

Description Carl 2016-06-10 07:14:20 UTC
Created attachment 329531 [details]
Posterize this with 3 levels to demonstrate a 27-colour result.

The Posterize documentation claims that this tool reduces the total number of colours to 2^LEVELS, where LEVELS is the number shown in the slider. This is not true. The actual number is 3^LEVELS and this is a maximum (ie. you may get less).

Where the documentation says the slider "allows[s] you to set the number of levels (2-256) in each RGB channel", I think the phrase "number of levels" should read "maximum number of colours".

Where it says "The total number of colors is the combination of these levels", I think "total number" should be replaced by "maximum total number".

Where it says "A level to 3 will give 2^3 = 8 colors", it should actually say "Setting the level to 3 will reduce the total colours to 3^3 = 27 colours or less". Better yet, reduce ambiguity with "Setting the level to 4 will reduce the total colours to 4^3 = 64 colours or less".

It was trivial to Posterize various images and then use the Colorcube Analysis tool to verify that colour counts achieved frequently exceed the obvious 2^LEVELS math error. Such experiments also find examples where the colour count is equal to or less than LEVELS^3.

My own feeling is that talking about "levels" in the documentation and using that same term in the tool GUI is needlessly confusing. Can we not just use "colours per channel"?

When posterized to 3 levels on GIMP v2.8.14 (Windows), the attached PNG image has 27 total colours.
Comment 1 Michael Schumacher 2017-02-28 20:44:54 UTC
qa contact change to bugs@gimp.org
Comment 2 GNOME Infrastructure Team 2018-05-24 10:33:47 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/GNOME/gimp-help-2/issues/40.