87 lines
2.1 KiB
Markdown
87 lines
2.1 KiB
Markdown
|
# 快速开始
|
|||
|
|
|
|||
|
|
5 分钟从零到第一个 GLB 模型。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://github.com/your-org/ViewDesignEngine.git
|
|||
|
|
cd ViewDesignEngine
|
|||
|
|
|
|||
|
|
mkdir build && cd build
|
|||
|
|
cmake .. -DBUILD_EXAMPLES=ON
|
|||
|
|
cmake --build . -j$(nproc)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 第一个 SDF 形状
|
|||
|
|
|
|||
|
|
创建文件 `hello_vde.cpp`：
|
|||
|
|
|
|||
|
|
```cpp
|
|||
|
|
#include <vde/sdf/sdf_primitives.h>
|
|||
|
|
#include <vde/sdf/sdf_operations.h>
|
|||
|
|
#include <vde/sdf/sdf_to_mesh.h>
|
|||
|
|
#include <vde/mesh/marching_cubes.h>
|
|||
|
|
#include <vde/mesh/halfedge_mesh.h>
|
|||
|
|
#include <vde/foundation/io_gltf.h>
|
|||
|
|
#include <iostream>
|
|||
|
|
|
|||
|
|
using namespace vde::core;
|
|||
|
|
using namespace vde::sdf;
|
|||
|
|
using namespace vde::mesh;
|
|||
|
|
using namespace vde::foundation;
|
|||
|
|
|
|||
|
|
int main() {
|
|||
|
|
// 1. 定义 SDF 函数
|
|||
|
|
auto shape = [](double x, double y, double z) -> double {
|
|||
|
|
Point3D p(x, y, z);
|
|||
|
|
double d_sphere = sphere(p, 1.2);
|
|||
|
|
double d_box = box(p, Point3D(1.5, 1.5, 0.5));
|
|||
|
|
// 平滑并集 (k=0.3 控制融合程度)
|
|||
|
|
return op_smooth_union(d_sphere, d_box, 0.3);
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
// 2. Marching Cubes → 三角形网格
|
|||
|
|
Point3D bmin(-2.5, -2.5, -2.5);
|
|||
|
|
Point3D bmax( 2.5, 2.5, 2.5);
|
|||
|
|
auto mc = marching_cubes(shape, 0.0, bmin, bmax, 64);
|
|||
|
|
|
|||
|
|
// 3. 构建半边网格
|
|||
|
|
HalfedgeMesh mesh;
|
|||
|
|
mesh.build_from_triangles(mc.vertices, mc.triangles);
|
|||
|
|
|
|||
|
|
// 4. 导出 GLB
|
|||
|
|
GltfOptions opts;
|
|||
|
|
opts.binary = true;
|
|||
|
|
opts.include_normals = true;
|
|||
|
|
write_gltf("hello_vde.glb", mesh, opts);
|
|||
|
|
|
|||
|
|
std::cout << "Done! Open hello_vde.glb in viewer/index.html\n";
|
|||
|
|
return 0;
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
编译运行：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
g++ -std=c++17 -I../include hello_vde.cpp -L. -lvde -o hello_vde
|
|||
|
|
./hello_vde
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 导出 GLB
|
|||
|
|
|
|||
|
|
GLB（glTF Binary）可直接在以下工具中打开：
|
|||
|
|
|
|||
|
|
- 本项目自带的 `viewer/index.html`（拖放即可）
|
|||
|
|
- Blender（File → Import → glTF 2.0）
|
|||
|
|
- 在线工具：gltf-viewer.donmccurdy.com
|
|||
|
|
- Windows/macOS 自带 3D Viewer
|
|||
|
|
|
|||
|
|
## 下一步
|
|||
|
|
|
|||
|
|
- [SDF 隐式建模教程](02-sdf-modeling.md) —— 学习更多图元与操作
|
|||
|
|
- [B-Rep 工业建模教程](03-brep-modeling.md) —— 精确边界表示建模
|
|||
|
|
- [API 参考](../API-REFERENCE.md) —— 完整 API 文档
|