new Cesium.CesiumWidget(container, options)
一个包含Cesium场景（Scene）的窗口部件。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
container |
Element | String | 将容纳Widget的HTML DOM 元素或ID。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
options |
Object |
optional
对象，具有以下属性：
|
异常情况：
-
DeveloperError : 文档中不存在具有该标识的"container"元素。
示例：
// 对于每个示例，在HTML头部包含一个到CesiumWidget.css样式表的链接，在正文中包含:
// Widget没有地形和默认必应地图图像提供器（imageryProvider）。
var widget = new Cesium.CesiumWidget('cesiumContainer');
// 使用ico图像和Cesium世界地形的Widget。
var widget = new Cesium.CesiumWidget('cesiumContainer', {
imageryProvider : Cesium.createWorldImagery(),
terrainProvider : Cesium.createWorldTerrain(),
// 使用高分辨率的星空，从 https://github.com/AnalyticalGraphicsInc/cesium-assets 下载
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'
}
}),
// 用网页墨卡托（Web Mercator）投影显示哥伦布视图（Columbus View）地图
sceneMode : Cesium.SceneMode.COLUMBUS_VIEW,
mapProjection : new Cesium.WebMercatorProjection()
});演示Demo：
成员变量
获取相机（Camera）。
canvas : Canvas
获取画布（Canvas）。
获取时钟（Clock）。
container : Element
获取父容器。
creditContainer : Element
获取版权容器（CreditContainer）。
creditViewport : Element
获取版权视窗（CreditViewport）。
获取将在地球渲染的图像图层的集合。
resolutionScale : Number
获取或设置渲染分辨率的比例因子。
小于1.0的值可以在功能较弱的设备上提高性能，而大于1.0的值将以更高的分辨率渲染，然后缩小比例，从而提高视觉保真度。
例如，如果部件的大小为640x480，将该值设置为0.5将导致场景以320x240的大小呈现，然后按比例放大，
而将其设置为2.0将导致场景以1280x960的大小呈现，然后按比例缩小。
-
Default Value:
1.0
获取场景（Scene）。
screenSpaceEventHandler : ScreenSpaceEventHandler
获取屏幕空间事件处理程序（ScreenSpaceEventHandler）。
targetFrameRate : Number
获取或设置当
useDefaultRenderLoop为true时，部件的目标帧率。
如果未定义，浏览器的requestAnimationFrame实现将确定帧速率。如果定义了，这个值必须大于0。
高于底层requestAnimationFrame实现的值将不起作用。
terrainProvider : TerrainProvider
为地球提供表面几何图形的terrainProvider。
useBrowserRecommendedResolution : Boolean
指示是否使用浏览器的推荐分辨率的布尔值。
如果为true，则忽略浏览器的设备像素比，代之以1.0，有效地基于CSS像素而不是设备像素进行渲染。这可以提高具有高像素密度的低功能设备的性能。
当为false时，渲染将以设备像素为单位。无论这个布尔值是true还是false，
Viewer#resolutionScale仍然有效。
-
Default Value:
false
useDefaultRenderLoop : Boolean
获取或设置此部件是否应控制渲染循环。
如果设置为true，部件将使用
requestAnimationFrame来执行部件的渲染和调整大小，以及驱动仿真时钟。
如果设置为false，您必须手动调用resize， render方法作为自定义渲染循环的一部分。
如果在渲染过程中出现错误，Scene的renderError事件将被触发，该属性将被设置为false。
必须将其设置为true，以便在发生错误后继续渲染。
内置方法
destroy()
销毁部件。如果从布局中永久删除viewer部件，则应调用。
返回值：
如果对象已被销毁，则为true，否则为false。
渲染这个场景。除非
useDefaultRenderLoop被设置为false，否则将根据需要自动调用此函数。
更新画布大小、相机长宽比和视口大小。
除非
useDefaultRenderLoop被设置为false，否则将根据需要自动自动调用此函数。
showErrorPanel(title, message, error)
向用户显示包含标题和更长的错误消息的错误面板，可以使用OK按钮关闭该错误消息。
如果在构建部件时showrenderlooper不为false，则在出现渲染循环错误时自动显示该面板。
| Name | Type | Description |
|---|---|---|
title |
String | 错误标题。这个字符串被解释为文本。 |
message |
String | 在详细的错误信息之前显示一个有用的、面向用户的消息。这个字符串被解释为HTML。 |
error |
String |
optional
要显示在错误面板上的错误。此字符串使用formatError进行格式化，然后显示为文本。
|
