建模 — 查询与空间
前置条件：先阅读 unreal-modeling。
库
| 库 |
CDO |
| 查询 |
/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshQueryFunctions |
| 空间 |
/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSpatialFunctions |
| 采样 |
/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSamplingFunctions |
| 包含 |
/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_ContainmentFunctions |
| 比较 |
/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshComparisonFunctions |
| 测地线 |
/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshGeodesicFunctions |
提示：简单的 mesh 概览可直接用 MeshOperationLibrary.GetMeshSummary，一次调用返回所有基础信息。以下函数用于更精细的查询。
查询函数 — 全局信息
| 函数 |
out 参数 |
说明 |
GetMeshInfoString |
InfoString |
可读的 mesh 信息字符串 |
GetIsDenseMesh |
bIsDense |
ID 空间是否无间隙 |
GetMeshBoundingBox |
返回 FBox |
包围盒 |
GetMeshVolumeArea |
SurfaceArea, Volume |
表面积和体积 |
GetMeshVolumeAreaCenter |
SurfaceArea, Volume, CenterOfMass |
表面积、体积、质心 |
GetIsClosedMesh |
bIsClosed |
是否闭合 |
GetNumOpenBorderLoops |
NumLoops |
开放边界环数量 |
GetNumOpenBorderEdges |
NumEdges |
开放边界边数量 |
GetNumConnectedComponents |
NumComponents |
连通分量数 |
GetMeshHasAttributeSet |
bHasAttributeSet |
是否有属性集 |
查询函数 — 计数与 ID
| 函数 |
out 参数 |
说明 |
GetVertexCount |
返回 int |
顶点数 |
GetNumVertexIDs |
NumVertexIDs |
MaxVertexID |
GetHasVertexIDGaps |
bHasGaps |
顶点 ID 是否有间隙 |
GetNumTriangleIDs |
NumTriangleIDs |
MaxTriangleID |
GetHasTriangleIDGaps |
bHasGaps |
三角形 ID 是否有间隙 |
GetNumUVSets |
NumUVSets |
UV 通道数 |
GetNumExtendedPolygroupLayers |
返回 int |
扩展 Polygroup 层数 |
查询函数 — 属性存在性
| 函数 |
out 参数 |
GetHasTriangleNormals |
bHasNormals |
GetHasVertexColors |
bHasColors |
GetHasMaterialIDs |
bHasMaterialIDs |
GetHasPolygroups |
bHasPolygroups |
查询函数 — 元素数据
| 函数 |
关键参数 |
说明 |
GetVertexPosition |
VertexID |
返回顶点位置。out：bIsValidVertex |
GetTrianglePositions |
TriangleID |
返回三角形三个顶点位置。out：bIsValidTriangle |
GetTriangleIndices |
TriangleID |
返回三角形的三个顶点 ID |
GetTriangleFaceNormal |
TriangleID |
返回面法线 |
GetTriangleNormals |
TriangleID |
返回三个角的法线 |
GetTriangleUVs |
TriangleID, UVSetIndex |
返回三个角的 UV |
GetTriangleVertexColors |
TriangleID |
返回三个角的顶点色 |
GetVertexConnectedTriangles |
VertexID |
返回顶点关联的三角形 ID 列表 |
GetVertexConnectedVertices |
VertexID |
返回顶点的邻居顶点 ID 列表 |
查询函数 — 批量获取
| 函数 |
说明 |
GetAllTriangleIDs |
返回所有三角形 ID 列表 |
GetAllTriangleIndices |
返回所有三角形的顶点索引列表 |
GetAllVertexIDs |
返回所有顶点 ID 列表 |
GetAllVertexPositions |
返回所有顶点位置列表 |
注意：批量函数返回 FGeometryScriptIndexList、FGeometryScriptTriangleList、FGeometryScriptVectorList 等不可序列化类型。用 MeshOperationLibrary 的 GetIndexListArray、GetTriangleListArray、GetVectorListArray 提取数据。
空间函数
| 函数 |
关键参数 |
说明 |
BuildBVHForMesh |
TargetMesh |
构建 BVH 加速结构。out：OutputBVH |
RebuildBVHForMesh |
TargetMesh, UpdateBVH |
重建已有 BVH |
FindNearestPointOnMesh |
TargetMesh, QueryPoint, Options |
查找 mesh 上最近点。out：NearestResult |
FindNearestRayIntersectionWithMesh |
TargetMesh, RayOrigin, RayDirection, Options |
射线与 mesh 求交。out：HitResult |
IsPointInsideMesh |
TargetMesh, QueryPoint, Options |
点是否在 mesh 内部。out：bIsInside（需要 BVH） |
注意：FGeometryScriptDynamicMeshBVH 不可序列化，BVH 只能在同一调用链中使用（如 Python 脚本内）。对于跨调用的空间查询，建议用 Python 脚本批量处理。
采样函数
| 函数 |
关键参数 |
说明 |
ComputePointSampling |
TargetMesh, Options |
泊松盘采样 |
ComputeUniformRandomPointSampling |
TargetMesh, Options |
均匀随机采样 |
ComputeNonUniformPointSampling |
TargetMesh, Options |
非均匀采样 |
ComputeVertexWeightedPointSampling |
TargetMesh, Options |
顶点权重采样 |
比较函数
| 函数 |
关键参数 |
说明 |
IsSameMeshAs |
TargetMesh, OtherMesh, Options |
两个 mesh 是否相同 |
MeasureDistancesBetweenMeshes |
TargetMesh, OtherMesh |
测量两个 mesh 间的距离 |
IsIntersectingMesh |
TargetMesh, OtherMesh, TargetTransform, OtherTransform |
两个 mesh 是否相交 |
JSON 示例
获取包围盒：
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshQueryFunctions","function":"GetMeshBoundingBox","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0"}}
获取三角形顶点位置：
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshQueryFunctions","function":"GetTrianglePositions","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","TriangleID":0}}
获取体积和表面积：
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshQueryFunctions","function":"GetMeshVolumeArea","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0"}}
发现
对上述任意 CDO 路径调用 DescribeObject 可查看完整函数列表和参数签名。
1---2name: unreal-modeling-query3description: GeometryScript 网格查询与空间操作。当用户要求获取网格信息（顶点数、包围盒、拓扑状态）、空间查询（最近点、射线求交、包含测试）或采样时使用。4---56# 建模 — 查询与空间78前置条件：先阅读 `unreal-modeling`。910## 库1112| 库 | CDO |13|----|-----|14| 查询 | `/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshQueryFunctions` |15| 空间 | `/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSpatialFunctions` |16| 采样 | `/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSamplingFunctions` |17| 包含 | `/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_ContainmentFunctions` |18| 比较 | `/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshComparisonFunctions` |19| 测地线 | `/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshGeodesicFunctions` |2021提示：简单的 mesh 概览可直接用 `MeshOperationLibrary.GetMeshSummary`，一次调用返回所有基础信息。以下函数用于更精细的查询。2223## 查询函数 — 全局信息2425| 函数 | out 参数 | 说明 |26|------|----------|------|27| `GetMeshInfoString` | `InfoString` | 可读的 mesh 信息字符串 |28| `GetIsDenseMesh` | `bIsDense` | ID 空间是否无间隙 |29| `GetMeshBoundingBox` | 返回 `FBox` | 包围盒 |30| `GetMeshVolumeArea` | `SurfaceArea`, `Volume` | 表面积和体积 |31| `GetMeshVolumeAreaCenter` | `SurfaceArea`, `Volume`, `CenterOfMass` | 表面积、体积、质心 |32| `GetIsClosedMesh` | `bIsClosed` | 是否闭合 |33| `GetNumOpenBorderLoops` | `NumLoops` | 开放边界环数量 |34| `GetNumOpenBorderEdges` | `NumEdges` | 开放边界边数量 |35| `GetNumConnectedComponents` | `NumComponents` | 连通分量数 |36| `GetMeshHasAttributeSet` | `bHasAttributeSet` | 是否有属性集 |3738## 查询函数 — 计数与 ID3940| 函数 | out 参数 | 说明 |41|------|----------|------|42| `GetVertexCount` | 返回 int | 顶点数 |43| `GetNumVertexIDs` | `NumVertexIDs` | MaxVertexID |44| `GetHasVertexIDGaps` | `bHasGaps` | 顶点 ID 是否有间隙 |45| `GetNumTriangleIDs` | `NumTriangleIDs` | MaxTriangleID |46| `GetHasTriangleIDGaps` | `bHasGaps` | 三角形 ID 是否有间隙 |47| `GetNumUVSets` | `NumUVSets` | UV 通道数 |48| `GetNumExtendedPolygroupLayers` | 返回 int | 扩展 Polygroup 层数 |4950## 查询函数 — 属性存在性5152| 函数 | out 参数 |53|------|----------|54| `GetHasTriangleNormals` | `bHasNormals` |55| `GetHasVertexColors` | `bHasColors` |56| `GetHasMaterialIDs` | `bHasMaterialIDs` |57| `GetHasPolygroups` | `bHasPolygroups` |5859## 查询函数 — 元素数据6061| 函数 | 关键参数 | 说明 |62|------|----------|------|63| `GetVertexPosition` | `VertexID` | 返回顶点位置。out：`bIsValidVertex` |64| `GetTrianglePositions` | `TriangleID` | 返回三角形三个顶点位置。out：`bIsValidTriangle` |65| `GetTriangleIndices` | `TriangleID` | 返回三角形的三个顶点 ID |66| `GetTriangleFaceNormal` | `TriangleID` | 返回面法线 |67| `GetTriangleNormals` | `TriangleID` | 返回三个角的法线 |68| `GetTriangleUVs` | `TriangleID`, `UVSetIndex` | 返回三个角的 UV |69| `GetTriangleVertexColors` | `TriangleID` | 返回三个角的顶点色 |70| `GetVertexConnectedTriangles` | `VertexID` | 返回顶点关联的三角形 ID 列表 |71| `GetVertexConnectedVertices` | `VertexID` | 返回顶点的邻居顶点 ID 列表 |7273## 查询函数 — 批量获取7475| 函数 | 说明 |76|------|------|77| `GetAllTriangleIDs` | 返回所有三角形 ID 列表 |78| `GetAllTriangleIndices` | 返回所有三角形的顶点索引列表 |79| `GetAllVertexIDs` | 返回所有顶点 ID 列表 |80| `GetAllVertexPositions` | 返回所有顶点位置列表 |8182注意：批量函数返回 `FGeometryScriptIndexList`、`FGeometryScriptTriangleList`、`FGeometryScriptVectorList` 等不可序列化类型。用 `MeshOperationLibrary` 的 `GetIndexListArray`、`GetTriangleListArray`、`GetVectorListArray` 提取数据。8384## 空间函数8586| 函数 | 关键参数 | 说明 |87|------|----------|------|88| `BuildBVHForMesh` | `TargetMesh` | 构建 BVH 加速结构。out：`OutputBVH` |89| `RebuildBVHForMesh` | `TargetMesh`, `UpdateBVH` | 重建已有 BVH |90| `FindNearestPointOnMesh` | `TargetMesh`, `QueryPoint`, `Options` | 查找 mesh 上最近点。out：`NearestResult` |91| `FindNearestRayIntersectionWithMesh` | `TargetMesh`, `RayOrigin`, `RayDirection`, `Options` | 射线与 mesh 求交。out：`HitResult` |92| `IsPointInsideMesh` | `TargetMesh`, `QueryPoint`, `Options` | 点是否在 mesh 内部。out：`bIsInside`（需要 BVH） |9394注意：`FGeometryScriptDynamicMeshBVH` 不可序列化，BVH 只能在同一调用链中使用（如 Python 脚本内）。对于跨调用的空间查询，建议用 Python 脚本批量处理。9596## 采样函数9798| 函数 | 关键参数 | 说明 |99|------|----------|------|100| `ComputePointSampling` | `TargetMesh`, `Options` | 泊松盘采样 |101| `ComputeUniformRandomPointSampling` | `TargetMesh`, `Options` | 均匀随机采样 |102| `ComputeNonUniformPointSampling` | `TargetMesh`, `Options` | 非均匀采样 |103| `ComputeVertexWeightedPointSampling` | `TargetMesh`, `Options` | 顶点权重采样 |104105## 比较函数106107| 函数 | 关键参数 | 说明 |108|------|----------|------|109| `IsSameMeshAs` | `TargetMesh`, `OtherMesh`, `Options` | 两个 mesh 是否相同 |110| `MeasureDistancesBetweenMeshes` | `TargetMesh`, `OtherMesh` | 测量两个 mesh 间的距离 |111| `IsIntersectingMesh` | `TargetMesh`, `OtherMesh`, `TargetTransform`, `OtherTransform` | 两个 mesh 是否相交 |112113## JSON 示例114115**获取包围盒**：116117```json118{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshQueryFunctions","function":"GetMeshBoundingBox","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0"}}119```120121**获取三角形顶点位置**：122123```json124{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshQueryFunctions","function":"GetTrianglePositions","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","TriangleID":0}}125```126127**获取体积和表面积**：128129```json130{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshQueryFunctions","function":"GetMeshVolumeArea","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0"}}131```132133## 发现134135对上述任意 CDO 路径调用 `DescribeObject` 可查看完整函数列表和参数签名。
Italink