PointPrimitive

new Cesium.PointPrimitive()
Scene/PointPrimitive.js 41

在3D场景中定位的图形点，它是创建的 并使用PointPrimitiveCollection进行渲染。将创建一个点及其初始值 属性通过调用PointPrimitiveCollection#add设置。
Performance:

读取属性（例如PointPrimitive#show）是恒定时间。 为属性赋值是恒定时间，但会导致 调用PointPrimitiveCollection#update时CPU到GPU的流量。每点基本流量是 不管更新了多少属性，都是一样的。如果集合中的大多数pointPrimitives需要 更新后，使用PointPrimitiveCollection#removeAll清除集合可能更有效 并添加新的点基元，而不是修改每一个。

Throws:
  • DeveloperError : 缩放距离.far必须大于scaleByDistance.近
  • DeveloperError ：translucencyByDistance.far公司必须大于translucencyByDistance.近
  • DeveloperError ：距离取消显示条件.far必须大于距离取消显示条件。接近
Demo:
See:

Members

color : Color
Scene/PointPrimitive.js 323

获取或设置点的内部颜色。 red、green、blue和alpha values用值的红色、绿色表示， 蓝色和alpha属性，如示例1所示。这些部件的范围为0.0 （无强度）至1.0（全强度）。
Examples:
// Example 1. Assign yellow.
p.color = Cesium.Color.YELLOW;
// Example 2. Make a pointPrimitive 50% translucent.
p.color = new Cesium.Color(1.0, 1.0, 1.0, 0.5);

disableDepthTestDistance : Number
Scene/PointPrimitive.js 425

获取或设置与摄影机的距离，在该距离处禁用深度测试，以防止针对地形进行剪裁。 设置为零时，始终应用深度测试。设置为时数正无穷大，则不应用深度测试。
Default Value: 0.0

distanceDisplayCondition : DistanceDisplayCondition
Scene/PointPrimitive.js 396

获取或设置条件，该条件指定此点将显示在距摄影机的距离。
Default Value: undefined

id : *
Scene/PointPrimitive.js 449

获取或设置拾取点时返回的用户定义值。

outlineColor : Color
Scene/PointPrimitive.js 347

获取或设置点的轮廓颜色。

outlineWidth : Number
Scene/PointPrimitive.js 372

获取或设置轮廓宽度（以像素为单位）。此宽度将添加到像素大小， 增加点的总大小。

pixelSize : Number
Scene/PointPrimitive.js 289

获取或设置点的内部大小（以像素为单位）。

position : Cartesian3
Scene/PointPrimitive.js 173

获取或设置此点的笛卡尔位置。

scaleByDistance : NearFarScalar
Scene/PointPrimitive.js 217

获取或设置基于点与摄影机的距离的点的近缩放和远缩放属性。 点的比例将在NearFarScalar#nearValue和 NearFarScalar#farValue，摄像机距离在上下限范围内 指定的NearFarScalar#near和NearFarScalar#far。 在这些范围之外，点的比例将保持在最近的边界。这个比例尺 乘以pixelSize和outlineWidth以影响点的总大小。如果未定义， scaleByDistance将被禁用。
Examples:
// Example 1.
// Set a pointPrimitive's scaleByDistance to scale to 15 when the
// camera is 1500 meters from the pointPrimitive and disappear as
// the camera distance approaches 8.0e6 meters.
p.scaleByDistance = new Cesium.NearFarScalar(1.5e2, 15, 8.0e6, 0.0);
// Example 2.
// disable scaling by distance
p.scaleByDistance = undefined;

show : Boolean
Scene/PointPrimitive.js 150

确定是否显示此点。用这个来隐藏或显示一个点 删除并重新添加到集合中。

translucencyByDistance : NearFarScalar
Scene/PointPrimitive.js 260

获取或设置基于点与摄影机的距离的点的近半透明和远半透明属性。 点的半透明性将在NearFarScalar#nearValue和 NearFarScalar#farValue，摄像机距离在上下限范围内 指定的NearFarScalar#near和NearFarScalar#far。 在这些范围之外，点的半透明性将保持钳制到最近的边界。如果未定义， 半透明ByDistance将被禁用。
Examples:
// Example 1.
// Set a point's translucency to 1.0 when the
// camera is 1500 meters from the point and disappear as
// the camera distance approaches 8.0e6 meters.
p.translucencyByDistance = new Cesium.NearFarScalar(1.5e2, 1.0, 8.0e6, 0.0);
// Example 2.
// disable translucency by distance
p.translucencyByDistance = undefined;

Methods

computeScreenSpacePosition(scene, result) → Cartesian2
Scene/PointPrimitive.js 567

计算点原点的屏幕空间位置。 屏幕空间原点是画布的左上角；x从 61166从左到下依次递增。
Name Type Description
scene Scene 现场。
result Cartesian2 optional 要将结果存储到的对象。
Returns:
点的屏幕空间位置。
Throws:
Example:
console.log(p.computeScreenSpacePosition(scene).toString());

equals(other) → Boolean
Scene/PointPrimitive.js 638

确定此点是否等于另一点。如果点的所有属性都相等 是平等的。不同集合中的点可以相等。
Name Type Description
other PointPrimitive 为了平等而比较的点。
Returns:
如果点相等，则为true；否则为false。