AGENT SKILL

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 直接创建或传递选择内容。

创建选择的两种方式:

  1. MeshOperationLibrary 桥接函数(推荐用于简单选择):SelectAllTriangles、SelectTrianglesByIDs、SelectVerticesByIDs、SelectPolygroupByID、SelectMaterialByID——见 unreal-modeling 核心 Skill
  2. 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

welflau
welflau/ai-dev-system

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.

测试与质量前端开发
★ 3
welflau
welflau/ai-dev-system

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.).

邮件与沟通
★ 3
welflau
welflau/ai-dev-system

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.

前端开发
★ 3
welflau
welflau/ai-dev-system

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.

设计师前端开发视觉设计
★ 3
welflau
welflau/ai-dev-system

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.

视觉设计
★ 3
welflau
welflau/ai-dev-system

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.

视觉设计
★ 3