Get Vertex Instance Connected Polygons
MeshDescriptionBaseЧто это
Pure-функция, возвращающая массив идентификаторов полигонов (PolygonID), которые соединены с указанным экземпляром вершины (Vertex Instance) в меше MeshDescriptionBase. Используется для анализа топологии сетки — например, чтобы получить все полигоны, инцидентные конкретной вершине в конкретной точке.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (MeshDescriptionBase Object Reference) — ссылка на объект описания меша, в котором производится поиск.
- VertexInstanceID (VertexInstanceID Structure) — идентификатор экземпляра вершины, для которого нужно найти соединённые полигоны.
Выходы (данные):
- ReturnValue (Array of PolygonID) — массив идентификаторов полигонов, связанных с данным экземпляром вершины. Если экземпляр не принадлежит ни одному полигону, возвращается пустой массив.
Когда используется
- При процедурной генерации геометрии или редактировании меша через Blueprint (например, с помощью Geometry Script).
- Для поиска смежных полигонов вокруг заданной вершины, чтобы применить деформацию или изменить материал на соседних гранях.
- В алгоритмах топологического анализа — проверка связности, построение списка рёбер и т.д.
Типичные проблемы
- Передача невалидного VertexInstanceID — если в массиве VertexInstances меша нет такого идентификатора, функция вернёт пустой массив без ошибки, что может привести к неожиданному поведению при дальнейшей обработке.
- Путаница между VertexID и VertexInstanceID — VertexInstanceID относится к конкретному «экземпляру» вершины в определённом полигоне, а не к уникальной позиции вершины. Использование VertexID вместо VertexInstanceID приведёт к ошибке компиляции или неверным результатам.
- Игнорирование возвращаемого пустого массива — если экземпляр вершины является изолированным (например, после удаления полигонов), результат будет пуст, и последующие операции с полигонами (например, получение их граней) упадут с ошибкой.