@cesium/engine 1.0.0 → 1.1.0

package/Source/Shaders/Voxels/convertUvToCylinder.js

@@ -0,0 +1,81 @@
+//This file is automatically rebuilt by the Cesium build process.
+export default "/* Cylinder defines (set in Scene/VoxelCylinderShape.js)\n\
+#define CYLINDER_HAS_RENDER_BOUNDS_RADIUS_FLAT\n\
+#define CYLINDER_HAS_RENDER_BOUNDS_HEIGHT_FLAT\n\
+#define CYLINDER_HAS_RENDER_BOUNDS_ANGLE_RANGE_EQUAL_ZERO\n\
+\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_RADIUS\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_RADIUS_FLAT\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_HEIGHT\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_HEIGHT_FLAT\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_ANGLE\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_RANGE_EQUAL_ZERO\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MIN_DISCONTINUITY\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MAX_DISCONTINUITY\n\
+#define CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MIN_MAX_REVERSED\n\
+*/\n\
+\n\
+#if defined(CYLINDER_HAS_SHAPE_BOUNDS_RADIUS)\n\
+    uniform vec2 u_cylinderUvToShapeUvRadius; // x = scale, y = offset\n\
+#endif\n\
+#if defined(CYLINDER_HAS_SHAPE_BOUNDS_HEIGHT)\n\
+    uniform vec2 u_cylinderUvToShapeUvHeight; // x = scale, y = offset\n\
+#endif\n\
+#if defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE)\n\
+    uniform vec2 u_cylinderUvToShapeUvAngle; // x = scale, y = offset\n\
+#endif\n\
+#if defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MIN_DISCONTINUITY) || defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MAX_DISCONTINUITY)\n\
+    uniform vec2 u_cylinderShapeUvAngleMinMax;\n\
+#endif\n\
+#if defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MIN_DISCONTINUITY) || defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MAX_DISCONTINUITY) || defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MIN_MAX_REVERSED)\n\
+    uniform float u_cylinderShapeUvAngleRangeZeroMid;\n\
+#endif\n\
+\n\
+vec3 convertUvToShapeUvSpace(in vec3 positionUv) {\n\
+    vec3 positionLocal = positionUv * 2.0 - 1.0; // [-1,+1]\n\
+\n\
+    // Compute radius\n\
+    #if defined(CYLINDER_HAS_SHAPE_BOUNDS_RADIUS_FLAT) || defined(CYLINDER_HAS_RENDER_BOUNDS_RADIUS_FLAT)\n\
+        float radius = length(positionLocal.xy); // [0,1]\n\
+    #else\n\
+        float radius = length(positionLocal.xy); // [0,1]\n\
+        #if defined(CYLINDER_HAS_SHAPE_BOUNDS_RADIUS)\n\
+            radius = radius * u_cylinderUvToShapeUvRadius.x + u_cylinderUvToShapeUvRadius.y; // x = scale, y = offset\n\
+        #endif\n\
+    #endif\n\
+\n\
+    // Compute height\n\
+    #if defined(CYLINDER_HAS_SHAPE_BOUNDS_HEIGHT_FLAT) || defined(CYLINDER_HAS_RENDER_BOUNDS_HEIGHT_FLAT)\n\
+        float height = positionUv.z; // [0,1]\n\
+    #else\n\
+        float height = positionUv.z; // [0,1]\n\
+        #if defined(CYLINDER_HAS_SHAPE_BOUNDS_HEIGHT)\n\
+            height = height * u_cylinderUvToShapeUvHeight.x + u_cylinderUvToShapeUvHeight.y; // x = scale, y = offset\n\
+        #endif\n\
+    #endif\n\
+\n\
+    // Compute angle\n\
+    #if defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_RANGE_EQUAL_ZERO) || defined(CYLINDER_HAS_RENDER_BOUNDS_ANGLE_RANGE_EQUAL_ZERO)\n\
+        float angle = 1.0;\n\
+    #else\n\
+        float angle = (atan(positionLocal.y, positionLocal.x) + czm_pi) / czm_twoPi; // [0,1]\n\
+        #if defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE)\n\
+            #if defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MIN_MAX_REVERSED)\n\
+                // Comparing against u_cylinderShapeUvAngleMinMax has precision problems. u_cylinderShapeUvAngleRangeZeroMid is more conservative.\n\
+                angle += float(angle < u_cylinderShapeUvAngleRangeZeroMid);\n\
+            #endif\n\
+\n\
+            // Avoid flickering from reading voxels from both sides of the -pi/+pi discontinuity.\n\
+            #if defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MIN_DISCONTINUITY)\n\
+                angle = angle > u_cylinderShapeUvAngleRangeZeroMid ? u_cylinderShapeUvAngleMinMax.x : angle;\n\
+            #elif defined(CYLINDER_HAS_SHAPE_BOUNDS_ANGLE_MAX_DISCONTINUITY)\n\
+                angle = angle < u_cylinderShapeUvAngleRangeZeroMid ? u_cylinderShapeUvAngleMinMax.y : angle;\n\
+            #endif\n\
+\n\
+            angle = angle * u_cylinderUvToShapeUvAngle.x + u_cylinderUvToShapeUvAngle.y; // x = scale, y = offset\n\
+        #endif\n\
+    #endif\n\
+\n\
+    return vec3(radius, height, angle);\n\
+}\n\
+";

