Scene

new Cesium.Scene (options, depthPlaneEllipsoidOffset )
Scene/Scene.js 154

Cesium 虚拟场景中所有 3D 图形对象和状态的容器。一般不直接创建场景；相反，它是由 CesiumWidget 隐式创建的。

contextOptions 参数详情:

默认值为: { webgl : { alpha : false, depth : true, stencil : false, antialias : true, powerPreference: 'high-performance', premultipliedAlpha : true, preserveDrawingBuffer : false, failIfMajorPerformanceCaveat : false }, allowTextureFilterAnisotropic : true }

webgl 属性对应于用于创建 WebGL 上下文的 WebGLContextAttributes 对象。

webgl.alpha 默认为 false，与标准 WebGL 默认为 true 相比，可以提高性能。如果应用程序需要使用 alpha 混合将 webgl.alpha 到其他 HTML 元素之上，请将 webgl.alpha 设置为 true。

其他 webgl 属性与 WebGLContextAttributes 的 WebGL 默认值匹配。

allowTextureFilterAnisotropic 默认为 true，在支持 WebGL 扩展时启用各向异性纹理过滤。将此设置为 false 将提高性能，但会损害视觉质量，尤其是对于水平视图。

Name Type Default Description
options Object 具有以下属性的对象:
姓名 类型 默认 描述
canvas HTMLCanvasElement 要为其创建场景的 HTML 画布元素。
contextOptions 目的 可选 的 Context 和 WebGL 创建属性。请参阅上面的详细信息。
creditContainer 元素 可选 将在其中显示学分的 HTML 元素。
creditViewport 元素 可选 要在其中显示信用弹出窗口的 HTML 元素。如果未指定，视口将作为画布的兄弟添加。
mapProjection 地图投影 new GeographicProjection() 可选 在 2D 和哥伦布视图模式中使用的地图投影。
orderIndependentTranslucency 布尔值 true 可选 如果为 true 并且配置支持它，请使用与顺序无关的半透明。
scene3DOnly 布尔值 false 可选 如果为 true，则优化 3D 模式的内存使用和性能，但禁用使用 2D 或 Columbus View 的能力。
shadows 布尔值 false 可选 确定阴影是否由光源投射。
mapMode2D MapMode2D MapMode2D.INFINITE_SCROLL 可选 确定 2D 地图是可旋转的还是可以在水平方向上无限滚动。
requestRenderMode 布尔值 false 可选 如果为 true，则仅在需要时才会渲染帧，具体取决于场景内的变化。启用会提高应用程序的性能，但需要使用 Scene#requestRender 在此模式下显式渲染新帧。在对 API 的其他部分中的场景进行更改后，这在许多情况下是必要的。请参阅 使用显式渲染提高性能 。
maximumRenderTimeChange 数字 0.0 可选 如果 requestRenderMode 为 true，则此值定义在请求渲染之前允许的模拟时间的最大变化。请参阅 使用显式渲染提高性能 。
depthPlaneEllipsoidOffset Number 0.0 可选 调整 DepthPlane 以解决椭球零海拔以下的渲染伪影。
options.msaaSamples Number 1 可选 如果提供，此值控制多重采样抗锯齿的速率。典型的多重采样率为每像素 2、4 甚至有时 8 个样本。更高的 MSAA 采样率可能会影响性能以换取改进的视觉质量。此值仅适用于支持多样本渲染目标的 WebGL2 上下文。
Throws:
Example: 
// Create scene without anisotropic texture filtering
const scene = new Cesium.Scene({
  canvas : canvas,
  contextOptions : {
    allowTextureFilterAnisotropic : false
  }
});
See:

Members

backgroundColor : Color
Scene/Scene.js 352

背景颜色，仅在没有天空盒时可见，即 Scene#skyBox 未定义。
Default Value: Color.BLACK
See:

readonly camera : Camera
Scene/Scene.js 975

获取或设置相机。

readonly cameraUnderground : Boolean
Scene/Scene.js 1594

