Scene

成员 Members

默认值： Default Value: false

默认值： Default Value: Color.BLACK

另见： See:

• Scene#skyBox

默认值： Default Value: false

另见： See:

• Scene#clampToHeight
• Scene#clampToHeightMostDetailed

默认值： Default Value: true

默认值： Default Value: undefined

示例： Example:

// Do not execute any commands.
scene.debugCommandFilter = function(command) {
    return false;
};

// Execute only the billboard's commands.  That is, only draw the billboard.
const billboards = new Cesium.BillboardCollection();
scene.debugCommandFilter = function(command) {
    return command.owner === billboards;
};

默认值： Default Value: undefined

默认值： Default Value: false

默认值： Default Value: 1

默认值： Default Value: false

默认值： Default Value: false

默认值： Default Value: false

另见： See:

• drawingBufferHeight

另见： See:

• drawingBufferWidth

默认值： Default Value: 1000.0

默认值： Default Value: 2.2

默认值： Default Value: false

默认值： Default Value: true

默认值： Default Value: false

默认值： Default Value: Color.WHITE

另见： See:

• Scene#invertClassification

默认值： Default Value: 1e9

默认值： Default Value: new GeographicProjection()

另见： See:

• glGet with ALIASED_LINE_WIDTH_RANGE.

另见： See:

• glGet with GL_MAX_CUBE_MAP_TEXTURE_SIZE.

默认值： Default Value: 0.0

另见： See:

• Improving Performance with Explicit Rendering
• Scene#requestRenderMode

默认值： Default Value: 0.0

默认值： Default Value: SceneMode.SCENE3D

默认值： Default Value: undefined

默认值： Default Value: Event()

默认值： Default Value: Event()

默认值： Default Value: 1.0

默认值： Default Value: 4

默认值： Default Value: 1.75e6

另见： See:

• Scene#pickPosition

默认值： Default Value: false

示例： Example:

// picking the position of a translucent primitive
viewer.screenSpaceEventHandler.setInputAction(function onLeftClick(movement) {
     const pickedFeature = viewer.scene.pick(movement.position);
     if (!Cesium.defined(pickedFeature)) {
         // nothing picked
         return;
     }
     const worldPosition = viewer.scene.pickPosition(movement.position);
}, Cesium.ScreenSpaceEventType.LEFT_CLICK);

另见： See:

• Improving Performance with Explicit Rendering
• Scene#preUpdate
• Scene#postUpdate
• Scene#postRender

另见： See:

• Improving Performance with Explicit Rendering
• Scene#preUpdate
• Scene#preRender
• Scene#postRender

另见： See:

• Improving Performance with Explicit Rendering
• Scene#preUpdate
• Scene#postUpdate
• Scene#postRender

另见： See:

• Improving Performance with Explicit Rendering
• Scene#postUpdate
• Scene#preRender
• Scene#postRender

默认值： Default Value: false

另见： See:

• Improving Performance with Explicit Rendering
• Scene#maximumRenderTimeChange
• Scene#requestRender

默认值： Default Value: false

另见： See:

• Scene#sampleHeight
• Scene#sampleHeightMostDetailed

默认值： Default Value: undefined

默认值： Default Value: undefined

另见： See:

• Scene#backgroundColor

另见： See:

• Scene#specularEnvironmentMaps

默认值： Default Value: undefined

默认值： Default Value: true

默认值： Default Value: true

默认值： Default Value: false

默认值： Default Value: 1.0

默认值： Default Value: 0.0

方法 Methods

返回： Returns:

示例： Example:

// Output the canvas position of longitude/latitude (0, 0) every time the mouse moves.
const scene = widget.scene;
const position = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
const handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
handler.setInputAction(function(movement) {
    console.log(scene.cartesianToCanvasCoordinates(position));
}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);

返回： Returns:

抛出： Throws:

• DeveloperError ：clampToHeight 仅在 3D 模式下支持。 : clampToHeight is only supported in 3D mode.
• DeveloperError ：clampToHeight 需要深度纹理支持。检查clampToHeightSupported。 : clampToHeight requires depth texture support. Check clampToHeightSupported.

示例： Example:

// Clamp an entity to the underlying scene geometry
const position = entity.position.getValue(Cesium.JulianDate.now());
entity.position = viewer.scene.clampToHeight(position);

另见： See:

• Scene#sampleHeight
• Scene#sampleHeightMostDetailed
• Scene#clampToHeightMostDetailed

返回： Returns:

抛出： Throws:

• DeveloperError ：clampToHeightMostDetailed 仅在 3D 模式下受支持。 : clampToHeightMostDetailed is only supported in 3D mode.
• DeveloperError ：clampToHeightMostDetailed 需要深度纹理支持。检查clampToHeightSupported。 : clampToHeightMostDetailed requires depth texture support. Check clampToHeightSupported.

