1. 视图类

位于：BOS3D.Viewer

1.1. 属性

1.1.1. viewerImpl

视图类具体实现

1.2. 视图、场景相关方法

1.2.1. addView

添加视图

调用方式：

/**
 * 添加视图
 * @function addView
 * @param {string} modelKey  模型的Key或者documentKey
 * @param {string} projectKey  项目Key
 * @param {string} [token=""]  用户令牌
 * @param {string} [share=""]  分享key
 * @return {void}
 */
var viewer3D = new BOS3D.Viewer();
viewer3D.addView("M123456", "bos3d");

demo 示例

1.2.2. addViews

添加视图

调用方式：

/**
 * 添加视图组
 * @function addView
 * @param {string} groupKey  组的Key
 * @param {array} modelKeys  模型Key数组
 * @param {string} projectKey  项目Key
 * @param {string} [token=""]  用户令牌
 * @return {void}
 */
var viewer3D = new BOS3D.Viewer();
viewer3D.addViews("G123", ["M123456"], "bos3d", "asdfasdf");

1.2.3. removeView

移除视图、模型

调用方式：

/**
 * 卸载指定模型
 * @function removeView
 * @param {String} modelKey - 模型Key
 * @return {void}
 */
var viewer3D = new BOS3D.Viewer();
var result = viewer3D.removeView("M123456");

1.2.4. removeAllView

移除视图、模型

调用方式：

/**
 * 卸载所有模型
 * @function removeAllView
 * @return {void}
 */
var viewer3D = new BOS3D.Viewer();
viewer3D.removeAllView();

1.2.5. loadComponents

加载指定的构件

使用方法如下： 依赖：最新的服务端版本（提供构件和几何包的关系），研发环境已经提供。 当没有服务端支持时，也可以试验加载指定构件的功能。 1、修改 BIMWINNER.BOS3D.GlobalData.DEBUG = true; 2、在加载模型之前执行 window.geoidToFileKeyMap={}; 3、模型正常加载完成之后，保存 window.geoidToFileKeyMap 中的数据 4、修改 BIMWINNER.BOS3D.GlobalData.DEBUG = false; 5、在按需加载之前定义 window.geoidToFileKeyMap={"1":" Z3JvdXAxLE0wMC9BRC85QS93S2dIQmwxeUx4U0FDZVRGQUFzUzBoM0VDTG8wNTI0Lmd6"} （第三步中保存的数据）

加载、卸载指定构件：
               1、修改 BIMWINNER.BOS3D.GlobalData.LoadComponentOnDemand = true;
 2、执行addview 方法，这时只加载基本数据，不会显示模型和构件
 3、在模型加载完成的回调之后执行 viewer3D.loadComponents 可以加载指定构件
 4、执行 viewer3D.unloadComponents 可以卸载指定构件

说明： 1、加载、卸载方法可以重复调用 2、如果要加载的构件不存在于已经加载的模型中，那么不会有结果

调用方式：

/**
 * 加载指定的构件
 * @function loadComponents
 * @param {string|array} keys  构件key
 * @param {function} startCallback  开始时的回调
 * @param {function} progressCallback  过程中的回调
 * @param {function} finishCallback  完成之后的回调
 * @return {void}
 */
viewer3D.loadComponents(
    "M123456_456",
    function () {
        //开始加载
    },
    function () {
        //加载进度
    },
    function () {
        //加载完成
    }
);

1.2.6. unloadComponents

卸载指定的构件

调用方式：

/**
 * 卸载指定的构件
 * @function unloadComponents
 * @param {string|array} keys  构件key
 * @param {function} finishCallback  完成之后的回调
 * @return {void}
 */
viewer3D.unloadComponents("M123456_456", function () {
    //卸载完成完成
});

1.2.7. getOriginalView

获取初始视角

调用方式：

/**
 * 获取初始视角
 * @function getOriginalView
 * @return {object} {position:{},target:{},up:{}}
 */
var view = viewer3D.getOriginalView();

1.2.8. setOriginalView

设置复位的视角

调用方式：

/**
 * 设置复位的视角
 * @function setOriginalView
 * @param {object} position  相机位置
 * @param {object} target  相机焦点
 * @param {object} up  相机正方向
 * @return {void}
 */
viewer3D.setOriginalView(
    {
        x: 1,
        y: 1,
        z: 1,
    },
    {
        x: 1,
        y: 1,
        z: 1,
    },
    {
        x: 1,
        y: 1,
        z: 1,
    }
);

1.2.9. render

渲染

调用方式：

/**
 * 渲染视图
 * @function render
 */
viewer3D.render();

1.2.10. syncRender

同步的方式渲染视图（如果没有必要，请不要使用同步的方式渲染视图）

调用方式：

/**
 * 同步的方式渲染视图（如果没有必要，请不要使用同步的方式渲染视图）
 * @function syncRender
 * @return {void}
 */
viewer3D.syncRender();

1.2.11. setSceneBackGroundColor

设置场景背景色

调用方式：

/**
 * 设置场景背景色
 * @function setSceneBackGroundColor
 * @param {string}  color 要设置的颜色，范围 #000000-#FFFFFF
 * @param{number} opacity   要设置的不透明度，范围 0-1
 * @return {void}
 */
viewer3D.setSceneBackGroundColor("#00ff00");

demo 示例

1.2.12. resetSceneBackgroundColor

重置场景背景色，恢复到初始的渐变色

调用方式：

/**
 * 重置场景背景色，恢复到初始的渐变色
 * @function resetSceneBackGroundColor
 * @return {void}
 */
viewer3D.resetSceneBackGroundColor();

demo 示例

1.2.13. resize

设置场景大小，修改窗口大小，单位 px

调用方式：

/**
 * 修改窗口大小，单位 px
 * @function resize
 * @param {Number} width - 窗口宽
 * @param {Number} height - 窗口高
 */
viewer3D.resize(100, 200);

1.2.14. autoResize

自动计算并修改窗口大小。在单三维展示以外的页面中，您应该使用 resize 方法明确指定画布大小。

调用方式：

/**
 * 自动修改窗口大小，单位 px
 * @function autoResize
 * @return {void}
 */
viewer3D.autoResize();

1.2.15. resetScene

复原场景

调用方式：

/**
 * 复原场景
 * @function resetScene
 * @param {object} [state]  复原的选项(不传参时恢复所有选项)
 * @param {boolean} [state.visible]   是否复位构件的可见性
 * @param {boolean} [state.selected]   是否清空高亮列表
 * @param {boolean} [state.transparent]  是否清空半透明列表
 * @param {boolean} [state.colorfully]   是否复位构件的颜色、透明度
 * @param {boolean} [state.view]   是否复位视角到初始位置
 * @return {void}
 */
viewer3D.resetScene({ view: true });

1.2.16. getSceneState

获取场景的状态，包括：相机状态、构件状态、模型状态，选中状态

调用方式：

/**
 * 获取场景的状态，包括：相机状态、构件状态、模型状态，选中状态
 * @function getSceneState
 * @return {Object} 场景状态 {
            state: state,
            camera: camera,
            selection: selection,
            modelSelection: modelSelection
        }
 */
