EzySlice 核心组件解析：从 Plane 到 SlicedHull 的完整工作流程

【免费下载链接】ezy-slice An open source mesh slicer framework for Unity3D Game Engine. Written in C#. 项目地址: https://gitcode.com/gh_mirrors/ez/ezy-slice

EzySlice 是一款为 Unity3D 游戏引擎开发的开源网格切割框架，采用 C# 编写，能够帮助开发者轻松实现复杂的 3D 模型切割功能。本文将深入解析 EzySlice 从 Plane 到 SlicedHull 的核心工作流程，带您了解这款强大工具的内部机制。

1. 准备工作：环境搭建与项目结构

要开始使用 EzySlice，首先需要将项目克隆到本地：

git clone https://gitcode.com/gh_mirrors/ez/ezy-slice

EzySlice 的核心代码位于 EzySlice 目录下，主要包含以下关键文件：

• 核心切割逻辑：Slicer.cs
• 平面定义：Plane.cs
• 切割结果：SlicedHull.cs
• 辅助类：IntersectionResult.cs、Triangle.cs 等

2. Plane 类：切割平面的数学定义

在 3D 空间中进行网格切割，首先需要定义一个切割平面。EzySlice 中的 Plane.cs 类正是为此设计的，它通过法线和距离来精确定义一个无限延伸的平面。

2.1 平面的数学表示

Plane 类使用以下公式来表示平面：

ax + by + cz + d = 0

其中 (a, b, c) 是平面的法线向量，d 是平面到原点的距离。

2.2 关键方法与属性

• 构造函数：支持通过点和法线、三点定义等多种方式创建平面
• SideOf 方法：判断一个点位于平面的哪一侧（上、下或平面上）
• normal 属性：获取平面的法线向量
• dist 属性：获取平面到原点的距离

以下是判断点与平面位置关系的核心代码：

public SideOfPlane SideOf(Vector3 pt) {
    float result = Vector3.Dot(m_normal, pt) - m_dist;
    
    if (result > Intersector.Epsilon) {
        return SideOfPlane.UP;
    }
    
    if (result < -Intersector.Epsilon) {
        return SideOfPlane.DOWN;
    }
    
    return SideOfPlane.ON;
}

3. Slicer 类：网格切割的核心引擎

Slicer.cs 是 EzySlice 的核心类，负责执行实际的网格切割操作。它接收 Mesh 和 Plane 作为输入，经过一系列复杂计算，最终生成切割后的网格。

3.1 切割流程概述

1. 输入验证：检查输入的 GameObject 是否包含 MeshFilter 和 MeshRenderer 组件
2. 网格数据提取：获取网格的顶点、UV、法线和切线等数据
3. 子网格处理：对每个子网格进行单独处理
4. 三角形切割：将每个三角形与切割平面相交，生成上、下 hull 和交叉点
5. 交叉区域生成：使用 Triangulator 生成交叉区域的三角形
6. 网格构建：创建上、下 hull 的新网格

3.2 三角形切割的核心逻辑

Slicer 类中的 Slice 方法是整个切割过程的入口。它首先检查输入的有效性，然后对每个子网格进行处理：

public static SlicedHull Slice(Mesh sharedMesh, Plane pl, TextureRegion region, int crossIndex) {
    // 输入验证和初始化代码...
    
    // 处理每个子网格
    for (int submesh = 0; submesh < submeshCount; submesh++) {
        int[] indices = sharedMesh.GetTriangles(submesh);
        // 处理每个三角形
        for (int index = 0; index < indicesCount; index += 3) {
            // 创建三角形并设置UV、法线和切线
            Triangle newTri = new Triangle(verts[i0], verts[i1], verts[i2]);
            // ...设置UV、法线和切线
            
            // 切割三角形
            if (newTri.Split(pl, result)) {
                // 处理切割结果，添加到上、下 hull 和交叉点列表
            } else {
                // 三角形完全位于平面一侧，直接添加到相应 hull
            }
        }
    }
    
    // 检查是否有有效的切割结果
    for (int i = 0; i < slices.Length; i++) {
        if (slices[i] != null && slices[i].isValid) {
            return CreateFrom(slices, CreateFrom(crossHull, pl.normal, region), crossIndex);
        }
    }
    
    return null;
}

4. SlicedHull 类：切割结果的封装与使用

切割完成后，结果被封装在 SlicedHull.cs 类中。这个类提供了便捷的方法来创建切割后的 GameObject，并处理材质等细节。

4.1 主要功能

• upperHull 和 lowerHull 属性：获取切割后的上、下网格
• CreateUpperHull 和 CreateLowerHull 方法：创建包含切割后网格的 GameObject
• 材质处理：自动处理原始材质和交叉区域材质

4.2 创建切割后对象的示例

public GameObject CreateUpperHull(GameObject original, Material crossSectionMat) {
    GameObject newObject = CreateUpperHull();
    
    if (newObject != null) {
        // 复制原始对象的变换属性
        newObject.transform.localPosition = original.transform.localPosition;
        newObject.transform.localRotation = original.transform.localRotation;
        newObject.transform.localScale = original.transform.localScale;
        
        // 处理材质
        Material[] shared = original.GetComponent<MeshRenderer>().sharedMaterials;
        // ...材质处理逻辑
    }
    
    return newObject;
}

5. 完整工作流程总结

EzySlice 的切割过程可以概括为以下几个关键步骤：

1. 定义切割平面：使用 Plane 类创建一个切割平面
2. 准备网格数据：从 GameObject 中提取网格和材质信息
3. 执行切割操作：调用 Slicer.Slice 方法进行网格切割
4. 处理切割结果：使用 SlicedHull 创建新的 GameObject
5. 渲染切割结果：将新创建的 GameObject 添加到场景中

这个流程涵盖了从数学定义到实际渲染的整个过程，展示了 EzySlice 作为一个成熟的网格切割框架的完整性和易用性。

6. 实际应用与扩展

EzySlice 可以应用于多种场景，如：

• 游戏开发：实现物体破坏、切割等特效
• 3D 建模：辅助进行网格编辑和优化
• 教育应用：展示 3D 物体的内部结构

开发者还可以通过扩展 EzySlice 的功能，如添加对复杂网格的支持、优化切割算法等，来满足特定需求。

通过本文的解析，相信您已经对 EzySlice 的核心工作流程有了深入的了解。无论是新手还是有经验的开发者，都可以通过 EzySlice 轻松实现复杂的 3D 网格切割功能，为您的 Unity 项目增添更多可能性。

【免费下载链接】ezy-slice An open source mesh slicer framework for Unity3D Game Engine. Written in C#. 项目地址: https://gitcode.com/gh_mirrors/ez/ezy-slice