POV-Ray : Newsgroups : povray.documentation.inbuilt : PIGMENT documentation-- a minor clarification : PIGMENT documentation-- a minor clarification Server Time
24 Mar 2023 11:58:05 EDT (-0400)
  PIGMENT documentation-- a minor clarification  
From: Kenneth
Date: 12 Nov 2017 14:45:00
Message: <web.5a08a3b02433197289df8d30@news.povray.org>
I have a small nit-pick about the in-built documentation at " Pigments"
within the first paragraph. (It's also in the online wiki, in "Tutorial Section
3.3", under "Advanced Texture Options / Pigments"...


Both places say this:
"Pigments can also be layered one on top of the next so long as the uppermost
layers are at least partially transparent so the ones beneath can show through."

As this is mentioned as a 'general' statement in the very first paragraph, and
before any qualifications are given, a naive or new-user might naturally assume
that the following construct is a nice way to get, for example,  a sort of
color-filtered bozo effect.(I'm using specific pigments to clarify the point)...

pigment {rgbt <.2,.5,.7,.5>

But that doesn't work-- the second pigment completely overrides the first, which
could be a frustrating surprise-- because adding pigments together this way is
not what is really meant by the doc's initial description *as it stands*. (Only
later in the docs is the pigment_map introduced, and/or multiple textures, which
are the correct methods of using/overlaying multiple pigments.) BTW, I was
tripped up by this too, when I first started using POV-Ray.

I would suggest a simple addition to the end of the documentation's sentence,
maybe in parentheses: "See "Using Transparent Pigments and Layered Textures"
below."  That should remove any mystery.

Post a reply to this message

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.