let state = viewer3D.getSceneState();

1.2.17. setSceneState

还原场景的状态，包括：相机状态、构件状态、模型状态，选中状态

调用方式：

/**
 * 还原场景的状态，包括：相机状态、构件状态、模型状态，选中状态
 * @function setSceneState
 * @param {Object} state 场景状态
 * @param {String} [state.state] 构件和模型的状态
 * @param {String} [state.camera] 相机的状态
 * @param {Array} [state.selection] 选中构件数组
 * @param {Array} [state.modelSelection] 选中模型数组
 * @return {void}
 */
viewer3D.setSceneState({
    state: "",
    camera: "",
    selection: [],
    modelSelection: [],
});

1.2.18. getScreenShot

获取场景截图

调用方式：

/**
 * 获取场景截图
 * @function getScreenShot
 * @param {Object} option 截图参数,若指定了参数，则只能使用回调函数才能获取到数据，无法使用返回值。
 * @param {BOS3D.Color} [option.color] 背景颜色值，默认为透明
 * @param {Number} [option.width] 场景截图的宽度，要求大于0，默认为场景显示的大小
 * @param {Number} [option.height] 场景截图的高度，要求大于0，默认为场景显示的大小
 * @param {function} [option.callback] 回调函数，参数为base64格式图片，
 * @return {String} 如果存在回调函数，则返回 null， 否则 返回 base64 图形数据
 */
viewer3D.getScreenShot({
    color: new BOS3D.Color(),
    width: 100,
    height: 100,
    callback: function (a) {},
});

1.2.19. destroy

销毁整个 Viewer 实例

调用方式：

/**
 * 销毁整个Viewer实例
 * @function destroy
 * @return {void}
 */
viewer3D.destroy();

1.2.20. getCanvasSize

获取绘制画布的大小

调用方式：

/**
 * 获取绘制画布的大小
 * @function getCanvasSize
 * @return {THREE.Vector2} 画布大小{x:100,y:200},{width:100,height:200}
 */
let size = viewer3D.getCanvasSize();

1.3. 视图控制器相关

1.3.1. enableViewController

使视图控制器可用，当初始化时没有启用，也可以通过这个接口开启

调用方式：

/**
 * 使视图控制器可用
 * @function enableViewController
 * @return {Boolean} 执行是否成功
 */
viewer3D.enableViewController();

demo 示例

1.3.2. disableViewController

使视图控制器不可用

调用方式：

/**
 * 使视图控制器不可用
 * @function disableViewController
 * @return {Boolean} 执行是否成功
 */
viewer3D.disableViewController();

1.4. 获取数据

1.4.1. getAllComponentsKey

获取所有构件的 key

调用方式：

/**
 * 获取所有构件的key
 * @function getAllComponentsKey
 * @return {Array} ["c1","c2"，"c3"]
 */
let list = viewer3D.getAllComponentsKey();

demo 示例

1.4.2. getComponentsKeyByModelKey

获取指定模型的所有构件的 key

调用方式：

/**
 * 获取指定模型的所有构件的key
 * @function getComponentsKeyByModelKey
 * @param {String} modelKey 模型key
 * @return {Array} ["c1","c2"，"c3"]
 */
let list = viewer3D.getComponentsKeyByModelKey("M123");

1.4.3. getComponentKeysByName

获取构件的 key，通过构件名称

调用方式：

/**
 * 获取构件的key，通过构件名称
 * @method getComponentKeysByName
 * @param {String} name 名称
 * @param {Object} [option] 选项
 * @param {boolean} [option.matchCase] 是否区分大小写，默认true
 * @param {boolean} [option.matchAll] 是否完全匹配，默认true，否则只要构件名称中包含name参数就认为匹配。
 * @param {string} [option.regExp] 用正则表达式匹配字符串，如果该参数不为空，则忽略matchAll选项。
 * @return {Array} ["c1","c2"，"c3"]
 */
let list = viewer3D.getComponentKeysByName("基础墙");

1.4.4. getComponentKeysByType

获取构件的 key，通过构件类型

调用方式：

/**
 * 获取构件的key，通过构件类型
 * @method getComponentKeysByType
 * @param {String} type 类型
 * @param {Object} [option] 选项
 * @param {boolean} [option.matchCase] 是否区分大小写，默认true
 * @param {boolean} [option.matchAll] 是否完全匹配，默认true，否则只要构件类型中包含type参数就认为匹配。
 * @param {string} [option.regExp] 用正则表达式匹配字符串，如果该参数不为空，则忽略matchAll选项。
 * @return {Array} ["c1","c2"，"c3"]
 */
let list = viewer3D.getComponentKeysByType("墙");

1.4.5. getComponentKeysByProperty

获取构件的 key，通过指定的构件属性

调用方式：

/**
 * 获取构件的key，通过指定的构件属性
 * @method getComponentKeysByProperty
 * @param {String} key 属性key
 * @param {String} value 属性值
 * @param {Object} [option] 选项,属性值为字符串时生效
 * @param {boolean} [option.matchCase] 是否区分大小写，默认true
 * @param {boolean} [option.matchAll] 是否完全匹配，默认true，否则只要构件属性中包含value参数就认为匹配。
 * @param {string} [option.regExp] 用正则表达式匹配字符串，如果该参数不为空，则忽略matchAll选项。
 * @return {Array} ["c1","c2"，"c3"]
 */
let list = viewer3D.getComponentKeysByProperty("name", "123");

1.4.6. getComponentsByKey

获取指定构件的信息

调用方式：

/**
 * 获取指定构件的信息
 * @function getComponentsByKey
 * @param {array/string} keys  构件key数组或构件key
 * @return {Array} [{componentKey:[{node}]},{componentKey:[{node}]}，{componentKey:[{node}]}] 数组中是构件对象，对象内部是节点数组
 */
let list = viewer3D.getComponentsByKey("M123_123");

demo 示例

1.4.7. getModelFloorMapsByKey

获取模型的小地图信息

调用方式：

/**
 * 获取模型的小地图信息
 * msg为"success"的时候，data为有效值
 * @param {string} key 模型key
 * @param {function} callback 回调函数
 * @return {object} {msg: string, data: object | undefined}
 */
let list = viewer3D.getModelFloorMapsByKey("M123", function () {});

1.4.8. sortComponentsById

通过构件 id，根据构件类型从一组构件中筛选出符合指定类型的构件 id

调用方式：

/**
 * 根据构件类型筛选出构件id，通过id
 * @function sortComponentsById
 * @param ids {array/string} 构件id数组或构件id
 * @param modelKey {string} 构件所属的模型的Key
 * @param type {string} 构件类型 ，如墙、窗等
 * @return ids{Array} id数组
 */
viewer3D.sortComponentsById(["123456", "234567"], "M123456", "门");

1.4.9. sortComponentsByKey

通过构件 key，根据构件类型从一组构件中筛选出符合指定类型的构件 key

调用方式：

