PolylineVolumeOutlineGeometry

创建一个带边框的线柱体几何体。

语法

var geometry = new Cesium.PolylineVolumeOutlineGeometry({
    vertexFormat : Cesium.VertexFormat.POSITION_ONLY,
    polylinePositions : Cesium.Cartesian3[],
    shapePositions : Cesium.Cartesian2[],
    cornerType : Cesium.CornerType.ROUNDED,
    granularity : Number
});

参数

• vertexFormat：可选，定义几何体属性的格式，类型为VertexFormat。默认值为VertexFormat.POSITION_ONLY。
• polylinePositions：必需，由线段的端点坐标数组组成的数组，类型为Cartesian3[]。这里的数组长度必须是shapePositions数组长度+1。
• shapePositions：必需，线柱体的横截面的点坐标数组，类型为Cartesian2[]。这里的数组长度必须是奇数，它的中间点作为轴心线上一端中点的位置。轴心线另一端中点的位置是由polylinePositions数组决定的。
• cornerType：可选，线柱体顶点的类型，类型为CornerType。默认值为CornerType.ROUNDED。
• granularity：可选，网格的粒度，类型为Number。默认值为Math.PI / ( shapePositions.length - 1 )。

描述

PolylineVolumeOutlineGeometry由一组线段和一个横截面组成，该横截面沿着指定的轴心线旋转形成线柱体。使用PolylineVolumeOutlineGeometry创建的几何实例可以使用GeometryInstance传递给Primitive进行渲染。

示例

var polylinePositions = [
    new Cesium.Cartesian3(-200000.0, -200000.0, -500000.0),
    new Cesium.Cartesian3(200000.0, 200000.0, -500000.0)
];

var shapePositions = [
    new Cesium.Cartesian2(0.0, -50000.0),
    new Cesium.Cartesian2(0.0, 50000.0),
    new Cesium.Cartesian2(100000.0, 50000.0),
    new Cesium.Cartesian2(100000.0, -50000.0)
];

var geometry = new Cesium.PolylineVolumeOutlineGeometry({
    vertexFormat: Cesium.VertexFormat.POSITION_ONLY,
    polylinePositions: polylinePositions,
    shapePositions: shapePositions,
    cornerType: Cesium.CornerType.ROUNDED,
    granularity: Math.PI / (shapePositions.length - 1)
});

var instance = new Cesium.GeometryInstance({
    geometry: geometry,
    attributes: {
        color: Cesium.ColorGeometryInstanceAttribute.fromColor(Cesium.Color.WHITE)
    }
});

var primitive = new Cesium.Primitive({
    geometryInstances: instance,
    appearance: new Cesium.PerInstanceColorAppearance()
});

scene.primitives.add(primitive);

参考

• GeometryInstance
• Primitive
• CornerType
• VertexFormat