unreal-modeling-selection
GeometryScript 网格选择操作。当用户要求按条件选择网格元素(球形/盒体/平面/法线角度/材质等)、组合选择、扩展/收缩选择时使用。
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 3
- Forks
- 1
01 前言 Front Matter
- name
- unreal-modeling-selection
- description
- GeometryScript 网格选择操作。当用户要求按条件选择网格元素(球形/盒体/平面/法线角度/材质等)、组合选择、扩展/收缩选择时使用。
03 SKILL.md 正文
建模 — 选择
前置条件:先阅读 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 可查看完整函数列表和参数签名。
04 同仓库更多 Skills
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
internal-comms
A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).
web-artifacts-builder
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
algorithmic-art
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
theme-factory
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.