/**
 * 根据构件类型筛选出构件key，通过key
 * @sortComponentsById
 * @param key {array/string} 构件key数组或构件key
 * @param type {string} 构件类型 ，如墙、窗等
 * @return keys{Array} 构件key数组
 */
viewer3D.sortComponentsByKey(["M123456_123456", "M123456_123457"], "门");

1.4.10. getComponentsAttributeById

通过构件 id 获取构件的属性

调用方式：

/**
 * 通过构件id获取构件的属性
 * @function getComponentsAttributeById
 * @param {string} id  构件id
 * @param {string}  modelKey 构件所属的模型的Key
 * @param {function} callback  回调函数
 * @return {void}
 */
viewer3D.getComponentsAttributeById("234567", "M123456", function (result) {
    console.log(result);
});

1.4.11. getComponentsAttributeByKey

通过构件 key 获取构件的属性

调用方式：

/**
 * 通过构件id获取构件的属性
 * @function getComponentsAttributeByKey
 * @param {string} key  构件key
 * @param {function} callback 回调函数
 * @return {void}
 */
viewer3D.getComponentsAttributeByKey("M123_234567", function (result) {
    console.log(result);
});

demo 示例

1.4.12. cloneComponentByKey

克隆构件，从 5.1.0 版本开始，第二个参数无效，克隆出来的构件（一个原生的 THREE.Mesh 对象）不会添加到场景中。

调用方式：

/**
 * 从5.1.0版本开始，第二个参数无效，克隆出来的构件（一个原生的THREE.Mesh对象）不会添加到场景中。
 * 根据指定的构件key，克隆构件（只针对BOS3D解析生成的场景内部构件使用）
 * 克隆出来的构件会自带两个额外属性
 * xxx.byClone {boolean} 标识构件此对象时被克隆出来的
 * xxx.originMId {string} 标识构件的原始材质Id
 * xxx.originComponentKey 标识构件原始构件key
 * @function cloneComponentByKey
 * @param {string} key -构件key
 * @param {"translate"|"scale"|"rotate"} [controllerName] -（从5.1.0版本开始该参数无效）控制器名称
 *  1:克隆完成后，克隆构件会显示在原始构件位置，不易区分克隆是否完成，此时可以通过添加控制器表现克隆以完成
 *  2:在业务上，克隆构件绘制的位置也并非是用户期望的位置，此时也可以通过此参数生成的变换控制器拖动旋转缩放构件至用户期望位置
 * @returns {object} -返回被克隆的构件及构件key，用户可以自行修改mesh及通过key调用BOS3D方法.（从5.5.0版本开始只返回构件mesh对象）
 如: THREE.Mesh|MeshEx
 */
viewer3D.cloneComponentByKey("M123_234567", "translate");

1.4.13. setCloneComponentMaterialsByKey

设置克隆构件材质

调用方式：

/**
 * 修改cloneComponentByKey方法生成克隆构件的材质
 * @function setCloneComponentMaterialsByKey
 * @param {string} CloneComponentByKey -克隆出来构件的构件key
 * @param {THREE.Material[]|THREE.Material} materials -材质数组
 * @param {number[]|number} [orders] -材质顺序,orders表明材质参数与mesh材质对象的对应关系，
 *  例如:1：当表示材质参数第一个材质对象对应mesh中第二个材质对象的时候，就可以设置orders=[1],对应下标以0开始
 *      2：当orders不存在时,会根据材质参数的长度依次替换mesh材质对象的参数，
 *      3：当mesh材质对象长度为2的时候，如果orders序号大于0时，方法将跳出，不在继续向下执行
 */
viewer3D.setCloneComponentMaterialsByKey("M123_234567", materials.orders);

1.4.14. pickByPoint

根据屏幕坐标点，模拟点击操作得到选中构件

调用方式：

/**
 * 根据屏幕坐标点，模拟点击操作得到选中构件，返回选中信息,包括：
 *  componentKey ：选中构件的Key
 *  worldPosition : 选中构件被选中的点的世界坐标
 *  worldBoundingBox : 选中构件的包围盒
 *  faceIndex : 选中构件被选中的面
 * @method pickByPoint
 * @param {Object} point - 坐标点({x:0, y: 0})
 * @return {Object} - 选中构件信息,如果没有构件选中，返回null
 */
viewer3D.pickByPoint({
    x: 0,
    y: 0,
});

1.4.15. calculateMinDistance

计算两个构件之间的最小距离

调用方式：

/**
 * 计算两个构件之间的最小距离，返回的信息包括：
 *  start ：起点坐标
 *  end : 终点坐标
 *  minDistance : 最小距离
 * @method calculateMinDistance
 * @param {string} componentKey 构件key
 * @param {string} componentKey2 第二个构件key
 * @return {Object} - 最小距离信息
 */
viewer3D.calculateMinDistance({
    x: 0,
    y: 0,
});

1.5. 坐标转换

1.5.1. getScreenCoordFromSceneCoord

获取场景坐标（三维）对应的屏幕坐标（二维）

调用方式：

/**
 * 获取场景坐标（三维）对应的屏幕坐标（二维）
 * @function getScreenCoordFromSceneCoord
 * @param {array/THREE.Vector3} coord  三维空间向量
 * @return {Array} 屏幕坐标，第三个数值表示是否在相机后边，1表示是，0表示否
 */
viewer3D.getScreenCoordFromSceneCoord([1, 2, 3]);

1.5.2. getWorldPositionFromLocalPositionByModelKey

从模型的局部坐标空间点获取世界空间坐标点

调用方式：

/**
 * 从模型的局部坐标空间点获取世界空间坐标点
 * @function getWorldPositionFromLocalPositionByModelKey
 * @param {array/THREE.Vector3} point  模型局部坐标点
 * @param {string} modelKey  模型key
 * @return {Array} 世界坐标数组
 */
viewer3D.getWorldPositionFromLocalPositionByModelKey([1, 2, 3], "M123");

1.5.3. getLocalPositionFromWorldPositionByModelKey

从世界坐标空间点获取模型局部空间坐标点

调用方式：

/**
 * 从世界坐标空间点获取模型局部空间坐标点
 * @function getLocalPositionFromWorldPositionByModelKey
 * @param {array/THREE.Vector3} point  世界坐标点
 * @param {string} modelKey  模型key
 * @return {Array} 模型局部坐标点数组
 */
viewer3D.getLocalPositionFromWorldPositionByModelKey([1, 2, 3], "M123");

1.5.4. getWorldPositionListFromLocalPositionListByModelKey

从模型的局部坐标空间点获取世界空间坐标点

调用方式：

/**
 * 从模型的局部坐标空间点获取世界空间坐标点
 * @function getWorldPositionListFromLocalPositionListByModelKey
 * @param {array} list  模型局部坐标点数组[THREE.Vector3,[x,y,z]]
 * @param {string} modelKey  模型key
 * @return {Array} 世界坐标点数组 [[x,y,z],[x,y,z]]
 */
viewer3D.getWorldPositionListFromLocalPositionListByModelKey([new THREE.Vector3(), [1, 2, 3]], "M123");

