Class: Cesium3DTileFeature

Cesium3DTileFeature

new Cesium3DTileFeature()

A feature of a Cesium3DTileset.

Provides access to a feature's properties stored in the tile's batch table, as well as the ability to show/hide a feature and change its highlight color via Cesium3DTileFeature#show and Cesium3DTileFeature#color, respectively.

Modifications to a Cesium3DTileFeature object have the lifetime of the tile's content. If the tile's content is unloaded, e.g., due to it going out of view and needing to free space in the cache for visible tiles, listen to the Cesium3DTileset#tileUnload event to save any modifications. Also listen to the Cesium3DTileset#tileVisible event to reapply any modifications.

Do not construct this directly. Access it through Cesium3DTileContent#getFeature or picking using Scene#pick.

Example
// On mouse over, display all the properties for a feature in the console log.
handler.setInputAction(function(movement) {
    const feature = scene.pick(movement.endPosition);
    if (feature instanceof Cesium.Cesium3DTileFeature) {
        const propertyIds = feature.getPropertyIds();
        const length = propertyIds.length;
        for (let i = 0; i < length; ++i) {
            const propertyId = propertyIds[i];
            console.log(`{propertyId}: ${feature.getProperty(propertyId)}`);
        }
    }
}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);

Members

colorColor

Gets or sets the highlight color multiplied with the feature's color. When this is white, the feature's color is not changed. This is set for all features when a style's color is evaluated.

Default Value:
Color.WHITE

readonly featureIdnumber

Get the feature ID associated with this feature. For 3D Tiles 1.0, the batch ID is returned. For EXT_mesh_features, this is the feature ID from the selected feature ID set.

polylinePositionsFloat64Array

Gets a typed array containing the ECEF positions of the polyline. Returns undefined if Cesium3DTileset#vectorKeepDecodedPositions is false or the feature is not a polyline in a vector tile.

readonly primitiveCesium3DTileset

All objects returned by Scene#pick have a primitive property. This returns the tileset containing the feature.

showboolean

Gets or sets if the feature will be shown. This is set for all features when a style's show is evaluated.

Default Value:
true

readonly tilesetCesium3DTileset

Gets the tileset containing the feature.

Methods

static getPropertyInherited(content, batchId, name){*}

Returns a copy of the feature's property with the given name, examining all the metadata from 3D Tiles 1.0 formats, the EXT_structural_metadata and legacy EXT_feature_metadata glTF extensions, and the metadata present either in the tileset JSON (3D Tiles 1.1) or in the 3DTILES_metadata 3D Tiles extension. Metadata is checked against name from most specific to most general and the first match is returned. Metadata is checked in this order:

  1. Batch table (structural metadata) property by semantic
  2. Batch table (structural metadata) property by property ID
  3. Content metadata property by semantic
  4. Content metadata property by property
  5. Tile metadata property by semantic
  6. Tile metadata property by property ID
  7. Subtree metadata property by semantic
  8. Subtree metadata property by property ID
  9. Group metadata property by semantic
  10. Group metadata property by property ID
  11. Tileset metadata property by semantic
  12. Tileset metadata property by property ID
  13. Otherwise, return undefined
Name Type Description
content Cesium3DTileContent

The content for accessing the metadata
batchId number

The batch ID (or feature ID) of the feature to get a property for
name string

The semantic or property ID of the feature. Semantics are checked before property IDs in each granularity of metadata.
Returns:
Type Description
* The value of the property or undefined if the feature does not have this property.

getProperty(name){*}

Returns a copy of the value of the feature's property with the given name. This includes properties from this feature's class and inherited classes when using a batch table hierarchy.

Name Type Description
name string

The case-sensitive name of the property.
Returns:
Type Description
* The value of the property or undefined if the feature does not have this property.
Example
// Display all the properties for a feature in the console log.
const propertyIds = feature.getPropertyIds();
const length = propertyIds.length;
for (let i = 0; i < length; ++i) {
    const propertyId = propertyIds[i];
    console.log(`{propertyId}: ${feature.getProperty(propertyId)}`);
}

getPropertyIds(results){Array.<string>}

Returns an array of property IDs for the feature. This includes properties from this feature's class and inherited classes when using a batch table hierarchy.

Name Type Description
results Array.<string> 可选

An array into which to store the results.
Returns:
Type Description
Array.<string> The IDs of the feature's properties.

hasProperty(name){boolean}

Returns whether the feature contains this property. This includes properties from this feature's class and inherited classes when using a batch table hierarchy.

Name Type Description
name string

The case-sensitive name of the property.
Returns:
Type Description
boolean Whether the feature contains this property.

setProperty(name, value)

Sets the value of the feature's property with the given name.

If a property with the given name doesn't exist, it is created.

Name Type Description
name string

The case-sensitive name of the property.
value *

The value of the property that will be copied.
Throws:

Inherited batch table hierarchy property is read only.

Type
DeveloperError
Examples
const height = feature.getProperty('Height'); // e.g., the height of a building
const name = 'clicked';
if (feature.getProperty(name)) {
    console.log('already clicked');
} else {
    feature.setProperty(name, true);
    console.log('first click');
}