Cesium API - Cesium3DTilePointFeature 中文文档

new Cesium.Cesium3DTilePointFeature()

Cesium3DTileset的点要素。

提供对存储在批处理表中的要素的访问，以及显示/隐藏要素和更改其点属性的功能。

对Cesium3DTilePointFeature对象的修改具有瓦片内容的生存期。如果瓦片的内容被卸载，例如，由于它离开了视图，需要为可见的瓦片释放缓存中的空间，那么监听Cesium3DTileset#tileUnload事件来保存任何修改。还可以监听Cesium3DTileset#tileVisible事件来重新应用任何修改。

不要直接构造它。通过Cesium3DTileContent#getFeature或挑选使用Scene#pick和Scene#pickPosition访问它。

示例：

// 鼠标悬停后，在控制台日志中显示某个要素的所有属性。
handler.setInputAction(function(movement) {
    var feature = scene.pick(movement.endPosition);
    if (feature instanceof Cesium.Cesium3DTilePointFeature) {
        var propertyNames = feature.getPropertyNames();
        var length = propertyNames.length;
        for (var i = 0; i < length; ++i) {
            var propertyName = propertyNames[i];
            console.log(propertyName + ': ' + feature.getProperty(propertyName));
        }
    }
}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);

实验功能说明：

这个要素是使用的3D瓦片规范的一部分，不是最终的，并可能会改变没有Cesium的标准弃用政策。

成员变量

anchorLineColor : Color

Scene/Cesium3DTilePointFeature.js 485

获取或设置锚线的颜色。

仅在定义heightOffset时应用。

anchorLineEnabled : Boolean

Scene/Cesium3DTilePointFeature.js 466

获取或设置是否显示锚线。

仅在定义heightOffset时应用。

backgroundColor : Color

Scene/Cesium3DTilePointFeature.js 330

获取或设置此要素的文本的背景颜色。

仅在定义labelText时应用。

backgroundEnabled : Boolean

Scene/Cesium3DTilePointFeature.js 368

获取或设置是否显示此要素的文本背景。

仅在定义labelText时应用。

backgroundPadding : Cartesian2

Scene/Cesium3DTilePointFeature.js 349

获取或设置此要素的文本背景填充。

仅在定义labelText时应用。

color : Color

Scene/Cesium3DTilePointFeature.js 135

获取或设置此要素点的颜色。

仅当image为undefined时应用。

disableDepthTestDistance : Number

Scene/Cesium3DTilePointFeature.js 521

获取或设置将禁用深度测试的距离。

distanceDisplayCondition : DistanceDisplayCondition

Scene/Cesium3DTilePointFeature.js 418

获取或设置指定将显示此要素的相机距离条件。

font : String

Scene/Cesium3DTilePointFeature.js 273

获取或设置此要素的字体。

仅在定义labelText时应用。

heightOffset : Number

Scene/Cesium3DTilePointFeature.js 436

获取或设置此要素的高度偏移（以米为单位）。

horizontalOrigin : HorizontalOrigin

Scene/Cesium3DTilePointFeature.js 538

获取或设置此点的水平原点，该原点确定该点是否位于其锚点位置的左侧、中部或右侧。

image : String

Scene/Cesium3DTilePointFeature.js 501

获取或设置此要素的图像。

labelColor : Color

Scene/Cesium3DTilePointFeature.js 215

获取或设置此要素的标签颜色。

如果labelText被定义，颜色将被应用到标签上。

labelHorizontalOrigin : HorizontalOrigin

Scene/Cesium3DTilePointFeature.js 570

获取或设置该点文本的水平原点，该原点确定该点文本是否位于其锚点位置的左侧、中部或右侧。

labelOutlineColor : Color

Scene/Cesium3DTilePointFeature.js 235

获取或设置此要素的标签轮廓颜色。

如果labelText被定义，则轮廓颜色将应用到标签上。

labelOutlineWidth : Number

Scene/Cesium3DTilePointFeature.js 254

获取或设置此要的轮廓宽度（以像素为单位）。

如果labelText被定义，则将轮廓宽度应用于该点。