1.5.5. getLocalPositionListFromWorldPositionListByModelKey

从世界坐标空间点获取模型局部空间坐标点

调用方式：

/**
 * 从世界坐标空间点获取模型局部空间坐标点
 * @function getLocalPositionListFromWorldPositionListByModelKey
 * @param {array} list  世界坐标点 [THREE.Vector3,[x,y,z]]
 * @param {string} modelKey  模型key
 * @return {Array} 模型局部坐标点数组 [[x,y,z],[x,y,z]]
 */
viewer3D.getLocalPositionListFromWorldPositionListByModelKey([new THREE.Vector3(), [1, 2, 3]], "M123");

1.5.6. getWorldPositionArrayFromLocalPositionArrayByModelKey

从模型的局部坐标空间点获取世界空间坐标点

调用方式：

/**
 * 从模型的局部坐标空间点获取世界空间坐标点
 * @function getWorldPositionArrayFromLocalPositionArrayByModelKey
 * @param {array} array  模型局部坐标点数组 [x,y,z,x,y,z,x,y,z]
 * @param {string} modelKey  模型key
 * @return {Array} 世界坐标点数组 [x,y,z,x,y,z,x,y,z]
 */
viewer3D.getWorldPositionArrayFromLocalPositionArrayByModelKey([1, 2, 3, 4, 5, 6], "M123");

1.5.7. getLocalPositionArrayFromWorldPositionArrayByModelKey

从世界坐标空间点获取模型局部空间坐标点

调用方式：

/**
 * 从世界坐标空间点获取模型局部空间坐标点
 * @function getLocalPositionArrayFromWorldPositionArrayByModelKey
 * @param {array} array  世界坐标点 [x,y,z,x,y,z,x,y,z]
 * @param {string} modelKey  模型key
 * @return {Array} 模型局部坐标点数组 [x,y,z,x,y,z,x,y,z]
 */
viewer3D.getLocalPositionArrayFromWorldPositionArrayByModelKey([1, 2, 3, 4, 5, 6], "M123");

1.6. 构件操作相关方法

1.6.1. showComponentsByKey

通过 key 将构件设置为可见

调用方式：

/**
 * 将指定的构件设置为可见，通过key
 * @showComponentsByKey
 * @param {array/string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.showComponentsByKey("M123456_123456");

1.6.2. hideComponentsByKey

通过 key 将构件设置为不可见

调用方式：

/**
 * 将指定的构件设置为不可见，通过key
 * @hideComponentsByKey
 * @param {array/string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.hideComponentsByKey("M123456_123456");

1.6.3. activateComponentsByKey

将指定的构件设置为有效状态,比如默认被失效的“房间”类型的构件。有效状态的构件才可以进行显示隐藏高亮上色等操作

调用方式：

/**
 * 将指定的构件设置为有效状态，通过key
 * @activateComponentsByKey
 * @param {array|string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.activateComponentsByKey("M123456_123456");

1.6.4. deactivateComponentsByKey

将指定的构件设置为无效状态，（只能通过对应接口复原） 通过 key。 BOS3D.DefaultInvisibleComponentType 中的类型会默认失效

调用方式：

/**
 * 将指定的构件设置为无效状态，（只能通过对应接口复原） 通过key
 * @deactivateComponentsByKey
 * @param {array|string} key  构件key数组或构件key
 * @return {void}
 */

viewer3D.deactivateComponentsByKey("M123456_123456");

1.6.5. getInvisibleComponentList

获取隐藏的构件 key，（不包括失活状态的构件）

调用方式：

/**
 * 获取隐藏的构件key（不包括失活状态的构件）
 * @function getInvisibleComponentList
 * @return {array} 构件key数组
 */
viewer3D.getInvisibleComponentList();

1.6.6. getInactivatedComponentList

获取处于失活状态的构件

调用方式：

/**
 * 获取处于失活状态的构件
 * @function getInactivatedComponentList
 * @return {array} 构件key数组
 */
viewer3D.getInactivatedComponentList();

1.6.7. hideAllComponents

隐藏所有构件

调用方式：

/**
 * 隐藏所有构件
 * @hideAllComponents
 * @return {void}
 */
viewer3D.hideAllComponents();

demo 示例

1.6.8. showAllComponents

显示所有构件

调用方式：

/**
 * 显示所有构件
 * @showAllComponents
 * @return {void}
 */
viewer3D.showAllComponents();

demo 示例

1.6.9. highlightComponentsByKey

通过 key 将构件设置为高亮

调用方式：

/**
 * 将指定的构件设置为高亮，通过key
 * @highlightComponentsByKey
 * @param {array/string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.highlightComponentsByKey("M123456_123456");

demo 示例

1.6.10. addHighlightComponentsByKey

通过 key 将构件添加到高亮列表

调用方式：

/**
 * 将指定的构件添加为高亮，通过key
 * @addHighlightComponentsByKey
 * @param {array/string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.addHighlightComponentsByKey("M123456_123456");

1.6.11. closeHighlightComponentsByKey

通过 key 将构件设置为不高亮

调用方式：

/**
 * 将指定的构件设置为不高亮，通过key
 * @closeHighlightComponentsByKey
 * @param {array/string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.closeHighlightComponentsByKey("M123456_123456");

demo 示例

1.6.12. getHighlightComponentsKey

获取高亮的构件的 key

调用方式：

/**
 * 获取高亮的构件的key
 * @function getHighlightComponentsKey
 * @return {Array} 构件的key数组
 */
viewer3D.getHighlightComponentsKey();

1.6.13. clearHighlightList

清空高亮列表

调用方式：

/**
 * 清空高亮列表
 * @function clearHighlightList
 * @return {void}
 */
viewer3D.clearHighlightList();

1.6.14. setComponentsOpacityState

设置构件显示状态(透明、不透明)

调用方式：

/**
 * 设置构件显示状态(透明、不透明)
 * @setComponentsOpacityState
 * @param {array} keys 构件 Id 集合
 * @param {BOS3D.EnumTransparentState} state 构件显示状态
 * @return {void}
 */
viewer3D.setComponentsOpacityState([111], BOS3D.EnumTransparentState.TRANSLUCENT);

1.6.15. transparentComponentsByKey

通过 key 将构件设置为透明

调用方式：

/**
 * 将指定的构件设置为透明，通过key
 * @transparentComponentsByKey
 * @param {array/string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.transparentComponentsByKey("M123456_123456");

demo 示例

1.6.16. transparentOtherComponentsByKey

将指定构件之外的其他构件设置为透明，通过 key

调用方式：

/**
 * 将指定构件之外的其他构件设置为透明，通过key
 * @transparentOtherComponentsByKey
 * @param {array/string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.transparentOtherComponentsByKey("M123456_123456");

1.6.17. transparentAllComponents

透明所有构件

调用方式：

/**
 * 透明所有构件
 * @function transparentAllComponents
 * @return {void}
 */
viewer3D.transparentAllComponents();

1.6.18. getTransparentComponentList

获取半透明(冻结)的构件

