Get Normalized Element List
TypedElementSelectionSetLibraryЧто это
Pure-функция библиотеки TypedElementSelectionSetLibrary. Принимает массив элементов и возвращает его «нормализованную» версию — без дубликатов и в порядке, соответствующем внутренней логике набора выделения. Полезна для подготовки списка перед массовыми операциями (например, удалением, трансформацией) в редакторе уровней.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (TypedElementSelectionSet Object Reference) — набор выделения, относительно которого выполняется нормализация
- ElementList (Array of Typed Element Handle) — исходный массив элементов
Выходы (данные):
- ReturnValue (Array of Typed Element Handle) — нормализованный массив элементов (без дубликатов, отсортированный)
Когда используется
- При необходимости получить «чистый» список выделенных элементов для пакетной обработки.
- Перед вызовом функций, чувствительных к порядку или дубликатам (например,
DeleteSelectedElements,SetElementSelectionStates).
Типичные проблемы
- Передача пустого массива — функция вернёт пустой массив, что может быть неочевидно, если ожидается хотя бы один элемент.
- Игнорирование результата: поскольку функция pure, её выход нужно явно подключить к следующей операции, иначе нормализация не применится.