*一年来再次重大更新：Cesium 1.83 来了

时间 2021-08-12

标签 git github 数组浏览器缓存 ide 函数工具测试优化栏目 Git 繁體版

原文原文链接

概览

动态地形夸大、过倾光线时阴影渐隐效果、增长 KTX2 和 Basis Universal 纹理格式的支持、自定义高程提供器、3D-Tiles 扩展检查机制git

提供 Windows *台外边线无效的提示文档github

修复旧式 tileset 顶级瓦片无几何偏差的错误、修复相机互操做问题、修复后处理异常和闪屏问题数组

更新部分文字性描述（文档类）浏览器

终结 IE11 的支持：1.83 是最后一个支持 IE11 的版本。缓存

破坏式更新 📣

再也不支持 KTX1 和 Crunch 纹理；使用 ktx2ktx2 升级 ktx1 文件

功能新增 🎉

新增 动态地形夸大功能，见 Globe.terrainExaggeration 和 Globe.terrainExaggerationRelativeHeight。ide

此更新是自 2015 年以来的再次优化。前者是夸大的倍数，后者是向上向下夸大的基准高度。函数

地形夸大的旧 API Globe.terrainExaggeration 将在 1.85 中移除。工具

原理：存储每一个顶点的 f32 类型的测地法线，并在着色器中将其添加到相对中心，它的效果即便不是 64 位仿真中也是不错的，官方测试中使用 32 位法线精度最多只有 10 厘米的偏差值。测试
```
float newHeight = (height - relativeHeight) * exaggeration + relativeHeight;
positionRTC += geodeticSurfaceNormal * (newHeight - height);
// ... 从 positionRTC 坐标转世界坐标
```
当地形夸大数字不是 1.0 时（哪怕是 1.01）才存储大地表面法线。因此，这是一个消耗内存的行为。静态夸大（旧API）是相似于烘焙的效果直接写入几何中，因此内存是不变的。在 TerrainMesh 类中，大约会额外占用 30% 的内存（可参考 Chrome 开发者工具的内存快照，查看具体类的内存占用）。优化

参考 pr
新增 ShadowMap 参数：options.fadingEnabled 来当光源接*地*线时，控制阴影是否具备淡出的效果。此选项默认开启。

var shadowMap = viewer.shadowMap;
  shadowMap.maximumDistance = 100000.0; // 米为单位
  shadowMap.darkness = 0; // 月球上是黑色阴影
  // !!!
  // 新 API，这个属性默认是 true，此处显性设为 false
  shadowMap.fadingEnabled = false;

新增对 KTX2 和 Basis Universal 纹理格式的支持；
- 增长对 glTF 格式中 KHR_texture_basisu 扩展的支持
- 添加了对 8 位、16 位浮点和 32 位浮点的 KTX2 镜面反射环境贴图的支持
- 在 Material 模块中添加了对 KTX2 图像的支持
- 对枚举模块 PixelFormat 和 WebGLConstants 添加了 EXT_texture_compression_bptc 和 WEBGL_compressed_texture_etc、WEBGL_compressed_texture_astc 扩展
KHR_texture_basisu 纹理支持非 2次幂尺寸的纹理贴图，可是官方仍然建议使用长宽尺寸同样的、且为 2次幂的纹理贴图。见 pr 9513
新增自定义高度图地形提供器，即新 API CustomHeightmapTerrainProvider，从一个回调函数里获取高程数据。从下列例子中可看出，只需指定能 返回高度类型数组 的回调函数、宽度、高度三个属性便可。

var width = 32;
var height = 32;
var viewer = new Cesium.Viewer("cesiumContainer", {
  terrainProvider: new Cesium.CustomHeightmapTerrainProvider({
    callback: function (x, y, level) {
      var buffer = new Float32Array(width * height);
      for (var yy = 0; yy < height; yy++) {
        for (var xx = 0; xx < width; xx++) {
          var v = (y + yy / (height - 1)) / Math.pow(2, level);
          var heightValue = 8000 * (Math.sin(4000 * v) * 0.5 + 0.5);
          var index = yy * width + xx;
          buffer[index] = heightValue;
        }
      }
      return buffer;
    },
    width: width,
    height: height,
  }),
});

有趣的是，这个虽然很灵活，可是官方仍然建议使用成熟的 TerrainProvider，由于这个没有水面特效。