调用方式：

/**
 * 获取半透明(冻结)的构件
 * @function getTransparentComponentList
 * @return {array} 构件key数组
 */
viewer3D.getTransparentComponentList();

1.6.19. closeTransparentComponentsByKey

通过 key 将指定的构件的透明度设置为原始状态

调用方式：

/**
 * 将指定的构件的透明度设置为原始状态，通过key
 * @function  closeTransparentComponentsByKey
 * @param {array/string} key  构件key数组或构件key
 * @return {void}
 */
viewer3D.closeTransparentComponentsByKey("M123456_123456");

demo 示例

1.6.20. clearTransparentList

清理透明模型和构件列表

调用方式：

/**
 * 清理透明模型和构件列表
 * @function clearTransparentList
 * @return {void}
 */
viewer3D.clearTransparentList();

1.6.21. clearComponentTransparentList

清理透明构件列表

调用方式：

/**
 * 清理透明构件列表
 * @function clearComponentTransparentList
 * @return {void}
 */
viewer3D.clearComponentTransparentList();

1.6.22. colorfulComponentsByKey

通过 key 为构件设置颜色

调用方式：

/**
 * 将指定的构件设置为变色，通过key
 * @colorfulComponentsByKey
 * @param {array/string} key 构件key数组或构件key
 * @param {number}  color  要设置的颜色，范围 0x000000-0xFFFFFF  16进制
 * @param {number} opacity  要设置的不透明度(默认为1)，范围 0-1  10进制
 * @return {void}
 */
viewer3D.colorfulComponentsByKey("M123456_123456", 0x00ff00, 1);

1.6.23. closeColorfulComponentsByKey

通过 key 将指定的构件的颜色设置为原始状态

调用方式：

/**
 * 将指定的构件取消变色，通过Key
 * @closeColorfulComponentsByKey
 * @param {array/string} key 构件id数组或构件id
 * @return {void}
 */
viewer3D.closeColorfulComponentsByKey("M123456_123456");

demo 示例

1.6.24. clearColorfulList

取消所有构件的变色

调用方式：

/**
 * 取消所有构件的变色
 * @clearColorfulList
 * @return {void}
 */
viewer3D.clearColorfulList();

1.6.25. wireFrameComponentsByKey

通过 key 为构件设置为线框模式

调用方式：

/**
 * 将指定的构件设置为线框，通过key
 * @wireFrameComponentsByKey
 * @param {array/string} keys  构件key数组或构件key
 * @return {void}
 */
viewer3D.wireFrameComponentsByKey("M123456_123456");

demo 示例

1.6.26. closeWireFrameComponentsByKey

通过 key 将指定的构件的线框模式设置为原始状态

调用方式：

/**
 * 将指定的构件取消线框，通过key
 * @function closeColorfulComponentsByKey
 * @param {array/string} keys  构件key数组或构件key
 * @return {void}
 */
viewer3D.closeWireFrameComponentsByKey("M123456_123456");

demo 示例

1.6.27. isolateComponentsByKey

通过构件 key 将指定的构件隔离，即仅显示隔离的构件

调用方式：

/**
 * 将指定的构件隔离，通过key
 * @isolateComponentsByKey
 * @param {array/string} key 构件key数组或构件key
 * @param {boolean} state  构件状态，true为隐藏，false为略微可见，默认true
 * @return {void}
 */
viewer3D.isolateComponentsByKey("M123456_123456", true);

demo 示例

1.6.28. closeIsolateComponentsByKey

将指定的构件从隔离列表中移除，如果移除之后列表为空，那么显示所有构件

调用方式：

/**
 * 将指定的构件从隔离列表中移除，通过key
 * @closeIsolateComponentsByKey
 * @param {array/string}  key 构件key数组或构件key
 * @return {void}
 */
viewer3D.closeIsolateComponentsByKey("M123456_123456");

demo 示例

1.6.29. clearIsolation

取消所有构件的隔离

调用方式：

/**
 * 取消所有构件隔离
 * @clearIsolation
 * @return {void}
 */
viewer3D.clearIsolation();

1.6.30. disableComponentsSelectionByKey

将指定的构件设置为不可选中

调用方式：

/**
 * 将指定的构件设置为不可选中
 * @function disableComponentsSelectionByKey
 * @param {array/string}  key 构件key数组或构件key
 * @return {void}
 */
viewer3D.disableComponentsSelectionByKey("M123456_123456");

demo 示例

1.6.31. enableComponentsSelectionByKey

将指定的构件设置为可选中

调用方式：

/**
 * 将指定的构件设置为可选中
 * @function enableComponentsSelectionByKey
 * @param {array/string}  key 构件key数组或构件key
 * @return {void}
 */
viewer3D.enableComponentsSelectionByKey("M123456_123456");

demo 示例

1.6.32. clearDisableSelectionList

清理不可选中的构件列表

调用方式：

/**
 * 清理不可选中的构件列表
 * @function clearDisableSelectionList
 * @return {void}
 */
viewer3D.clearDisableSelectionList();

1.6.33. setBlinkByComponentKeys

设置构件闪烁

调用方式：

viewer3D.setBlinkByComponentKeys(["M1234_234936"], new BOS3D.Color(1, 0, 0, 1), 1000);

1.6.34. closeBlinkByComponentKeys

关闭构件闪烁

调用方式：

/**
 * 关闭构件闪烁
 * @function closeBlinkByComponentKeys
 * @return {void}
 */
viewer3D.closeBlinkByComponentKeys(["M1234_234936"]);

1.6.35. clearBlinkList

清除所有构件闪烁

调用方式：

/**
 * 清除所有构件闪烁
 * @function clearBlinkList
 * @return {void}
 */
viewer3D.clearBlinkList();

1.7. 吸附功能相关方法

1.7.1. initAdsorbControl

初始化吸附控件，该方法只需要初始化一次

调用方式：

//初始化吸附控件(只需要初始化一次)
viewer3D.initAdsorbControl();

1.7.2. enableAdsorbControl

开启吸附功能

调用方式

/**
 * 是否开启吸附功能
 * @param {Boolean} value
 * @returns void
 */
viewer3D.enableAdsorbControl(true);

1.8. 构件变换相关方法

1.8.1. translateComponentByKey

对构件进行平移操作

调用方式：

/**
 * 对构件进行平移操作
 * @function translateComponentByKey
 * @param {String} key 构件key
 * @param { function } updateCallback 每次拖拽都调用的回调
 * @param { function } pauseCallback 连续拖拽之后松手之后的回调
 * @param { Object}  [options = {}] 一个有以下参数的对象
 * @param { Boolean } [options.isAdsorb = false] 是否开启吸附功能，默认为false
 * @return {void}
 */
viewer3D.translateComponentByKey(
    key,
    function () {},
    function () {},
    { isAdsorb: false }
);

1.8.2. scaleComponentByKey

对构件进行缩放操作

调用方式：

