Scene

查阅Mars3D API

成员(属性)

默认值: Color.BLACK

参考:

• Scene#skyBox

默认值: false

参考:

• Scene#clampToHeight
• Scene#clampToHeightMostDetailed

默认值: true

默认值: undefined

使用示例:

// 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;
};

默认值: undefined

默认值: false

默认值: 1

默认值: false

默认值: false

默认值: false

参考:

• drawingBufferHeight

参考:

• drawingBufferWidth

默认值: 1000.0

默认值: 2.2

默认值: false

默认值: true

默认值: false

默认值: Color.WHITE

参考:

• Scene#invertClassification

默认值: 1e9

默认值: new GeographicProjection()

参考:

• glGet with ALIASED_LINE_WIDTH_RANGE.

参考:

• glGet with GL_MAX_CUBE_MAP_TEXTURE_SIZE.

默认值: 0.0

参考:

• Improving Performance with Explicit Rendering
• Scene#requestRenderMode

默认值: 0.0

默认值: SceneMode.SCENE3D

默认值: undefined

默认值: Event()

默认值: Event()

默认值: 1.0

默认值: 1

默认值: 1.75e6

参考:

• Scene#pickPosition

默认值: false

使用示例:

// 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);

参考:

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

参考:

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

参考:

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

参考:

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

默认值: false

参考:

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

默认值: false

参考:

• Scene#sampleHeight
• Scene#sampleHeightMostDetailed

默认值: undefined

默认值: undefined

参考:

• Scene#backgroundColor

参考:

• Scene#specularEnvironmentMaps

默认值: undefined

默认值: true

默认值: true

默认值: false

默认值: 1.0

默认值: 0.0

方法

返回值:

使用示例:

// Output the canvas position of longitude/latitude (0, 0) every time the mouse moves.
const scene = widget.scene;
const ellipsoid = scene.globe.ellipsoid;
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);

返回值:

Throws:

• DeveloperError : clampToHeight is only supported in 3D mode.
• DeveloperError : clampToHeight requires depth texture support. Check clampToHeightSupported.

使用示例:

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

参考:

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

返回值:

Throws:

• DeveloperError : clampToHeightMostDetailed is only supported in 3D mode.
• DeveloperError : clampToHeightMostDetailed requires depth texture support. Check clampToHeightSupported.

使用示例:

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];
}

参考:

• Scene#clampToHeight

Throws:

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

使用示例:

scene = scene && scene.destroy();

参考:

• Scene#isDestroyed

返回值:

Throws:

• DeveloperError : windowPosition is undefined.

使用示例:

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

参考:

• Scene#pick

返回值:

返回值:

参考:

• Scene#destroy

返回值:

使用示例:

// 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);

返回值:

Throws:

• DeveloperError : Picking from the depth buffer is not supported. Check pickPositionSupported.

返回值:

使用示例:

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

This feature is not final and is subject to change without Cesium's standard deprecation policy.

参考:

• Scene#requestRenderMode

返回值:

Throws:

• DeveloperError : sampleHeight is only supported in 3D mode.
• DeveloperError : sampleHeight requires depth texture support. Check sampleHeightSupported.

使用示例:

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

参考:

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

返回值:

Throws:

• DeveloperError : sampleHeightMostDetailed is only supported in 3D mode.
• DeveloperError : sampleHeightMostDetailed requires depth texture support. Check sampleHeightSupported.

使用示例:

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.
}

参考:

• Scene#sampleHeight

返回值:

使用示例s:

// 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}`);
});