3dTiles 扩展检查器

若一个 tileset 在 extensionsRequired 数组中指定了一个非官方记录的扩展，会直接弹出运行时错误：
```
throw new RuntimeError("Unsupported 3D Tiles Extension: " + extension)
```
参考 API Cesium3DTileset.checkSupportedExtensions(this._extensions)，官方参考了 ModelUtility.js 模块中对 glTF 的扩展的扩展检查。
终于！更新了文档：在 Windows *台上全部主流浏览器将忽略 outlineWidth 属性（在Windows 的 WebGL 自己不支持外边线线宽绘制）。涉及到的模块有：
- BoxGraphics
- CorridorGraphics
- CylinderGraphics
- EllipseGraphics
- EllipsoidGraphics
- PlaneGraphics
- PolygonGraphics
- RectangleGraphics
- WallGraphics
- PolylineVolumeGraphics
届时能够查看最新的帮助文档。
为 KmlTour, KmlTourFlyTo, 和 KmlTourWait 模块增长了文档。为 KmlDataSource 模块的 kmlTours 读类型属性添加文档，并从 KmlTourSoundCues 类中移除文档引用。
对 OSM Buildings 以及其余在 glTF 模型中用到了 CESIUM_primitive_outline 扩展的 tileset 提供隐藏边线的能力。

主要是在 Model.js、Batched3DModel3DTileContent.js、Cesium3DTileset.js、Gltf3DTileContent.js、Instanced3DModel3DTileContent.js、ModelInstanceCollection.js、createOsmBuildings.js、ModelSpec.js 做出了修改，部分模块加入 showOutline 属性。（参考 pr）
对于 glTF 某些特定的纹理和 ImageBitmap 的色彩空间，提供了 ignore 选项。

修复🔧

修复了一些旧式 tileset 中顶级瓦片由于没有几何偏差而不加载的错误

以往有一些 3dtiles 的根属性中没有 geometricError，会致使 preprocess3DTileContent.js 模块判断错误。在 1.83 中已修复为判断 root 属性。

修复了 WebMapTileServiceImageryProvider 这个模块中若 URL 使用了子域（SubDomains）后，请求会由于查询参数而失败的状况（详细问题见：9598）
修复了 ScreenSpaceCameraController.tilt3DOnTerain API 中当摇晃相机视角时，会有偏移的小问题。精彩推理见：9562 彷佛是国人
当地球表面瓦片（GlobeSurfaceTile模块）请求错误时，修复在控制台中的报错
修复了沙盒示例中 KML 示例的缩略图丢失

修复了 GlobeFS 着色器中当自定义材质的 positionToEyeEC 和 tangentToEyeMatrix 属性未设置的错误

// GlobeFS.glsl
void main() {
  // 其余部分略
  materialInput.positionToEyeEC = -v_positionEC;
  materialInput.tangentToEyeMatrix = czm_eastNorthUpToEyeCoordinates(v_positionMC, normalize(v_normalEC));  
}

修复了 Matrix4 模块中 inverse 和 inverseTransformation 中使用仿射变换的误导性文档，已使用旋转和*移替代。
当 glTF 模型引用了外部图像资源且没有被 preferImageBitmap 加载时，它会在主线程的解码过程当中形成帧率暴跌的问题，已经修复；一般 glTF 的图像资源都是内嵌的，也就是 glb 的形式，这个问题被官方发现并修复。针对的模块：Scene/GltfImageLoader.js 和 Scene/Model.js
修复 Cesium3DTileStyle 中关于颜色、显隐的误导性 else 条件设置。逻辑上，若是没有给定，那就应该使用默认值 true。主要针对的模块：Scene/Cesium3DTileBatchTable.js
修复后处理禁用后再启用时发生崩溃的问题，这个修复同时能防止在第一次启用后处理阶段功能时闪屏的问题。缘由彷佛是若是没有任何一个后处理阶段被标记为活动的话，缓存的纹理就不会建立 FBO，虽然这些后处理都启用了。针对模块：PostProcessStageCollection.js

功能废弃⏳

CesiumWidget, Viewer, 及 Scene 模块的 Scene.terrainExaggeration、options.terrainExaggeration 将会在 1.85 版本中移除。使用 Globe.terrainExaggeration API 来代替他们。
loadCRN 和 loadKTX 函数被移除。
对 IE11 的支持将在 1.84 正式中止