示例： Example:

const cartesians = [
    entities[0].position.getValue(Cesium.JulianDate.now()),
    entities[1].position.getValue(Cesium.JulianDate.now())
];
const promise = viewer.scene.clampToHeightMostDetailed(cartesians);
promise.then(function(updatedCartesians) {
    entities[0].position = updatedCartesians[0];
    entities[1].position = updatedCartesians[1];
}

另见： See:

• Scene#clampToHeight

抛出： Throws:

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

示例： Example:

scene = scene && scene.destroy();

另见： See:

• Scene#isDestroyed

返回： Returns:

抛出： Throws:

• DeveloperError ：窗口位置未定义。 : windowPosition is undefined.

示例： Example:

const pickedObjects = scene.drillPick(new Cesium.Cartesian2(100.0, 200.0));

另见： See:

• Scene#pick

返回： Returns:

返回： Returns:

另见： See:

• Scene#destroy

返回： Returns:

示例： Example:

// On mouse over, color the feature yellow.
handler.setInputAction(function(movement) {
    const feature = scene.pick(movement.endPosition);
    if (feature instanceof Cesium.Cesium3DTileFeature) {
        feature.color = Cesium.Color.YELLOW;
    }
}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);

返回： Returns:

示例： Example:

// On mouse over, color the feature yellow.
handler.setInputAction(function(movement) {
    const feature = scene.pickAsync(movement.endPosition).then(function(feature) {
       if (feature instanceof Cesium.Cesium3DTileFeature) {
           feature.color = Cesium.Color.YELLOW;
       }
    });
}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);

另见： See:

• Scene#pick

返回： Returns:

实验性 Experimental

此功能不是最终版本，可能会在没有 Cesium 标准弃用政策的情况下进行更改。 This feature is not final and is subject to change without Cesium's standard deprecation policy.

返回： Returns:

实验性 Experimental

此功能不是最终版本，可能会在没有 Cesium 标准弃用政策的情况下进行更改。 This feature is not final and is subject to change without Cesium's standard deprecation policy.

返回： Returns:

抛出： Throws:

• DeveloperError ：不支持从深度缓冲区中选取。检查 pickPositionSupported。 : Picking from the depth buffer is not supported. Check pickPositionSupported.

返回： Returns:

示例： Example:

On left click, report the value of the "color" property at that voxel sample.
handler.setInputAction(function(movement) {
  const voxelCell = scene.pickVoxel(movement.position);
  if (defined(voxelCell)) {
    console.log(voxelCell.getProperty("color"));
  }
}, Cesium.ScreenSpaceEventType.LEFT_CLICK);

实验性 Experimental

此功能不是最终版本，可能会在没有 Cesium 标准弃用政策的情况下进行更改。 This feature is not final and is subject to change without Cesium's standard deprecation policy.

另见： See:

• Scene#requestRenderMode

返回： Returns:

抛出： Throws:

• DeveloperError ：sampleHeight 仅在 3D 模式下支持。 : sampleHeight is only supported in 3D mode.
• DeveloperError ：sampleHeight 需要深度纹理支持。检查示例高度支持。 : sampleHeight requires depth texture support. Check sampleHeightSupported.

示例： Example:

const position = new Cesium.Cartographic(-1.31968, 0.698874);
const height = viewer.scene.sampleHeight(position);
console.log(height);

另见： See:

• Scene#clampToHeight
• Scene#clampToHeightMostDetailed
• Scene#sampleHeightMostDetailed

返回： Returns:

抛出： Throws:

• DeveloperError ：sampleHeightMostDetailed 仅在 3D 模式下受支持。 : sampleHeightMostDetailed is only supported in 3D mode.
• DeveloperError ：sampleHeightMostDetailed 需要深度纹理支持。检查示例高度支持。 : sampleHeightMostDetailed requires depth texture support. Check sampleHeightSupported.

示例： Example:

const positions = [
    new Cesium.Cartographic(-1.31968, 0.69887),
    new Cesium.Cartographic(-1.10489, 0.83923)
];
const promise = viewer.scene.sampleHeightMostDetailed(positions);
promise.then(function(updatedPosition) {
    // positions[0].height and positions[1].height have been updated.
    // updatedPositions is just a reference to positions.
}

另见： See:

• Scene#sampleHeight

返回： Returns:

示例： Examples:

// Use Cesium World Terrain
scene.setTerrain(Cesium.Terrain.fromWorldTerrain());

// Use a custom terrain provider
const terrain = new Cesium.Terrain(Cesium.CesiumTerrainProvider.fromUrl("https://myTestTerrain.com"));
scene.setTerrain(terrain);

terrain.errorEvent.addEventListener(error => {
  alert(`Encountered an error while creating terrain! ${error}`);
});