BaseLayerPicker

new Cesium.BaseLayerPicker (container, options)


BaseLayerPicker 打开下拉面板。


BaseLayerPicker 是一个单按钮小部件,可显示可用图像和地形提供者的面板。选择影像时,会创建相应的影像图层并将其插入为影像集合的基础图层;移除现有的基地。选择地形时,它会替换当前的地形提供者。可用提供程序列表中的每个项目都包含一个名称、一个代表图标和一个工具提示,以在悬停时显示更多信息。该列表最初是空的,必须在使用前进行配置,如下例所示。
Name Type Description
container Element | String 此小部件的父 HTML 容器节点或 ID。
options Object 具有以下属性的对象:
姓名 类型 默认 描述
globe 地球 要使用的地球仪。
imageryProviderViewModels 数组。< ProviderViewModel > [] 可选 用于图像的 ProviderViewModel 实例数组。
selectedImageryProviderViewModel 提供者视图模型 可选 当前基本影像层的视图模型,如果未提供,则使用第一个可用影像层。
terrainProviderViewModels 数组。< ProviderViewModel > [] 可选 要用于地形的 ProviderViewModel 实例数组。
selectedTerrainProviderViewModel 提供者视图模型 可选 当前基础地形图层的视图模型,如果未提供,则使用第一个可用的地形图层。
Throws:
Example:
// In HTML head, include a link to the BaseLayerPicker.css stylesheet,
// and in the body, include: <div id="baseLayerPickerContainer"
//   style="position:absolute;top:24px;right:24px;width:38px;height:38px;"></div>

//Create the list of available providers we would like the user to select from.
//This example uses 3, OpenStreetMap, The Black Marble, and a single, non-streaming world image.
const imageryViewModels = [];
imageryViewModels.push(new Cesium.ProviderViewModel({
     name : 'Open\u00adStreet\u00adMap',
     iconUrl : Cesium.buildModuleUrl('Widgets/Images/ImageryProviders/openStreetMap.png'),
     tooltip : 'OpenStreetMap (OSM) is a collaborative project to create a free editable \
map of the world.\nhttp://www.openstreetmap.org',
     creationFunction : function() {
         return new Cesium.OpenStreetMapImageryProvider({
             url : 'https://a.tile.openstreetmap.org/'
         });
     }
 }));

 imageryViewModels.push(new Cesium.ProviderViewModel({
     name : 'Earth at Night',
     iconUrl : Cesium.buildModuleUrl('Widgets/Images/ImageryProviders/blackMarble.png'),
     tooltip : 'The lights of cities and villages trace the outlines of civilization \
in this global view of the Earth at night as seen by NASA/NOAA\'s Suomi NPP satellite.',
     creationFunction : function() {
         return new Cesium.IonImageryProvider({ assetId: 3812 });
     }
 }));

 imageryViewModels.push(new Cesium.ProviderViewModel({
     name : 'Natural Earth\u00a0II',
     iconUrl : Cesium.buildModuleUrl('Widgets/Images/ImageryProviders/naturalEarthII.png'),
     tooltip : 'Natural Earth II, darkened for contrast.\nhttp://www.naturalearthdata.com/',
     creationFunction : function() {
         return new Cesium.TileMapServiceImageryProvider({
             url : Cesium.buildModuleUrl('Assets/Textures/NaturalEarthII')
         });
     }
 }));

//Create a CesiumWidget without imagery, if you haven't already done so.
const cesiumWidget = new Cesium.CesiumWidget('cesiumContainer', { imageryProvider: false });

//Finally, create the baseLayerPicker widget using our view models.
const layers = cesiumWidget.imageryLayers;
const baseLayerPicker = new Cesium.BaseLayerPicker('baseLayerPickerContainer', {
    globe : cesiumWidget.scene.globe,
    imageryProviderViewModels : imageryViewModels
});
See:

Members

获取父容器。
获取视图模型。

Methods

销毁小部件。如果从布局中永久删除小部件,则应调用。
Returns:
如果对象已被销毁,则为 true,否则为 false。