相机是否位于地球下方。
Default Value: false

readonly canvas : HTMLCanvasElement
Scene/Scene.js 780

获取此场景绑定到的画布元素。

readonly clampToHeightSupported : Boolean
Scene/Scene.js 887

如果支持 Scene#clampToHeight 和 Scene#clampToHeightMostDetailed 函数，则返回 true 。
See:

completeMorphOnUserInput : Boolean
Scene/Scene.js 285

确定是否在用户输入时立即完成场景过渡动画。
Default Value: true

debugCommandFilter : function
Scene/Scene.js 432

该属性仅用于调试；它不用于生产用途。

确定执行哪些命令的函数。如下例所示，该函数接收命令的 owner 作为参数，并返回一个布尔值，指示是否应该执行该命令。

默认为 undefined ，表示执行所有命令。

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

readonly debugFrustumStatistics : Object
Scene/Scene.js 1314

该属性仅用于调试；它不用于生产用途。

当 Scene.debugShowFrustums 为 true 时，它​​包含有关每个平截头体执行的命令数的统计信息的属性。 totalCommands 是执行的命令总数，忽略重叠。 commandsInFrustums 是一个数组，其中包含命令被冗余执行的次数，例如，有多少命令与两个或三个平截头体重叠。

Default Value: undefined

debugShowCommands : Boolean
Scene/Scene.js 446

该属性仅用于调试；它不用于生产用途。

当为 true 时，命令会随机着色。这对于性能分析很有用，可以查看场景或模型的哪些部分是命令密集的并且可以从批处理中受益。

Default Value: false

debugShowDepthFrustum : Number
Scene/Scene.js 487

该属性仅用于调试；它不用于生产用途。

指示哪个截锥体将显示深度信息。

Default Value: 1

debugShowFramesPerSecond : Boolean
Scene/Scene.js 475

该属性仅用于调试；它不用于生产用途。

显示每秒帧数和帧之间的时间。

Default Value: false

debugShowFrustumPlanes : Boolean
Scene/Scene.js 499

该属性仅用于调试；它不用于生产用途。

如果为 true ，则绘制轮廓以显示相机平截头体的边界

Default Value: false

debugShowFrustums : Boolean
Scene/Scene.js 463

该属性仅用于调试；它不用于生产用途。

当为 true 时，命令会根据它们重叠的截锥体进行着色。最近的截锥体中的命令被染成红色，下一个最近的截锥体中的命令是绿色的，最远的截锥体中的命令是蓝色的。如果一个命令与一个以上的平截头体重叠，则组合颜色分量，例如，一个与前两个平截头体重叠的命令被染成黄色。

Default Value: false

readonly drawingBufferHeight : Number
Scene/Scene.js 795

底层 GL 上下文的绘图缓冲区高度。
See:

readonly drawingBufferWidth : Number
Scene/Scene.js 810

底层 GL 上下文的绘图缓冲区高度。
See:

eyeSeparation : Number
Scene/Scene.js 594

用于纸板或 WebVR 的眼睛分离距离（以米为单位）。

farToNearRatio : Number
Scene/Scene.js 380

使用正常深度缓冲区时多截头体的远近比。

该值用于为多截头体的每个截头体创建近值和远值。它仅在 Scene#logarithmicDepthBuffer 为 false 时使用。当 logarithmicDepthBuffer 为 true 时，使用 Scene#logarithmicDepthFarToNearRatio 。

Default Value: 1000.0

focalLength : Number
Scene/Scene.js 588

使用纸板或 WebVR 时使用的焦距。

fog : Fog
Scene/Scene.js 548

将大气与远离相机的几何图形混合，以获得地平线视图。通过渲染更少的几何图形和调度更少的地形请求，允许额外的性能改进。

gamma : Number
Scene/Scene.js 1540

用于伽玛校正的值。这仅在以高动态范围渲染时使用。
Default Value: 2.2

globe : Globe
Scene/Scene.js 929

获取或设置深度测试椭球。

