麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - PointPrimitiveCollection 中文文档

发布时间: 2019-11-13 所属分类: Cesium中文API文档（v1.63.1） 文章标签: cesiumCesium中文文档
当前位置：
麻辣GIS » GIS手册 » Cesium中文API文档（v1.63.1） » Cesium API - PointPrimitiveCollection 中文文档

本文介绍下Cesium中 PointPrimitiveCollection API的详细使用说明。

PointPrimitiveCollection API 调用方法

new Cesium.PointPrimitiveCollection(options)
Scene/PointPrimitiveCollection.js 83
一个可渲染的点集合。

使用以下命令添加和删除集合中的点 PointPrimitiveCollection#add和 PointPrimitiveCollection#remove。
效率优化说明：

为了获取更好的性能，最好是创建较少的集合，每个集合有较多的点，而不是较多的集合，每个集合中有较少的点。 组织集合的时候，将有相同更新频率的点放在一个集合，不更新的点放在一个集合。

Name Type Description
options Object optional 具有下列属性的对象：
Name Type Default Description
modelMatrix Matrix4 Matrix4.IDENTITY optional 4x4变换矩阵，将每个点从模型坐标变换为世界坐标。
debugShowBoundingVolume Boolean false optional 仅用于调，是否显示此图元的包围球。
blendOption BlendOption BlendOption.OPAQUE_AND_TRANSLUCENT optional 点的混合选项。默认的是用于渲染不透明和半透明的点， 但是，如果所有的点都是完全不透明的或者都是完全透明的，则可以设置为 BlendOption.OPAQUE 或者 BlendOption.TRANSLUCENT，这样性能可以提升2倍。
示例：
// 创建一个包含两个点的pointPrimitive集合。
var points = scene.primitives.add(new Cesium.PointPrimitiveCollection());
points.add({
  position : new Cesium.Cartesian3(1.0, 2.0, 3.0),
  color : Cesium.Color.YELLOW
});
points.add({
  position : new Cesium.Cartesian3(4.0, 5.0, 6.0),
  color : Cesium.Color.CYAN
});
参考：

成员变量

点的混合选项。默认的是用于渲染不透明和半透明的点， 但是，如果所有的点都是完全不透明的或者都是完全透明的，则可以设置为 BlendOption.OPAQUE 或者 BlendOption.TRANSLUCENT，这样性能可以提升2倍。
Default Value: BlendOption.OPAQUE_AND_TRANSLUCENT
debugShowBoundingVolume : Boolean
Scene/PointPrimitiveCollection.js 165
此属性仅用于调试;它既不用于生产，也不是最优的。

显示图元的包围球。

Default Value: false
返回集合中点的个数。 这通常与PointPrimitiveCollection#get一起使用，以迭代集合中的所有点。
4x4变换矩阵，将集合中的每个点从模型坐标变换为世界坐标。 当这是单位矩阵时，点图元是在世界坐标中绘制的，即地球的WGS84坐标。 本地参考系可以通过提供一个不同的变换矩阵来使用，就像Transforms.eastNorthUpToFixedFrame返回的那样。
Default Value: Matrix4.IDENTITY
示例：
var center = Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883);
pointPrimitives.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(center);
pointPrimitives.add({
  color : Cesium.Color.ORANGE,
  position : new Cesium.Cartesian3(0.0, 0.0, 0.0) // center
});
pointPrimitives.add({
  color : Cesium.Color.YELLOW,
  position : new Cesium.Cartesian3(1000000.0, 0.0, 0.0) // east
});
pointPrimitives.add({
  color : Cesium.Color.GREEN,
  position : new Cesium.Cartesian3(0.0, 1000000.0, 0.0) // north
});
pointPrimitives.add({
  color : Cesium.Color.CYAN,
  position : new Cesium.Cartesian3(0.0, 0.0, 1000000.0) // up
});
参考：

内置方法

创建具有指定初始属性的点并将其添加到集合中。 将返回添加的点，以便以后可以修改或从集合中删除它。
效率优化说明：

为了获得最好的性能，在调用update之前，添加尽可能多的点图元。

