本技能面向 Unreal Engine 5.9 的 Hair Strands 毛发系统,主题是 groom(发丝型毛发资产)的导入、配置、绑定、渲染与调试。
【核心概念】 一个 groom 由三份必须相互一致的资产构成:UGroomAsset 保存发丝数据及其渲染方式;UGroomBindingAsset 定义发根在某个骨骼网格体上的落点;UGroomComponent 把两者挂到骨骼网格体组件下进行渲染。多数“毛发不见了”的问题都源于这三者不一致,或者某项 groom 设置被修改后资产没有察觉。发丝数据按组划分,每组在 HairGroupsRendering、HairGroupsLOD、HairGroupsInterpolation、HairGroupsPhysics、HairGroupsCards、HairGroupsMeshes 中有对应条目,并共用资产级的 HairGroupsMaterials 材质槽。
【何时使用】 导入 Alembic(.abc)groom,或通过 Python/C++/编辑器手动设置宽度、LOD、guides、材质;构建或重定向 UGroomBindingAsset,选择 Rigid 或 Skinning 挂接方式,并向角色添加 UGroomComponent;排查不可见、全秃、幽灵状或变细的毛发,包括在场景捕获中;把卡片毛发转换为发丝,或为 MetaHuman Creator 准备 groom。
【关键设置】 宽度:GeometrySettings.HairWidth 单位为厘米,只有 hair_width_override 为 true 时才生效;未覆盖时使用文件导入宽度,文件无宽度则取 0.01 cm,看起来像淡淡的幽灵。HairRootScale 和 HairTipScale 是根部和尖端的宽度倍数,尖端缩放为 1 会显得像钝的圆柱。 LOD:每个 LOD 有 CurveDecimation、ScreenSize、GeometryType(Strands/Cards/Meshes)、BindingType(Rigid/Skinning)等,默认 BindingType 为 Skinning。Auto LOD 默认开启,活跃曲线数随屏幕覆盖变化,小视图下毛发会变稀或消失;需要近景满密度时可设 LODMode 为 Manual、提高 AutoLODBias,或关闭项目设置。 绑定类型:Rigid 只需父网格体组件,便宜,适合头盔、短发和道具;Skinning 跟随蒙皮表面,需要已构建的绑定资产。注意绑定类型存在 groom 上,不在绑定资产上。缺少绑定时毛发会脱离而不是隐藏,组件会把该 LOD 降级为 NoneBinding,毛发停在静止形态并不跟随网格体。 材质:按组内隐藏的 MaterialSlotName 在 HairGroupsMaterials 中查找;无匹配用槽 0,无材质或不兼容则回退插件默认材质。发丝材质需 Hair 着色模型、Used with Hair Strands 用法、不透明或遮罩混合模式。组件 OverrideMaterials 优先。Cards/Meshes 的 LOD 走各自描述的材质槽。 绑定构建:可从源网格体通过 UV 通道 0 和 MatchingSection(默认 0)转移;NumInterpolationPoints 默认 100。绑定异步构建,IsCompiling() 为 true 表示仍在进行。附加骨骼用 AttachmentName 指定骨骼名(不是插槽),组件在 tick 时查找并保持相对变换。
【使用方式】 需先启用 Groom(HairStrands)和 Alembic Groom Importer(AlembicHairImporter)插件(默认均关闭)。通过 UHairStrandsFactory 显式指定、配置 UGroomImportOptions 的旋转与缩放、以自动化模式导入 .abc 曲线。之后逐组设置宽度覆盖、根尖缩放,检查 guides,按 LOD 决定 BindingType 与 LODMode,分配材质,创建绑定并添加组件。文档给出 C++ 模式(模块依赖 HairStrandsCore,创建 UGroomComponent 并 SetupAttachment 到网格体,SetGroomAsset 设置 groom 和绑定)和 Python 完整示例(构造 GroomImportOptions、AssetImportTask、编辑组设置、创建材质与绑定、保存资产)。
【Python 结构体规则】 组的数组通过 BlueprintGetter/Setter 暴露:直接读属性返回副本,修改会丢失;get_editor_property 返回的数组包装器索引或遍历时返回元素副本,在 5.9 中对临时值 set_editor_property 会抛出 RuntimeError;arr[i] = elem 直接写入资产内存但不发变更通知。正确做法是 list(...) 取出副本、编辑后整体 set_editor_property 回去,以触发重建。
【限制与注意】 绑定资产只接受指向同一 groom(按 PrimaryAssetId 比较)、组数相同、已构建根数据 LOD 数一致的组件。SetGroom 不重建绑定;Python set_editor_property("groom", g) 会重建但绑定仍订阅旧 groom。Build() 不标记包脏,保存需 only_if_is_dirty=False。大 groom 的 Skinning 绑定构建可能耗时很久(文档记录约 4 万发丝对全脸网格体超过 15 分钟),建议先用 Rigid 测试。MaterialSlotName 不可编辑,从其他 groom 复制材质可能导致各组都取第一个材质。