# 自定义文件转换
# 背景
为了能够在web端实现模型和图纸的浏览，需要将文件转换为轻量化数据包，并提取文件数据上传到云端数据库进行结构化存储。
# 说明
- 文件必须首先上传到云端才能发起转换；
- 不同的文件格式有不同的转换方式，其转换结果也不同。
# 主要流程
模型和图纸上传转换后，会生成BIMFACE定义的轻量化数据包，包含模型的几何数据和属性、空间等非几何信息。
# 1. 配置转换参数
一般情况下，使用默认参数调用转换API即可，但如果需要获取差异化的结果，可以通过参数来进行控制。以下为不同格式转换支持的config：
# 1.1 模型通用参数
| 字段 | 描述 | 取值 | 默认值 |
|---|---|---|---|
| toBimtiles | 是否转换为流式加载数据 | true, false | true |
| bimtilesVersion | 流式加载数据版本，仅"toBimtiles"为true时生效 | V2, V3 | V3 |
# 1.2 rvt模型
字段 | 描述 | 取值 | 默认值 |
|---|---|---|---|
| texture | 转换时是否添加材质 | true, false | false |
| viewName | 转换使用的3D视图 | string | {3D} |
| displaylevel | 设置转换的精细度 | fine（精细）medium（中等）coarse（粗略） | fine |
| exportHiddenObjects | 是否导出三维视图中隐藏的构件 | true, false | false |
| exportSchedule | 是否使用明细表内容 | true, false | false |
| exportViewImage | 是否导出视图图片 | true, false | false |
| viewImageDPI | 设置导出视图图片精度 | 72, 150, 300 | 150 |
| export3DViews | 导出三维视图列表 | array("all"代表所有视图) | [] |
| exportSectionBox | 是否按剖切模式导出 | true, false | true |
| drawingGroups | 导出指定分组中的图纸 | array(多个层级用"\"划分，如：{"drawingGroups": ["03.PUBLISHED\DETAILS", "02.SHARED"]}) | [] |
| language | 语言版本 | zh_CN（中文版），en_GB（英文版） | zh_CN |
| customizedObjectData | 指定构件属性作为objectData，并根据objectData组织构件树。指定的构件属性作为构件树的各级节点，层级顺序与输入的属性顺序一致，前面的字段作为后面字段的父节点。 | Array | 空 |
# 1.3 dwg图纸
| 字段 | 描述 | 取值 | 默认值 |
|---|---|---|---|
| exportDrawing | 是否转成矢量图纸 | true, false | true |
| exportPdf | 是否导出pdf文件 | true, false | false |
| exportThumb | 是否导出缩略图 | true, false | true |
| exportAxisGrids | 解析轴网信息 | { "gridLines":["轴线所在图层"], "gridBubbles":["轴号所在图层"] } | 空 |
| viewType | dwg文件的显示类型 | 2D, 3D | 空 |
# 1.4 压缩文件
rvt文件与材质文件打包的zip文件，其转换参数config内容与rvt文件一致。
# 1.5 其他格式
| 字段 | 支持格式 | 描述 | 取值 | 默认值 | |
|---|---|---|---|---|---|
| objectMap | ifc | 导出指定属性与构件ID的映射关系 | Array（如：{"objectMap": ["tag"]}） | [] |
# 2. 发起文件转换
调用服务端API即可发起转换。 API：发起转换 (opens new window)
# 3. 等待转换结果
转换发起后，一般需要等待5~10分钟，可以通过两种方式获取转换状态：
1）BIMFACE完成转换后，回调（即callback）自己的系统。我们推荐这种方式；回调的URL在调用“发起文件转换”的API时通过参数指定，如何处理回调结果，请参考“发起转换”API的详细说明；
2）您也可以调用服务端接口获取转换状态。 API：获取转换状态 (opens new window)
# 4. 显示转换后的模型
通过BIMFACE提供的显示组件，用户可以直接在浏览器中显示三维模型和二维图纸，使用JavaScript API能够在显示的基础上进行二次开发，创建更加丰富的业务功能。
# 5. 获取转换后的BIM数据
在模型转换成功后，模型内的BIM数据会在云端进行解析，提取并结构化入库。
通过BIMFACE提供的服务端API，用户可以直接获取转换后的轻量化数据包中的所有内容，包括构件的所有属性信息、图纸信息、空间信息……
| BIM信息 | 获取方式 |
|---|---|
| 符合条件的构件ID列表 | 查询符合条件的构件ID列表 (opens new window) |
| 构件材质 | 获取构件材质 (opens new window) |
| 构件属性信息 | 获取构件属性 (opens new window) |
| 楼层 | 获取多模型楼层信息 (opens new window) |
| 模型链接 | 获取模型链接信息 (opens new window) |
| 房间 | 获取单个房间信息 (opens new window) |
| 面积分区 | 获取单个面积分区信息 (opens new window) |
| 构件分类树 | 获取构件分类树 (opens new window) |
| 图纸 | 获取图纸列表 (opens new window) |