@cesium/engine 1.0.0 → 1.1.0

package/Source/Shaders/Voxels/IntersectDepth.glsl

@@ -0,0 +1,23 @@
+// See IntersectionUtils.glsl for the definitions of Ray, Intersections,
+// setIntersectionPair, INF_HIT, NO_HIT
+
+/* intersectDepth defines (set in Scene/VoxelRenderResources.js)
+#define DEPTH_INTERSECTION_INDEX ###
+*/
+
+uniform mat4 u_transformPositionViewToUv;
+
+void intersectDepth(vec2 screenCoord, Ray ray, inout Intersections ix) {
+    float logDepthOrDepth = czm_unpackDepth(texture2D(czm_globeDepthTexture, screenCoord));
+    if (logDepthOrDepth != 0.0) {
+        // Calculate how far the ray must travel before it hits the depth buffer.
+        vec4 eyeCoordinateDepth = czm_screenToEyeCoordinates(screenCoord, logDepthOrDepth);
+        eyeCoordinateDepth /= eyeCoordinateDepth.w;
+        vec3 depthPositionUv = vec3(u_transformPositionViewToUv * eyeCoordinateDepth);
+        float t = dot(depthPositionUv - ray.pos, ray.dir);
+        setIntersectionPair(ix, DEPTH_INTERSECTION_INDEX, vec2(t, +INF_HIT));
+    } else {
+        // There's no depth at this location.
+        setIntersectionPair(ix, DEPTH_INTERSECTION_INDEX, vec2(NO_HIT));
+    }
+}

package/Source/Shaders/Voxels/IntersectDepth.js

@@ -0,0 +1,25 @@
+//This file is automatically rebuilt by the Cesium build process.
+export default "// See IntersectionUtils.glsl for the definitions of Ray, Intersections,\n\
+// setIntersectionPair, INF_HIT, NO_HIT\n\
+\n\
+/* intersectDepth defines (set in Scene/VoxelRenderResources.js)\n\
+#define DEPTH_INTERSECTION_INDEX ###\n\
+*/\n\
+\n\
+uniform mat4 u_transformPositionViewToUv;\n\
+\n\
+void intersectDepth(vec2 screenCoord, Ray ray, inout Intersections ix) {\n\
+    float logDepthOrDepth = czm_unpackDepth(texture2D(czm_globeDepthTexture, screenCoord));\n\
+    if (logDepthOrDepth != 0.0) {\n\
+        // Calculate how far the ray must travel before it hits the depth buffer.\n\
+        vec4 eyeCoordinateDepth = czm_screenToEyeCoordinates(screenCoord, logDepthOrDepth);\n\
+        eyeCoordinateDepth /= eyeCoordinateDepth.w;\n\
+        vec3 depthPositionUv = vec3(u_transformPositionViewToUv * eyeCoordinateDepth);\n\
+        float t = dot(depthPositionUv - ray.pos, ray.dir);\n\
+        setIntersectionPair(ix, DEPTH_INTERSECTION_INDEX, vec2(t, +INF_HIT));\n\
+    } else {\n\
+        // There's no depth at this location.\n\
+        setIntersectionPair(ix, DEPTH_INTERSECTION_INDEX, vec2(NO_HIT));\n\
+    }\n\
+}\n\
+";

package/Source/Shaders/Voxels/IntersectEllipsoid.glsl

