I3SGeometry

I3SGeometry 是一个 CesiumJS 中用于加载 I3S 数据的几何对象接口。

概述

I3SGeometry 用于加载 I3S 中的几何对象，包括点、线、面、网格等多种类型，同时支持动态 LOD、多层瓦片等功能。

使用方法

使用 I3SGeometry 首先需要创建一个 Cesium.I3DTileset 对象，用于加载 I3S 数据：

var tileset = new Cesium.I3DTileset({
    url: 'path/to/your/i3s/file'
});

创建完成后，可以监听 tileset 的 tileLoad 事件来获取每个瓦片对应的 I3SGeometry 对象：

tileset.tileLoad.addEventListener(function(tile) {
    var features = tile.content.features;
    var geometries = features.map(function(feature) {
        return feature.geometry;
    });
    doSomethingWithGeometries(geometries);
});

通过 tile.content.features 获取瓦片内所包含的所有要素，然后通过 feature.geometry 获取每个要素的几何体。

属性

I3SGeometry 对象包含以下属性：

attributes

几何体属性，具体如下：

• position：表示当前几何体的所有顶点的位置坐标，类型为 Float64Array。
• normal：表示当前几何体的所有顶点的法向向量，类型为 Float32Array。
• texcoord0：表示当前几何体的所有顶点的第一个纹理坐标，类型为 Float32Array。
• texcoord1：表示当前几何体的所有顶点的第二个纹理坐标，类型为 Float32Array。
• color：表示当前几何体的所有顶点的颜色，类型为 Uint8Array。
• batchId：表示当前几何体的所有顶点的批次 ID，用于批量渲染时分组处理，类型为 Uint16Array。

indices

几何体索引，表示几何体所有三角形所连接的顶点索引，类型为 Uint32Array。

方法

I3SGeometry 对象包含以下方法：

applyTransform(matrix)

将当前几何体的所有顶点坐标根据矩阵 matrix 进行变换，并更新属性 position。

destroy()

销毁当前几何体，释放内存空间。在不需要使用 I3SGeometry 对象时，应该及时调用此方法进行销毁。

示例

以下是一个简单的使用示例：

var tileset = new Cesium.I3DTileset({
    url: 'path/to/your/i3s/file'
});

tileset.tileLoad.addEventListener(function(tile) {
    var features = tile.content.features;
    var geometries = features.map(function(feature) {
        return feature.geometry;
    });

    geometries.forEach(function(geometry) {
        // 将几何体顶点坐标向上移动 100 米
        var matrix = Cesium.Matrix4.fromTranslation(new Cesium.Cartesian3(0, 0, 100));
        geometry.applyTransform(matrix);

        // 渲染当前几何体
        var primitive = new Cesium.Primitive({
            geometryInstances: new Cesium.GeometryInstance({
                geometry: geometry,
                attributes: {
                    color: new Cesium.ColorGeometryInstanceAttribute(1.0, 0.0, 0.0, 1.0)
                }
            }),
            appearance: new Cesium.PerInstanceColorAppearance()
        });

        viewer.scene.primitives.add(primitive);

        // 销毁当前几何体
        geometry.destroy();
    });
});

viewer.dataSources.add(tileset);