UnityMeshSimplifier使用手册

UnityMeshSimplifier 是一个专为 Unity 平台设计的网格简化工具，它基于 Fast Quadric Mesh Simplification 算法并完全以 C# 实现。这个开源项目适用于所有Unity官方支持的平台，包括编辑器环境和运行时构建。下面将详细介绍如何安装、使用此库，并概览其API。

安装指南

通过Unity包管理器安装

对于Unity 2018.1及以上版本，推荐使用Unity的Package Manager来安装UnityMeshSimplifier。你可以在项目的Package Manager界面中，通过“Add Package from Git URL…”选项，输入项目仓库的Git地址来进行安装。对于更早期的Unity版本（如5.6至2017.2），虽然可能兼容但已不再官方支持。

手动安装

如果你偏好手动操作，可以从GitHub仓库下载源代码，然后将其作为Asset导入到你的Unity项目中。确保你的项目设置为.NET Standard 2.0或.NET 4.X脚本运行时版本。

项目使用说明

非程序员友好方式

非编程用户可以利用“LOD Generator Helper”组件。这个组件提供了直观的界面来生成Level of Detail (LOD)组，自动处理网格简化过程。

程序员API指南

开发者应查阅项目Wiki上的“Mesh Simplifier API”和“LOD Generator API”页面。这些API允许你控制简化程度、选择特定算法选项等，实现高度定制化的网格简化逻辑。

项目API使用文档

基础使用示例：

在代码中，创建一个MeshSimplifier实例，设定SimplificationOptions，然后调用简化方法。

using Whinarn.UnityMeshSimplifier;

public void SimplifyMesh(GameObject objToSimplify)
{
    var meshFilter = objToSimplify.GetComponent<MeshFilter>();
    if (meshFilter != null)
    {
        MeshSimplifier simplifier = new MeshSimplifier(meshFilter.mesh);
        SimplificationOptions options = new SimplificationOptions();
        // 设置智能链接以避免简化后出现孔洞，默认启用
        options.EnableSmartLink = true;
        
        Mesh simplifiedMesh = simplifier.Simplify(options);
        meshFilter.sharedMesh = simplifiedMesh;
    }
}

智能链接特性

智能链接是一个用于解决简化过程中可能导致的空洞和连接问题的功能。它默认开启，你可以通过调整SimplificationOptions中的VertexLinkDistance来控制顶点链接的最大距离，以此适应不同规模的网格模型。

解决常见问题

• 缺少XML文档：若通过Git URL安装导致无文档，需在Unity偏好设置的“外部工具”中勾选生成.csproj文件，之后刷新项目即可看到完整文档。
• 简化后的网格有孔洞：启用智能链接通常能解决问题。对于复杂情况，考虑使用边、缝合线保持选项。
• 动画不正确：动画异常通常发生在父级是骨骼的对象上。建议为这些对象单独创建LOD Group。
• VS解决方案问题：确保Unity与Visual Studio工具有最新版本，并适当配置，特别是对于Unity 2017.3+用户。

结语

UnityMeshSimplifier提供了一套强大的工具集，让开发者能够高效地进行网格简化工作，无论是自动化处理还是精细调控都能得到满足。记得查阅完整的贡献指南，参与项目改进，共同优化这一强大的Unity工具。