Scene - Cesium Documentation

new Cesium.Scene(options)

三维场景类，它是所有三维图形对象和状态的容器，通常不直接创建场景，而是由CesiumWidget隐式创建。

contextOptions参数详细信息：

默认值为: { webgl : { alpha : false, depth : true, stencil : false, antialias : true, premultipliedAlpha : true, preserveDrawingBuffer : false, failIfMajorPerformanceCaveat : false }, allowTextureFilterAnisotropic : true }

webgl属性对应用于创建WebGL环境的WebGLContextAttributes对象。

webgl.alpha默认为false，与标准WebGL默认值为true相比，这可以提高性能。

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

allowTextureFilterAnisotropic默认为true，这允许在支持WebGL扩展时进行各向异性纹理过滤。设置为false可以提高性能，但会损害视觉质量，特别是对于水平视图。

Name Type Description

options

Object

optional 对象具有以下属性:

Name	Type	Default	Description
`canvas`	Canvas		用于创建场景的HTML cancas元素。
`contextOptions`	Object		optional 环境和WebGL创建属性，详见上述。
`creditContainer`	Element		optional 用于显示服务描述信息的HTML元素。
`mapProjection`	MapProjection	`new GeographicProjection()`	optional 在二维和Columbus 视图模式下使用的地图投影。
`orderIndependentTranslucency`	Boolean	`true`	optional 如果此项设置为true，并且使用设备支持，将使用与顺序无关的半透明。
`scene3DOnly`	Boolean	`false`	optional 如果此项设置为true，将优化三维模式的内存使用和性能，但禁止使用二维或Columbus视图功能。
`terrainExaggeration`	Number	`1.0`	optional 用于夸大地形的标量。请注意，设置地形夸张不会修改其它任何数据。
`shadows`	Boolean	`false`	optional 确定阴影是否由太阳投射形成。
`mapMode2D`	MapMode2D	`MapMode2D.INFINITE_SCROLL`	optional 确定二维地图是可旋转的或是可以在在水平方向上无限滚动。

Throws:

DeveloperError : options 需要指定options、options.canvas。

Example:

//创建一个场景。
var viewer=new new Cesium.Viewer('Container');
var scene = viewer.scene;

See:

CesiumWidget

Members

readonlycamera : Camera

获取当前场景的相机对象。

readonlycanvas : Element

获取scene绑定的canvas元素。

debugShowFrustumPlanes : Boolean

This property is for debugging only; it is not for production use.

When true, draws outlines to show the boundaries of the camera frustums

Default Value: false

debugShowFrustums : Boolean

该属性仅用于调试，不用于生产。当为true时，绘制轮廓线展示相机平台的范围。

Default Value: false

readonlydrawingBufferHeight : Number

GL绘制缓冲区高度。

See:

drawingBufferWidth

readonlydrawingBufferWidth : Number

GL绘制缓冲区宽度。

See:

drawingBufferHeight

enableOcclude

当前场景是否开启遮挡剔除。

Default Value: true

eyeSeparation : Number

The eye separation distance in meters for use with cardboard or WebVR.

focalLength : Number

The focal length for use when with cardboard or WebVR.

globe : Globe

获取地球对象。

readonlygroundPrimitives : PrimitiveCollection

获取所有贴地图元集合。

hdrEnabled

当前场景是否开启hdr。

Default Value: true

readonlyid : String

获取当前场景的id。

readonlyimageryLayers : ImageryLayerCollection

获取当前场景影像图层集合。

imagerySplitPosition : Number

获取当前场景的影像分隔条位置。

invertClassification : Boolean

When false, 3D Tiles will render normally. When true, classified 3D Tile geometry will render normally and unclassified 3D Tile geometry will render with the color multiplied by Scene#invertClassificationColor.

Default Value: false

invertClassificationColor : Color

The highlight color of unclassified 3D Tile geometry when Scene#invertClassification is true.

When the color's alpha is less than 1.0, the unclassified portions of the 3D Tiles will not blend correctly with the classified positions of the 3D Tiles.

Also, when the color's alpha is less than 1.0, the WEBGL_depth_texture and EXT_frag_depth WebGL extensions must be supported.

Default Value: Color.WHITE

readonlylayers : Layers

获取当前场景的三维切片缓存图层集合。

lightSource

获取当前场景中的光源。

readonlymapProjection : MapProjection

获取地图投影对象，用于2D或者Columbus View模式,默认为经纬度投影。

Default Value: new GeographicProjection()

minimumDisableDepthTestDistance : Number

通过设置相机视角距离禁止布告板、标签和点对象的深度测试。例如，为了防止剪切地形数据，将距离设置为0则深度测试一直有效，将距离设置为小于0则深度测试失效。通过设置布告板、标签和点对象的disableDepthTestDistance属性修改距离值。

Default Value: 0.0

mode : SceneMode

获取当前场景的模式。

Default Value: SceneMode.SCENE3D

multiViewportMode : Number

获取或者设置当前场景的多视口模式,默认单视口。

Default Value: 0

pickTranslucentDepth : Boolean

当为true时，支持使用深度缓冲区拾取半透明的几何图形。Scene#useDepthPicking也必须为true，支持拾取深度缓冲区。使用时性能有所下降，对于半透明的几何图形，将调用额外的绘图命令写入深度。

Default Value: false

readonlypostRender : Event

获取当前场景每帧渲染结束时的事件，监听该事件在每帧渲染结束时触发。

readonlypreRender : Event

获取当前场景每帧渲染前的事件，监听该事件在每帧渲染之前触发。

readonlyprimitives : PrimitiveCollection

获取所有图元集合。

readonlyscreenSpaceCameraController : ScreenSpaceCameraController

获取当前场景的相机操作对象。