readonly groundPrimitives : PrimitiveCollection
Scene/Scene.js 962

获取地面基元的集合。

highDynamicRange : Boolean
Scene/Scene.js 1555

是否使用高动态范围渲染。
Default Value: false

readonly highDynamicRangeSupported : Boolean
Scene/Scene.js 1577

是否支持高动态范围渲染。
Default Value: true

readonly id : String
Scene/Scene.js 1352

获取此场景的唯一标识符。

readonly imageryLayers : ImageryLayerCollection
Scene/Scene.js 1129

获取将在地球上渲染的图像图层的集合。

invertClassification : Boolean
Scene/Scene.js 568

当为 false 时，3D Tiles 将正常渲染。当为 true 时，分类的 3D Tile 几何体将正常渲染，而未分类的 3D Tile 几何体将使用与 Scene#invertClassificationColor 相乘的颜色进行渲染。
Default Value: false

invertClassificationColor : Color
Scene/Scene.js 577

当 Scene#invertClassification 为 true 时，未分类的 3D Tile 几何体的高亮颜色。

当颜色的 alpha 小于 1.0 时，3D Tiles 的未分类部分将无法与 3D Tiles 的分类位置正确混合。

此外，当颜色的 alpha 小于 1.0 时，必须支持 WEBGL_depth_texture 和 EXT_frag_depth WebGL 扩展。

Default Value: Color.WHITE

readonly invertClassificationSupported : Boolean
Scene/Scene.js 902

如果支持 Scene#invertClassification ，则返回 true 。
See:

readonly lastRenderTime : JulianDate
Scene/Scene.js 1279

获取上次渲染场景时的模拟时间。如果尚未渲染场景，则返回 undefined。

light : Light
Scene/Scene.js 742

用于着色的光源。默认为来自太阳的定向光。

logarithmicDepthBuffer : Boolean
Scene/Scene.js 1521

是否使用对数深度缓冲区。启用此选项将允许在多视锥中减少视锥，从而提高性能。此属性依赖于所支持的 fragmentDepth。

logarithmicDepthFarToNearRatio : Number
Scene/Scene.js 393

使用对数深度缓冲区时多截头体的远近比。

该值用于为多截头体的每个截头体创建近值和远值。它仅在 Scene#logarithmicDepthBuffer 为 true 时使用。当 logarithmicDepthBuffer 为 false 时，使用 Scene#farToNearRatio 。

Default Value: 1e9

readonly mapMode2D : MapMode2D
Scene/Scene.js 1469

确定 2D 地图是可旋转的还是可以在水平方向上无限滚动。

readonly mapProjection : MapProjection
Scene/Scene.js 1056

获取地图投影以在 2D 和哥伦布视图模式下使用。
Default Value: new GeographicProjection()

readonly maximumAliasedLineWidth : Number
Scene/Scene.js 825

此 WebGL 实现支持的最大别名线宽（以像素为单位）。至少会是一个。
See:
  • glGet with ALIASED_LINE_WIDTH_RANGE .

readonly maximumCubeMapSize : Number
Scene/Scene.js 840

此 WebGL 实现支持的立方体贴图一条边的最大像素长度。至少会是 16 岁。
See:
  • glGet with GL_MAX_CUBE_MAP_TEXTURE_SIZE .

maximumRenderTimeChange : Number
Scene/Scene.js 674

如果 Scene#requestRenderMode 为 true ，则此值定义在请求渲染之前允许的模拟时间的最大变化。较低的值会增加渲染的帧数，而较高的值会减少渲染的帧数。如果 undefined ，对模拟时间的更改将永远不会请求渲染。该值会影响场景变化（如照明、实体属性更新和动画）的渲染速率。
Default Value: 0.0
See:

minimumDisableDepthTestDistance : Number
Scene/Scene.js 1499

禁用广告牌、标签和点的深度测试的相机距离，例如，防止对地形进行裁剪。当设置为零时，应始终应用深度测试。当小于零时，永远不应应用深度测试。设置广告牌、标签或点的 disableDepthTestDistance 属性将覆盖此值。
Default Value: 0.0

