BufferPolygon

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

BufferPolygon 实例是享元： 单个 BufferPolygon 实例可以临时绑定到 BufferPolygonCollection 中任意概念上的 "polygon"，允许以最小的内存占用迭代和更新超大型集合。

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

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

Experimental

此功能尚未最终确定，可能会在没有 Cesium 标准弃用策略的情况下发生变化。

See:

Extends

Members

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

与该图元关联的特性 ID；不要求唯一。
Inherited From:

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

此多边形中洞（索引）的数量。

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

此多边形外部线性环中位置（顶点）的数量，即 VEC3 元素的数量。

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

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

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

是否显示该图元。
Inherited From:

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

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

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

此多边形中位置（顶点）的数量，包括外部环和 内部环（洞），即 VEC3 元素的数量。

Methods

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

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

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

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

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

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

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

返回指定洞中（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 222

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

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

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

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

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

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

设置此多边形的洞索引，洞表示为此多边形位置数组中的单个 偏移量。每个洞隐式地从该顶点偏移量沿内部线性环继续， 直到到达位置数组的末尾或下一个洞的偏移量。
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 161

Name Type Description
positions TypedArray

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

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

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

返回表示该多边形的可 JSON 序列化对象。此编码 不是内存高效的，通常应用于调试和 测试。
Returns:
可 JSON 序列化的对象。
Inherited From:
需要帮助？获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。
CtrlK
packages/engine
packages/widgets