[x3d-public] fogCoordinate description problematic

[simon place]

i understand its not much fun, but isn't it pretty important to fix
stuff like this?

On Fri, 5 Jul 2019 at 19:41, simon place <psiplace at netscape.net> wrote:
>
> looking at https://www.web3d.org/x3d/tooltips/X3dTooltips.html#FogCoordinate.depth
>
> i notice it says
>
> > FogCoordinate defines a set of explicit fog depths on a per-vertex basis, overriding Fog visibilityRange.
>
> seems to me they actually 'bypass' and the above wording may be a
> symptom/contribute to a confusing description....
>
> the spec. http://www.web3d.org/documents/specifications/19775-1/V3.3/Part01/components/enveffects.html#FogCoordinate
> seems, to me, to be interpretable as meaning either:
>
> the depth's replace the visibilityRange value ('overriding' it in the
> calc.,  as the above implies),
>
> or, what i think,
>
> that they replace the result of the calculation that is using
> visibilityRange ('bypassing' it)  and are so in-fact simply blending
> factors independent of the avatar distance.
>
> in either case a much simple/clearer wording seems very possible,
> particularly the liberal use of the word 'depth' to refer to a
> non-distance thing seems an issue.
>
>
> (Note also; that page refers to the depth's as MFVec3f but includes a
> link showing them to in-fact be MFFloat)