Name Type Description
options Object optional 描述点属性的模板，如示例1所示。
返回值：
添加到集合中的点。
异常情况：
示例：
// 例1：添加一个点，指定所有默认值。
var p = pointPrimitives.add({
  show : true,
  position : Cesium.Cartesian3.ZERO,
  pixelSize : 10.0,
  color : Cesium.Color.WHITE,
  outlineColor : Cesium.Color.TRANSPARENT,
  outlineWidth : 0.0,
  id : undefined
});
// 例2：只指定该点的位置属性。
var p = pointPrimitives.add({
  position : Cesium.Cartesian3.fromDegrees(longitude, latitude, height)
});
参考：
contains(pointPrimitive) → Boolean
Scene/PointPrimitiveCollection.js 357
检查此集合是否包含给定的点。
Name Type Description
pointPrimitive PointPrimitive optional 要检查的点。
返回值：
如果包含此点返回true，否则返回false。
参考：
销毁此对象持有的WebGL资源。

一旦对象被销毁，它将不能在使用；调用除isDestroyed之外的任何函数都会导致DeveloperError异常。 因此，将返回值(undefined)赋给对象，如示例所示。
异常情况：
示例：
pointPrimitives = pointPrimitives && pointPrimitives.destroy();
参考：
返回集合中指定索引处的点。索引是从零开始的，随着点数的增加而增加。 移除一个点后，所有点都向左移动，改变它们的索引。这个函数通常与PointPrimitiveCollection#length一起使用，用于迭代集合中的所有点。
Name Type Description
index Number 索引。
返回值：
返回索引处的点。
异常情况：
示例：
// 切换集合中每个点的show属性
var len = pointPrimitives.length;
for (var i = 0; i < len; ++i) {
  var p = pointPrimitives.get(i);
  p.show = !p.show;
}
参考：
isDestroyed() → Boolean
Scene/PointPrimitiveCollection.js 975
如果该对象没被销毁，返回false。

如果该对象已经被销毁，使用isDestroyed 会触发 DeveloperError 异常。
返回值：
false
参考：
remove(pointPrimitive) → Boolean
Scene/PointPrimitiveCollection.js 285
从集合中移除一个点。
效率优化说明：

为了获得最佳性能，在调用update之前，尽可能多地删除点。

Name Type Description
pointPrimitive PointPrimitive 要移除的点。
返回值：
如果该点被移除返回true, 如果该点没找到返回false。
异常情况：
示例：
var p = pointPrimitives.add(...);
pointPrimitives.remove(p);  // Returns true
参考：
从集合中移除所有点。
效率优化说明：

从集合中删除所有点然后添加新点比完全创建新集合效率更高。

异常情况：
示例：
pointPrimitives.add(...);
pointPrimitives.add(...);
pointPrimitives.removeAll();
参考：

其他API

Cesium中文API文档手册（v1.63.1版本）参考：《Cesium中文API文档手册（v1.63.1版本）》

相关阅读

快速搭建一个Cesium应用示例
快速搭建一个Cesium应用示例
2024-01-03
Cesium ion支持私有化部署
Cesium ion支持私有化部署
2023-12-15
3D Tiles格式说明电子版(中文版PDF)
3D Tiles格式说明电子版(中文版PDF)
2023-12-13
Cesium中的常用格式 3D Tiles简介
Cesium中的常用格式 3D Tiles简介
2023-12-12
Cesium中的glTF是什么
Cesium中的glTF是什么
2023-12-05
为什么选择Cesium
为什么选择Cesium
2023-12-04
麻辣GIS-Sailor

作者：

GIS爱好者，学GIS，更爱玩GIS。
qq加入QQ群 B站关注

声明

1.本文所分享的所有需要用户下载使用的内容（包括但不限于软件、数据、图片）来自于网络或者麻辣GIS粉丝自行分享，版权归该下载资源的合法拥有者所有，如有侵权请第一时间联系本站删除。

2.下载内容仅限个人学习使用，请切勿用作商用等其他用途，否则后果自负。

手机阅读
公众号关注
知识星球
手机阅读
麻辣GIS微信公众号关注
最新GIS干货
关注麻辣GIS知识星球
私享圈子

留言板（小编看到第一时间回复）