package/Source/Shaders/Voxels/convertUvToEllipsoid.glsl

@@ -0,0 +1,133 @@
+/* Ellipsoid defines (set in Scene/VoxelEllipsoidShape.js)
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MIN_DISCONTINUITY
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MAX_DISCONTINUITY
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_MIN_MAX_REVERSED
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_RANGE_EQUAL_ZERO
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE_RANGE_EQUAL_ZERO
+#define ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_FLAT
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_MIN
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_FLAT
+#define ELLIPSOID_IS_SPHERE
+*/
+
+uniform vec3 u_ellipsoidRadiiUv; // [0,1]
+#if !defined(ELLIPSOID_IS_SPHERE)
+    uniform vec3 u_ellipsoidInverseRadiiSquaredUv;
+#endif
+#if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MIN_DISCONTINUITY) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MAX_DISCONTINUITY) || defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_MIN_MAX_REVERSED)
+    uniform vec3 u_ellipsoidShapeUvLongitudeMinMaxMid;
+#endif
+#if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE)
+    uniform vec2 u_ellipsoidUvToShapeUvLongitude; // x = scale, y = offset
+#endif
+#if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE)
+    uniform vec2 u_ellipsoidUvToShapeUvLatitude; // x = scale, y = offset
+#endif
+#if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_MIN) && !defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_FLAT)
+    uniform float u_ellipsoidInverseHeightDifferenceUv;
+    uniform vec2 u_ellipseInnerRadiiUv; // [0,1]
+#endif
+
+// robust iterative solution without trig functions
+// https://github.com/0xfaded/ellipse_demo/issues/1
+// https://stackoverflow.com/questions/22959698/distance-from-given-point-to-given-ellipse
+// Pro: Good when radii.x ~= radii.y
+// Con: Breaks at pos.x ~= 0.0, especially inside the ellipse
+// Con: Inaccurate with exterior points and thin ellipses
+float ellipseDistanceIterative (vec2 pos, vec2 radii) {
+    vec2 p = abs(pos);
+    vec2 invRadii = 1.0 / radii;
+    vec2 a = vec2(1.0, -1.0) * (radii.x * radii.x - radii.y * radii.y) * invRadii;
+    vec2 t = vec2(0.70710678118); // sqrt(2) / 2
+    vec2 v = radii * t;
+
+    const int iterations = 3;
+    for (int i = 0; i < iterations; ++i) {
+        vec2 e = a * pow(t, vec2(3.0));
+        vec2 q = normalize(p - e) * length(v - e);
+        t = normalize((q + e) * invRadii);
+        v = radii * t;
+    }
+    return length(v * sign(pos) - pos) * sign(p.y - v.y);
+}
+
+vec3 convertUvToShapeUvSpace(in vec3 positionUv) {
+    // Compute position and normal.
+    // Convert positionUv [0,1] to local space [-1,+1] to "normalized" cartesian space [-a,+a] where a = (radii + height) / (max(radii) + height).
+    // A point on the largest ellipsoid axis would be [-1,+1] and everything else would be smaller.
+    vec3 positionLocal = positionUv * 2.0 - 1.0;
+    #if defined(ELLIPSOID_IS_SPHERE)
+        vec3 posEllipsoid = positionLocal * u_ellipsoidRadiiUv.x;
+        vec3 normal = normalize(posEllipsoid);
+    #else
+        vec3 posEllipsoid = positionLocal * u_ellipsoidRadiiUv;
+        vec3 normal = normalize(posEllipsoid * u_ellipsoidInverseRadiiSquaredUv); // geodetic surface normal
+    #endif
+
+    // Compute longitude
+    #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO)
+        float longitude = 1.0;
+    #else
+        float longitude = (atan(normal.y, normal.x) + czm_pi) / czm_twoPi;
+
+        // Correct the angle when max < min
+        // Technically this should compare against min longitude - but it has precision problems so compare against the middle of empty space.
+        #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_MIN_MAX_REVERSED)
+            longitude += float(longitude < u_ellipsoidShapeUvLongitudeMinMaxMid.z);
+        #endif
+
+        // Avoid flickering from reading voxels from both sides of the -pi/+pi discontinuity.
+        #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MIN_DISCONTINUITY)
+            longitude = longitude > u_ellipsoidShapeUvLongitudeMinMaxMid.z ? u_ellipsoidShapeUvLongitudeMinMaxMid.x : longitude;
+        #endif
+        #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MAX_DISCONTINUITY)
+            longitude = longitude < u_ellipsoidShapeUvLongitudeMinMaxMid.z ? u_ellipsoidShapeUvLongitudeMinMaxMid.y : longitude;
+        #endif
+
+        #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE)
+            longitude = longitude * u_ellipsoidUvToShapeUvLongitude.x + u_ellipsoidUvToShapeUvLongitude.y;
+        #endif
+    #endif
+
+    // Compute latitude
+    #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE_RANGE_EQUAL_ZERO) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_RANGE_EQUAL_ZERO)
+        float latitude = 1.0;
+    #else
+        float latitude = (asin(normal.z) + czm_piOverTwo) / czm_pi;
+        #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE)
+            latitude = latitude * u_ellipsoidUvToShapeUvLatitude.x + u_ellipsoidUvToShapeUvLatitude.y;
+        #endif
+    #endif
+
+    // Compute height
+    #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_FLAT) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_FLAT)
+        // TODO: This breaks down when minBounds == maxBounds. To fix it, this
+        // function would have to know if ray is intersecting the front or back of the shape
+        // and set the shape space position to 1 (front) or 0 (back) accordingly.
+        float height = 1.0;
+    #else
+        #if defined(ELLIPSOID_IS_SPHERE)
+            #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_MIN)
+                float height = (length(posEllipsoid) - u_ellipseInnerRadiiUv.x) * u_ellipsoidInverseHeightDifferenceUv;
+            #else
+                float height = length(posEllipsoid);
+            #endif
+        #else
+            #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_MIN)
+                // Convert the 3D position to a 2D position relative to the ellipse (radii.x, radii.z) (assuming radii.x == radii.y which is true for WGS84).
+                // This is an optimization so that math can be done with ellipses instead of ellipsoids.
+                vec2 posEllipse = vec2(length(posEllipsoid.xy), posEllipsoid.z);
+                float height = ellipseDistanceIterative(posEllipse, u_ellipseInnerRadiiUv) * u_ellipsoidInverseHeightDifferenceUv;
+            #else
+                // TODO: this is probably not correct
+                float height = length(posEllipsoid);
+            #endif
+        #endif
+    #endif
+
+    return vec3(longitude, latitude, height);
+}

