Cesium3DTileset
的点要素。
提供对存储在批处理表中的要素的访问,以及显示/隐藏要素和更改其点属性的功能。
对Cesium3DTilePointFeature
对象的修改具有瓦片内容的生存期。
如果瓦片的内容被卸载,例如,由于它离开了视图,需要为可见的瓦片释放缓存中的空间,
那么监听Cesium3DTileset#tileUnload
事件来保存任何修改。
还可以监听Cesium3DTileset#tileVisible
事件来重新应用任何修改。
不要直接构造它。通过Cesium3DTileContent#getFeature
或挑选使用Scene#pick
和Scene#pickPosition
访问它。
Example:
// 鼠标悬停后,在控制台日志中显示某个要素的所有属性。
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);
Experimental
这个要素是使用的3D瓦片规范的一部分,不是最终的,并可能会改变没有Cesium的标准弃用政策。
Members
anchorLineColor : Color
获取或设置锚线的颜色。
仅在定义heightOffset
时应用。
获取或设置是否显示锚线。
仅在定义heightOffset
时应用。
backgroundColor : Color
获取或设置此要素的文本的背景颜色。
仅在定义labelText
时应用。
获取或设置是否显示此要素的文本背景。
仅在定义labelText
时应用。
backgroundPadding : Cartesian2
获取或设置此要素的文本背景填充。
仅在定义labelText
时应用。
获取或设置此要素点的颜色。
仅当image
为undefined
时应用。
获取或设置将禁用深度测试的距离。
distanceDisplayCondition : DistanceDisplayCondition
获取或设置指定将显示此要素的相机距离条件。
获取或设置此要素的字体。
仅在定义labelText
时应用。
获取或设置此要素的高度偏移(以米为单位)。
horizontalOrigin : HorizontalOrigin
获取或设置此点的水平原点,该原点确定该点是否位于其锚点位置的左侧、中部或右侧。
获取或设置此要素的图像。
labelColor : Color
获取或设置此要素的标签颜色。
如果labelText
被定义,颜色将被应用到标签上。
labelHorizontalOrigin : HorizontalOrigin
获取或设置该点文本的水平原点,该原点确定该点文本是否位于其锚点位置的左侧、中部或右侧。
labelOutlineColor : Color
获取或设置此要素的标签轮廓颜色。
如果labelText
被定义,则轮廓颜色将应用到标签上。
获取或设置此要的轮廓宽度(以像素为单位)。
如果labelText
被定义,则将轮廓宽度应用于该点。
labelStyle : LabelStyle
获取或设置此要素的填充和轮廓样式。
仅在定义labelText
时应用。
获取或设置此要素的文本。
labelVerticalOrigin : VerticalOrigin
获取或设置该点文本的垂直原点,该原点确定该点文本是否位于其锚点的底部、中心、顶部还是基线。
pointOutlineColor : Color
获取或设置此要素的点轮廓颜色。
仅当image
为undefined
时应用。
获取或设置此要素的点轮廓宽度(以像素为单位)。
仅当image
为undefined
时应用。
获取或设置此要素的点大小。
仅当image
为undefined
时应用。
readonlyprimitive : Cesium3DTileset
Scene#pick
返回的所有对象都有一个primitive
属性。
这将返回包含该要素的tileset。
scaleByDistance : NearFarScalar
获取或设置此要素的远近缩放属性。
获取或设置将显示的要素。这是在评估样式的显示时为所有要素设置的。
-
Default Value:
true
readonlytileset : Cesium3DTileset
获取包含该要素的tileset。
translucencyByDistance : NearFarScalar
获取或设置此要素的远近半透明属性。
verticalOrigin : VerticalOrigin
获取或设置此点的垂直原点,该原点确定该点是否指向其锚点位置的底部、中心或顶部。
Methods
返回具有给定名称的要素的属性值的副本。这包括使用批处理表层次结构时来自该要素的类和继承的类的属性。
Name | Type | Description |
---|---|---|
name |
String | 区分大小写的属性名。 |
Returns:
属性的值,如果属性不存在,则
undefined
。
Example:
// 在控制台日志中显示某个要素的所有属性。
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));
}
See:
返回要素的属性名称数组。这包括使用批处理表层次结构时来自该要素的类和继承的类的属性。
Name | Type | Description |
---|---|---|
results |
Array.<String> | 存储结果的数组。 |
Returns:
要素的属性的名称。
返回要素是否包含此属性。这包括使用批处理表层次结构时来自该要素的类和继承的类的属性。
Name | Type | Description |
---|---|---|
name |
String | 区分大小写的属性名。 |
Returns:
要素是否包含此属性。
使用给定名称设置要素的属性的值。
如果具有给定名称的属性不存在,则创建它。
Name | Type | Description |
---|---|---|
name |
String | 区分大小写的属性名。 |
value |
* | 要复制的属性的值。 |
Throws:
-
DeveloperError : 继承的批处理表层次结构属性为只读。
Examples:
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');
}