1. ModelLayer

Extends: Layer

ModelLayer,模型图层类，可实现对3DTiles和glTF模型的添加、获取、移除、缩放至和显隐等操作

1.1. 初始化 new ModelLayer(options, customGroupId)

Example

//通过图层管理类统一创建模型图层
let modelLayer = geomap.layerManager.createLayer(BOSGeo.LayerType.MODEL, "模型"); //模型图层

1.2. 属性

1.3. 方法

1.3.1. modelLayer.add(modelParam)

加载模型3DTiles/glTF/glb

Example

let modelLayer = geomap.layerManager.createLayer(BOSGeo.LayerType.MODEL, "模型"); //模型图层
//添加模型
let myModel = modelLayer.add(
    {
        name: '测试模型2',
        url: 'https://alpha-bigbos-bos3d.boswinner.com/api/d0ee39131a37426aa58a013c82fbbae4/geomodels/G1596620314217/data/tileset.json',
        position: [112.2491853712431, 24.94423899253814, 100],
        rotation: [0, 20, 0],
        scale: 2,
        featureType: BOSGeo.FeatureType.BIM,
        luminanceAtZenith: 0.5,  //模型的亮度
        attribute: {name: '测试模型2'}
    }
);
//  加载完成回调模型
myModel.readyPromise.then((model) => {
    BOSGeo.GeoUtil.selectFeature()
    geomap.disableMoveFeature();
    let axis = new BOSGeo.AxisFrame(geomap, {target: model, hasDepth: true});
    geomap.enableMoveFeature(axis);
})

1.3.2. modelLayer.getModelByName(name)

根据名称获取模型

Example

modelLayer.getModelByName('测试模型2');

1.3.3. modelLayer.zoomToLayer(callback)

缩放至本图层

Example

modelLayer.zoomToLayer();

1.3.4. modelLayer.getAllModels()

获取该图层的所有模型

Returns: Array.<(Model|Cesium3DTileset)>

1.3.5. modelLayer.setModelVisibleByName(name, visible)

设置模型显隐

Example

modelLayer.setModelVisibleByName('测试模型2', false);

1.3.6. modelLayer.getModelVisible(name)

获取模型的显隐信息

Example

let visible = modelLayer.getModelVisible('测试模型2');

1.3.7. modelLayer.getBoundingPointByName(name, [isMaximumPoint]) ⇒ Promise.<Cartesian3> | undefined

根据模型名称获取其根节点包围盒上极值点（部分白模或者倾斜由于底部不平或者根节点包围盒过大不适用于该方法），该方法只适用于3DTiles数据，不适用于gltf模型数据

Returns: Promise.<Cartesian3> | undefined -

undefined表示不存在该名称的模型图层或者图层还未开始加载

Example

const tilesetName = '测试模型2';
tileset.readyPromise.then(() => {
  const readyPromise = modelLayer.getBoundingPointByName(tilesetName);
  readyPromise && readyPromise.then((point) => {
     const relativeHeight = 0 - point.z; // 相对地面高程
     const groundAltitude = 0; // 模型中心点所在位置的地面高程
     BOSGeo.GeoUtil.setTilesetHeight(tileset, relativeHeight + groundAltitude);
  });
});

1.3.8. modelLayer.getExtremePointByName(name, [isMaximumPoint]) ⇒ Cartesian3 | undefined

获取模型在根节点模型空间下的极值点坐标（由于该方法统计的是整个tileset下的极值点，所以最好在大部分瓦片加载完后调用，否则获取的值会偏大），该方法只适用于3DTiles数据，不适用于gltf模型数据

Returns: Cartesian3 | undefined -

undefined表示不存在该名称的模型图层或者图层还未初始加载完

Example

const tilesetName = '测试模型2';
const minPoint = modelLayer.getExtremePointByName(tilesetName, false);
if (minPoint) {
  const relativeHeight = 0 - minPoint.z;
  const groundAltitude = 0; // 模型中心点所在位置的地面高程
  BOSGeo.GeoUtil.setTilesetHeight(tileset, relativeHeight + groundAltitude);
} else {
  console.log("不存在该名称的模型图层或者图层还未初始加载完!");
}

1.3.9. modelLayer.setLuminanceAtZenith([val])

设置太阳在天顶时模型的亮度，用于该模型的程序环境光

Example

let modelLayer = geomap.layerManager.createLayer(BOSGeo.LayerType.MODEL, "模型"); //模型图层
//添加模型
let myModel = modelLayer.add({
    name: '测试模型2',
    url: 'https://alpha-bigbos-bos3d.boswinner.com/api/d0ee39131a37426aa58a013c82fbbae4/geomodels/G1596620314217/data/tileset.json',
    position: [112.2491853712431, 24.94423899253814, 100],
    rotation: [0, 20, 0],
    scale: 2,
    featureType: BOSGeo.FeatureType.BIM,
    luminanceAtZenith: 0.5,  //模型的亮度
    attribute: {name: '测试模型2'}
});
myModel.luminanceAtZenith = 0.6; //设置模型光照亮度,默认为0.2
modelLayer.setLuminanceAtZenith(100);//设置该模型图层下所有模型光照亮度,默认为0.2

1.3.10. modelLayer.removeByName(name)

根据对象名称移除模型

Example

modelLayer.removeByName('测试模型2');

1.3.11. modelLayer.remove(model)

删除模型

Example

modelLayer.remove(myModel)

1.3.12. modelLayer.removeAll()

移除该图层所有模型

1.3.13. modelLayer.zoomTo(model, callback)

定位到某个模型

Example

modelLayer.zoomTo(myModel)

1.3.14. modelLayer.destroy()

销毁本图层

1.3.15. modelLayer.on(eventType, callBack)

绑定事件

Example

layer.on(BOSGeo.LayerEventType.ADD, (result) => {
    console.log(result);
});

1.3.16. modelLayer.fire(eventType, value)

触发事件

1.3.17. modelLayer.hasOn(eventType, callBack)

判断该函数是否已绑定该事件

Example

var hasBind = layer.hasOn(BOSGeo.LayerEventType.ADD, callback);

1.3.18. modelLayer.once(eventType, callBack)

绑定后该函数只执行一次

1.3.19. modelLayer.off(eventType, callBack)

取消事件绑定