BufferPolygon

绑定到 BufferPolygonCollection 底层缓冲数据的视图。

BufferPolygon 实例是享元: 单个 BufferPolygon 实例可以临时绑定到 BufferPolygonCollection 中的任意概念 "多边形",允许以最小的内存占用迭代和更新非常大的集合。

由一个 (1) 外部线性环表示,包含三个 (3) 或更多位置。 可选择在多边形内定义一个或多个内部线性环("孔")。 每个孔表示为位置数组中的单个索引,该索引处的顶点是内部线性环的起点, 沿后续顶点继续,直到到达下一个孔的顶点索引或顶点列表的末尾。 存储预计算的三角剖分,表示为每个三角形三个顶点索引。

new Cesium.BufferPolygon()
engine/Source/Scene/BufferPolygon.js 34

Experimental

此功能尚未最终确定,可能会在不遵循 Cesium 标准弃用政策的情况下进行更改。

See:

Extends

Members

featureId : number
engine/Source/Scene/BufferPrimitive.js 148

与图元关联的特征 ID;不需要唯一。
Inherited From:

readonly holeCount : number
engine/Source/Scene/BufferPolygon.js 240

此多边形中的孔(索引)数量。

readonly outerVertexCount : number
engine/Source/Scene/BufferPolygon.js 202

此多边形外线性环中的位置(顶点)数量, VEC3 元素数量。

readonly outerVertexOffset : number
engine/Source/Scene/BufferPolygon.js 191

多边形外线性环中第一个顶点在集合位置数组中的偏移量, VEC3 元素数量。

show : boolean
engine/Source/Scene/BufferPrimitive.js 160

图元是否显示。
Inherited From:

readonly triangleCount : number
engine/Source/Scene/BufferPolygon.js 419

此多边形中的三角形数量,VEC3 元素数量。

readonly vertexCount : number
engine/Source/Scene/BufferPolygon.js 140

此多边形中的位置(顶点)数量,包括外环和 内部环(孔),VEC3 元素数量。

Methods

static Cesium.BufferPolygon.clone(polygon, result) → BufferPolygon
engine/Source/Scene/BufferPolygon.js 110

将源多边形的数据复制到结果。如果结果多边形不是新的 (集合中的最后一个多边形),则源多边形和结果多边形 必须具有相同的顶点数、孔数和三角形数。
Name Type Description
polygon BufferPolygon
result BufferPolygon
Returns:

getHolePositions(holeIndex, result)
engine/Source/Scene/BufferPolygon.js 341

返回指定孔的内部线性环顶点位置的数组视图。 如果给定 'result' 参数,顶点位置将写入该数组并返回。 否则,返回集合内存上的 ArrayView — 对此数组的更改 不会触发渲染更新,这需要 `.setPositions()`。
Name Type Description
holeIndex number
result TypedArray optional return {TypedArray}

getHoles(result) → TypedArray
engine/Source/Scene/BufferPolygon.js 257

获取此多边形的孔索引,每个孔表示为 此多边形位置数组中的单个偏移量。每个孔隐式地 从该顶点偏移量沿内部线性环继续, 直到到达位置数组的末尾或下一个孔偏移量。 如果给定 'result' 参数,孔索引将写入该数组并返回。 否则,返回集合内存上的 ArrayView — 对此数组的更改 不会触发渲染更新,这需要 `.setHoles()`。
Name Type Description
result TypedArray optional
Returns:

getHoleVertexCount(holeIndex) → number
engine/Source/Scene/BufferPolygon.js 317

返回指定孔中的 (VEC3) 顶点数。
Name Type Description
holeIndex number
Returns:

getMaterial(result) → BufferPrimitiveMaterial
engine/Source/Scene/BufferPrimitive.js 172

Name Type Description
result BufferPrimitiveMaterial
Returns:
Inherited From:

getOuterPositions(result) → TypedArray
engine/Source/Scene/BufferPolygon.js 218

返回此多边形外线性环顶点位置的数组视图。 如果给定 'result' 参数,顶点位置将写入该数组并返回。 否则,返回集合内存上的 ArrayView — 对此数组的更改 不会触发渲染更新,这需要 `.setPositions()`。
Name Type Description
result TypedArray optional
Returns:

getPositions(result)
engine/Source/Scene/BufferPolygon.js 153

返回此多边形顶点位置的数组视图。如果给定 'result' 参数,顶点位置将写入该数组并返回。 否则,返回集合内存上的 ArrayView — 对此数组的更改 不会触发渲染更新,这需要 `.setPositions()`。
Name Type Description
result TypedArray optional return {TypedArray}

getTriangles(result) → TypedArray
engine/Source/Scene/BufferPolygon.js 434

返回此多边形三角形索引的数组视图,表示为 每个三角形三个顶点索引。 如果给定 'result' 参数,三角形索引将写入该数组并返回。 否则,返回集合内存上的 ArrayView — 对此数组的更改 不会触发渲染更新,这需要 `.setTriangles()`。
Name Type Description
result TypedArray optional
Returns:

setHoles(holes)
engine/Source/Scene/BufferPolygon.js 288

设置此多边形的孔索引,孔表示为此多边形 位置数组中的单个偏移量。每个孔隐式地 从该顶点偏移量沿内部线性环继续, 直到到达位置数组的末尾或下一个孔偏移量。
Name Type Description
holes TypedArray

setMaterial(material)
engine/Source/Scene/BufferPrimitive.js 186

Name Type Description
material BufferPrimitiveMaterial
Inherited From:

setPositions(positions)
engine/Source/Scene/BufferPolygon.js 158

Name Type Description
positions TypedArray

setTriangles(indices)
engine/Source/Scene/BufferPolygon.js 465

设置此多边形的三角形索引,表示为 每个三角形三个顶点索引。
Name Type Description
indices TypedArray

toJSON() → Object
engine/Source/Scene/BufferPolygon.js 500

返回表示该多边形的可 JSON 序列化的对象。此编码 不具有内存效率,通常应用于调试和测试。
Returns:
可 JSON 序列化的对象。
Inherited From:
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
CtrlK
packages/engine
packages/widgets