/**
 * 对构件进行缩放操作
 * @function scaleComponentByKey
 * @param {String} key 构件key
 * @param { function } updateCallback 每次拖拽都调用的回调
 * @param { function } pauseCallback 连续拖拽之后松手之后的回调
 * @param { Object}  [options = {}] 一个有以下参数的对象
 * @param { Boolean } [options.isAdsorb = false] 是否开启吸附功能，默认为false
 * @return {void}
 */
viewer3D.scaleComponentByKey(
    key,
    function () {},
    function () {},
    { isAdsorb: false }
);

1.8.3. isometricScaleComponentByKey

对构件进行等比缩放操作

调用方式：

/**
 * 对构件进行缩放操作
 * @function isometricScaleComponentByKey
 * @param {String} key 构件key
 * @param { function } updateCallback 每次拖拽都调用的回调
 * @param { function } pauseCallback 连续拖拽之后松手之后的回调
 * @param { Object}  [options = {}] 一个有以下参数的对象
 * @param { Boolean } [options.isAdsorb = false] 是否开启吸附功能，默认为false
 * @return {void}
 */
viewer3D.isometricScaleComponentByKey(
    key,
    function () {},
    function () {},
    { isAdsorb: false }
);

1.8.4. axialScaleComponentByKey

对构件进行等比缩放操作

调用方式：

/**
 * 对构件进行缩放操作
 * @function axialScaleComponentByKey
 * @param {String} key 构件key
 * @param { function } updateCallback 每次拖拽都调用的回调
 * @param { function } pauseCallback 连续拖拽之后松手之后的回调
 * @param { Object}  [options = {}] 一个有以下参数的对象
 * @param { Boolean } [options.isAdsorb = false] 是否开启吸附功能，默认为false
 * @return {void}
 */
viewer3D.axialScaleComponentByKey(
    key,
    function () {},
    function () {},
    { isAdsorb: false }
);

1.8.5. rotateComponentByKey

对构件进行旋转操作

调用方式：

/**
 * 对构件进行旋转操作
 * @function rotateComponentByKey
 * @param {String} key 构件key
 * @param { function } updateCallback 每次拖拽都调用的回调
 * @param { function } pauseCallback 连续拖拽之后松手之后的回调
 * @param { Object}  [options = {}] 一个有以下参数的对象
 * @param { Boolean } [options.isAdsorb = false] 是否将该对象设置为被吸附对象
 * @param { Boolean } [options.rotateSpace = TransformSpace.WORLD] 当前构件的旋转方式，默认是在世界坐标系下旋转
 * @return {void}
 */
viewer3D.rotateComponentByKey(
    key,
    function () {},
    function () {},
    {
        isAdsorb: false,
        rotateSpace: BOS3D.TransformSpace.LOCAL,
    }
);

demo 示例

1.8.6. cancelTransformComponent

取消变换构件

调用方式：

/**
 * 取消变换
 * @param needRestore 是否需要重置为变换以前的状态，不传或者传false表示不重置
 */
viewer3D.cancelTransformComponent(true);

1.8.7. restoreComponentTransform

只是重置构件的变换，恢复到初始状态，不会取消变换

调用方式：

/**
 * 只是重置构件的变换，恢复到初始状态，不会取消变换
 */
viewer3D.restoreComponentTransform();

1.8.8. getComponentLocalMatrixByKey

获取构件的本地矩阵，相对于世界矩阵（worldMatrix）而言

调用方式：

/**
 * 获取构件的本地矩阵，相对于世界矩阵（worldMatrix）而言
 * @param key 构件的key
 */
var matrix = viewer3D.getComponentLocalMatrixByKey(key);

1.8.9. getComponentWorldMatrixByKey

获取构件的世界矩阵，相对于本地矩阵（matrix）而言

调用方式：

/**
 * 获取构件的世界矩阵，相对于本地矩阵（matrix）而言
 * @param key 构件的key
 */
var matrix = viewer3D.getComponentWorldMatrixByKey(key);

1.8.10. setComponentLocalMatrixByKey

设置构件的本地矩阵，相对于世界矩阵（matrixWorld）而言

调用方式：

/**
 * 设置构件的本地矩阵，相对于世界矩阵（matrixWorld）而言
 * @param key 构件的key
 * @param matrixArray 矩阵
 */
var matrix = viewer3D.setComponentLocalMatrixByKey(key, matrixArray);

1.8.11. resetComponentMatrix

重置构件的矩阵到模型加载的初始状态

调用方式：

/**
 * 重置构件的矩阵到模型加载的初始状态
 * @function resetComponentMatrix
 * @param {String} key 构件key
 * @param {Boolean} needUpdateSceneBBox 是否需要更新场景包围盒
 */
var matrix = viewer3D.resetComponentMatrix("M123456_123456", true);

1.8.12. increaseComponentTransformControlSize

增大构件变换控制器的大小（坐标轴的长短、旋转轴的大小等等），有最大值

调用方式：

/**
 * 增大构件变换控制器的大小（坐标轴的长短、旋转轴的大小等等）
 */
viewer3D.increaseComponentTransformControlSize();

1.8.13. decreaseComponentTransformControlSize

减小构件变换控制器的大小（坐标轴的长短、旋转轴的大小等等），有最小值

调用方式：

/**
 * 减小构件变换控制器的大小（坐标轴的长短、旋转轴的大小等等）
 */
viewer3D.decreaseComponentTransformControlSize();

1.8.14. setComponentTransformControlSize

设置构件变换控制器的大小（坐标轴的长短、旋转轴的大小等等）

调用方式：

/**
 * 设置构件变换控制器的大小（坐标轴的长短、旋转轴的大小等等）
 * @function setComponentTransformControlSize
 * @param {number} size 控制器的大小，默认为1.
 * @return {void}
 */
viewer3D.setComponentTransformControlSize(2);

1.8.15. getComponentTransformControlSize

获取构件变换控制器的大小（坐标轴的长短、旋转轴的大小等等）

调用方式：

/**
 * 获取构件变换控制器的大小（坐标轴的长短、旋转轴的大小等等）
 * @function getComponentTransformControlSize
 * @return {number} 变换控制器的大小
 */
viewer3D.getComponentTransformControlSize();

1.8.16. setComponentTransformSpaceToLocalSpace

设置变换空间为局部的，构件的局部坐标轴会随构件一起变换

调用方式：

/**
 * 设置变换空间为局部的，构件的局部坐标轴会随构件一起变换
 */
viewer3D.setComponentTransformSpaceToLocalSpace();

1.8.17. setComponentTransformSpaceToWorldSpace

设置变换空间为世界的，构件的坐标轴不会随构件一起变换

调用方式：

/**
 * 设置变换空间为世界的，构件的坐标轴不会随构件一起变换
 */
viewer3D.setComponentTransformSpaceToWorldSpace();

1.8.18. switchComponentTransformSpaceBetweenLocalAndWorld

设置构件变换空间，在局部和世界空间来回切换

调用方式：

/**
 * 设置构件变换空间，在局部和世界空间来回切换
 */
viewer3D.switchComponentTransformSpaceBetweenLocalAndWorld();

1.8.19. showComponentTransformOnAxis

显示 axis 轴的变换

