BIM Viewer 开源项目教程

BIM Viewer 开源项目教程

1. 项目介绍

BIM Viewer 是一个基于 WebGL 的前端项目，旨在展示 BIM（建筑信息模型）模型。该项目支持显示 gltf、obj、fbx、ifc、dae 等格式的模型。它构建在 three.js 之上，因此可以轻松扩展以支持 three.js 支持的任何格式。该项目目前还不成熟，更像是一个演示，有很多待办事项（TODOs）。由于无法继续工作，因此开源出来，希望对 BIM/AEC 行业的人有所帮助。

2. 项目快速启动

首先，确保您的开发环境中已经安装了 Node.js。

克隆项目到本地：

git clone https://github.com/egghunters/bim-viewer.git
cd bim-viewer

安装依赖：

npm install

启动开发服务器：

npm run serve

编译并生成生产环境的代码：

npm run build

执行代码检查并自动修复：

npm run lint

3. 应用案例和最佳实践

添加自定义项目

您可以通过编辑 projects.json 文件来添加自己的项目或模型。按照以下结构添加信息，并将模型文件放置在 public/projects/my_project 文件夹下。

{
  "id": "my_project",
  "name": "my project",
  "thumbnail": "projects/my_project/thumbnail.png",
  "models": [{
    "name": "my model",
    "src": "projects/my_project/my_model.gltf",
    "merge": false,
    "edges": true
  }]
}

特性使用

• 3D 模型加载与查看：项目支持加载和查看 3D 模型。
• 正交相机：可以使用正交相机查看模型。
• 距离测量：支持测量模型中两点之间的距离。
• 面积测量：支持测量模型表面的面积。
• 角度测量：支持测量模型中的角度。
• 剖切平面：可以添加剖切平面查看模型内部结构。
• 剖切盒子：可以添加剖切盒子查看模型内部的特定部分。
• 组件选择：支持选择模型中的特定组件。
• 显示轮廓：可以显示模型的轮廓线。
• 透明模式：支持将模型设置为透明，以便查看隐藏的部分。

4. 典型生态项目

目前 BIM Viewer 项目的生态系统尚未成熟，但以下是一些可能的方向和项目：

• 注释管理器：用于管理和展示模型中的注释。
• 视点管理器：用于管理和切换模型中的视点。
• 漫游：允许用户在模型中自由移动。
• 模型爆炸：用于分解模型，以便更清楚地查看各个部分。
• 对象属性对话框：显示选中对象的详细信息。
• 工具栏：为用户提供一系列操作工具。
• 导航立方体：帮助用户在 3D 空间中定位。
• 后期处理：对模型进行图像处理，提升视觉效果。
• GIS 数据：集成 GIS 数据，例如 OGC 服务和 GIS 文件。

以上就是 BIM Viewer 项目的介绍和快速启动教程。希望对您有所帮助！