italink/unrealclientprotocol/unreal-modeling-selection

建模 — 选择

前置条件：先阅读 unreal-modeling。

重要说明

FGeometryScriptMeshSelection 内部使用不可序列化的 TSharedPtr<FGeometrySelection> 存储数据，无法通过 UCP JSON 直接创建或传递选择内容。

创建选择的两种方式：

1. MeshOperationLibrary 桥接函数（推荐用于简单选择）：SelectAllTriangles、SelectTrianglesByIDs、SelectVerticesByIDs、SelectPolygroupByID、SelectMaterialByID——见 unreal-modeling 核心 Skill
2. GeometryScript 原生选择函数（本 Skill）：SelectMeshElementsInSphere、SelectMeshElementsByNormalAngle 等——适用于基于几何条件的复杂选择

创建后的 Selection 可作为参数传给其他 GeometryScript 函数（UV、变形、简化等）。

库

CDO：/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSelectionFunctions

创建选择

EGeometryScriptMeshSelectionType

MinNumTrianglePoints 参数

控制三角形被选中的条件：1 = 任意顶点在范围内即选中，2 = 至少两个顶点，3 = 全部顶点都在范围内。

转换选择

组合选择

EGeometryScriptCombineSelectionMode

修改选择

查询选择

JSON 示例

球形范围选择三角形：

{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSelectionFunctions","function":"SelectMeshElementsInSphere","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","SphereOrigin":{"X":0,"Y":0,"Z":50},"SphereRadius":100,"SelectionType":"Triangles","MinNumTrianglePoints":1}}

按法线角度选择（朝上的面）：

{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSelectionFunctions","function":"SelectMeshElementsByNormalAngle","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","Normal":{"X":0,"Y":0,"Z":1},"MaxAngleDeg":45,"SelectionType":"Triangles","MinNumTrianglePoints":3}}

组合两个选择（并集）：

使用 Python 脚本在单次调用中完成多步选择组合，避免 Selection 的不可序列化问题：

# 通过 ExecutePythonScript 在引擎内执行
import unreal
# ... 在脚本内创建、组合选择并传给后续操作

或者分步调用：先创建选择 A，再创建选择 B，然后组合——每步的 Selection 作为 out 参数返回后可在下一步作为输入使用（UCP 会在同一连接内保持对象引用）。

发现

对 CDO 路径调用 DescribeObject 可查看完整函数列表和参数签名。