mode : SceneMode
Scene/Scene.js 1364

获取或设置场景的当前模式。
Default Value: SceneMode.SCENE3D

moon : Moon
Scene/Scene.js 342

Moon
Default Value: undefined

morphComplete : Event
Scene/Scene.js 299

该事件在场景转换完成时触发。
Default Value: Event()

morphStart : Event
Scene/Scene.js 292

该事件在场景转换开始时触发。
Default Value: Event()

morphTime : Number
Scene/Scene.js 367

当前 2D/Columbus View 和 3D 之间的变形过渡时间，0.0 为 2D 或 Columbus View，1.0 为 3D。
Default Value: 1.0

msaaSamples : Number
Scene/Scene.js 1606

多重采样抗锯齿的采样率（大于 1 的值启用 MSAA）。
Default Value: 1

readonly msaaSupported : Boolean
Scene/Scene.js 1622

如果场景的上下文支持 MSAA，则返回 true 。

nearToFarDistance2D : Number
Scene/Scene.js 403

确定 2D 中多截头体的每个截头体的均匀深度大小（以米为单位）。如果靠近表面的图元或模型显示 z-fighting，则减少它会消除伪影，但会降低性能。另一方面，增加此值会提高性能，但可能会导致靠近表面的图元之间发生 z-fighting。
Default Value: 1.75e6

readonly orderIndependentTranslucency : Boolean
Scene/Scene.js 1340

获取场景是否启用了与顺序无关的半透明。请注意，这仅反映原始构造选项，还有其他因素可能会阻止 OIT 在给定系统配置上运行。

readonly pickPositionSupported : Boolean
Scene/Scene.js 855

如果支持 Scene#pickPosition 函数，则返回 true 。
See:

pickTranslucentDepth : Boolean
Scene/Scene.js 533

当为 true 时，启用使用深度缓冲区拾取半透明几何体。请注意， Scene#useDepthPicking 也必须为 true 才能使其正常工作。

启用后性能会有所下降。有额外的绘制调用来为半透明几何体写入深度。

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

postProcessStages : PostProcessStageCollection
Scene/Scene.js 600

应用于最终渲染的后处理效果。

readonly postRender : Event
Scene/Scene.js 1265

获取将在场景渲染后立即引发的事件。事件的订阅者接收场景实例作为第一个参数和当前时间作为第二个参数。
See:

readonly postUpdate : Event
Scene/Scene.js 1210

获取将在场景更新后和渲染场景之前立即引发的事件。事件的订阅者接收场景实例作为第一个参数和当前时间作为第二个参数。
See:

readonly preRender : Event
Scene/Scene.js 1246

获取将在场景更新后和渲染场景之前引发的事件。事件的订阅者接收场景实例作为第一个参数和当前时间作为第二个参数。
See:

readonly preUpdate : Event
Scene/Scene.js 1190

获取将在更新或渲染场景之前引发的事件。事件的订阅者接收场景实例作为第一个参数和当前时间作为第二个参数。
See:

readonly primitives : PrimitiveCollection
Scene/Scene.js 949

获取原语的集合。

readonly renderError : Event
Scene/Scene.js 1226

获取在 render 函数内引发错误时将引发的事件。场景实例和抛出的错误是传递给事件处理程序的仅有的两个参数。默认情况下，引发此事件后不会重新引发错误，但可以通过设置 rethrowRenderErrors 属性来更改。

requestRenderMode : Boolean
Scene/Scene.js 657

如果为 true ，则仅在需要时才会渲染帧，具体取决于场景中的变化。启用会提高应用程序的性能，但需要使用 Scene#requestRender 在此模式下显式渲染新帧。在对 API 的其他部分中的场景进行更改后，这在许多情况下是必要的。
Default Value: false
See:

rethrowRenderErrors : Boolean
Scene/Scene.js 276

