POV-Ray : Newsgroups : povray.documentation.inbuilt : HF_Gray_16 docs can be misleading : HF_Gray_16 docs can be misleading Server Time
20 Jan 2022 12:29:20 EST (-0500)
  HF_Gray_16 docs can be misleading  
From: Kenneth
Date: 17 Apr 2014 05:15:01
Message: <web.534f9ae240533f5c2d977c20@news.povray.org>
Something has always bugged me about the docs on this subject (old docs as well
as the new ones for 3.7.)

It says there...

"3.4.1.4 HF_Gray_16
Grayscale output can be used to generate heightfields for use in other POV-Ray
scenes..."

That's well and good!

But not this...
"With Grayscale_Output=true, the output file will be in the form of a
heightfield, with the height at any point being dependent on the brightness of
the pixel..."

Uh, no, the output file is not 'a heightfield'; it's just a grayscale image that
*can be used to create* a heightfield (or for other things.)  That partial
sentence should be sliced and diced and generally re-worded-- IMHO, of course
;-) -- so that its meaning is clearer to new users.

The reason I bring this up is that it *really* confused me during my early
POV-Ray learning-curve. Could it be confusing to other newbies as well? I was
expecting (out of naivete and lack of experience) that, by using HF_Gray_16, its
*own* render would produce a beautiful craggy-mountain HF on the screen (!). A
silly thought, now that I know better-- but not at the time. :-/ I would imagine
that a HF is one of *the* coolest CG objects that newbies would like to create.
But if the concept of how a HF is made is new to them, the offending sentence
could be confusing, or at least off-putting.

My two-cents for the day ;-)


Post a reply to this message

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