Get Vertex Instance For Polygon Vertex
MeshDescriptionBaseЧто это
Чистая (pure) функция MeshDescriptionBase, возвращающая идентификатор экземпляра вершины (VertexInstanceID), соответствующий заданной вершине (VertexID) внутри указанного полигона (PolygonID). Позволяет получить конкретное представление вершины, ассоциированное с гранью, что полезно при работе с атрибутами, привязанными к экземплярам (нормали, UV и т.д.). Не изменяет состояние меша.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- PolygonID (FPolygonID) — идентификатор полигона (грани), в которой ищется экземпляр вершины
- VertexID (FVertexID) — идентификатор вершины, для которой нужно получить экземпляр в указанном полигоне
Выходы (данные):
- ReturnValue (FVertexInstanceID) — идентификатор найденного экземпляра вершины (если вершина принадлежит полигону); в противном случае – невалидный идентификатор
Когда используется
- При необходимости получить уникальный VertexInstanceID для задания атрибутов (UV, vertex colors, нормали), которые хранятся на уровне экземпляров вершин, а не на самих вершинах.
- В алгоритмах модификации геометрии, когда нужно точно адресовать конкретное «копіе» вершины в грани, например, при разъединении рёбер или расчёте сглаживания.
Типичные проблемы
- Передача невалидного идентификатора — вызов с несуществующим PolygonID или VertexID (например, после удаления геометрии) может привести к крашу или возврату невалидного VertexInstanceID без ошибки. Всегда проверяйте данные перед вызовом.
- Игнорирование возвращаемого значения — функция pure, результат нужно использовать немедленно или сохранить, иначе вызов не имеет смысла.
- Забывают, что вершина может отсутствовать в полигоне — если вершина не входит в указанную грань, функция вернёт невалидный ID. Это не ошибка, а особенность топологии; проверяйте IsValid() перед дальнейшим использованием.