القائمة
GeometryScript 法线与切线操作。当用户要求重算法线、分裂法线、翻转法线、计算切线或修复法线方向时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
GeometryScript 资产读写与碰撞操作。当用户要求精细控制 StaticMesh 资产加载/保存选项、创建新资产、生成碰撞体时使用。
GeometryScript 网格属性操作。当用户要求设置/查询顶点色、Polygroup、材质 ID 时使用。
Create geometry through the GeometryScript modeling workflow. Use when the user asks to create primitives, generate profile-based shapes, or produce mesh assets or working meshes for downstream pipelines.
GeometryScript 变形与变换操作。当用户要求弯曲、扭曲、平滑、噪声、位移、平移、旋转、缩放网格时使用。
GeometryScript 网格处理操作。当用户要求修复、简化、Remesh、布尔运算、体素化、分解、基础编辑或细分网格时使用。
GeometryScript 图元创建与建模函数。当用户要求创建 Box、Sphere、Cylinder 等基础形状，或进行拉伸、旋转体、壳体等建模操作时使用。
| name | unreal-modeling-normals |
| description | GeometryScript 法线与切线操作。当用户要求重算法线、分裂法线、翻转法线、计算切线或修复法线方向时使用。 |
前置条件：先阅读 unreal-modeling。
CDO：/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshNormalsFunctions
TargetMesh 为 UDynamicMesh* 路径字符串。Debug 省略。需要 FGeometryScriptMeshSelection 的函数，用 MeshOperationLibrary 桥接。需要 FGeometryScriptVectorList 的函数，用 MakeVectorList/GetVectorListArray 桥接。
| 函数 | 关键参数 | 说明 |
|---|---|---|
SetPerVertexNormals | TargetMesh | 平滑法线（无硬边） |
SetPerFaceNormals | TargetMesh | 面法线（每条边都是硬边） |
RecomputeNormals | TargetMesh, CalculateOptions, bDeferChangeNotifications | 保留已有分裂，重新计算法线 |
RecomputeNormalsForMeshSelection | TargetMesh, Selection, CalculateOptions | 对选中区域重算法线 |
ComputeSplitNormals | TargetMesh, SplitOptions, CalculateOptions | 按角度/Polygroup 重建分裂后重算法线 |
AutoRepairNormals | TargetMesh | 修复不一致的法线方向（闭合 mesh 效果最佳） |
| 函数 | 关键参数 | 说明 |
|---|---|---|
FlipNormals | TargetMesh | 翻转全部法线并反转三角形绕序 |
FlipTriangleSelectionNormals | TargetMesh, Selection, bFlipTriangleOrientation, bFlipNormalDirection | 翻转选中区域法线 |
| 函数 | 关键参数 | 说明 |
|---|---|---|
SetMeshTriangleNormals | TargetMesh, TriangleID, Normals(FGeometryScriptTriangle) | 设置单个三角形三个角的法线。out：bIsValidTriangle |
SetMeshPerVertexNormals | TargetMesh, VertexNormalList | 批量设置每顶点法线（列表大小 = MaxVertexID） |
GetMeshPerVertexNormals | TargetMesh, bAverageSplitVertexValues | out：NormalList、bIsValidNormalSet、bHasVertexIDGaps |
UpdateVertexNormal | TargetMesh, VertexID, bUpdateNormal, NewNormal, bUpdateTangents, NewTangentX, NewTangentY | 更新单个顶点的法线和/或切线 |
SetSplitNormalsAlongSelectedEdges | TargetMesh, Selection, bSplit, bRecalculateNormals, CalculateOptions | 沿选中边分裂/合并法线 |
| 函数 | 关键参数 | 说明 |
|---|---|---|
ComputeTangents | TargetMesh, Options | 计算切线（需要有效法线 + UV） |
SetMeshPerVertexTangents | TargetMesh, TangentXList, TangentYList | 批量设置切线 |
GetMeshPerVertexTangents | TargetMesh, bAverageSplitVertexValues | out：TangentXList、TangentYList |
GetMeshHasTangents | TargetMesh | out：bHasTangents |
DiscardTangents | TargetMesh | 移除切线层 |
FGeometryScriptCalculateNormalsOptions| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
bAngleWeighted | bool | true | 按角度加权 |
bAreaWeighted | bool | true | 按面积加权 |
FGeometryScriptSplitNormalsOptions| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
bSplitByOpeningAngle | bool | true | 按折痕角度分裂 |
OpeningAngleDeg | float | 15 | 折痕角度阈值（度） |
bSplitByFaceGroup | bool | false | 按 Polygroup 边界分裂 |
GroupLayer | FGeometryScriptGroupLayer | 默认层 | Polygroup 层 |
FGeometryScriptTangentsOptions| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Type | EGeometryScriptTangentTypes | FastMikkT | 切线算法 |
UVLayer | int | 0 | 用于计算切线的 UV 通道 |
EGeometryScriptTangentTypes| 值 | 说明 |
|---|---|
FastMikkT | 快速 MikkT 切线 |
PerTriangle | 每三角形切线 |
StandardMikkT | 标准 MikkT（可能回退到 FastMikkT） |
重算法线（保留分裂，面积+角度加权）：
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshNormalsFunctions","function":"RecomputeNormals","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","CalculateOptions":{"bAreaWeighted":true,"bAngleWeighted":true},"bDeferChangeNotifications":false}}
按角度分裂法线后重算：
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshNormalsFunctions","function":"ComputeSplitNormals","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","SplitOptions":{"bSplitByOpeningAngle":true,"OpeningAngleDeg":60,"bSplitByFaceGroup":false},"CalculateOptions":{"bAreaWeighted":true,"bAngleWeighted":true}}}
计算切线（MikkT，UV 通道 0）：
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshNormalsFunctions","function":"ComputeTangents","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","Options":{"Type":"FastMikkT","UVLayer":0}}}
对 CDO 路径调用 DescribeObject 可查看完整函数列表和参数签名。