render 中发生的异常总是被捕获以引发 renderError 事件。如果此属性为 true，则在引发事件后重新引发错误。如果此属性为 false，则 render 函数在引发事件后正常返回。
Default Value: false

readonly sampleHeightSupported : Boolean
Scene/Scene.js 871

如果支持 Scene#sampleHeight 和 Scene#sampleHeightMostDetailed 函数，则返回 true 。
See:

readonly scene3DOnly : Boolean
Scene/Scene.js 1326

获取场景是否针对仅 3D 观看进行了优化。

readonly screenSpaceCameraController : ScreenSpaceCameraController
Scene/Scene.js 1041

获取用于相机输入处理的控制器。

shadowMap : ShadowMap
Scene/Scene.js 556

场景光源的阴影贴图。启用后，模型、图元和地球仪可能会投射和接收阴影。

skyAtmosphere : SkyAtmosphere
Scene/Scene.js 317

绘制在地球周围的天空气氛。
Default Value: undefined

skyBox : SkyBox
Scene/Scene.js 309

SkyBox 用于绘制星星。
Default Value: undefined
See:

specularEnvironmentMaps : String
Scene/Scene.js 735

KTX2 文件的 URL，其中包含 PBR 模型的基于图像的光照的高光环境贴图和卷积 mipmap。

readonly specularEnvironmentMapsSupported : Boolean
Scene/Scene.js 917

如果支持高光环境贴图，则返回 true 。
See:

sphericalHarmonicCoefficients : Array.< Cartesian3 >
Scene/Scene.js 729

基于图像的 PBR 模型照明的球谐系数。

splitPosition : Number
Scene/Scene.js 1481

获取或设置拆分器在视口中的位置。有效值介于 0.0 和 1.0 之间。

sun : Sun
Scene/Scene.js 325

Sun 。
Default Value: undefined

sunBloom : Boolean
Scene/Scene.js 333

启用时在太阳上使用布隆过滤器。
Default Value: true

terrainProvider : TerrainProvider
Scene/Scene.js 1145

为地球提供表面几何图形的地形提供者。

readonly terrainProviderChanged : Event
Scene/Scene.js 1167

获取更改地形提供程序时引发的事件

useDepthPicking : Boolean
Scene/Scene.js 509

当为 true 时，启用使用深度缓冲区进行拾取。
Default Value: true

useWebVR : Boolean
Scene/Scene.js 1426

当为 true 时，将场景拆分为两个视口，左眼和右眼具有立体视图。用于纸板和 WebVR。
Default Value: false

Methods

cartesianToCanvasCoordinates (position, result ) → Cartesian2
Scene/Scene.js 4349

将笛卡尔坐标中的位置转换为画布坐标。这通常用于将 HTML 元素放置在与场景中的对象相同的屏幕位置。
Name Type Description
position Cartesian3 笛卡尔坐标中的位置。
result Cartesian2 可选 一个可选对象，用于返回转换为画布坐标的输入位置。
Returns:
修改后的结果参数或新的 Cartesian2 实例（如果未提供）。如果输入位置靠近椭圆体的中心，这可能是 undefined 的。
Example: 
// 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);

clampToHeight (cartesian, objectsToExclude , width , result ) → Cartesian3
Scene/Scene.js 4235

将给定的笛卡尔位置沿大地表面法线钳制到场景几何体。如果没有场景几何体要夹住，则返回夹住的位置或 undefined 的位置。可用于将对象夹在地球、3D 瓷砖或场景中的图元上。

此函数仅钳制在当前视图中呈现的地球图块和 3D 图块。钳制到所有其他基元，无论其可见性如何。

Name Type Default Description
cartesian Cartesian3 笛卡尔位置。
objectsToExclude Array.<Object> 可选 不钳制到的基元、实体或 3D Tiles 特征的列表。
width Number 0.1 可选 交叉点体积的宽度（以米为单位）。
result Cartesian3 optional 一个可选对象，用于返回夹紧位置。
Returns:
修改后的结果参数或新的 Cartesian3 实例（如果未提供）。如果没有场景几何可以钳制，这可能是 undefined 的。
Throws:
Example: 
// Clamp an entity to the underlying scene geometry
const position = entity.position.getValue(Cesium.JulianDate.now());
entity.position = viewer.scene.clampToHeight(position);
See:

clampToHeightMostDetailed (cartesians, objectsToExclude , width ) → Promise.<Array.< Cartesian3 >>
Scene/Scene.js 4318

使用场景中 3D Tilesets 的最大细节级别对 Cartesian3 位置数组启动异步 Scene#clampToHeight 查询。返回查询完成时解决的承诺。每个位置都修改到位。如果由于无法在该位置对几何体进行采样而无法固定某个位置，或者发生另一个错误，则数组中的元素将设置为未定义。
Name Type Default Description
cartesians Array.< Cartesian3 > 使用钳位位置更新的笛卡尔位置。
objectsToExclude Array.<Object> 可选 不钳制到的基元、实体或 3D Tiles 特征的列表。
width Number 0.1 可选 交叉点体积的宽度（以米为单位）。
Returns:
查询完成后解析为提供的职位列表的承诺。
Throws:
  • DeveloperError :clampToHeightMostDetailed 仅在 3D 模式下受支持。
  • DeveloperError :clampToHeightMostDetailed 需要深度纹理支持。检查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:

completeMorph ()
Scene/Scene.js 4356

立即完成主动过渡。

destroy ()
Scene/Scene.js 4438

销毁此对象持有的 WebGL 资源。销毁一个对象允许确定性地释放 WebGL 资源，而不是依赖垃圾收集器来销毁这个对象。

一旦一个对象被销毁，它就不应该被使用；调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。因此，如示例中所做的那样，将返回值 ( undefined ) 分配给对象。
Throws:
Example: 
scene = scene && scene.destroy();
See:

drillPick (windowPosition, limit , width , height ) → Array.<*>
Scene/Scene.js 4028

返回一个对象列表，每个对象都包含一个 `primitive` 属性，用于特定窗口坐标位置的所有图元。其他属性也可以根据基元的类型进行设置，并且可以用于进一步识别拾取的对象。列表中的图元按它们在场景中的视觉顺序（从前到后）排序。
Name Type Default Description
windowPosition Cartesian2 执行拾取的窗口坐标。
limit Number 可选 如果提供，收集这么多镐后停止钻孔。
width Number 3 可选 选取矩形的宽度。
height Number 3 可选 选取矩形的高度。
Returns:
对象数组，每个对象包含 1 个选取的基元。
Throws:
Example: 
const pickedObjects = scene.drillPick(new Cesium.Cartesian2(100.0, 200.0));
See:

getCompressedTextureFormatSupported (format) → boolean
Scene/Scene.js 1670

确定是否支持压缩纹理格式。
Name Type Description
format String 纹理格式。可以是格式名称或 WebGL 扩展名，例如 s3tc 或 WEBGL_compressed_texture_s3tc。
Returns:
是否支持格式。

isDestroyed () → Boolean
Scene/Scene.js 4418

如果此对象被销毁，则返回 true；否则为假。

如果该对象被销毁，则不应使用；调用 isDestroyed 以外的任何函数都会导致 DeveloperError 异常。
Returns:
如果此对象被销毁，则为 true ；否则， false 。
See:

morphTo2D ( duration )
Scene/Scene.js 4364

将场景异步转换为 2D。
Name Type Default Description
duration Number 2.0 可选 过渡动画完成的时间量（以秒为单位）。

morphTo3D ( duration )
Scene/Scene.js 4396

将场景异步转换为 3D。
Name Type Default Description
duration Number 2.0 可选 过渡动画完成的时间量（以秒为单位）。

morphToColumbusView ( duration )
Scene/Scene.js 4380

将场景异步转换到哥伦布视图。
Name Type Default Description
duration Number 2.0 可选 过渡动画完成的时间量（以秒为单位）。