@@ -0,0 +1,337 @@
+// See IntersectionUtils.glsl for the definitions of Ray, Intersections,
+// setIntersection, setIntersectionPair, INF_HIT, NO_HIT
+
+/* Ellipsoid defines (set in Scene/VoxelEllipsoidShape.js)
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_UNDER_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_EQUAL_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_OVER_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_UNDER_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_EQUAL_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_OVER_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_UNDER_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_EQUAL_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_OVER_HALF
+#define ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_MIN
+#define ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_FLAT
+#define ELLIPSOID_INTERSECTION_INDEX_LONGITUDE
+#define ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MAX
+#define ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MIN
+#define ELLIPSOID_INTERSECTION_INDEX_HEIGHT_MAX
+#define ELLIPSOID_INTERSECTION_INDEX_HEIGHT_MIN
+*/
+
+#if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE)
+    uniform vec2 u_ellipsoidRenderLongitudeMinMax;
+#endif
+#if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_UNDER_HALF) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_OVER_HALF) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_UNDER_HALF) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_OVER_HALF)
+    uniform vec2 u_ellipsoidRenderLatitudeCosSqrHalfMinMax;
+#endif
+#if defined(ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_MIN)
+    uniform float u_ellipsoidInverseInnerScaleUv;
+#endif
+
+vec2 intersectZPlane(Ray ray)
+{
+    float o = ray.pos.z;
+    float d = ray.dir.z;
+    float t = -o / d;
+    float s = sign(o);
+
+    if (t >= 0.0 != s >= 0.0) return vec2(t, +INF_HIT);
+    else return vec2(-INF_HIT, t);
+}
+
+vec4 intersectHalfPlane(Ray ray, float angle) {
+    vec2 o = ray.pos.xy;
+    vec2 d = ray.dir.xy;
+    vec2 planeDirection = vec2(cos(angle), sin(angle));
+    vec2 planeNormal = vec2(planeDirection.y, -planeDirection.x);
+
+    float a = dot(o, planeNormal);
+    float b = dot(d, planeNormal);
+    float t = -a / b;
+
+    vec2 p = o + t * d;
+    bool outside = dot(p, planeDirection) < 0.0;
+    if (outside) return vec4(-INF_HIT, +INF_HIT, NO_HIT, NO_HIT);
+
+    return vec4(-INF_HIT, t, t, +INF_HIT);
+}
+
+vec2 intersectHalfSpace(Ray ray, float angle)
+{
+    vec2 o = ray.pos.xy;
+    vec2 d = ray.dir.xy;
+    vec2 n = vec2(sin(angle), -cos(angle));
+
+    float a = dot(o, n);
+    float b = dot(d, n);
+    float t = -a / b;
+    float s = sign(a);
+
+    if (t >= 0.0 != s >= 0.0) return vec2(t, +INF_HIT);
+    else return vec2(-INF_HIT, t);
+}
+
+vec2 intersectRegularWedge(Ray ray, float minAngle, float maxAngle)
+{
+    vec2 o = ray.pos.xy;
+    vec2 d = ray.dir.xy;
+    vec2 n1 = vec2(sin(minAngle), -cos(minAngle));
+    vec2 n2 = vec2(-sin(maxAngle), cos(maxAngle));
+
+    float a1 = dot(o, n1);
+    float a2 = dot(o, n2);
+    float b1 = dot(d, n1);
+    float b2 = dot(d, n2);
+
+    float t1 = -a1 / b1;
+    float t2 = -a2 / b2;
+    float s1 = sign(a1);
+    float s2 = sign(a2);
+
+    float tmin = min(t1, t2);
+    float tmax = max(t1, t2);
+    float smin = tmin == t1 ? s1 : s2;
+    float smax = tmin == t1 ? s2 : s1;
+
+    bool e = tmin >= 0.0;
+    bool f = tmax >= 0.0;
+    bool g = smin >= 0.0;
+    bool h = smax >= 0.0;
+
+    if (e != g && f == h) return vec2(tmin, tmax);
+    else if (e == g && f == h) return vec2(-INF_HIT, tmin);
+    else if (e != g && f != h) return vec2(tmax, +INF_HIT);
+    else return vec2(NO_HIT);
+}
+
+vec4 intersectFlippedWedge(Ray ray, float minAngle, float maxAngle)
+{
+    vec2 planeIntersectMin = intersectHalfSpace(ray, minAngle);
+    vec2 planeIntersectMax = intersectHalfSpace(ray, maxAngle + czm_pi);
+    return vec4(planeIntersectMin, planeIntersectMax);
+}
+
+vec2 intersectUnitSphere(Ray ray)
+{
+    vec3 o = ray.pos;
+    vec3 d = ray.dir;
+
+    float b = dot(d, o);
+    float c = dot(o, o) - 1.0;
+    float det = b * b - c;
+
+    if (det < 0.0) {
+        return vec2(NO_HIT);
+    }
+
+    det = sqrt(det);
+    float t1 = -b - det;
+    float t2 = -b + det;
+    float tmin = min(t1, t2);
+    float tmax = max(t1, t2);
+
+    return vec2(tmin, tmax);
+}
+
+vec2 intersectUnitSphereUnnormalizedDirection(Ray ray)
+{
+    vec3 o = ray.pos;
+    vec3 d = ray.dir;
+
+    float a = dot(d, d);
+    float b = dot(d, o);
+    float c = dot(o, o) - 1.0;
+    float det = b * b - a * c;
+
+    if (det < 0.0) {
+        return vec2(NO_HIT);
+    }
+
+    det = sqrt(det);
+    float t1 = (-b - det) / a;
+    float t2 = (-b + det) / a;
+    float tmin = min(t1, t2);
+    float tmax = max(t1, t2);
+
+    return vec2(tmin, tmax);
+}
+
+vec2 intersectDoubleEndedCone(Ray ray, float cosSqrHalfAngle)
+{
+    vec3 o = ray.pos;
+    vec3 d = ray.dir;
+    float a = d.z * d.z - dot(d, d) * cosSqrHalfAngle;
+    float b = d.z * o.z - dot(o, d) * cosSqrHalfAngle;
+    float c = o.z * o.z - dot(o, o) * cosSqrHalfAngle;
+    float det = b * b - a * c;
+
+    if (det < 0.0) {
+        return vec2(NO_HIT);
+    }
+
+    det = sqrt(det);
+    float t1 = (-b - det) / a;
+    float t2 = (-b + det) / a;
+    float tmin = min(t1, t2);
+    float tmax = max(t1, t2);
+    return vec2(tmin, tmax);
+}
+
+vec4 intersectFlippedCone(Ray ray, float cosSqrHalfAngle) {
+    vec2 intersect = intersectDoubleEndedCone(ray, cosSqrHalfAngle);
+
+    if (intersect.x == NO_HIT) {
+        return vec4(-INF_HIT, +INF_HIT, NO_HIT, NO_HIT);
+    }
+
+    vec3 o = ray.pos;
+    vec3 d = ray.dir;
+    float tmin = intersect.x;
+    float tmax = intersect.y;
+    float zmin = o.z + tmin * d.z;
+    float zmax = o.z + tmax * d.z;
+
+    // One interval
+    if (zmin < 0.0 && zmax < 0.0) return vec4(-INF_HIT, +INF_HIT, NO_HIT, NO_HIT);
+    else if (zmin < 0.0) return vec4(-INF_HIT, tmax, NO_HIT, NO_HIT);
+    else if (zmax < 0.0) return vec4(tmin, +INF_HIT, NO_HIT, NO_HIT);
+    // Two intervals
+    else return vec4(-INF_HIT, tmin, tmax, +INF_HIT);
+}
+
+vec2 intersectRegularCone(Ray ray, float cosSqrHalfAngle) {
+    vec2 intersect = intersectDoubleEndedCone(ray, cosSqrHalfAngle);
+
+    if (intersect.x == NO_HIT) {
+        return vec2(NO_HIT);
+    }
+
+    vec3 o = ray.pos;
+    vec3 d = ray.dir;
+    float tmin = intersect.x;
+    float tmax = intersect.y;
+    float zmin = o.z + tmin * d.z;
+    float zmax = o.z + tmax * d.z;
+
+    if (zmin < 0.0 && zmax < 0.0) return vec2(NO_HIT);
+    else if (zmin < 0.0) return vec2(tmax, +INF_HIT);
+    else if (zmax < 0.0) return vec2(-INF_HIT, tmin);
+    else return vec2(tmin, tmax);
+}
+
+void intersectShape(in Ray ray, inout Intersections ix) {
+    // Position is converted from [0,1] to [-1,+1] because shape intersections assume unit space is [-1,+1].
+    // Direction is scaled as well to be in sync with position.
+    ray.pos = ray.pos * 2.0 - 1.0;
+    ray.dir *= 2.0;
+
+    // Outer ellipsoid
+    vec2 outerIntersect = intersectUnitSphereUnnormalizedDirection(ray);
+    setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_HEIGHT_MAX, outerIntersect);
+
+    // Exit early if the outer ellipsoid was missed.
+    if (outerIntersect.x == NO_HIT) {
+        return;
+    }
+
+    // Inner ellipsoid
+    #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_FLAT)
+        // When the ellipsoid is perfectly thin it's necessary to sandwich the
+        // inner ellipsoid intersection inside the outer ellipsoid intersection.
+
+        // Without this special case,
+        // [outerMin, outerMax, innerMin, innerMax] will bubble sort to
+        // [outerMin, innerMin, outerMax, innerMax] which will cause the back
+        // side of the ellipsoid to be invisible because it will think the ray
+        // is still inside the inner (negative) ellipsoid after exiting the
+        // outer (positive) ellipsoid.
+
+        // With this special case,
+        // [outerMin, innerMin, innerMax, outerMax] will bubble sort to
+        // [outerMin, innerMin, innerMax, outerMax] which will work correctly.
+
+        // Note: If initializeIntersections() changes its sorting function
+        // from bubble sort to something else, this code may need to change.
+        setIntersection(ix, 0, outerIntersect.x, true, true);   // positive, enter
+        setIntersection(ix, 1, outerIntersect.x, false, true);  // negative, enter
+        setIntersection(ix, 2, outerIntersect.y, false, false); // negative, exit
+        setIntersection(ix, 3, outerIntersect.y, true, false);  // positive, exit
+    #elif defined(ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_MIN)
+        Ray innerRay = Ray(ray.pos * u_ellipsoidInverseInnerScaleUv, ray.dir * u_ellipsoidInverseInnerScaleUv);
+        vec2 innerIntersect = intersectUnitSphereUnnormalizedDirection(innerRay);
+
+        if (innerIntersect == vec2(NO_HIT)) {
+            setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_HEIGHT_MIN, innerIntersect);
+        } else {
+            // When the ellipsoid is very large and thin it's possible for floating
+            // point math to cause the ray to intersect the inner ellipsoid before
+            // the outer ellipsoid. To prevent this from happening, clamp innerIntersect
+            // to outerIntersect and sandwhich the intersections like described above.
+            //
+            // In theory a similar fix is needed for cylinders, however it's more
+            // complicated to implement because the inner shape is allowed to be
+            // intersected first.
+            innerIntersect.x = max(innerIntersect.x, outerIntersect.x);
+            innerIntersect.y = min(innerIntersect.y, outerIntersect.y);
+            setIntersection(ix, 0, outerIntersect.x, true, true);   // positive, enter
+            setIntersection(ix, 1, innerIntersect.x, false, true);  // negative, enter
+            setIntersection(ix, 2, innerIntersect.y, false, false); // negative, exit
+            setIntersection(ix, 3, outerIntersect.y, true, false);  // positive, exit
+        }
+    #endif
+
+    // Flip the ray because the intersection function expects a cone growing towards +Z.
+    #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_UNDER_HALF) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_EQUAL_HALF) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_UNDER_HALF)
+        Ray flippedRay = ray;
+        flippedRay.dir.z *= -1.0;
+        flippedRay.pos.z *= -1.0;
+    #endif
+
+    // Bottom cone
+    #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_UNDER_HALF)
+        vec2 bottomConeIntersection = intersectRegularCone(flippedRay, u_ellipsoidRenderLatitudeCosSqrHalfMinMax.x);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MIN, bottomConeIntersection);
+    #elif defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_EQUAL_HALF)
+        vec2 bottomConeIntersection = intersectZPlane(flippedRay);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MIN, bottomConeIntersection);
+    #elif defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MIN_OVER_HALF)
+        vec4 bottomConeIntersection = intersectFlippedCone(ray, u_ellipsoidRenderLatitudeCosSqrHalfMinMax.x);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MIN + 0, bottomConeIntersection.xy);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MIN + 1, bottomConeIntersection.zw);
+    #endif
+
+    // Top cone
+    #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_UNDER_HALF)
+        vec4 topConeIntersection = intersectFlippedCone(flippedRay, u_ellipsoidRenderLatitudeCosSqrHalfMinMax.y);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MAX + 0, topConeIntersection.xy);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MAX + 1, topConeIntersection.zw);
+    #elif defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_EQUAL_HALF)
+        vec2 topConeIntersection = intersectZPlane(ray);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MAX, topConeIntersection);
+    #elif defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_MAX_OVER_HALF)
+        vec2 topConeIntersection = intersectRegularCone(ray, u_ellipsoidRenderLatitudeCosSqrHalfMinMax.y);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LATITUDE_MAX, topConeIntersection);
+    #endif
+
+    // Wedge
+    #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO)
+        vec4 wedgeIntersect = intersectHalfPlane(ray, u_ellipsoidRenderLongitudeMinMax.x);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LONGITUDE + 0, wedgeIntersect.xy);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LONGITUDE + 1, wedgeIntersect.zw);
+    #elif defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_UNDER_HALF)
+        vec2 wedgeIntersect = intersectRegularWedge(ray, u_ellipsoidRenderLongitudeMinMax.x, u_ellipsoidRenderLongitudeMinMax.y);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LONGITUDE, wedgeIntersect);
+    #elif defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_EQUAL_HALF)
+        vec2 wedgeIntersect = intersectHalfSpace(ray, u_ellipsoidRenderLongitudeMinMax.x);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LONGITUDE, wedgeIntersect);
+    #elif defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_OVER_HALF)
+        vec4 wedgeIntersect = intersectFlippedWedge(ray, u_ellipsoidRenderLongitudeMinMax.x, u_ellipsoidRenderLongitudeMinMax.y);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LONGITUDE + 0, wedgeIntersect.xy);
+        setIntersectionPair(ix, ELLIPSOID_INTERSECTION_INDEX_LONGITUDE + 1, wedgeIntersect.zw);
+    #endif
+}