Модуль слияния Базовые принципы нового конфигуратора 2026
Руководство пользователя по модулю слияния (Merger)
Версия модуля: 2.3.14 (FIX: Corrected Phantom Quaternion Inheritance) Дата: 2025-10-08 21:20:00
1. Общая концепция и роли объектов
Модуль Merger позволяет автоматически подгонять размеры и позицию одного объекта (Источник/Source) под свободный или конструкционный объем другого объекта (Приемник/Target) во время перетаскивания.
|
Роль |
Русское название |
Английское название |
Описание |
|
Source |
Источник |
Source |
Объект, который вы перетаскиваете. Его размер и позиция будут изменены по форме фантома. |
|
Target |
Приемник |
Target |
Объект, который принимает Source. Он предоставляет целевой объем для слияния. |
Экспортировать в Таблицы
2. Основные настройки (General Configuration)
Эти параметры находятся в группе “Общие настройки” (merging_config_general) и определяют базовое поведение объекта.
|
Русское название |
Английское название (Blueprint Key) |
Тип |
Возможные значения / Default |
Описание |
|
Участие в слиянии |
merger_enabled |
checkbox (Boolean) |
true / false (false) |
Включает/выключает функциональность Merger для объекта. Должно быть включено для активации остальных параметров. |
|
Роль: Приемник (Target) |
merger_isTarget |
checkbox (Boolean) |
true / false (false) |
Объект может служить целевым объемом для других Source-объектов. Исключает роль Source. |
|
Роль: Источник (Source) |
merger_isSource |
checkbox (Boolean) |
true / false (false) |
Объект может изменять свои размеры при слиянии с Target-объектом. |
|
Режим UI |
merger_ui_mode |
dropdown (String) |
‘Simple’, ‘Advanced’ (‘Simple’) |
Определяет уровень детализации настроек Source-объекта в панели. |
Экспортировать в Таблицы
3. Настройки для роли Источник (Source)
Эти параметры доступны, когда объект является Источником (isSource = true).
A. Общие настройки Target-объема (merging_config_target)
|
Русское название |
Английское название (Blueprint Key) |
Тип |
Возможные значения |
Примечание |
|
Целевой объем |
merger_isTarget_Volume |
dropdown (String) |
Auto (Внутренний объем), CabinetBody_In (Внутренний объем), CabinetBody_Ext (Корпус внешний), Cokol (Цоколь), Tabletop (Столешница), Module (Модуль) |
Определяет, какой именно конструкционный объем Target-объекта будет использоваться для слияния. |
|
Порог коллизии (мм) |
merger_collisionThreshold_ui |
text (Number) |
Любое положительное число (100.0) |
Минимальная глубина пересечения (в мм), необходимая для создания фантома и запуска логики слияния. |
Экспортировать в Таблицы
B. Конфигурация фантома по осям (Advanced Mode Only)
Эти настройки появляются только при Режим UI: Advanced. Они определяют размер и позицию фантома, который будет использоваться для подгонки Source-объекта.
1. Ширина (X) / Width (W)
|
Русское название |
Английское название (Blueprint Key) |
Тип |
Варианты заполнения |
Описание |
|
Режим |
merger_phantom_W_mode |
dropdown (String) |
Размер источника (ActiveObject), Процент от приемника (Percentage) |
Метод расчета ширины фантома. |
|
Значение (%) |
merger_phantom_W_value |
text (Number) |
0 – 100+ (100) |
Применяется, если Режим: Процент от приемника. |
|
Якорь |
merger_phantom_W_anchor |
dropdown (String) |
Центр (C), Лево (L), Право (R), Без привязки (N) |
Точка привязки фантома внутри целевого объема по оси X. |
|
Отступ от якоря (мм) |
merger_phantom_W_offset |
text (Number) |
Любое число (0) |
Смещение фантома от выбранного якоря в миллиметрах. |
Экспортировать в Таблицы
2. Высота (Y) / Height (H)
|
Русское название |
Английское название (Blueprint Key) |
Тип |
Варианты заполнения |
Описание |
|
Режим |
merger_phantom_H_mode |
dropdown (String) |
Размер источника (ActiveObject), Процент от приемника (Percentage) |
Метод расчета высоты фантома. |
|
Значение (%) |
merger_phantom_H_value |
text (Number) |
0 – 100+ (100) |
Применяется, если Режим: Процент от приемника. |
|
Якорь |
merger_phantom_H_anchor |
dropdown (String) |
Центр (C), Верх (U), Низ (D), Без привязки (N) |
Точка привязки фантома внутри целевого объема по оси Y. |
|
Отступ от якоря (мм) |
merger_phantom_H_offset |
text (Number) |
Любое число (0) |
Смещение фантома от выбранного якоря в миллиметрах. |
Экспортировать в Таблицы
3. Глубина (Z) / Depth (D)
|
Русское название |
Английское название (Blueprint Key) |
Тип |
Варианты заполнения |
Описание |
|
Режим |
merger_phantom_D_mode |
dropdown (String) |
Размер источника (ActiveObject), Процент от приемника (Percentage) |
Метод расчета глубины фантома. |
|
Значение (%) |
merger_phantom_D_value |
text (Number) |
0 – 100+ (100) |
Применяется, если Режим: Процент от приемника. |
|
Якорь |
merger_phantom_D_anchor |
dropdown (String) |
Центр (C), Фасад (F), Тыл (B), Без привязки (N) |
Точка привязки фантома внутри целевого объема по оси Z. |
|
Отступ от якоря (мм) |
merger_phantom_D_offset |
text (Number) |
Любое число (0) |
Смещение фантома от выбранного якоря в миллиметрах. |
Экспортировать в Таблицы
4. Как работает слияние (Workflow)
- Настройка ролей: Убедитесь, что объект, который вы будете двигать, имеет Роль: Источник, а принимающий объект (шкаф, ниша и т.п.) — Роль: Приемник.
- Перетаскивание: Начните перетаскивать Source-объект.
- Обнаружение коллизии: Когда Source-объект пересекает Target-объем на величину, превышающую Порог коллизии, активируется логика Merger.
- Создание фантома: Внутри Target-объема создается и позиционируется Фантом (полупрозрачный фиолетовый куб) в соответствии с настройками осей (Режим, Якорь, Отступ). Фантом копирует вращение Source-объекта.
- Завершение перетаскивания: Когда вы отпускаете кнопку мыши (dragEnd):
- Source-объекту назначаются новые размеры (ширина, глубина, высота корпуса) по размерам Фантома.
- Вызывается функция перестройки (build()).
- После перестройки объекта его позиция и вращение корректируются, чтобы он точно совпал с положением Фантома.