Viewer

Members

Default Value: Ellipsoid.default

Default Value: 1.0

Default Value: true

Methods

See:

• viewerDragDropMixin

Returns:

Returns:

Returns:

Type Definitions

Properties:

Name	Type	Attributes	Default	Description
animation	boolean	<optional>	true	如果设为 false，则不会创建 Animation 控件。
baseLayerPicker	boolean	<optional>	true	如果设为 false，则不会创建 BaseLayerPicker 控件。
fullscreenButton	boolean	<optional>	true	如果设为 false，则不会创建 FullscreenButton 控件。
vrButton	boolean	<optional>	false	如果设为 true，则会创建 VRButton 控件。
geocoder	boolean | IonGeocodeProviderType | Array.<GeocoderService>	<optional>	IonGeocodeProviderType.DEFAULT	使用 Geocoder 控件搜索时要使用的地理编码服务或服务列表。如果设为 false，则不会创建 Geocoder 控件。
homeButton	boolean	<optional>	true	如果设为 false，则不会创建 HomeButton 控件。
infoBox	boolean	<optional>	true	如果设为 false，则不会创建 InfoBox 控件。
sceneModePicker	boolean	<optional>	true	如果设为 false，则不会创建 SceneModePicker 控件。
selectionIndicator	boolean	<optional>	true	如果设为 false，则不会创建 SelectionIndicator 控件。
timeline	boolean	<optional>	true	如果设为 false，则不会创建 Timeline 控件。
navigationHelpButton	boolean	<optional>	true	如果设为 false，则不会创建导航帮助按钮（navigation help button）。
navigationInstructionsInitiallyVisible	boolean	<optional>	true	如果导航说明在初始时应可见则为 true；如果直到用户显式点击按钮之前都不应显示，则为 false。
scene3DOnly	boolean	<optional>	false	当为 true 时，为了节省 GPU 内存，每个几何实例将仅在 3D 中渲染。
shouldAnimate	boolean	<optional>	false	true 表示时钟在默认情况下应尝试推进仿真时间，false 表示不推进。此选项优先于对 Viewer#clockViewModel 的设置。
clockViewModel	ClockViewModel	<optional>	new ClockViewModel(clock)	用于控制当前时间的时钟视图模型（clock view model）。
selectedImageryProviderViewModel	ProviderViewModel	<optional>		当前基础影像图层的视图模型，如果未提供则使用第一个可用的基础图层。此值仅在 `baseLayerPicker` 设为 true 时有效。
imageryProviderViewModels	Array.<ProviderViewModel>	<optional>	createDefaultImageryProviderViewModels()	可从 BaseLayerPicker 中选择的 ProviderViewModel 数组。此值仅在 `baseLayerPicker` 设为 true 时有效。
selectedTerrainProviderViewModel	ProviderViewModel	<optional>		当前基础地形图层的视图模型，如果未提供则使用第一个可用的基础图层。此值仅在 `baseLayerPicker` 设为 true 时有效。
terrainProviderViewModels	Array.<ProviderViewModel>	<optional>	createDefaultTerrainProviderViewModels()	可从 BaseLayerPicker 中选择的 ProviderViewModel 数组。此值仅在 `baseLayerPicker` 设为 true 时有效。
baseLayer	ImageryLayer | false	<optional>	ImageryLayer.fromWorldImagery()	应用于地球的最底层影像图层。如果设为 false，则不会添加影像提供者。此值仅在 `baseLayerPicker` 设为 false 时有效。当 `globe` 设为 false 时不能使用。
ellipsoid	Ellipsoid	<optional>	Ellipsoid.default	默认椭球体。
terrainProvider	TerrainProvider	<optional>	new EllipsoidTerrainProvider()	要使用的地形提供者（terrain provider）。
terrain	Terrain	<optional>		用于处理异步地形提供者的地形对象。仅当 options.terrainProvider 未定义时才能指定。
skyBox	SkyBox | false	<optional>		用于渲染星星的天空盒（skybox）。当为 undefined 且使用 WGS84 椭球体时，使用默认星空。如果设为 false，则不添加天空盒、太阳或月亮。
skyAtmosphere	SkyAtmosphere | false	<optional>		蓝天，以及地球边缘周围的光晕。在使用 WGS84 椭球体时启用。设为 false 可将其关闭。
fullscreenElement	Element | string	<optional>	document.body	按下全屏按钮时要进入全屏模式的元素或 ID。
useDefaultRenderLoop	boolean	<optional>	true	如果此控件应控制渲染循环则为 true，否则为 false。
targetFrameRate	number	<optional>		使用默认渲染循环时的目标帧率。
showRenderLoopErrors	boolean	<optional>	true	如果为 true，当渲染循环发生错误时，此控件会自动向用户显示一个包含错误信息的 HTML 面板。
useBrowserRecommendedResolution	boolean	<optional>	true	如果为 true，则以浏览器推荐的分辨率渲染，并忽略 window.devicePixelRatio。
automaticallyTrackDataSourceClocks	boolean	<optional>	true	如果为 true，此控件会自动跟踪新添加的数据源（DataSource）的时钟设置，并在数据源的时钟发生变化时更新。如果您想独立配置时钟，请将其设为 false。
contextOptions	ContextOptions	<optional>		传递给 Scene 的上下文和 WebGL 创建属性。
sceneMode	SceneMode	<optional>	SceneMode.SCENE3D	初始场景模式（scene mode）。
mapProjection	MapProjection	<optional>	new GeographicProjection(options.ellipsoid)	在 2D 和 Columbus View 模式下使用的地图投影。
globe	Globe | false	<optional>	new Globe(options.ellipsoid)	场景中要使用的地球。如果设为 false，则不会添加地球，并且天空大气默认会被隐藏。
orderIndependentTranslucency	boolean	<optional>	true	如果为 true 且配置支持，则使用顺序无关透明度（order independent translucency）。
creditContainer	Element | string	<optional>		将包含 CreditDisplay 的 DOM 元素或 ID。如果未指定，版权信息（credits）会被添加到控件本身的底部。
creditViewport	Element | string	<optional>		将包含由 CreditDisplay 创建的版权弹出框的 DOM 元素或 ID。如果未指定，它将显示在控件本身之上。
dataSources	DataSourceCollection	<optional>	new DataSourceCollection()	由该控件可视化的数据源集合。如果提供了此参数，则认为该实例归调用者所有，并且在查看器被销毁时不会被销毁。
shadows	boolean	<optional>	false	确定光源是否投射阴影。
terrainShadows	ShadowMode	<optional>	ShadowMode.RECEIVE_ONLY	确定地形是否投射或接收来自光源的阴影。
mapMode2D	MapMode2D	<optional>	MapMode2D.INFINITE_SCROLL	确定 2D 地图是否可旋转，或者是否可以在水平方向上无限滚动。
projectionPicker	boolean	<optional>	false	如果设为 true，则会创建 ProjectionPicker 控件。
blurActiveElementOnCanvasFocus	boolean	<optional>	true	如果为 true，点击查看器的 canvas 时，活动元素会失去焦点（blur）。将其设为 false 适用于以下情况：点击 canvas 仅仅是为了获取位置或实体数据，而实际上并不打算将 canvas 设为活动元素。
requestRenderMode	boolean	<optional>	false	如果为 true，仅在场景内发生变化需要时才会渲染一帧。启用此选项可降低应用程序的 CPU/GPU 使用率，并在移动设备上消耗更少的电量，但在此模式下需要使用 Scene#requestRender 显式地渲染新的一帧。在对 API 的其他部分修改场景后，很多情况下都需要这样做。参见 Improving Performance with Explicit Rendering。
maximumRenderTimeChange	number	<optional>	0.0	如果 requestRenderMode 为 true，此值定义了在请求渲染之前允许的仿真时间最大变化量。参见 Improving Performance with Explicit Rendering。
depthPlaneEllipsoidOffset	number	<optional>	0.0	调整 DepthPlane 以解决椭球体零高程以下的渲染瑕疵（artefacts）。
msaaSamples	number	<optional>	4	如果提供此值，它将控制多重采样抗锯齿（multisample antialiasing）的速率。典型的多重采样率为 2、4，有时为 8 个样本/像素。更高的 MSAA 采样率可能会影响性能，以换取更好的视觉质量。此值仅适用于支持多重采样渲染目标的 WebGL2 上下文。设为 1 可禁用 MSAA。

See:

• Viewer#extend