package/Source/Shaders/Voxels/convertUvToEllipsoid.js

@@ -0,0 +1,135 @@
+//This file is automatically rebuilt by the Cesium build process.
+export default "/* Ellipsoid defines (set in Scene/VoxelEllipsoidShape.js)\n\
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO\n\
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MIN_DISCONTINUITY\n\
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MAX_DISCONTINUITY\n\
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE\n\
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO\n\
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_MIN_MAX_REVERSED\n\
+#define ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_RANGE_EQUAL_ZERO\n\
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE\n\
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE_RANGE_EQUAL_ZERO\n\
+#define ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_FLAT\n\
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_MIN\n\
+#define ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_FLAT\n\
+#define ELLIPSOID_IS_SPHERE\n\
+*/\n\
+\n\
+uniform vec3 u_ellipsoidRadiiUv; // [0,1]\n\
+#if !defined(ELLIPSOID_IS_SPHERE)\n\
+    uniform vec3 u_ellipsoidInverseRadiiSquaredUv;\n\
+#endif\n\
+#if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MIN_DISCONTINUITY) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MAX_DISCONTINUITY) || defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_MIN_MAX_REVERSED)\n\
+    uniform vec3 u_ellipsoidShapeUvLongitudeMinMaxMid;\n\
+#endif\n\
+#if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE)\n\
+    uniform vec2 u_ellipsoidUvToShapeUvLongitude; // x = scale, y = offset\n\
+#endif\n\
+#if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE)\n\
+    uniform vec2 u_ellipsoidUvToShapeUvLatitude; // x = scale, y = offset\n\
+#endif\n\
+#if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_MIN) && !defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_FLAT)\n\
+    uniform float u_ellipsoidInverseHeightDifferenceUv;\n\
+    uniform vec2 u_ellipseInnerRadiiUv; // [0,1]\n\
+#endif\n\
+\n\
+// robust iterative solution without trig functions\n\
+// https://github.com/0xfaded/ellipse_demo/issues/1\n\
+// https://stackoverflow.com/questions/22959698/distance-from-given-point-to-given-ellipse\n\
+// Pro: Good when radii.x ~= radii.y\n\
+// Con: Breaks at pos.x ~= 0.0, especially inside the ellipse\n\
+// Con: Inaccurate with exterior points and thin ellipses\n\
+float ellipseDistanceIterative (vec2 pos, vec2 radii) {\n\
+    vec2 p = abs(pos);\n\
+    vec2 invRadii = 1.0 / radii;\n\
+    vec2 a = vec2(1.0, -1.0) * (radii.x * radii.x - radii.y * radii.y) * invRadii;\n\
+    vec2 t = vec2(0.70710678118); // sqrt(2) / 2\n\
+    vec2 v = radii * t;\n\
+\n\
+    const int iterations = 3;\n\
+    for (int i = 0; i < iterations; ++i) {\n\
+        vec2 e = a * pow(t, vec2(3.0));\n\
+        vec2 q = normalize(p - e) * length(v - e);\n\
+        t = normalize((q + e) * invRadii);\n\
+        v = radii * t;\n\
+    }\n\
+    return length(v * sign(pos) - pos) * sign(p.y - v.y);\n\
+}\n\
+\n\
+vec3 convertUvToShapeUvSpace(in vec3 positionUv) {\n\
+    // Compute position and normal.\n\
+    // Convert positionUv [0,1] to local space [-1,+1] to \"normalized\" cartesian space [-a,+a] where a = (radii + height) / (max(radii) + height).\n\
+    // A point on the largest ellipsoid axis would be [-1,+1] and everything else would be smaller.\n\
+    vec3 positionLocal = positionUv * 2.0 - 1.0;\n\
+    #if defined(ELLIPSOID_IS_SPHERE)\n\
+        vec3 posEllipsoid = positionLocal * u_ellipsoidRadiiUv.x;\n\
+        vec3 normal = normalize(posEllipsoid);\n\
+    #else\n\
+        vec3 posEllipsoid = positionLocal * u_ellipsoidRadiiUv;\n\
+        vec3 normal = normalize(posEllipsoid * u_ellipsoidInverseRadiiSquaredUv); // geodetic surface normal\n\
+    #endif\n\
+\n\
+    // Compute longitude\n\
+    #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_RANGE_EQUAL_ZERO)\n\
+        float longitude = 1.0;\n\
+    #else\n\
+        float longitude = (atan(normal.y, normal.x) + czm_pi) / czm_twoPi;\n\
+\n\
+        // Correct the angle when max < min\n\
+        // Technically this should compare against min longitude - but it has precision problems so compare against the middle of empty space.\n\
+        #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE_MIN_MAX_REVERSED)\n\
+            longitude += float(longitude < u_ellipsoidShapeUvLongitudeMinMaxMid.z);\n\
+        #endif\n\
+\n\
+        // Avoid flickering from reading voxels from both sides of the -pi/+pi discontinuity.\n\
+        #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MIN_DISCONTINUITY)\n\
+            longitude = longitude > u_ellipsoidShapeUvLongitudeMinMaxMid.z ? u_ellipsoidShapeUvLongitudeMinMaxMid.x : longitude;\n\
+        #endif\n\
+        #if defined(ELLIPSOID_HAS_RENDER_BOUNDS_LONGITUDE_MAX_DISCONTINUITY)\n\
+            longitude = longitude < u_ellipsoidShapeUvLongitudeMinMaxMid.z ? u_ellipsoidShapeUvLongitudeMinMaxMid.y : longitude;\n\
+        #endif\n\
+\n\
+        #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LONGITUDE)\n\
+            longitude = longitude * u_ellipsoidUvToShapeUvLongitude.x + u_ellipsoidUvToShapeUvLongitude.y;\n\
+        #endif\n\
+    #endif\n\
+\n\
+    // Compute latitude\n\
+    #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE_RANGE_EQUAL_ZERO) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_LATITUDE_RANGE_EQUAL_ZERO)\n\
+        float latitude = 1.0;\n\
+    #else\n\
+        float latitude = (asin(normal.z) + czm_piOverTwo) / czm_pi;\n\
+        #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_LATITUDE)\n\
+            latitude = latitude * u_ellipsoidUvToShapeUvLatitude.x + u_ellipsoidUvToShapeUvLatitude.y;\n\
+        #endif\n\
+    #endif\n\
+\n\
+    // Compute height\n\
+    #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_FLAT) || defined(ELLIPSOID_HAS_RENDER_BOUNDS_HEIGHT_FLAT)\n\
+        // TODO: This breaks down when minBounds == maxBounds. To fix it, this\n\
+        // function would have to know if ray is intersecting the front or back of the shape\n\
+        // and set the shape space position to 1 (front) or 0 (back) accordingly.\n\
+        float height = 1.0;\n\
+    #else\n\
+        #if defined(ELLIPSOID_IS_SPHERE)\n\
+            #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_MIN)\n\
+                float height = (length(posEllipsoid) - u_ellipseInnerRadiiUv.x) * u_ellipsoidInverseHeightDifferenceUv;\n\
+            #else\n\
+                float height = length(posEllipsoid);\n\
+            #endif\n\
+        #else\n\
+            #if defined(ELLIPSOID_HAS_SHAPE_BOUNDS_HEIGHT_MIN)\n\
+                // Convert the 3D position to a 2D position relative to the ellipse (radii.x, radii.z) (assuming radii.x == radii.y which is true for WGS84).\n\
+                // This is an optimization so that math can be done with ellipses instead of ellipsoids.\n\
+                vec2 posEllipse = vec2(length(posEllipsoid.xy), posEllipsoid.z);\n\
+                float height = ellipseDistanceIterative(posEllipse, u_ellipseInnerRadiiUv) * u_ellipsoidInverseHeightDifferenceUv;\n\
+            #else\n\
+                // TODO: this is probably not correct\n\
+                float height = length(posEllipsoid);\n\
+            #endif\n\
+        #endif\n\
+    #endif\n\
+\n\
+    return vec3(longitude, latitude, height);\n\
+}\n\
+";