Cesium3DTileset

Members

Default Value: 2048

Default Value: 12288

Default Value: new Event()

Example:

tileset.allTilesLoaded.addEventListener(function() {
    console.log('All tiles are loaded');
});

See:

• Cesium3DTileset#tilesLoaded

Default Value: true

Deprecated: true

Default Value: 1024

Example:

const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
    url : 'http://localhost:8002/tilesets/Seattle/tileset.json'
}));

tileset.readyPromise.then(function(tileset) {
    // Set the camera to view the newly added tileset
    viewer.camera.viewBoundingSphere(tileset.boundingSphere, new Cesium.HeadingPitchRange(0, -0.5, 0));
});

Default Value: undefined

Experimental

This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.

Default Value: 0.5

Default Value: Cesium3DTileColorBlendMode.HIGHLIGHT

Default Value: true

Default Value: 60.0

Default Value: undefined

Experimental

This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.

Default Value: false

Default Value: false

Default Value: DebugModelMaterialChannel.NONE

Default Value: false

Default Value: false

Default Value: false

Default Value: false

Default Value: false

Default Value: false

Default Value: false

Default Value: false

Default Value: false

Default Value: 0.00278

Default Value: 4.0

Default Value: 0.25

Experimental

This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.

See:

• Extras in the 3D Tiles specification.

Experimental

This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.

Default Value: 0.3

Default Value: 0.0

Default Value: true

Default Value: 0.2

Default Value: false

Default Value: new Event()

Example:

tileset.initialTilesLoaded.addEventListener(function() {
    console.log('Initial tiles are loaded');
});

See:

• Cesium3DTileset#allTilesLoaded

Experimental

This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.

Default Value: undefined

Default Value: new Event()

Example:

tileset.loadProgress.addEventListener(function(numberOfPendingRequests, numberOfTilesProcessing) {
    if ((numberOfPendingRequests === 0) && (numberOfTilesProcessing === 0)) {
        console.log('Stopped loading');
        return;
    }

    console.log(`Loading: requests: ${numberOfPendingRequests}, processing: ${numberOfTilesProcessing}`);
});

Default Value: false

Default Value: 512

See:

• Cesium3DTileset#totalMemoryUsageInBytes

Default Value: 16

Default Value: Matrix4.IDENTITY

Example:

// Adjust a tileset's height from the globe's surface.
const heightOffset = 20.0;
const boundingSphere = tileset.boundingSphere;
const cartographic = Cesium.Cartographic.fromCartesian(boundingSphere.center);
const surface = Cesium.Cartesian3.fromRadians(cartographic.longitude, cartographic.latitude, 0.0);
const offset = Cesium.Cartesian3.fromRadians(cartographic.longitude, cartographic.latitude, heightOffset);
const translation = Cesium.Cartesian3.subtract(offset, surface, new Cesium.Cartesian3());
tileset.modelMatrix = Cesium.Matrix4.fromTranslation(translation);

Default Value: Color.BLACK

Default Value: false

Default Value: true

Default Value: false

Default Value: 0.3

Example:

console.log(`Maximum building height: ${tileset.properties.height.maximum}`);
console.log(`Minimum building height: ${tileset.properties.height.minimum}`);

See:

• Cesium3DTileFeature#getProperty
• Cesium3DTileFeature#setProperty

Default Value: false

Example:

tileset.readyPromise.then(function(tileset) {
    // tile.properties is not defined until readyPromise resolves.
    const properties = tileset.properties;
    if (Cesium.defined(properties)) {
        for (const name in properties) {
            console.log(properties[name]);
        }
    }
});

Default Value: false

Default Value: ShadowMode.ENABLED

Default Value: true

Default Value: false

Default Value: true

Default Value: false

Default Value: 1

Default Value: 16

{
  enable: false,                       // 是否开启实心裁剪
  YZPlaneDistance: 0,                  // Y-Z 裁剪平面的距离分量
  XZPlaneDistance: 0,                  // X-Z 裁剪平面的距离分量
  XYPlaneDistance: 0,                  // X-Y 裁剪平面的距离分量
  colorByFeaturePropertyName: 'names', // 指定根据 feature 的哪个属性名对裁剪平面进行着色
  colors: {},                          // 指定裁剪平面的颜色，属性名是 feature 的属性值，属性值是对应的颜色。默认是蓝色
}

Example:

tileset.solidClippingOptions = {
  enable: true,
  YZPlaneDistance: 0,
  XZPlaneDistance: 0,
  XYPlaneDistance: 0,
  colorByFeaturePropertyName: 'names',
  colors: {
    'Cube.001': Cesium.Color.fromCssColorString('#00AAFF'),
    'Cube.002': Cesium.Color.fromCssColorString('#CC0004'),
    'Cube.003': Cesium.Color.fromCssColorString('#51CB2B'),
  }
};

Default Value: 0.5

Default Value: SplitDirection.NONE

Default Value: undefined

Example:

tileset.style = new Cesium.Cesium3DTileStyle({
   color : {
       conditions : [
           ['${Height} >= 100', 'color("purple", 0.5)'],
           ['${Height} >= 50', 'color("red")'],
           ['true', 'color("blue")']
       ]
   },
   show : '${Height} > 0',
   meta : {
       description : '"Building id ${id} has height ${Height}."'
   }
});

See:

• 3D Tiles Styling language

Default Value: false

Example:

tileset.swapYZAxes = true;

Default Value: new Event()

Example:

tileset.tileFailed.addEventListener(function(error) {
    console.log(`An error occurred loading tile: ${error.url}`);
    console.log(`Error: ${error.message}`);
});

Default Value: new Event()

Example:

tileset.tileLoad.addEventListener(function(tile) {
    console.log('A tile was loaded.');
});

Default Value: false

See:

• Cesium3DTileset#allTilesLoaded

Default Value: new Event()

Example:

tileset.tileUnload.addEventListener(function(tile) {
    console.log('A tile was unloaded from the cache.');
});

See:

• Cesium3DTileset#maximumMemoryUsage
• Cesium3DTileset#trimLoadedTiles

Default Value: new Event()

Examples:

tileset.tileVisible.addEventListener(function(tile) {
    if (tile.content instanceof Cesium.Model3DTileContent) {
        console.log('A 3D model tile is visible.');
    }
});

// Apply a red style and then manually set random colors for every other feature when the tile becomes visible.
tileset.style = new Cesium.Cesium3DTileStyle({
    color : 'color("red")'
});
tileset.tileVisible.addEventListener(function(tile) {
    const content = tile.content;
    const featuresLength = content.featuresLength;
    for (let i = 0; i < featuresLength; i+=2) {
        content.getFeature(i).color = Cesium.Color.fromRandom();
    }
});

See:

• Cesium3DTileset#maximumMemoryUsage

Default Value: false

Experimental

This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.

Default Value: false

Experimental

This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.

Methods

Returns:

Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

Example:

tileset = tileset && tileset.destroy();

See:

• Cesium3DTileset#isDestroyed

Returns:

Returns:

See:

• Cesium3DTileset#destroy

Type Definitions

Returns:

Default Value: Math.lerp