shadowMap : ShadowMap

场景中的阴影贴图。启用时，模型、图元和地球可以投射和接收阴影。默认情况下，阴影贴图的光源是太阳。

terrainProvider : TerrainProvider

获取或者设置当前场景的地形服务provider对象。

readonlyterrainProviderChanged : Event

获取当前场景地形服务provider改变事件。

toneMappingEnabled

当前场景是否开启toneMapping。

undergroundDepth : Number

获取或者设置地下场景深度，默认1000米（单位：米）。

undergroundMode : Boolean

获取或者设置是否开启地下场景。

Default Value: false

Methods

addFieldLayer(url) → Promise

根据url路径添加场数据图层。

Name	Type	Description
`url`	String	场数据的url路径。

Returns:

返回场数据图层FieldLayer3D，异步创建场图层对象。

Example:

var promise =  viewer.scene.addFieldLayer("../data.nc");
 Cesium.when(promise,function(fieldLayer){
       fieldLayer.particleVelocityFieldEffect.velocityScale = 100.0;
       fieldLayer.particleVelocityFieldEffect.particleSize = 2;
       fieldLayer.particleVelocityFieldEffect.paricleCountPerDegree = 1.5;
       scene.primitives.add(fieldLayer);
       fieldLayer.particleVelocityFieldEffect.colorTable = colorTable;
       var options = {
        longitude:'lon',
        latitude:'lat',
        uwnd:'uwnd',
        vwnd:'uwnd'
     }
      fieldLayer.NetCDFData = options;
	})

addLayerService(url, sceneName, layerName)

添加场景图层服务。

Name	Type	Description
`url`	String	图层服务的url路径。
`sceneName`	String	场景名称。
`layerName`	String	图层名称。

addLightSource(lightSource) → Scene

添加光源。

Name	Type	Description
`lightSource`	LightSource	光源。

Returns:

添加点光源后后的场景。

addS3MGroupLayer(url, options, index) → Promise

添加S3M分组图层。

Name	Type	Description
`url`	String	iserver中发布的配置文件地址。
`options`	Object	图层所需属性对象。
`index`	Number	索引。

Returns:

返回promise异步加载对象

addS3MTilesLayerByScp(url, options, index) → Promise

添加三维切片缓存图层（S3M、S3MB）。

Name	Type	Default	Description
`url`	String		iserver中发布的配置文件地址。
`options`	Object		图层所需属性对象。
`index`	Number		索引。
`options.name`	String		图层名称。
`options.cullEnabled`	Boolean	`true`	optional 是否双面渲染(背面剔除),默认为单面，即剔除背面。

Returns:

返回promise异步加载对象

Example:

var promise = scene.addS3MTilesLayerByScp('http://localhost:8090/iserver/services/3D-zj/rest/realspace/datas/zj/config', {name : 'base'});
promise.then(function(layer){
    layer.visible = false;
});

cartesianToCanvasCoordinates(position, result) → Cartesian2

转换三维空间坐标到canvas坐标（窗口坐标）。

Name	Type	Description
`position`	Cartesian3	三维空间坐标。
`result`	Cartesian2	optional 窗口坐标，用于保存结果。

Returns:

窗口坐标。

Example:

//随着鼠标移动输出经纬度为(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);

getCompressedTextureFormatSupported(format) → boolean

当前场景是否支持纹理压缩格式。

Name	Type	Description
`format`	String	纹理格式。格式名称或WebGL扩展名。例如：s3tc 或 WEBGL_compressed_texture_s3tc。

Returns:

该格式是否被支持。

getHeight(lon, lat) → Number

根据经纬度坐标获取对应高度。

Name	Type	Description
`lon`	Number	经度坐标。
`lat`	Number	纬度坐标。

Returns:

高度值，单位：米。

getViewport(windowPosition) → BoundingRectangle

根据窗口坐标，获取当前场景视口。

Name	Type	Description
`windowPosition`	Cartesian2	窗口坐标。

Returns:

视口。

open(url) → Promise

打开iserver场景服务下所有图层。

Name	Type	Description
`url`	String	服务url。

Returns:

返回promise异步加载对象。

Example:

var promise = scene.open('http://localhost:8090/iserver/services/3D-BIM3/rest/realspace');
promise.then(function(layers){});

outputSceneToFile() → Promise

将当前场景输出Base64编码。

Returns:

持有Base64编码的异步对象。

Example:

var promise =  scene.outputSceneToFile();
  Cesium.when(promise,function(base64data){
     $("#ID").css("background","url(" + base64data +")");
   })

pick(windowPosition, width, height) → Object

场景拾取，返回在场景中该窗口位置对应的第一个图元对象，如果该位置没有任何物体则返回undefined。

Name	Type	Default	Description
`windowPosition`	Cartesian2		窗口坐标。
`width`	Number	`3`	optional 拾取矩形宽度。
`height`	Number	`3`	optional 拾取矩形高度。

Returns:

拾取的图元对象。

Throws:

DeveloperError : windowPosition 未定义。

pickPosition(windowPosition, result) → Cartesian3

位置拾取，根据窗口坐标，从场景的深度缓冲区中拾取相应的位置，返回笛卡尔坐标,需要支持深度纹理。

Name	Type	Description
`windowPosition`	Cartesian2	窗口坐标。
`result`	Cartesian3	optional 笛卡尔坐标,保存返回结果。

Returns:

返回相应的笛卡尔坐标（三维世界坐标）。

Throws:

DeveloperError : 不支持从深度纹理中拾取，请检查 pickPositionSupported。不支持2D。正交投影矩阵不可逆。

removeLightSource(lightSource) → Scene

删除光源。

Name	Type	Description
`lightSource`	LightSource	光源。

Returns:

添加光源后后的场景。