ClippingPlaneCollection

Cesium中的ClippingPlaneCollection是一个可编辑的平面集合，可用于在三维场景中裁剪几何体。它可以用于许多场景，例如将地形剖面或将建筑物剖面以显示它们的内部。此文档将介绍其基本使用和属性。

定义

var clippingPlanes = new Cesium.ClippingPlaneCollection({
    planes : [
        new Cesium.ClippingPlane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 0.0)
    ],
    edgeWidth : 1.0
});

属性

ClippingPlaneCollection#planes

管理中的平面数组。默认情况下为空数组。每个平面都由具有三个元素的Cartesian3位置和第四个元素表示的距离定义。

ClippingPlaneCollection#edgeWidth

边缘宽度，以像素为单位。默认情况下为1像素。

ClippingPlane#distanceDisplayCondition

可以使用这个属性来控制距离该平面多远时应该显示。

方法

ClippingPlaneCollection#add(plane)

添加一个平面到平面集合中。

ClippingPlaneCollection#remove(plane)

从平面集合中删除一个平面。

ClippingPlaneCollection#removeAll()

删除所有平面。

示例

var viewer = new Cesium.Viewer('cesiumContainer');

var clippingPlanes = new Cesium.ClippingPlaneCollection();

clippingPlanes.add(new Cesium.ClippingPlane(new Cesium.Cartesian3(0.0, 0.0, -1.0), 0.0));
clippingPlanes.add(new Cesium.ClippingPlane(new Cesium.Cartesian3(0.0, 0.0, 1.0), 0.0));

viewer.scene.globe.clippingPlanes = clippingPlanes;

在此示例中，我们创建了一个具有两个平面的ClippingPlaneCollection对象，并将其应用于场景默认的地球上。第一个平面将地球裁剪，使其只能看到其北半球，第二个平面将地球裁剪，使其只能看到南半球。