麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - PointPrimitive 中文文档

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

PointPrimitive API 调用方法

new Cesium.PointPrimitive()
在三维场景中定位的图形点,使用PointPrimitiveCollection创建和渲染。 通过调用PointPrimitiveCollection#add创建一个点。
异常情况:
  • DeveloperError : scaleByDistance.far 必须大于 scaleByDistance.near。
  • DeveloperError : translucencyByDistance.far 必须大于 translucencyByDistance.near。
  • DeveloperError : distanceDisplayCondition.far 必须大于 distanceDisplayCondition.near。
演示Demo:
参考:

成员变量

获取或设置点的内部颜色。
示例:
// 例1:指定为黄色。
p.color = Cesium.Color.YELLOW;
// 例2:设置点为半透明。
p.color = new Cesium.Color(1.0, 1.0, 1.0, 0.5);
disableDepthTestDistance : Number
获取或者设置深度测试的距离。 当设置为0时,总是应用深度测试。 当设置为Number.POSITIVE_INFINITY时,总是不应用深度测试。
Default Value: 0.0
获取或设置条件,该条件指定此点与相机的距离。
Default Value: undefined
获取或设置在选择该点时返回的用户定义值。
获取或设置点的轮廓颜色。
outlineWidth : Number
获取或设置以像素为单位的轮廓宽度。 这个宽度增加像素大小,增加点的总大小。
pixelSize : Number
获取或设置点的内部大小(以像素为单位)。
获取或设置此点的笛卡尔坐标位置。
根据点到相机的距离获取或设置点的远近缩放属性。 当相机距离落在指定的nearfarscalar#nearnearfarscalar#far的上界和下界内时, 点的缩放比例将在nearfarscalar#nearnearfarscalar#far之间插入。 在这些范围之外,点的缩放比例仍然保持在最近的范围内。这个缩放比例乘以像素大小和轮廓线宽度,以决定点的总大小。 如果未定义,scaleByDistance将被禁用。
示例:
// 例1:
// 当相机距离原始点1500米时,将pointPrimitive的scaleByDistance设置为15,当相机距离接近8.0e6米时,将消失。
p.scaleByDistance = new Cesium.NearFarScalar(1.5e2, 15, 8.0e6, 0.0);
// 例2:
// 禁用按距离缩放
p.scaleByDistance = undefined;
是否显示此点。 使用它来隐藏或显示某个点,而不是删除它并将其重新添加到集合中。
translucencyByDistance : NearFarScalar
根据点到摄像机的距离获取或设置点的近、远半透明属性。 当摄像机距离落在指定的nearfarscalar#nearnearfarscalar#far的上下界内时, 点的半透明将在nearfarscalar#nearnearfarscalar#far之间插入。 在这些范围之外,该点的半透明性仍然被限制在最近的范围内。如果未定义,translucencyByDistance将被禁用。
示例:
// 例1
// 当相机距离该点1500米时,将该点的半透明度设为1.0,当相机距离接近8.0e6米时,将消失。
p.translucencyByDistance = new Cesium.NearFarScalar(1.5e2, 1.0, 8.0e6, 0.0);
// 例2
// 通过距离禁用半透明
p.translucencyByDistance = undefined;

内置方法

computeScreenSpacePosition(scene, result)Cartesian2
计算点原点的屏幕空间位置。 屏幕空间原点是画布的左上角,x轴向右,y轴向下。
Name Type Description
scene Scene 整个场景。
result Cartesian2 optional 存储结果的对象。
返回值:
点的屏幕空间位置。
异常情况:
示例:
console.log(p.computeScreenSpacePosition(scene).toString());
equals(other)Boolean
确定这一点是否等于另一点。 如果它们所有的性质都相等,则认为点是相等的。 不同集合中的点可以是相等的。
Name Type Description
other PointPrimitive 比较的点。
返回值:
如果相等返回true,否则返回false。

其他API

Cesium中文API文档手册(v1.63.1版本)参考:《Cesium中文API文档手册(v1.63.1版本)

相关阅读

麻辣GIS-Sailor

作者:

GIS爱好者,学GIS,更爱玩GIS。

声明

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

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

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

留言板(小编看到第一时间回复)