CascadeStudio 开源项目教程

1. 项目介绍

CascadeStudio 是一个完全在浏览器中运行的实时脚本化 CAD 内核和 IDE。它允许用户通过代码创建 3D 模型，支持从简单的基本几何体到复杂的旋转、扫描和倒角等高级功能。CascadeStudio 利用 OpenCascade 内核的强大功能，并提供了一个简洁的标准库来简化模型的构建。用户可以将完成的模型保存为 STEP、STL 或 OBJ 格式，或者通过 URL 分享给社区。

2. 项目快速启动

2.1 环境准备

确保你已经安装了以下工具：

• 现代浏览器（如 Chrome、Firefox）
• 代码编辑器（如 VS Code）

2.2 克隆项目

首先，克隆 CascadeStudio 项目到本地：

git clone https://github.com/zalo/CascadeStudio.git

2.3 启动项目

进入项目目录并启动本地服务器：

cd CascadeStudio
python -m http.server 8000

打开浏览器，访问 http://localhost:8000，你将看到 CascadeStudio 的界面。

2.4 创建第一个模型

在代码编辑器中打开 index.html，找到代码编辑区域，输入以下代码来创建一个简单的立方体：

let cube = oc.BRepPrimAPI_MakeBox(10, 10, 10).Shape();
let result = cube;

点击“运行”按钮，你将在浏览器中看到一个 10x10x10 的立方体。

3. 应用案例和最佳实践

3.1 创建复杂模型

CascadeStudio 支持创建复杂的 3D 模型。例如，你可以通过组合多个基本几何体来创建一个复杂的机械零件：

let cylinder = oc.BRepPrimAPI_MakeCylinder(5, 20).Shape();
let box = oc.BRepPrimAPI_MakeBox(10, 10, 10).Shape();
let result = oc.BRepAlgoAPI_Fuse(cylinder, box).Shape();

3.2 导入和导出模型

CascadeStudio 支持导入和导出多种格式的 3D 模型。你可以导入一个 STEP 文件并进行编辑，然后导出为 STL 格式：

let importedModel = oc.BRep_Tool.ReadStepFile("path/to/your/model.step");
let result = importedModel;

导出模型：

oc.BRep_Tool.WriteStlFile(result, "path/to/save/model.stl");

4. 典型生态项目

4.1 OpenCascade.js

OpenCascade.js 是 CascadeStudio 的核心 CAD 内核，它将 OpenCascade 的功能移植到浏览器中，使得在浏览器中进行复杂的 3D 建模成为可能。

4.2 Three.js

Three.js 是一个用于在浏览器中创建 3D 图形的 JavaScript 库。CascadeStudio 使用 Three.js 来渲染 3D 模型，提供了丰富的视觉效果和交互功能。

4.3 Monaco Editor

Monaco Editor 是 VS Code 使用的代码编辑器，CascadeStudio 使用 Monaco Editor 提供代码编辑和智能感知功能，使得代码编写更加高效。

通过这些生态项目的结合，CascadeStudio 提供了一个功能强大且易于使用的 3D 建模环境。