new Cesium.PointPrimitive()
在三维场景中定位的图形点,使用
PointPrimitiveCollection
创建和渲染。
通过调用PointPrimitiveCollection#add
创建一个点。
异常情况:
-
DeveloperError : scaleByDistance.far 必须大于 scaleByDistance.near。
-
DeveloperError : translucencyByDistance.far 必须大于 translucencyByDistance.near。
-
DeveloperError : distanceDisplayCondition.far 必须大于 distanceDisplayCondition.near。
成员变量
color : Color
获取或设置点的内部颜色。
示例:
// 例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
distanceDisplayCondition : DistanceDisplayCondition
获取或设置条件,该条件指定此点与相机的距离。
-
Default Value:
undefined
id : *
获取或设置在选择该点时返回的用户定义值。
outlineColor : Color
获取或设置点的轮廓颜色。
outlineWidth : Number
获取或设置以像素为单位的轮廓宽度。 这个宽度增加像素大小,增加点的总大小。
pixelSize : Number
获取或设置点的内部大小(以像素为单位)。
position : Cartesian3
获取或设置此点的笛卡尔坐标位置。
scaleByDistance : NearFarScalar
根据点到相机的距离获取或设置点的远近缩放属性。
当相机距离落在指定的
nearfarscalar#near
和nearfarscalar#far
的上界和下界内时,
点的缩放比例将在nearfarscalar#near
和nearfarscalar#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;
show : Boolean
是否显示此点。 使用它来隐藏或显示某个点,而不是删除它并将其重新添加到集合中。
translucencyByDistance : NearFarScalar
根据点到摄像机的距离获取或设置点的近、远半透明属性。
当摄像机距离落在指定的
nearfarscalar#near
和nearfarscalar#far
的上下界内时,
点的半透明将在nearfarscalar#near
和nearfarscalar#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;
内置方法
计算点原点的屏幕空间位置。
屏幕空间原点是画布的左上角,x轴向右,y轴向下。
Name | Type | Description |
---|---|---|
scene |
Scene | 整个场景。 |
result |
Cartesian2 | optional 存储结果的对象。 |
返回值:
点的屏幕空间位置。
异常情况:
-
DeveloperError : PointPrimitive必须在一个集合中。
示例:
console.log(p.computeScreenSpacePosition(scene).toString());
确定这一点是否等于另一点。 如果它们所有的性质都相等,则认为点是相等的。
不同集合中的点可以是相等的。
Name | Type | Description |
---|---|---|
other |
PointPrimitive | 比较的点。 |
返回值:
如果相等返回true,否则返回false。