包含Cesium场景的小部件。
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
container
|
Element | String | 将包含窗口小部件的DOM元素或ID。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
options
|
Object |
optional
Object with the following properties:
|
Throws:
-
DeveloperError :ID为'容器'的元素在文档中不存在。
Example:
// For each example, include a link to CesiumWidget.css stylesheet in HTML head,
// and in the body, include: <div id="cesiumContainer"></div>
//Widget with no terrain and default Bing Maps imagery provider.
var widget = new Cesium.CesiumWidget('cesiumContainer');
//Widget with ion imagery and Cesium World Terrain.
var widget = new Cesium.CesiumWidget('cesiumContainer', {
imageryProvider : Cesium.createWorldImagery(),
terrainProvider : Cesium.createWorldTerrain(),
skyBox : new Cesium.SkyBox({
sources : {
positiveX : 'stars/TychoSkymapII.t3_08192x04096_80_px.jpg',
negativeX : 'stars/TychoSkymapII.t3_08192x04096_80_mx.jpg',
positiveY : 'stars/TychoSkymapII.t3_08192x04096_80_py.jpg',
negativeY : 'stars/TychoSkymapII.t3_08192x04096_80_my.jpg',
positiveZ : 'stars/TychoSkymapII.t3_08192x04096_80_pz.jpg',
negativeZ : 'stars/TychoSkymapII.t3_08192x04096_80_mz.jpg'
}
}),
// Show Columbus View map with Web Mercator projection
sceneMode : Cesium.SceneMode.COLUMBUS_VIEW,
mapProjection : new Cesium.WebMercatorProjection()
});
Demo:
Members
readonly camera : Camera
获取相机。
获取画布。
readonly clock : Clock
获取时钟。
获取父容器。
获取信用容器。
获取功劳视口
readonly imageryLayers : ImageryLayerCollection
获取将在地球上渲染的图像图层的集合。
获取或设置渲染分辨率的缩放比例。小于1.0的值可以改善性能不佳的设备上的性能,而值大于1.0则将以更高的速度呈现分辨率,然后缩小比例,从而提高视觉保真度。例如,如果窗口小部件的尺寸为640x480,则将此值设置为0.5将导致场景以320x240渲染,然后在设置时按比例放大设置为2.0将导致场景以1280x960渲染,然后按比例缩小。
-
Default Value:
1.0
readonly scene : Scene
获取场景。
readonly screenSpaceEventHandler : ScreenSpaceEventHandler
获取屏幕空间事件处理程序。
在
useDefaultRenderLoop
时获取或设置小部件的目标帧速率是真的。如果未定义,则为浏览器的
requestAnimationFrame
实现确定帧频。如果定义,则该值必须大于0。更高的值比基础的requestAnimationFrame实现无效。
terrainProvider : TerrainProvider
地形提供者为地球提供表面几何形状。
布尔标志,指示是否使用浏览器推荐的分辨率。如果为true,则会忽略浏览器的设备像素比率,而改用1.0,根据CSS像素而不是设备像素有效地渲染。这样可以改善在像素密度较高的功能较弱的设备上的性能。如果为假,则渲染将以设备像素为单位。
CesiumWidget#resolutionScale
仍然会生效该标志为真或假。
-
Default Value:
true
获取或设置此小部件是否应控制渲染循环。如果设置为true,则小部件将使用
requestAnimationFrame
执行小部件的渲染和调整大小,以及驱动模拟时钟。如果设置为false,则必须手动调用
resize
,
render
方法作为自定义的一部分渲染循环。如果在渲染过程中发生错误,则
Scene
renderError
事件将引发,并且此属性将设置为false。必须将其设置为true才能继续渲染错误之后。
Methods
销毁小部件。如果永久应调用从布局中删除小部件。
Returns:
如果对象已销毁,则为true,否则为false。
渲染场景。该功能会自动调用除非
useDefaultRenderLoop
设置为false;
更新画布大小,相机纵横比和视口大小。除非需要,否则将自动调用此函数
useDefaultRenderLoop
设置为false。
向用户显示错误面板,其中包含标题和较长的错误消息,可以使用'确定'按钮将其关闭。该面板自动显示当发生渲染循环错误时,如果showRenderLoopErrors不为false,则当小部件已构建。
Name | Type | Description |
---|---|---|
title
|
String | 在错误面板上显示的标题。该字符串被解释为文本。 |
message
|
String | 可选 在详细的错误信息之前显示的有用的,面向用户的消息。此字符串被解释为HTML。 |
error
|
String |
可选
要在错误面板上显示的错误。该字符串使用
formatError
格式化,然后显示为文本。
|