调用方式：

/**
 * 显示axis轴的变换
 */
viewer3D.showComponentTransformOnAxis("x");

1.8.20. hideComponentTransformOnAxis

隐藏 axis 轴的变换

调用方式：

/**
 * 隐藏axis轴的变换
 */
viewer3D.hideComponentTransformOnAxis("x");

1.8.21. disableComponentTransform

禁用构件变换，但是变换控制器仍然还在显示

调用方式：

/**
 * 禁用构件变换，但是变换控制器仍然还在显示
 */
viewer3D.disableComponentTransform();

1.8.22. enableComponentTransform

重新启用构件变换

调用方式：

/**
 * 重新启用构件变换
 */
viewer3D.enableComponentTransform();

1.8.23. getMatrix4FromEuler

从欧拉角获取矩阵

调用方式：

/**
 * 从欧拉角获取矩阵
 * @function getMatrix4FromEuler
 * @param {object/array}  euler 在xyz轴上的旋转角度（弧度制）例如：{x:1,y:1,z:1}或者[1,1,1]
 * @param {object/array}  position 旋转中心  例如：{x:1,y:1,z:1}或者[1,1,1]
 * @param {BOS3D.RotationOrders} order 旋转的执行顺序 可选值 ['XYZ', 'YZX', 'ZXY', 'XZY', 'YXZ', 'ZYX']
 * @return {void}
 */
let m4 = viewer3D.getMatrix4FromEuler(
    {
        x: 1,
        y: 1,
        z: 1,
    },
    [1, 1, 1],
    "XYZ"
);

1.8.24. componentApplyMatrix

对构件应用矩阵

调用方式：

/**
 * 对构件应用矩阵
 * @function componentApplyMatrix
 * @param {string}  key 要应用矩阵的构件的key
 * @param {THREE.Matrix4}  matrix4 矩阵
 * @return {void}
 */
let m4 = new THREE.Matrix4();
viewer3D.componentApplyMatrix("M123456_123456", m4);

1.8.25. setComponentMatrix

设置构件的矩阵

调用方式：

/**
 * 设置构件的矩阵
 * @function setComponentMatrix
 * @param {string}  key 设置矩阵的构件的key
 * @param {THREE.Matrix4}  matrix4 矩阵
 * @return {Boolean} 执行是否成功
 */
let m4 = new THREE.Matrix4();
viewer3D.setComponentMatrix("M123456_123456", m4);

1.8.26. setComponentPositionByKey

通过构件 key 设置构件的位置

调用方式：

/**
 * 通过构件key设置构件的位置
 * @function setComponentPositionByKey
 * @param key {string} 构件key
 * @param position {array} 构件新的空间位置
 */
viewer3D.setComponentPositionByKey("M123456_123456", [100, 200, 300]);

demo 示例

1.8.27. componentsRotate

构件旋转 支持多个构件一起旋转 支持内部构件和外部构件

调用方式：

/**
 * 构件旋转
 * @function componentsRotate
 * @param {Array<string> | string} componentKeys
 * @param {Matrix4} rotateMatrix
 * @return {void}
 */
viewer3D.componentsRotate(["M123456"], matrix);

1.8.28. rotateMatrixFromAxes

根据旋转轴获取旋转矩阵 支持内部构件和外部构件

调用方式：

/**
 * 根据旋转轴获取旋转矩阵
 * @function rotateMatrixFromAxes
 * @param {Vector3} startVector
 * @param {Vector3} endVector
 * @param {number} rad
 * @param {boolean} clockwise
 * @return {Matrix4}
 */
let matrix = viewer3D.rotateMatrixFromAxes(new THREE.Vector3(0, 0, 1), new THREE.Vector3(0, 0, 2), 1, true);

1.8.29. componentCenterFromKey

获取一个构件的中心点 支持内部构件和外部构件

调用方式：

/**
 * 根据构件key获取构件的中心点
 * @function componentCenterFromKey
 * @param {string} key
 * @return {Vector3}
 */
let center = viewer3D.componentCenterFromKey("M123456");

1.9. 模型级别相关操作方法

1.9.1. showModelsByKey

通过 key 将模型设置为可见

调用方式：

/**
 * 将指定的模型设置为可见，通过key
 * @showModelsByKey
 * @param {array/string} key  模型key数组或模型key
 * @return {void}
 */
viewer3D.showModelsByKey("M123456");

1.9.2. hideModelsByKey

通过 key 将模型设置为不可见

调用方式：

/**
 * 将指定的模型设置为不可见，通过key
 * @hideModelsByKey
 * @param {array/string} key  模型key数组或模型key
 * @return {void}
 */
viewer3D.hideModelsByKey("M123456");

1.9.3. hideAllModels

隐藏所有模型

调用方式：

/**
 * 隐藏所有模型
 * @hideAllModels
 * @return {void}
 */
viewer3D.hideAllModels();

1.9.4. showAllModels

显示所有模型

调用方式：

/**
 * 显示所有模型
 * @showAllModels
 * @return {void}
 */
viewer3D.showAllModels();

1.9.5. highlightModelsByKey

通过 key 将模型设置为高亮

调用方式：

/**
 * 将指定的模型设置为高亮，通过key
 * @highlightModelsByKey
 * @param {array/string} key  模型key数组或模型key
 * @return {void}
 */
viewer3D.highlightModelsByKey("M123456_123456");

1.9.6. addHighlightModelsByKey

通过 key 将模型添加到高亮列表

调用方式：

/**
 * 将指定的模型添加为高亮，通过key
 * @addHighlightModelsByKey
 * @param {array/string} key  模型key数组或模型key
 * @return {void}
 */
viewer3D.addHighlightModelsByKey("M123456_123456");

1.9.7. closeHighlightModelsByKey

通过 key 将模型设置为不高亮

调用方式：

/**
 * 将指定的模型设置为不高亮，通过key
 * @closeHighlightModelsByKey
 * @param {array/string} key  模型key数组或模型key
 * @return {void}
 */
viewer3D.closeHighlightModelsByKey("M123456_123456");

1.9.8. getHighlightModelsKey

获取高亮的模型的 key

调用方式：

/**
 * 获取高亮的模型的key
 * @function getHighlightModelsKey
 * @return {Array} 构件的id数组
 */
viewer3D.getHighlightModelsKey();

1.9.9. clearModelHighlightList

清空模型高亮列表

调用方式：

/**
 * 清空模型高亮列表
 * @function clearModelHighlightList
 * @return {void}
 */
viewer3D.clearModelHighlightList();

1.9.10. transparentModelsByKey

通过 key 将模型设置为透明

调用方式：

/**
 * 将指定的模型设置为透明，通过key
 * @transparentModelsByKey
 * @param {array/string} key  模型key数组或模型key
 * @param {boolean} [originColor]  是否基于原始材质透明,true为开启,false或者无参数则表示基于bos3d内部单色材质透明
 * @param {float} [opacity]  基于原始材质透明时，模型的透明度值0-1
 * @return {void}
 */
viewer3D.transparentModelsByKey("M123456", true, 0.3);

