Get Triangle Polygon Group
MeshDescriptionBase
0
Что это
Pure-функция, возвращающая идентификатор группы полигонов (PolygonGroupID), к которой принадлежит треугольник с заданным TriangleID в составе MeshDescriptionBase. Не изменяет данные, предназначена только для чтения.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (MeshDescriptionBase Object Reference) — объект описания меша, из которого извлекается группа.
- TriangleID (TriangleID Structure) — идентификатор треугольника, для которого необходимо получить группу.
Выходы (данные):
- ReturnValue (PolygonGroupID) — идентификатор группы полигонов, которой принадлежит треугольник. Если треугольник не привязан ни к одной группе, возвращается INDEX_NONE (валидность нужно проверять отдельно).
Когда используется
- При импорте или генерации меша, когда нужно узнать, к какой группе материалов относится конкретный треугольник.
- При перестроении топологии: после изменения состава треугольников необходимо заново получить их группы для корректного назначения материалов.
Типичные проблемы
- Устаревший TriangleID. После добавления, удаления или перестроения треугольников старые идентификаторы становятся невалидными — функция может вернуть некорректный PolygonGroupID или INDEX_NONE.
- Не проверен ReturnValue. Если треугольник не принадлежит ни одной группе (например, из-за повреждённой топологии), возвращается INDEX_NONE. Игнорирование этой проверки может привести к ошибкам при использовании PolygonGroupID в других операциях.
- Ошибка контекста. Убедитесь, что Target ссылается на существующий и полностью загруженный MeshDescription. Вызов на некорректном объекте (например, на Null или неинициализированном) приведёт к крашу.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.