@cesium/engine 10.0.0 → 10.1.0

package/Source/Shaders/Model/ImageBasedLightingStageFS.js

@@ -17,10 +17,10 @@ vec3 getProceduralSkyMetrics(vec3 positionWC, vec3 reflectionWC)\n\
 }\n\
 \n\
 /**\n\
- * Compute the diffuse irradiance for a procedural sky lighting model\n\
+ * Compute the diffuse irradiance for a procedural sky lighting model.\n\
  *\n\
  * @param {vec3} skyMetrics The dot products of the horizon and reflection directions with the nadir, and an atmosphere boundary distance.\n\
- * @return {vec3} The computed diffuse irradiance\n\
+ * @return {vec3} The computed diffuse irradiance.\n\
  */\n\
 vec3 getProceduralDiffuseIrradiance(vec3 skyMetrics)\n\
 {\n\
@@ -31,10 +31,12 @@ vec3 getProceduralDiffuseIrradiance(vec3 skyMetrics)\n\
 }\n\
 \n\
 /**\n\
- * Compute the specular irradiance for a procedural sky lighting model\n\
+ * Compute the specular irradiance for a procedural sky lighting model.\n\
  *\n\
+ * @param {vec3} reflectionWC The reflection vector in world coordinates.\n\
  * @param {vec3} skyMetrics The dot products of the horizon and reflection directions with the nadir, and an atmosphere boundary distance.\n\
- * @return {vec3} The computed specular irradiance\n\
+ * @param {float} roughness The roughness of the material.\n\
+ * @return {vec3} The computed specular irradiance.\n\
  */\n\
 vec3 getProceduralSpecularIrradiance(vec3 reflectionWC, vec3 skyMetrics, float roughness)\n\
 {\n\
@@ -43,7 +45,7 @@ vec3 getProceduralSpecularIrradiance(vec3 reflectionWC, vec3 skyMetrics, float r
     reflectionWC = -normalize(czm_temeToPseudoFixed * reflectionWC);\n\
     reflectionWC.x = -reflectionWC.x;\n\
 \n\
-    float inverseRoughness = 1.04 - roughness;\n\
+    float inverseRoughness = 1.0 - roughness;\n\
     inverseRoughness *= inverseRoughness;\n\
     vec3 sceneSkyBox = czm_textureCube(czm_environmentMap, reflectionWC).rgb * inverseRoughness;\n\
 \n\
@@ -122,7 +124,7 @@ float getSunLuminance(vec3 positionWC, vec3 normalEC, vec3 lightDirectionEC)\n\
 ) {\n\
     vec3 viewDirectionEC = -normalize(positionEC);\n\
     vec3 positionWC = vec3(czm_inverseView * vec4(positionEC, 1.0));\n\
-    vec3 reflectionWC = normalize(czm_inverseViewRotation * normalize(reflect(viewDirectionEC, normalEC)));\n\
+    vec3 reflectionWC = normalize(czm_inverseViewRotation * reflect(viewDirectionEC, normalEC));\n\
     vec3 skyMetrics = getProceduralSkyMetrics(positionWC, reflectionWC);\n\
 \n\
     float roughness = material.roughness;\n\
@@ -174,11 +176,12 @@ vec3 sampleSpecularEnvironment(vec3 cubeDir, float roughness)\n\
         return czm_sampleOctahedralProjection(czm_specularEnvironmentMaps, czm_specularEnvironmentMapSize, cubeDir, lod, maxLod);\n\
     #endif\n\
 }\n\
-vec3 computeSpecularIBL(vec3 cubeDir, float NdotV, float VdotH, vec3 f0, float roughness)\n\
+vec3 computeSpecularIBL(vec3 cubeDir, float NdotV, vec3 f0, float roughness)\n\
 {\n\
-    float reflectance = czm_maximumComponent(f0);\n\
-    vec3 f90 = vec3(clamp(reflectance * 25.0, 0.0, 1.0));\n\
-    vec3 F = fresnelSchlick2(f0, f90, VdotH);\n\
+    // see https://bruop.github.io/ibl/ at Single Scattering Results\n\
+    // Roughness dependent fresnel, from Fdez-Aguera\n\
+    vec3 f90 = max(vec3(1.0 - roughness), f0);\n\
+    vec3 F = fresnelSchlick2(f0, f90, NdotV);\n\
 \n\
     vec2 brdfLut = texture(czm_brdfLut, vec2(NdotV, roughness)).rg;\n\
     vec3 specularSample = sampleSpecularEnvironment(cubeDir, roughness);\n\
@@ -203,34 +206,31 @@ vec3 textureIBL(\n\
     vec3 lightDirectionEC,\n\
     czm_modelMaterial material\n\
 ) {\n\
-    // Find the direction in which to sample the environment map\n\
-    vec3 cubeDir = normalize(model_iblReferenceFrameMatrix * normalize(reflect(-viewDirectionEC, normalEC)));\n\
-\n\
     #ifdef DIFFUSE_IBL\n\
-        vec3 diffuseContribution = computeDiffuseIBL(cubeDir) * material.diffuse;\n\
+        vec3 normalMC = normalize(model_iblReferenceFrameMatrix * normalEC);\n\
+        vec3 diffuseContribution = computeDiffuseIBL(normalMC) * material.diffuse;\n\
     #else\n\
         vec3 diffuseContribution = vec3(0.0); \n\
     #endif\n\
-\n\
-    float roughness = material.roughness;\n\
 \n\
     #ifdef USE_ANISOTROPY\n\
-        // Update environment map sampling direction to account for anisotropic distortion of specular reflection\n\
+        // Bend normal to account for anisotropic distortion of specular reflection\n\
         vec3 anisotropyDirection = material.anisotropicB;\n\
         vec3 anisotropicTangent = cross(anisotropyDirection, viewDirectionEC);\n\
         vec3 anisotropicNormal = cross(anisotropicTangent, anisotropyDirection);\n\
-        float bendFactor = 1.0 - material.anisotropyStrength * (1.0 - roughness);\n\
+        float bendFactor = 1.0 - material.anisotropyStrength * (1.0 - material.roughness);\n\
         float bendFactorPow4 = bendFactor * bendFactor * bendFactor * bendFactor;\n\
         vec3 bentNormal = normalize(mix(anisotropicNormal, normalEC, bendFactorPow4));\n\
-        cubeDir = normalize(model_iblReferenceFrameMatrix * normalize(reflect(-viewDirectionEC, bentNormal)));\n\
+        vec3 reflectEC = reflect(-viewDirectionEC, bentNormal);\n\
+    #else\n\
+        vec3 reflectEC = reflect(-viewDirectionEC, normalEC);\n\
     #endif\n\
 \n\
     #ifdef SPECULAR_IBL\n\
-        float NdotV = abs(dot(normalEC, viewDirectionEC)) + 0.001;\n\
-        vec3 halfwayDirectionEC = normalize(viewDirectionEC + lightDirectionEC);\n\
-        float VdotH = clamp(dot(viewDirectionEC, halfwayDirectionEC), 0.0, 1.0);\n\
+        vec3 reflectMC = normalize(model_iblReferenceFrameMatrix * reflectEC);\n\
+        float NdotV = clamp(dot(normalEC, viewDirectionEC), 0.0, 1.0);\n\
         vec3 f0 = material.specular;\n\
-        vec3 specularContribution = computeSpecularIBL(cubeDir, NdotV, VdotH, f0, roughness);\n\
+        vec3 specularContribution = computeSpecularIBL(reflectMC, NdotV, f0, material.roughness);\n\
     #else\n\
         vec3 specularContribution = vec3(0.0); \n\
     #endif\n\

package/Source/Shaders/Model/LightingStageFS.glsl

@@ -34,18 +34,19 @@ vec3 addClearcoatReflection(vec3 baseLayerColor, vec3 position, vec3 lightDirect
 
     // compute specular reflection from direct lighting
     float roughness = material.clearcoatRoughness;
-    float directStrength = computeDirectSpecularStrength(normal, lightDirection, viewDirection, halfwayDirection, roughness);
+    float alphaRoughness = roughness * roughness;
+    float directStrength = computeDirectSpecularStrength(normal, lightDirection, viewDirection, halfwayDirection, alphaRoughness);
     vec3 directReflection = F * directStrength * NdotL;
     vec3 color = lightColorHdr * directReflection;
 
     #ifdef SPECULAR_IBL
         // Find the direction in which to sample the environment map
-        vec3 cubeDir = normalize(model_iblReferenceFrameMatrix * normalize(reflect(-viewDirection, normal)));
-        vec3 iblColor = computeSpecularIBL(cubeDir, NdotV, NdotV, f0, roughness);
+        vec3 reflectMC = normalize(model_iblReferenceFrameMatrix * reflect(-viewDirection, normal));
+        vec3 iblColor = computeSpecularIBL(reflectMC, NdotV, f0, roughness);
         color += iblColor * material.occlusion;
     #elif defined(USE_IBL_LIGHTING)
         vec3 positionWC = vec3(czm_inverseView * vec4(position, 1.0));
-        vec3 reflectionWC = normalize(czm_inverseViewRotation * normalize(reflect(viewDirection, normal)));
+        vec3 reflectionWC = normalize(czm_inverseViewRotation * reflect(viewDirection, normal));
         vec3 skyMetrics = getProceduralSkyMetrics(positionWC, reflectionWC);
 
         vec3 specularIrradiance = getProceduralSpecularIrradiance(reflectionWC, skyMetrics, roughness);
@@ -57,7 +58,7 @@ vec3 addClearcoatReflection(vec3 baseLayerColor, vec3 position, vec3 lightDirect
         #endif
         float maximumComponent = czm_maximumComponent(lightColorHdr);
         vec3 clampedLightColor = lightColorHdr / max(maximumComponent, 1.0);
-        color += clampedLightColor* iblColor * material.occlusion;
+        color += clampedLightColor * iblColor * material.occlusion;
     #endif
 
     float clearcoatFactor = material.clearcoatFactor;

package/Source/Shaders/Model/LightingStageFS.js

@@ -35,18 +35,19 @@ vec3 addClearcoatReflection(vec3 baseLayerColor, vec3 position, vec3 lightDirect
 \n\
     // compute specular reflection from direct lighting\n\
     float roughness = material.clearcoatRoughness;\n\
-    float directStrength = computeDirectSpecularStrength(normal, lightDirection, viewDirection, halfwayDirection, roughness);\n\
+    float alphaRoughness = roughness * roughness;\n\
+    float directStrength = computeDirectSpecularStrength(normal, lightDirection, viewDirection, halfwayDirection, alphaRoughness);\n\
     vec3 directReflection = F * directStrength * NdotL;\n\
     vec3 color = lightColorHdr * directReflection;\n\
 \n\
     #ifdef SPECULAR_IBL\n\
         // Find the direction in which to sample the environment map\n\
-        vec3 cubeDir = normalize(model_iblReferenceFrameMatrix * normalize(reflect(-viewDirection, normal)));\n\
-        vec3 iblColor = computeSpecularIBL(cubeDir, NdotV, NdotV, f0, roughness);\n\
+        vec3 reflectMC = normalize(model_iblReferenceFrameMatrix * reflect(-viewDirection, normal));\n\
+        vec3 iblColor = computeSpecularIBL(reflectMC, NdotV, f0, roughness);\n\
         color += iblColor * material.occlusion;\n\
     #elif defined(USE_IBL_LIGHTING)\n\
         vec3 positionWC = vec3(czm_inverseView * vec4(position, 1.0));\n\
-        vec3 reflectionWC = normalize(czm_inverseViewRotation * normalize(reflect(viewDirection, normal)));\n\
+        vec3 reflectionWC = normalize(czm_inverseViewRotation * reflect(viewDirection, normal));\n\
         vec3 skyMetrics = getProceduralSkyMetrics(positionWC, reflectionWC);\n\
 \n\
         vec3 specularIrradiance = getProceduralSpecularIrradiance(reflectionWC, skyMetrics, roughness);\n\
@@ -58,7 +59,7 @@ vec3 addClearcoatReflection(vec3 baseLayerColor, vec3 position, vec3 lightDirect
         #endif\n\
         float maximumComponent = czm_maximumComponent(lightColorHdr);\n\
         vec3 clampedLightColor = lightColorHdr / max(maximumComponent, 1.0);\n\
-        color += clampedLightColor* iblColor * material.occlusion;\n\
+        color += clampedLightColor * iblColor * material.occlusion;\n\
     #endif\n\
 \n\
     float clearcoatFactor = material.clearcoatFactor;\n\

package/Source/Shaders/Model/MaterialStageFS.glsl

@@ -258,8 +258,7 @@ void setSpecularGlossiness(inout czm_modelMaterial material)
     material.specular = specular;
 
     // glossiness is the opposite of roughness, but easier for artists to use.
-    float roughness = 1.0 - glossiness;
-    material.roughness = roughness * roughness;
+    material.roughness = 1.0 - glossiness;
 }
 #elif defined(LIGHTING_PBR)
 float setMetallicRoughness(inout czm_modelMaterial material)
@@ -272,7 +271,7 @@ float setMetallicRoughness(inout czm_modelMaterial material)
 
         vec3 metallicRoughness = texture(u_metallicRoughnessTexture, metallicRoughnessTexCoords).rgb;
         float metalness = clamp(metallicRoughness.b, 0.0, 1.0);
-        float roughness = clamp(metallicRoughness.g, 0.04, 1.0);
+        float roughness = clamp(metallicRoughness.g, 0.0, 1.0);
         #ifdef HAS_METALLIC_FACTOR
             metalness = clamp(metalness * u_metallicFactor, 0.0, 1.0);
         #endif
@@ -288,7 +287,7 @@ float setMetallicRoughness(inout czm_modelMaterial material)
         #endif
 
         #ifdef HAS_ROUGHNESS_FACTOR
-            float roughness = clamp(u_roughnessFactor, 0.04, 1.0);
+            float roughness = clamp(u_roughnessFactor, 0.0, 1.0);
         #else
             float roughness = 1.0;
         #endif
@@ -303,9 +302,8 @@ float setMetallicRoughness(inout czm_modelMaterial material)
     // diffuse only applies to dielectrics.
     material.diffuse = mix(material.baseColor.rgb, vec3(0.0), metalness);
 
-    // roughness is authored as perceptual roughness
-    // square it to get material roughness
-    material.roughness = roughness * roughness;
+    // This is perceptual roughness. The square of this value is used for direct lighting
+    material.roughness = roughness;
 
     return metalness;
 }
@@ -418,9 +416,8 @@ void setClearcoat(inout czm_modelMaterial material, in ProcessedAttributes attri
     #endif
 
     material.clearcoatFactor = clearcoatFactor;
-    // roughness is authored as perceptual roughness
-    // square it to get material roughness
-    material.clearcoatRoughness = clearcoatRoughness * clearcoatRoughness;
+    // This is perceptual roughness. The square of this value is used for direct lighting
+    material.clearcoatRoughness = clearcoatRoughness;
     #ifdef HAS_CLEARCOAT_NORMAL_TEXTURE
         material.clearcoatNormal = getClearcoatNormalFromTexture(attributes, attributes.normalEC);
     #else
@@ -458,14 +455,13 @@ void materialStage(inout czm_modelMaterial material, ProcessedAttributes attribu
         baseColorWithAlpha *= color;
     #endif
 
+    #ifdef USE_CPU_STYLING
+        baseColorWithAlpha.rgb = blend(baseColorWithAlpha.rgb, feature.color.rgb, model_colorBlend);
+    #endif
     material.baseColor = baseColorWithAlpha;
     material.diffuse = baseColorWithAlpha.rgb;
     material.alpha = baseColorWithAlpha.a;
 
-    #ifdef USE_CPU_STYLING
-        material.diffuse = blend(material.diffuse, feature.color.rgb, model_colorBlend);
-    #endif
-
     #ifdef HAS_OCCLUSION_TEXTURE
         vec2 occlusionTexCoords = TEXCOORD_OCCLUSION;
         #ifdef HAS_OCCLUSION_TEXTURE_TRANSFORM

package/Source/Shaders/Model/MaterialStageFS.js

@@ -259,8 +259,7 @@ void setSpecularGlossiness(inout czm_modelMaterial material)\n\
     material.specular = specular;\n\
 \n\
     // glossiness is the opposite of roughness, but easier for artists to use.\n\
-    float roughness = 1.0 - glossiness;\n\
-    material.roughness = roughness * roughness;\n\
+    material.roughness = 1.0 - glossiness;\n\
 }\n\
 #elif defined(LIGHTING_PBR)\n\
 float setMetallicRoughness(inout czm_modelMaterial material)\n\
@@ -273,7 +272,7 @@ float setMetallicRoughness(inout czm_modelMaterial material)\n\
 \n\
         vec3 metallicRoughness = texture(u_metallicRoughnessTexture, metallicRoughnessTexCoords).rgb;\n\
         float metalness = clamp(metallicRoughness.b, 0.0, 1.0);\n\
-        float roughness = clamp(metallicRoughness.g, 0.04, 1.0);\n\
+        float roughness = clamp(metallicRoughness.g, 0.0, 1.0);\n\
         #ifdef HAS_METALLIC_FACTOR\n\
             metalness = clamp(metalness * u_metallicFactor, 0.0, 1.0);\n\
         #endif\n\
@@ -289,7 +288,7 @@ float setMetallicRoughness(inout czm_modelMaterial material)\n\
         #endif\n\
 \n\
         #ifdef HAS_ROUGHNESS_FACTOR\n\
-            float roughness = clamp(u_roughnessFactor, 0.04, 1.0);\n\
+            float roughness = clamp(u_roughnessFactor, 0.0, 1.0);\n\
         #else\n\
             float roughness = 1.0;\n\
         #endif\n\
@@ -304,9 +303,8 @@ float setMetallicRoughness(inout czm_modelMaterial material)\n\
     // diffuse only applies to dielectrics.\n\
     material.diffuse = mix(material.baseColor.rgb, vec3(0.0), metalness);\n\
 \n\
-    // roughness is authored as perceptual roughness\n\
-    // square it to get material roughness\n\
-    material.roughness = roughness * roughness;\n\
+    // This is perceptual roughness. The square of this value is used for direct lighting\n\
+    material.roughness = roughness;\n\
 \n\
     return metalness;\n\
 }\n\
@@ -419,9 +417,8 @@ void setClearcoat(inout czm_modelMaterial material, in ProcessedAttributes attri
     #endif\n\
 \n\
     material.clearcoatFactor = clearcoatFactor;\n\
-    // roughness is authored as perceptual roughness\n\
-    // square it to get material roughness\n\
-    material.clearcoatRoughness = clearcoatRoughness * clearcoatRoughness;\n\
+    // This is perceptual roughness. The square of this value is used for direct lighting\n\
+    material.clearcoatRoughness = clearcoatRoughness;\n\
     #ifdef HAS_CLEARCOAT_NORMAL_TEXTURE\n\
         material.clearcoatNormal = getClearcoatNormalFromTexture(attributes, attributes.normalEC);\n\
     #else\n\
@@ -459,13 +456,12 @@ void materialStage(inout czm_modelMaterial material, ProcessedAttributes attribu
         baseColorWithAlpha *= color;\n\
     #endif\n\
 \n\
+    #ifdef USE_CPU_STYLING\n\
+        baseColorWithAlpha.rgb = blend(baseColorWithAlpha.rgb, feature.color.rgb, model_colorBlend);\n\
+    #endif\n\
     material.baseColor = baseColorWithAlpha;\n\
     material.diffuse = baseColorWithAlpha.rgb;\n\
     material.alpha = baseColorWithAlpha.a;\n\
-\n\
-    #ifdef USE_CPU_STYLING\n\
-        material.diffuse = blend(material.diffuse, feature.color.rgb, model_colorBlend);\n\
-    #endif\n\
 \n\
     #ifdef HAS_OCCLUSION_TEXTURE\n\
         vec2 occlusionTexCoords = TEXCOORD_OCCLUSION;\n\

package/Source/Shaders/PointPrimitiveCollectionFS.glsl

@@ -3,9 +3,13 @@ in vec4 v_outlineColor;
 in float v_innerPercent;
 in float v_pixelDistance;
 in vec4 v_pickColor;
+in float v_splitDirection;
 
 void main()
 {
+    if (v_splitDirection < 0.0 && gl_FragCoord.x > czm_splitPosition) discard;
+    if (v_splitDirection > 0.0 && gl_FragCoord.x < czm_splitPosition) discard;
+
     // The distance in UV space from this fragment to the center of the point, at most 0.5.
     float distanceToCenter = length(gl_PointCoord - vec2(0.5));
     // The max distance stops one pixel shy of the edge to leave space for anti-aliasing.

package/Source/Shaders/PointPrimitiveCollectionFS.js

@@ -4,9 +4,13 @@ in vec4 v_outlineColor;\n\
 in float v_innerPercent;\n\
 in float v_pixelDistance;\n\
 in vec4 v_pickColor;\n\
+in float v_splitDirection;\n\
 \n\
 void main()\n\
 {\n\
+    if (v_splitDirection < 0.0 && gl_FragCoord.x > czm_splitPosition) discard;\n\
+    if (v_splitDirection > 0.0 && gl_FragCoord.x < czm_splitPosition) discard;\n\
+\n\
     // The distance in UV space from this fragment to the center of the point, at most 0.5.\n\
     float distanceToCenter = length(gl_PointCoord - vec2(0.5));\n\
     // The max distance stops one pixel shy of the edge to leave space for anti-aliasing.\n\

package/Source/Shaders/PointPrimitiveCollectionVS.glsl

@@ -2,16 +2,17 @@ uniform float u_maxTotalPointSize;
 
 in vec4 positionHighAndSize;
 in vec4 positionLowAndOutline;
-in vec4 compressedAttribute0;                       // color, outlineColor, pick color
-in vec4 compressedAttribute1;                       // show, translucency by distance, some free space
-in vec4 scaleByDistance;                            // near, nearScale, far, farScale
-in vec3 distanceDisplayConditionAndDisableDepth;    // near, far, disableDepthTestDistance
+in vec4 compressedAttribute0;                                        // color, outlineColor, pick color
+in vec4 compressedAttribute1;                                        // show, translucency by distance, some free space
+in vec4 scaleByDistance;                                             // near, nearScale, far, farScale
+in vec4 distanceDisplayConditionAndDisableDepthAndSplitDirection;    // near, far, disableDepthTestDistance, splitDirection
 
 out vec4 v_color;
 out vec4 v_outlineColor;
 out float v_innerPercent;
 out float v_pixelDistance;
 out vec4 v_pickColor;
+out float v_splitDirection;
 
 const float SHIFT_LEFT8 = 256.0;
 const float SHIFT_RIGHT8 = 1.0 / 256.0;
@@ -135,8 +136,8 @@ void main()
 #endif
 
 #ifdef DISTANCE_DISPLAY_CONDITION
-    float nearSq = distanceDisplayConditionAndDisableDepth.x;
-    float farSq = distanceDisplayConditionAndDisableDepth.y;
+    float nearSq = distanceDisplayConditionAndDisableDepthAndSplitDirection.x;
+    float farSq = distanceDisplayConditionAndDisableDepthAndSplitDirection.y;
     if (lengthSq < nearSq || lengthSq > farSq) {
         // push vertex behind camera to force it to be clipped
         positionEC.xyz = vec3(0.0, 0.0, 1.0);
@@ -147,7 +148,7 @@ void main()
     czm_vertexLogDepth();
 
 #ifdef DISABLE_DEPTH_DISTANCE
-    float disableDepthTestDistance = distanceDisplayConditionAndDisableDepth.z;
+    float disableDepthTestDistance = distanceDisplayConditionAndDisableDepthAndSplitDirection.z;
     if (disableDepthTestDistance == 0.0 && czm_minimumDisableDepthTestDistance != 0.0)
     {
         disableDepthTestDistance = czm_minimumDisableDepthTestDistance;
@@ -180,4 +181,5 @@ void main()
     gl_Position *= show;
 
     v_pickColor = pickColor;
+    v_splitDirection = distanceDisplayConditionAndDisableDepthAndSplitDirection.w;
 }

package/Source/Shaders/PointPrimitiveCollectionVS.js

@@ -3,16 +3,17 @@ export default "uniform float u_maxTotalPointSize;\n\
 \n\
 in vec4 positionHighAndSize;\n\
 in vec4 positionLowAndOutline;\n\
-in vec4 compressedAttribute0;                       // color, outlineColor, pick color\n\
-in vec4 compressedAttribute1;                       // show, translucency by distance, some free space\n\
-in vec4 scaleByDistance;                            // near, nearScale, far, farScale\n\
-in vec3 distanceDisplayConditionAndDisableDepth;    // near, far, disableDepthTestDistance\n\
+in vec4 compressedAttribute0;                                        // color, outlineColor, pick color\n\
+in vec4 compressedAttribute1;                                        // show, translucency by distance, some free space\n\
+in vec4 scaleByDistance;                                             // near, nearScale, far, farScale\n\
+in vec4 distanceDisplayConditionAndDisableDepthAndSplitDirection;    // near, far, disableDepthTestDistance, splitDirection\n\
 \n\
 out vec4 v_color;\n\
 out vec4 v_outlineColor;\n\
 out float v_innerPercent;\n\
 out float v_pixelDistance;\n\
 out vec4 v_pickColor;\n\
+out float v_splitDirection;\n\
 \n\
 const float SHIFT_LEFT8 = 256.0;\n\
 const float SHIFT_RIGHT8 = 1.0 / 256.0;\n\
@@ -136,8 +137,8 @@ void main()\n\
 #endif\n\
 \n\
 #ifdef DISTANCE_DISPLAY_CONDITION\n\
-    float nearSq = distanceDisplayConditionAndDisableDepth.x;\n\
-    float farSq = distanceDisplayConditionAndDisableDepth.y;\n\
+    float nearSq = distanceDisplayConditionAndDisableDepthAndSplitDirection.x;\n\
+    float farSq = distanceDisplayConditionAndDisableDepthAndSplitDirection.y;\n\
     if (lengthSq < nearSq || lengthSq > farSq) {\n\
         // push vertex behind camera to force it to be clipped\n\
         positionEC.xyz = vec3(0.0, 0.0, 1.0);\n\
@@ -148,7 +149,7 @@ void main()\n\
     czm_vertexLogDepth();\n\
 \n\
 #ifdef DISABLE_DEPTH_DISTANCE\n\
-    float disableDepthTestDistance = distanceDisplayConditionAndDisableDepth.z;\n\
+    float disableDepthTestDistance = distanceDisplayConditionAndDisableDepthAndSplitDirection.z;\n\
     if (disableDepthTestDistance == 0.0 && czm_minimumDisableDepthTestDistance != 0.0)\n\
     {\n\
         disableDepthTestDistance = czm_minimumDisableDepthTestDistance;\n\
@@ -181,5 +182,6 @@ void main()\n\
     gl_Position *= show;\n\
 \n\
     v_pickColor = pickColor;\n\
+    v_splitDirection = distanceDisplayConditionAndDisableDepthAndSplitDirection.w;\n\
 }\n\
 ";

package/index.d.ts

@@ -15890,7 +15890,7 @@ export namespace Simon1994PlanetaryPositions {
     function computeSunPositionInEarthInertialFrame(julianDate?: JulianDate, result?: Cartesian3): Cartesian3;
     /**
      * Computes the position of the Moon in the Earth-centered inertial frame
-     * @param [julianDate] - The time at which to compute the moon's position, if not provided the current system time is used.
+     * @param [julianDate] - The time at which to compute the Moon's position, if not provided the current system time is used.
      * @param [result] - The object onto which to store the result.
      * @returns Calculated moon position
      */
@@ -17292,6 +17292,21 @@ export namespace Transforms {
      * @returns The modified result parameter or a new HeadingPitchRoll instance if none was provided.
      */
     function fixedFrameToHeadingPitchRoll(transform: Matrix4, ellipsoid?: Ellipsoid, fixedFrameTransform?: Transforms.LocalFrameToFixedFrame, result?: HeadingPitchRoll): HeadingPitchRoll;
+    /**
+     * The default function to compute a rotation matrix to transform a point or vector from the International Celestial
+     * Reference Frame (GCRF/ICRF) inertial frame axes to the central body, typically Earth, fixed frame axis at a given
+     * time for use in lighting and transformation from inertial reference frames. This function may return undefined if
+     * the data necessary to do the transformation is not yet loaded.
+     * @example
+     * // Set the default ICRF to fixed transformation to that of the Moon.
+     * Cesium.Transforms.computeIcrfToCentralBodyFixedMatrix = Cesium.Transforms.computeIcrfToMoonFixedMatrix;
+     * @param date - The time at which to compute the rotation matrix.
+     * @param [result] - The object onto which to store the result.  If this parameter is
+     *                  not specified, a new instance is created and returned.
+     * @returns The rotation matrix, or undefined if the data necessary to do the
+     *                   transformation is not yet loaded.
+     */
+    function computeIcrfToCentralBodyFixedMatrix(date: JulianDate, result?: Matrix3): Matrix3 | undefined;
     /**
      * Computes a rotation matrix to transform a point or vector from True Equator Mean Equinox (TEME) axes to the
      * pseudo-fixed axes at a given time.  This method treats the UT1 time standard as equivalent to UTC.
@@ -17345,7 +17360,39 @@ export namespace Transforms {
      * @returns The rotation matrix, or undefined if the data necessary to do the
      *                   transformation is not yet loaded.
      */
-    function computeIcrfToFixedMatrix(date: JulianDate, result?: Matrix3): Matrix3;
+    function computeIcrfToFixedMatrix(date: JulianDate, result?: Matrix3): Matrix3 | undefined;
+    /**
+     * Computes a rotation matrix to transform a point or vector from the Moon-Fixed frame axes
+     * to the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes
+     * at a given time.
+     * @example
+     * // Transform a point from the Fixed axes to the ICRF axes.
+     * const now = Cesium.JulianDate.now();
+     * const pointInFixed = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
+     * const fixedToIcrf = Cesium.Transforms.computeMoonFixedToIcrfMatrix(now);
+     * let pointInInertial = new Cesium.Cartesian3();
+     * if (Cesium.defined(fixedToIcrf)) {
+     *     pointInInertial = Cesium.Matrix3.multiplyByVector(fixedToIcrf, pointInFixed, pointInInertial);
+     * }
+     * @param date - The time at which to compute the rotation matrix.
+     * @param [result] - The object onto which to store the result.  If this parameter is
+     *                  not specified, a new instance is created and returned.
+     * @returns The rotation matrix.
+     */
+    function computeMoonFixedToIcrfMatrix(date: JulianDate, result?: Matrix3): Matrix3;
+    /**
+     * Computes a rotation matrix to transform a point or vector from the International Celestial
+     * Reference Frame (GCRF/ICRF) inertial frame axes to the Moon-Fixed frame axes
+     * at a given time.
+     * @example
+     * // Set the default ICRF to fixed transformation to that of the Moon.
+     * Cesium.Transforms.computeIcrfToCentralBodyFixedMatrix = Cesium.Transforms.computeIcrfToMoonFixedMatrix;
+     * @param date - The time at which to compute the rotation matrix.
+     * @param [result] - The object onto which to store the result.  If this parameter is
+     *                  not specified, a new instance is created and returned.
+     * @returns The rotation matrix.
+     */
+    function computeIcrfToMoonFixedMatrix(date: JulianDate, result?: Matrix3): Matrix3;
     /**
      * Computes a rotation matrix to transform a point or vector from the Earth-Fixed frame axes (ITRF)
      * to the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes
@@ -17366,7 +17413,7 @@ export namespace Transforms {
      * @returns The rotation matrix, or undefined if the data necessary to do the
      *                   transformation is not yet loaded.
      */
-    function computeFixedToIcrfMatrix(date: JulianDate, result?: Matrix3): Matrix3;
+    function computeFixedToIcrfMatrix(date: JulianDate, result?: Matrix3): Matrix3 | undefined;
     /**
      * Transform a point from model coordinates to window coordinates.
      * @param modelViewProjectionMatrix - The 4x4 model-view-projection matrix.
@@ -18654,6 +18701,7 @@ export namespace BillboardGraphics {
      * @property [imageSubRegion] - A Property specifying a {@link BoundingRectangle} that defines a sub-region of the image to use for the billboard, rather than the entire image, measured in pixels from the bottom-left.
      * @property [distanceDisplayCondition] - A Property specifying at what distance from the camera that this billboard will be displayed.
      * @property [disableDepthTestDistance] - A Property specifying the distance from the camera at which to disable the depth test to.
+     * @property [splitDirection] - A Property specifying the {@link SplitDirection} of the billboard.
      */
     type ConstructorOptions = {
         show?: Property | boolean;
@@ -18676,6 +18724,7 @@ export namespace BillboardGraphics {
         imageSubRegion?: Property | BoundingRectangle;
         distanceDisplayCondition?: Property | DistanceDisplayCondition;
         disableDepthTestDistance?: Property | number;
+        splitDirection?: Property | SplitDirection;
     };
 }
 
@@ -18842,6 +18891,10 @@ export class BillboardGraphics {
      * When set to zero, the depth test is always applied. When set to Number.POSITIVE_INFINITY, the depth test is never applied.
      */
     disableDepthTestDistance: Property | undefined;
+    /**
+     * Gets or sets the Property specifying the {@link SplitDirection} of this billboard.
+     */
+    splitDirection: Property | undefined;
     /**
      * Duplicates this instance.
      * @param [result] - The object onto which to store the result.
@@ -22994,6 +23047,7 @@ export namespace PointGraphics {
      * @property [translucencyByDistance] - A {@link NearFarScalar} Property used to set translucency based on distance from the camera.
      * @property [distanceDisplayCondition] - A Property specifying at what distance from the camera that this point will be displayed.
      * @property [disableDepthTestDistance] - A Property specifying the distance from the camera at which to disable the depth test to.
+     * @property [splitDirection] - A Property specifying the {@link SplitDirection} split to apply to this point.
      */
     type ConstructorOptions = {
         show?: Property | boolean;
@@ -23006,6 +23060,7 @@ export namespace PointGraphics {
         translucencyByDistance?: Property | NearFarScalar;
         distanceDisplayCondition?: Property | DistanceDisplayCondition;
         disableDepthTestDistance?: Property | number;
+        splitDirection?: Property | SplitDirection;
     };
 }
 
@@ -23065,6 +23120,10 @@ export class PointGraphics {
      * When set to zero, the depth test is always applied. When set to Number.POSITIVE_INFINITY, the depth test is never applied.
      */
     disableDepthTestDistance: Property | undefined;
+    /**
+     * Gets or sets the Property specifying the {@link SplitDirection} of this point.
+     */
+    splitDirection: Property | undefined;
     /**
      * Duplicates this instance.
      * @param [result] - The object onto which to store the result.
@@ -25865,6 +25924,7 @@ export namespace Billboard {
      * @property [imageSubRegion] - A {@link BoundingRectangle} Specifying the sub-region of the image to use for the billboard, rather than the entire image.
      * @property [distanceDisplayCondition] - A {@link DistanceDisplayCondition} Specifying the distance from the camera at which this billboard will be displayed.
      * @property [disableDepthTestDistance] - A number specifying the distance from the camera at which to disable the depth test to, for example, prevent clipping against terrain.
+     * @property [splitDirection] - A {@link SplitDirection} Specifying the split property of the billboard.
      */
     type ConstructorOptions = {
         position: Cartesian3;
@@ -25889,6 +25949,7 @@ export namespace Billboard {
         imageSubRegion?: BoundingRectangle;
         distanceDisplayCondition?: DistanceDisplayCondition;
         disableDepthTestDistance?: number;
+        splitDirection?: SplitDirection;
     };
     /**
      * A function that creates an image.
@@ -26155,6 +26216,10 @@ export class Billboard {
      * has been downloaded and the WebGL resources are created.
      */
     readonly ready: boolean;
+    /**
+     * Gets or sets the {@link SplitDirection} of this billboard.
+     */
+    splitDirection: SplitDirection;
     /**
      * <p>
      * Sets the image to be used for this billboard.  If a texture has already been created for the
@@ -33541,8 +33606,8 @@ export class ImageBasedLighting {
      * </p>
      *
      * These values can be obtained by preprocessing the environment map using the <code>cmgen</code> tool of
-     * {@link https://github.com/google/filament/releases|Google's Filament project}. This will also generate a KTX file that can be
-     * supplied to {@link Model#specularEnvironmentMaps}.
+     * {@link https://github.com/google/filament/releases|Google's Filament project}.
+     * Be sure to use the <code>--no-mirror</code> option in <code>cmgen</code>.
      */
     sphericalHarmonicCoefficients: Cartesian3[];
     /**
@@ -38327,6 +38392,10 @@ export class PointPrimitive {
      * Gets or sets the user-defined value returned when the point is picked.
      */
     id: any;
+    /**
+     * The {@link SplitDirection} to apply to this point.
+     */
+    splitDirection: SplitDirection;
     /**
      * Computes the screen-space position of the point's origin.
      * The screen space origin is the top, left corner of the canvas; <code>x</code> increases from