1.9.11. transparentOtherModelsByKey

将指定模型之外的其他模型设置为透明，通过 key

调用方式：

/**
 * 将指定模型之外的其他模型设置为透明，通过key
 * @transparentOtherModelsByKey
 * @param {array/string} key  模型key数组或模型key
 * @param {boolean} [originColor]   是否基于原始材质透明,true为开启,false或者无参数则表示基于bos3d内部单色材质透明
 * @param {float} [opacity]  基于原始材质透明时，模型的透明度值0-1
 * @return {void}
 */
viewer3D.transparentOtherModelsByKey("M123456_123456");

1.9.12. transparentAllModels

透明所有模型

调用方式：

/**
 * 透明所有模型
 * @function transparentAllModels
 * @param {boolean} [originColor]   是否基于原始材质透明,true为开启,false或者无参数则表示基于bos3d内部单色材质透明
 * @param {float} [opacity]  基于原始材质透明时，模型的透明度值0-1
 * @return {void}
 */
viewer3D.transparentAllModels();

1.9.13. closeTransparentModelsByKey

将指定的模型的透明度设置为原始状态，通过 key

调用方式：

/**
 * 将指定的模型的透明度设置为原始状态，通过key
 * @function  closeTransparentModelsByKey
 * @param {array/string} key  模型key数组或模型key
 * @return {void}
 */
viewer3D.closeTransparentModelsByKey("M123456_123456");

1.9.14. clearModelTransparentList

清理透明模型列表

调用方式：

/**
 * 清理透明模型列表
 * @function clearModelTransparentList
 * @return {void}
 */
viewer3D.clearModelTransparentList();

1.9.15. colorfulModelsByKey

通过 key 为模型设置颜色

调用方式：

/**
 * 将指定的模型设置为变色，通过key
 * @colorfulModelsByKey
 * @param {array/string} key 模型key数组或模型key
 * @param {number}  color  要设置的颜色，范围 0x000000-0xFFFFFF  16进制
 * @param {number} opacity  要设置的不透明度(默认为1)，范围 0-1  10进制
 * @return {void}
 */
viewer3D.colorfulModelsByKey("M123456_123456", 0x00ff00, 1);

1.9.16. closeColorfulModelsByKey

通过 key 将指定的模型的颜色设置为原始状态

调用方式：

/**
 * 将指定的模型取消变色，通过Key
 * @closeColorfulModelsByKey
 * @param {array/string} key 模型key数组或模型key
 * @return {void}
 */
viewer3D.closeColorfulModelsByKey("M123456");

1.9.17. clearModelColorfulList

取消所有模型的变色

调用方式：

/**
 * 取消所有模型的变色
 * @clearModelColorfulList
 * @return {void}
 */
viewer3D.clearModelColorfulList();

1.9.18. isolateModelsByKey

通过模型 key 将指定的模型隔离，即仅显示隔离的模型

调用方式：

/**
 * 将指定的模型隔离，通过key
 * @isolateModelsByKey
 * @param {array/string} key 模型key数组或模型key
 * @param {boolean} state  模型状态，true为隐藏，false为略微可见，默认true
 * @return {void}
 */
viewer3D.isolateModelsByKey("M123456_123456", true);

1.9.19. closeIsolateModelsByKey

将指定的模型从隔离列表中移除

调用方式：

/**
 * 将指定的模型从隔离列表中移除，通过key
 * @closeIsolateModelsByKey
 * @param {array/string}  key 模型key数组或模型key
 * @return {void}
 */
viewer3D.closeIsolateModelsByKey("M123456_123456");

1.9.20. clearModelIsolation

取消所有模型的隔离

调用方式：

/**
 * 取消所有模型隔离
 * @clearModelIsolation
 * @return {void}
 */
viewer3D.clearModelIsolation();

1.9.21. disableModelsSelectionByKey

将指定的模型设置为不可选中

调用方式：

/**
 * 将指定的模型设置为不可选中
 * @function disableModelsSelectionByKey
 * @param {array/string}  key 模型key数组或模型key
 * @return {void}
 */
viewer3D.disableModelsSelectionByKey("M123456");

1.9.22. enableModelsSelectionByKey

将指定的模型设置为可选中

调用方式：

/**
 * 将指定的模型设置为可选中
 * @function enableModelsSelectionByKey
 * @param {array/string}  key 模型key数组或模型key
 * @return {void}
 */
viewer3D.enableModelsSelectionByKey("M123456");

1.9.23. setModelMatrix

设置指定的模型的矩阵，该操作会覆盖原始数据，请谨慎操作

调用方式：

/**
 * 设置指定的模型的矩阵，该操作会覆盖原始数据，请谨慎操作
 * @setModelMatrix
 * @param {string}  modelKey 模型key
 * @param {THREE.Matrix4}  matrix 4*4转换矩阵
 * @return {void}
 */
viewer3D.setModelMatrix("M123456", new THREE.Matrix4());

demo 示例

1.9.24. applyModelMatrix

应用指定的模型的矩阵

调用方式：

/**
 * 应用指定的模型的矩阵（当前模型矩阵乘参数矩阵）
 * @applyModelMatrix
 * @param {string}  modelKey 模型key
 * @param {THREE.Matrix4}  matrix 4*4转换矩阵
 * @return {void}
 */
viewer3D.applyModelMatrix("M123456", new THREE.Matrix4());

1.9.25. getModelMatrix

获取指定的模型的矩阵的拷贝

调用方式：

/**
 * 获取指定的模型的矩阵的拷贝
 * @getModelMatrix
 * @param {string}  modelKey 模型key
 * @return {THREE.Matrix4} 4*4转换矩阵
 */
var matrix = viewer3D.getModelMatrix("M123456");

1.9.26. setModelMatrixFromTransform

通过坐标，旋转，缩放变换参数设置模型矩阵，该操作会覆盖模型的原始数据

调用方式：

let transformObject = {
    position: new THREE.Vector3(10, 10, 10),
    quaternion: new THREE.Quaternion(),
    scale: new THREE.Vector3(1, 1, 1),
};
viewer3D.setModelMatrixFromTransform("123123", transformObject);

1.9.27. getTransformByModelKey

根据模型 key，获取模型的变换参数，即坐标，旋转，缩放值

调用方式：

//创建保存结果的对象
let transformObject = {
    position: new THREE.Vector3(),
    quaternion: new THREE.Quaternion(),
    scale: new THREE.Vector3(1, 1, 1),
};
//模型的坐标，旋转，缩放值会报存在transformObject对象中
viewer3D.getTransformByModelKey("123123", transformObject);

1.9.28. overturnYAndZaxis

基于原点翻转模型的 Y 轴和 Z 轴（针对建模时 Y 轴向上的模型）

调用方式：

/**
 * 基于原点翻转模型的Y轴和Z轴（针对建模时Y轴向上的模型）
 * @overturnYAndZaxis
 * @param {string}  modelKey 模型key
 * @return {void}
 */
viewer3D.overturnYAndZaxis("M123456");

1.9.29. translateModel