建模 — 选择
前置条件：先阅读 unreal-modeling。
重要说明
FGeometryScriptMeshSelection 内部使用不可序列化的 TSharedPtr<FGeometrySelection> 存储数据，无法通过 UCP JSON 直接创建或传递选择内容。
创建选择的两种方式：
- MeshOperationLibrary 桥接函数（推荐用于简单选择）：
SelectAllTriangles、SelectTrianglesByIDs、SelectVerticesByIDs、SelectPolygroupByID、SelectMaterialByID——见 unreal-modeling 核心 Skill
- GeometryScript 原生选择函数（本 Skill）：
SelectMeshElementsInSphere、SelectMeshElementsByNormalAngle 等——适用于基于几何条件的复杂选择
创建后的 Selection 可作为参数传给其他 GeometryScript 函数（UV、变形、简化等）。
库
CDO：/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSelectionFunctions
创建选择
| 函数 |
关键参数 |
说明 |
CreateSelectAllMeshSelection |
TargetMesh |
选择全部。out：Selection |
SelectMeshElementsInSphere |
TargetMesh, SphereOrigin, SphereRadius, SelectionType, MinNumTrianglePoints |
球形范围选择。out：Selection |
SelectMeshElementsInBox |
TargetMesh, BoxTransform, BoxDimensions, SelectionType, MinNumTrianglePoints |
盒体范围选择 |
SelectMeshElementsWithPlane |
TargetMesh, PlaneOrigin, PlaneNormal, SelectionType, MinNumTrianglePoints |
平面一侧选择 |
SelectMeshElementsByNormalAngle |
TargetMesh, Normal, MaxAngleDeg, SelectionType, MinNumTrianglePoints |
按法线角度选择 |
SelectMeshElementsByMaterialID |
TargetMesh, MaterialID |
按材质 ID 选择 |
EGeometryScriptMeshSelectionType
| 值 |
说明 |
Vertices |
选择顶点 |
Edges |
选择边 |
Triangles |
选择三角形 |
Polygroups |
选择 Polygroup |
MinNumTrianglePoints 参数
控制三角形被选中的条件：1 = 任意顶点在范围内即选中，2 = 至少两个顶点，3 = 全部顶点都在范围内。
转换选择
| 函数 |
关键参数 |
说明 |
ConvertMeshSelection |
TargetMesh, FromSelection, NewType |
在顶点/三角形/Polygroup 间转换。out：ToSelection |
ConvertMeshSelectionToIndexList |
TargetMesh, Selection |
转换为索引列表。out：IndexList、SelectionType |
ConvertIndexListToMeshSelection |
TargetMesh, IndexList, SelectionType |
从索引列表创建选择。out：Selection |
ConvertIndexArrayToMeshSelection |
TargetMesh, IndexArray, SelectionType |
从 int 数组创建选择 |
组合选择
| 函数 |
关键参数 |
说明 |
CombineMeshSelections |
SelectionA, SelectionB, CombineMode |
组合两个选择。out：ResultSelection |
EGeometryScriptCombineSelectionMode
| 值 |
说明 |
Add |
并集 |
Subtract |
差集（A - B） |
Intersection |
交集 |
修改选择
| 函数 |
关键参数 |
说明 |
InvertMeshSelection |
TargetMesh, Selection |
反转选择。out：NewSelection |
ExpandMeshSelectionToConnected |
TargetMesh, Selection |
扩展到连通区域。out：NewSelection |
ExpandContractMeshSelection |
TargetMesh, Selection, Iterations, bContract, bOnlyExpandToFaceNeighbours |
扩展/收缩选择 |
查询选择
| 函数 |
关键参数 |
说明 |
GetMeshSelectionInfo |
Selection |
out：SelectionType、NumSelected |
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 可查看完整函数列表和参数签名。
1---2name: unreal-modeling-selection3description: GeometryScript 网格选择操作。当用户要求按条件选择网格元素（球形/盒体/平面/法线角度/材质等）、组合选择、扩展/收缩选择时使用。4---56# 建模 — 选择78前置条件：先阅读 `unreal-modeling`。910## 重要说明1112`FGeometryScriptMeshSelection` 内部使用不可序列化的 `TSharedPtr<FGeometrySelection>` 存储数据，**无法通过 UCP JSON 直接创建或传递选择内容**。1314**创建选择的两种方式**：15161. **MeshOperationLibrary 桥接函数**（推荐用于简单选择）：`SelectAllTriangles`、`SelectTrianglesByIDs`、`SelectVerticesByIDs`、`SelectPolygroupByID`、`SelectMaterialByID`——见 `unreal-modeling` 核心 Skill172. **GeometryScript 原生选择函数**（本 Skill）：`SelectMeshElementsInSphere`、`SelectMeshElementsByNormalAngle` 等——适用于基于几何条件的复杂选择1819创建后的 Selection 可作为参数传给其他 GeometryScript 函数（UV、变形、简化等）。2021## 库2223CDO：`/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSelectionFunctions`2425## 创建选择2627| 函数 | 关键参数 | 说明 |28|------|----------|------|29| `CreateSelectAllMeshSelection` | `TargetMesh` | 选择全部。out：`Selection` |30| `SelectMeshElementsInSphere` | `TargetMesh`, `SphereOrigin`, `SphereRadius`, `SelectionType`, `MinNumTrianglePoints` | 球形范围选择。out：`Selection` |31| `SelectMeshElementsInBox` | `TargetMesh`, `BoxTransform`, `BoxDimensions`, `SelectionType`, `MinNumTrianglePoints` | 盒体范围选择 |32| `SelectMeshElementsWithPlane` | `TargetMesh`, `PlaneOrigin`, `PlaneNormal`, `SelectionType`, `MinNumTrianglePoints` | 平面一侧选择 |33| `SelectMeshElementsByNormalAngle` | `TargetMesh`, `Normal`, `MaxAngleDeg`, `SelectionType`, `MinNumTrianglePoints` | 按法线角度选择 |34| `SelectMeshElementsByMaterialID` | `TargetMesh`, `MaterialID` | 按材质 ID 选择 |3536### `EGeometryScriptMeshSelectionType`3738| 值 | 说明 |39|----|------|40| `Vertices` | 选择顶点 |41| `Edges` | 选择边 |42| `Triangles` | 选择三角形 |43| `Polygroups` | 选择 Polygroup |4445### `MinNumTrianglePoints` 参数4647控制三角形被选中的条件：`1` = 任意顶点在范围内即选中，`2` = 至少两个顶点，`3` = 全部顶点都在范围内。4849## 转换选择5051| 函数 | 关键参数 | 说明 |52|------|----------|------|53| `ConvertMeshSelection` | `TargetMesh`, `FromSelection`, `NewType` | 在顶点/三角形/Polygroup 间转换。out：`ToSelection` |54| `ConvertMeshSelectionToIndexList` | `TargetMesh`, `Selection` | 转换为索引列表。out：`IndexList`、`SelectionType` |55| `ConvertIndexListToMeshSelection` | `TargetMesh`, `IndexList`, `SelectionType` | 从索引列表创建选择。out：`Selection` |56| `ConvertIndexArrayToMeshSelection` | `TargetMesh`, `IndexArray`, `SelectionType` | 从 int 数组创建选择 |5758## 组合选择5960| 函数 | 关键参数 | 说明 |61|------|----------|------|62| `CombineMeshSelections` | `SelectionA`, `SelectionB`, `CombineMode` | 组合两个选择。out：`ResultSelection` |6364### `EGeometryScriptCombineSelectionMode`6566| 值 | 说明 |67|----|------|68| `Add` | 并集 |69| `Subtract` | 差集（A - B） |70| `Intersection` | 交集 |7172## 修改选择7374| 函数 | 关键参数 | 说明 |75|------|----------|------|76| `InvertMeshSelection` | `TargetMesh`, `Selection` | 反转选择。out：`NewSelection` |77| `ExpandMeshSelectionToConnected` | `TargetMesh`, `Selection` | 扩展到连通区域。out：`NewSelection` |78| `ExpandContractMeshSelection` | `TargetMesh`, `Selection`, `Iterations`, `bContract`, `bOnlyExpandToFaceNeighbours` | 扩展/收缩选择 |7980## 查询选择8182| 函数 | 关键参数 | 说明 |83|------|----------|------|84| `GetMeshSelectionInfo` | `Selection` | out：`SelectionType`、`NumSelected` |8586## JSON 示例8788**球形范围选择三角形**：8990```json91{"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}}92```9394**按法线角度选择（朝上的面）**：9596```json97{"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}}98```99100**组合两个选择（并集）**：101102使用 Python 脚本在单次调用中完成多步选择组合，避免 Selection 的不可序列化问题：103104```python105# 通过 ExecutePythonScript 在引擎内执行106import unreal107# ... 在脚本内创建、组合选择并传给后续操作108```109110或者分步调用：先创建选择 A，再创建选择 B，然后组合——每步的 Selection 作为 out 参数返回后可在下一步作为输入使用（UCP 会在同一连接内保持对象引用）。111112## 发现113114对 CDO 路径调用 `DescribeObject` 可查看完整函数列表和参数签名。
Italink