labelStyle : LabelStyle

Scene/Cesium3DTilePointFeature.js 292

获取或设置此要素的填充和轮廓样式。

仅在定义labelText时应用。

labelText : String

Scene/Cesium3DTilePointFeature.js 308

获取或设置此要素的文本。

labelVerticalOrigin : VerticalOrigin

Scene/Cesium3DTilePointFeature.js 586

获取或设置该点文本的垂直原点，该原点确定该点文本是否位于其锚点的底部、中心、顶部还是基线。

pointOutlineColor : Color

Scene/Cesium3DTilePointFeature.js 175

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

仅当image为undefined时应用。

pointOutlineWidth : Number

Scene/Cesium3DTilePointFeature.js 195

获取或设置此要素的点轮廓宽度（以像素为单位）。

仅当image为undefined时应用。

pointSize : Number

Scene/Cesium3DTilePointFeature.js 155

获取或设置此要素的点大小。

仅当image为undefined时应用。

readonlyprimitive : Cesium3DTileset

Scene/Cesium3DTilePointFeature.js 636

Scene#pick返回的所有对象都有一个primitive属性。这将返回包含该要素的tileset。

scaleByDistance : NearFarScalar

Scene/Cesium3DTilePointFeature.js 384

获取或设置此要素的远近缩放属性。

show : Boolean

Scene/Cesium3DTilePointFeature.js 114

获取或设置将显示的要素。这是在评估样式的显示时为所有要素设置的。

Default Value: true

readonlytileset : Cesium3DTileset

Scene/Cesium3DTilePointFeature.js 620

获取包含该要素的tileset。

translucencyByDistance : NearFarScalar

Scene/Cesium3DTilePointFeature.js 401

获取或设置此要素的远近半透明属性。

verticalOrigin : VerticalOrigin

Scene/Cesium3DTilePointFeature.js 554

获取或设置此点的垂直原点，该原点确定该点是否指向其锚点位置的底部、中心或顶部。

内置方法

getProperty(name) → *

Scene/Cesium3DTilePointFeature.js 777

返回具有给定名称的要素的属性值的副本。这包括使用批处理表层次结构时来自该要素的类和继承的类的属性。

Name	Type	Description
`name`	String	区分大小写的属性名。

返回值：

属性的值，如果属性不存在，则undefined。

示例：

// 在控制台日志中显示某个要素的所有属性。
var propertyNames = feature.getPropertyNames();
var length = propertyNames.length;
for (var i = 0; i < length; ++i) {
    var propertyName = propertyNames[i];
    console.log(propertyName + ': ' + feature.getProperty(propertyName));
}

参考：

https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/extensions/3DTILES_batch_table_hierarchy

getPropertyNames(results) → Array.<String>

Scene/Cesium3DTilePointFeature.js 738

返回要素的属性名称数组。这包括使用批处理表层次结构时来自该要素的类和继承的类的属性。

Name	Type	Description
`results`	Array.<String>	存储结果的数组。

返回值：

要素的属性的名称。

参考：

https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/extensions/3DTILES_batch_table_hierarchy

hasProperty(name) → Boolean

Scene/Cesium3DTilePointFeature.js 717

返回要素是否包含此属性。这包括使用批处理表层次结构时来自该要素的类和继承的类的属性。

Name	Type	Description
`name`	String	区分大小写的属性名。

返回值：

要素是否包含此属性。

参考：

https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/extensions/3DTILES_batch_table_hierarchy

setProperty(name, value)

Scene/Cesium3DTilePointFeature.js 827

使用给定名称设置要素的属性的值。

如果具有给定名称的属性不存在，则创建它。

Name	Type	Description
`name`	String	区分大小写的属性名。
`value`	*	要复制的属性的值。

异常情况：

DeveloperError : 继承的批处理表层次结构属性为只读。

示例：

var height = feature.getProperty('Height'); // e.g., the height of a building

var name = 'clicked';
if (feature.getProperty(name)) {
    console.log('already clicked');
} else {
    feature.setProperty(name, true);
    console.log('first click');
}