PointPrimitive

new Cesium.PointPrimitive()

在三维场景中定位的图形点,使用PointPrimitiveCollection创建和渲染。 通过调用PointPrimitiveCollection#add创建一个点。
Throws:
  • DeveloperError : scaleByDistance.far 必须大于 scaleByDistance.near。
  • DeveloperError : translucencyByDistance.far 必须大于 translucencyByDistance.near。
  • DeveloperError : distanceDisplayCondition.far 必须大于 distanceDisplayCondition.near。
Demo:
See:

Members

获取或设置点的内部颜色。
Examples:
// 例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将被禁用。
Examples:
// 例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将被禁用。
Examples:
// 例1
// 当相机距离该点1500米时,将该点的半透明度设为1.0,当相机距离接近8.0e6米时,将消失。
p.translucencyByDistance = new Cesium.NearFarScalar(1.5e2, 1.0, 8.0e6, 0.0);
// 例2
// 通过距离禁用半透明
p.translucencyByDistance = undefined;

Methods

computeScreenSpacePosition(scene, result)Cartesian2

计算点原点的屏幕空间位置。 屏幕空间原点是画布的左上角,x轴向右,y轴向下。
Name Type Description
scene Scene 整个场景。
result Cartesian2 optional 存储结果的对象。
Returns:
点的屏幕空间位置。
Throws:
Example:
console.log(p.computeScreenSpacePosition(scene).toString());

equals(other)Boolean

确定这一点是否等于另一点。 如果它们所有的性质都相等,则认为点是相等的。 不同集合中的点可以是相等的。
Name Type Description
other PointPrimitive 比较的点。
Returns:
如果相等返回true,否则返回false。