pick (windowPosition, width , height ) → Object
Scene/Scene.js 3955

返回具有 `primitive` 属性的对象，该属性包含场景中特定窗口坐标处的第一个（顶部）图元，如果该位置没有任何内容，则返回未定义的对象。其他属性可能会根据基元的类型进行设置，并可用于进一步识别拾取的对象。

当一个 3D Tiles 瓦片集的特征被拾取时， pick 返回一个 Cesium3DTileFeature 对象。

Name Type Default Description
windowPosition Cartesian2 执行拾取的窗口坐标。
width Number 3 可选 选取矩形的宽度。
height Number 3 可选 选取矩形的高度。
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);

pickPosition (windowPosition, result ) → Cartesian3
Scene/Scene.js 4005

返回从深度缓冲区和窗口位置重建的笛卡尔位置。

在 2D 中从深度缓冲区重建的位置可能与在 3D 和哥伦布视图中重建的位置略有不同。这是由于透视投影和正投影的深度值分布不同造成的。

将 Scene#pickTranslucentDepth 设置为 true 以包含半透明图元的深度；否则，这基本上是通过半透明基元挑选的。

Name Type Description
windowPosition Cartesian2 执行拾取的窗口坐标。
result Cartesian3 可选 要在其上恢复结果的对象。
Returns:
笛卡尔位置。
Throws:
  • DeveloperError :不支持从深度缓冲区中选取。检查pickPositionSupported。

render ( time )
Scene/Scene.js 3809

更新和渲染场景。通常不需要直接调用这个函数，因为 CesiumWidget 或 Viewer 会自动调用。
Name Type Description
time JulianDate 可选 渲染的模拟时间。

requestRender ()
Scene/Scene.js 3919

当 Scene#requestRenderMode 设置为 true 时请求新的渲染帧。渲染速率不会超过 CesiumWidget#targetFrameRate 。
See:

sampleHeight (position, objectsToExclude , width ) → Number
Scene/Scene.js 4204

返回给定制图位置的场景几何体的高度，如果没有场景几何体可从中采样高度，则返回 undefined 的高度。输入位置的高度被忽略。可用于将对象夹在地球、3D 瓷砖或场景中的图元上。

此函数仅从当前视图中渲染的地球图块和 3D 图块中采样高度。对所有其他基元的高度进行采样，无论其可见性如何。

Name Type Default Description
position Cartographic 从中采样高度的制图位置。
objectsToExclude Array.<Object> 可选 不从中采样高度的基元、实体或 3D Tiles 特征的列表。
width Number 0.1 可选 交叉点体积的宽度（以米为单位）。
Returns:
高度。如果没有场景几何体可以从中采样高度，这可能是 undefined 的。
Throws:
Example: 
const position = new Cesium.Cartographic(-1.31968, 0.698874);
const height = viewer.scene.sampleHeight(position);
console.log(height);
See:

sampleHeightMostDetailed (positions, objectsToExclude , width ) → Promise.<Array.< Cartographic >>
Scene/Scene.js 4278

使用场景中 3D Tilesets 的最大细节级别启动对 Cartographic 位置数组的异步 Scene#sampleHeight 查询。输入位置的高度被忽略。返回查询完成时解决的承诺。每个点的高度都在原地修改。如果由于无法在该位置对几何体进行采样而无法确定高度，或者发生其他错误，则将高度设置为未定义。
Name Type Default Description
positions Array.< Cartographic > 使用采样高度更新的制图位置。
objectsToExclude Array.<Object> 可选 不从中采样高度的基元、实体或 3D Tiles 特征的列表。
width Number 0.1 可选 交叉点体积的宽度（以米为单位）。
Returns:
查询完成后解析为提供的职位列表的承诺。
Throws:
  • DeveloperError : sampleHeightMostDetailed 仅在 3D 模式下受支持。
  • DeveloperError : sampleHeightMostDetailed 需要深度纹理支持。检查 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: