Cesium API - Scene 中文文档

成员变量

Default Value: Color.BLACK

参考：

• Scene#skyBox

参考：

• Scene#clampToHeight
• Scene#clampToHeightMostDetailed

Default Value: true

Default Value: undefined

示例：

// 不执行任何命令。
scene.debugCommandFilter = function(command) {
    return false;
};

// 只执行布告牌的命令。也就是说，只画布告牌。
var 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

Default Value: false

参考：

• drawingBufferHeight

参考：

• drawingBufferHeight

Default Value: 1000.0

Default Value: 2.2

Default Value: true

Default Value: true

Default Value: false

Default Value: Color.WHITE

参考：

• Scene#invertClassification

Default Value: 1e9

Default Value: new GeographicProjection()

参考：

• glGet with ALIASED_LINE_WIDTH_RANGE.

参考：

• glGet with GL_MAX_CUBE_MAP_TEXTURE_SIZE.

Default Value: 0.0

参考：

• 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: 1.75e6

参考：

• Scene#pickPosition

Default Value: false

示例：

// 拾取半透明图元的位置
viewer.screenSpaceEventHandler.setInputAction(function onLeftClick(movement) {
     var pickedFeature = viewer.scene.pick(movement.position);
     if (!Cesium.defined(pickedFeature)) {
         return;    // nothing picked
     }
     viewer.scene.render();
     var 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

Default Value: false

参考：

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

Default Value: false

参考：

• Scene#sampleHeight
• Scene#sampleHeightMostDetailed

Default Value: undefined

Default Value: undefined

参考：

• Scene#backgroundColor

参考：

• Scene#specularEnvironmentMaps

Default Value: undefined

Default Value: true

Default Value: Cartesian3(1.8, 1.85, 2.0)

Default Value: true

Default Value: false

内置方法

示例：

// 每当鼠标移动时，输出经度/纬度(0,0)的画布位置。
var scene = widget.scene;
var ellipsoid = scene.globe.ellipsoid;
var position = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
var handler = new Cesium.ScreenSpaceEventHandler(scene.canvas);
handler.setInputAction(function(movement) {
    console.log(scene.cartesianToCanvasCoordinates(position));
}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);

• DeveloperError : clampToHeight 仅支持3D模式。
• DeveloperError : clampToHeight 需要深度纹理支持。检查sampleHeightSupported。

示例：

// 贴紧一个实体到底层的场景几何图形
var position = entity.position.getValue(Cesium.JulianDate.now());
entity.position = viewer.scene.clampToHeight(position);

参考：

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

• DeveloperError : clampToHeightMostDetailed 仅支持3D模式。
• DeveloperError : clampToHeightMostDetailed 需要深度纹理支持。检查sampleHeightSupported。

示例：

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

参考：

• Scene#clampToHeight

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

示例：

scene = scene && scene.destroy();

参考：

• Scene#isDestroyed

• DeveloperError : 未定义的 windowPosition。

示例：

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

参考：

• Scene#pick

参考：

• Scene#destroy

示例：

// 鼠标移上去时显示黄色。
handler.setInputAction(function(movement) {
    var feature = scene.pick(movement.endPosition);
    if (feature instanceof Cesium.Cesium3DTileFeature) {
        feature.color = Cesium.Color.YELLOW;
    }
}, Cesium.ScreenSpaceEventType.MOUSE_MOVE);

• DeveloperError : 不支持从深度缓冲区中进行选择，检查pickPositionSupported。

参考：

• Scene#requestRenderMode

• DeveloperError : sampleHeight 仅支持3D模式。
• DeveloperError : sampleHeight 需要深度纹理支持。检查sampleHeightSupported。

示例：

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

参考：

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

• DeveloperError : sampleHeightMostDetailed 仅支持3D模式。
• DeveloperError : sampleHeightMostDetailed 需要深度纹理支持。检查sampleHeightSupported。

示例：

var positions = [
    new Cesium.Cartographic(-1.31968, 0.69887),
    new Cesium.Cartographic(-1.10489, 0.83923)
];
var 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