xeokit-bim-viewer 开源项目教程

xeokit-bim-viewer 开源项目教程

xeokit-bim-viewer A browser-based BIM viewer, built on the xeokit SDK 项目地址: https://gitcode.com/gh_mirrors/xe/xeokit-bim-viewer

1. 项目介绍

xeokit-bim-viewer 是一个基于浏览器的三维建筑信息模型（BIM）查看器，它构建在 xeokit SDK 之上。该项目由 xeolabs 和 OpenProject 开发，并集成在 OpenProject BIM 10.4 及更高版本中。xeokit-bim-viewer 可以在浏览器中加载来自文件系统的模型，提供了一种低成本、高性能的方式将 IFC 模型展示在 Web 上。

2. 项目快速启动

方法一：使用 GitHub Pages 部署

1. Fork 项目： 首先，在 GitHub 上 Fork xeokit-bim-viewer 项目。

2. 转换模型： 使用开源 CLI 工具将你的 IFC 文件转换为 XKT 格式，并将转换后的模型添加到你的 Fork 项目的 data 目录中。

3. 启用 GitHub Pages： 在你的 Fork 项目中启用 GitHub Pages，用户可以通过以下 URL 访问你的模型：

   https://<你的用户名>.github.io/xeokit-bim-viewer/app/index.html?projectId=<你的项目ID>
   

方法二：本地部署

1. 安装 Node.js： 从 Node.js 官网 下载并安装 Node.js。

2. 克隆项目：

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

3. 安装依赖：

   npm install
   

4. 添加模型： 将转换后的模型添加到 data 目录中。

5. 启动服务：

   npm run serve
   

6. 访问本地服务： 打开浏览器，访问 http://localhost:8080/app/index.html?projectId=<你的项目ID>。

3. 应用案例和最佳实践

案例一：建筑项目可视化

某建筑公司使用 xeokit-bim-viewer 将多个建筑项目的 IFC 模型展示在 Web 上，方便客户和团队成员在线查看和讨论建筑设计。通过自定义 URL 参数，他们可以快速加载特定的项目和模型，提高了沟通效率。

案例二：教育培训

某大学建筑系使用 xeokit-bim-viewer 作为教学工具，学生可以在浏览器中查看和操作复杂的建筑模型，学习建筑信息模型的结构和细节。教师可以通过设置不同的视图状态和配置，帮助学生更好地理解课程内容。

4. 典型生态项目

xeokit SDK

xeokit SDK 是 xeokit-bim-viewer 的基础，提供了高效的模型加载和渲染功能。xeokit SDK 支持多种浏览器，包括移动设备，并且可以加载来自文件系统的模型。

OpenProject BIM

OpenProject BIM 是一个开源的项目管理工具，集成了 xeokit-bim-viewer，使得用户可以在项目管理界面中直接查看和操作 BIM 模型，提高了项目管理的效率和可视化程度。

IFC.js

IFC.js 是一个用于处理 IFC 文件的 JavaScript 库，可以与 xeokit-bim-viewer 结合使用，提供更强大的 IFC 模型处理能力。

xeokit-bim-viewer A browser-based BIM viewer, built on the xeokit SDK 项目地址: https://gitcode.com/gh_mirrors/xe/xeokit-bim-viewer