GeometryPipeline

GeometryPipeline 是 CesiumJS 中的一个模块，用于对几何体进行处理、转换和优化。

基本用法

首先要从 cesium/Source/Core/GeometryPipeline 模块中导入 GeometryPipeline：

import { GeometryPipeline } from "cesium/Source/Core/GeometryPipeline";

然后，可以调用 GeometryPipeline 的各种方法对几何体进行处理。以下是一些常用的方法：

transformToWorldCoordinates

将几何体转换成世界坐标系中的坐标。

const transformedGeometry = GeometryPipeline.transformToWorldCoordinates(geometry, modelMatrix);

其中 geometry 是待处理的几何体，modelMatrix 是几何体所在的模型矩阵。

projectTo2D

将几何体投影到二维平面上。

const projectedGeometry = GeometryPipeline.projectTo2D(geometry, viewportTransformation);

其中 geometry 是待处理的几何体，viewportTransformation 是视口变换矩阵。

createAttribute

根据给定的数据，创建一个几何体属性。

const attribute = GeometryPipeline.createAttribute({
    componentDatatype : ComponentDatatype.FLOAT,
    componentsPerAttribute : 3,
    values : new Float32Array([...])
});

其中参数 componentDatatype 表示属性中每个元素的数据类型，componentsPerAttribute 表示每个属性包含几个元素，values 是属性的值数组。

computeNormal

计算一个三角形或三角形带的法向量。

const normal = GeometryPipeline.computeNormal(positions, indices);

其中 positions 是几何体的位置属性，indices 是几何体的索引属性。

createLineSegmentsForVectors

根据给定的向量数组，创建对应的线段数组。

const lines = GeometryPipeline.createLineSegmentsForVectors({
    vectors : [new Cartesian3(1, 0, 0), new Cartesian3(0, 1, 0), new Cartesian3(0, 0, 1)],
    length : 1.0,
    angle : 0.1,
    returnStartAndEnd : true
});

其中 vectors 是给定的向量数组，length 是线段的长度，angle 是线段与向量之间的夹角，returnStartAndEnd 表示是否返回线段的起点和终点。

注意事项

在使用 GeometryPipeline 的方法时，需要注意以下事项：

• 几何体的属性必须是有效的，并且至少包含位置信息。
• 在使用 transformToWorldCoordinates 方法时，modelMatrix 必须是一个正确的变换矩阵。如果你只想对几何体进行简单的位移、旋转等变换，可以使用 Transfroms 模块中的方法来构造变换矩阵。
• 在使用 projectTo2D 方法时，viewportTransformation 必须是一个正确的视口变换矩阵。可以使用 Camera 模块中的 getViewportTransformation 方法来生成视口变换矩阵。
• 在使用 createAttribute 方法时，要确保属性的值数组长度正确。
• 在使用 computeNormal 方法时，要确保给定的几何体是一个三角形或三角形带。
• 在使用 createLineSegmentsForVectors 方法时，length 和 angle 参数要根据实际需求进行调整。

参考文献

• GeometryPipeline - Cesium Documentation