Files
gods-eye-view/src/globe/navara/overlayDepth.js
T
German Khokhlov 14b2adb7af Never hide a mover behind the terrain it sits on
Cesium does not test points, billboards or labels against terrain depth;
only the horizon, 3D tiles and models hide them. Navara compared every
fragment of a marker's quad with the terrain, so markers on slopes or a
little below the rendered terrain disappeared (the flood markers in the
Nepal story). Navara now follows Cesium's rule for movers with the normal
depth test, the contract describes it, and the contract suite checks it.
2026-11-12 00:42:17 +04:00

85 lines
3.1 KiB
JavaScript

import { PACKED_DEPTH_GLSL } from './shaderChunks.js';
// The depth test of gev's screen overlays on Navara (sprites, points and
// lines drawn after tone mapping, overlay.js): there is no depth buffer in
// the post-processing chain, so each fragment compares its own logarithmic
// depth with the scene's, read from Navara's MRT pass (depth packed to RGBA,
// as the sharpening reads it). Modes: 0 always drawn; 1 hidden where the
// scene is nearer (normal); 2 drawn only where the scene is nearer (a
// line's depth-fail copy). `vGevDepthFree` (set by the vertex shader) lets
// an instance skip the test (disableWithinM). No three imports: GLSL only.
export const OVERLAY_DEPTH_MODES = Object.freeze({
always: 0,
normal: 1,
fail: 2,
});
// Cesium clears terrain depth before primitives, retaining only the limb
// plane. The ray-cone test limits that plane to the Earth's silhouette.
const MOVER_DEPTH_GLSL = /* glsl */ `
bool gevMoverHorizonHidden(float limbSquared, float towardCenter, float raySquared) {
return limbSquared >= 0.0 && towardCenter > limbSquared &&
towardCenter * towardCenter > limbSquared * raySquared;
}
bool gevMoverSceneHidden(float mine, float scene, float globe) {
// Allow the same two depth-copy rounding steps as ground classification.
return scene < globe - 2e-7 && packedDepthOccluded(mine, scene, 2e-6);
}
`;
/** Fragment declarations: uniforms, the varying and gevOverlayHidden(). */
export const OVERLAY_DEPTH_FRAGMENT = /* glsl */ `
${PACKED_DEPTH_GLSL}
#ifdef GEV_MOVER_DEPTH
${MOVER_DEPTH_GLSL}
uniform sampler2D tGevGlobeDepth;
uniform vec3 uGevScaledCamera;
uniform float uGevLimbSquared;
varying vec3 vGevScaledRay;
#endif
uniform sampler2D tGevSceneDepth;
uniform vec2 uGevResolution;
uniform float uGevDepthMode;
uniform float uGevDisplayBlend;
vec4 gevOverlayDisplayColor(vec4 color) {
return uGevDisplayBlend>0.5 ? sRGBTransferOETF(color) : color;
}
varying float vGevDepthFree;
bool gevOverlayHidden() {
if (uGevDepthMode < 0.5 || vGevDepthFree > 0.5 || uGevResolution.x < 1.0)
return false;
// three's unpackRGBAToDepth (RGBADepthPacking).
float scene = dot(
#ifdef GEV_MOVER_DEPTH
texelFetch(tGevSceneDepth, ivec2(gl_FragCoord.xy), 0),
#else
texture2D(tGevSceneDepth, gl_FragCoord.xy / uGevResolution),
#endif
vec4(255.0 / 256.0, 255.0 / 65536.0, 255.0 / 16777216.0, 1.0 / 16777216.0)
);
#ifdef USE_LOGARITHMIC_DEPTH_BUFFER
float mine = log2(vFragDepth) * logDepthBufFC * 0.5;
#else
float mine = gl_FragCoord.z;
#endif
bool occluded = packedDepthOccluded(mine, scene, 2e-6);
#ifdef GEV_MOVER_DEPTH
float globe = dot(
texelFetch(tGevGlobeDepth, ivec2(gl_FragCoord.xy), 0),
vec4(255.0 / 256.0, 255.0 / 65536.0, 255.0 / 16777216.0, 1.0 / 16777216.0)
);
occluded = gevMoverHorizonHidden(
uGevLimbSquared,
-dot(vGevScaledRay, uGevScaledCamera),
dot(vGevScaledRay, vGevScaledRay)
) || gevMoverSceneHidden(mine, scene, globe);
#endif
return uGevDepthMode < 1.5 ? occluded : !occluded;
}
`;
/** Vertex declaration of the per-vertex escape from the depth test. */
export const OVERLAY_DEPTH_VERTEX = /* glsl */ `
varying float vGevDepthFree;
`;