Перейти к содержанию

Xta-tools-auto-labeling: различия между версиями

Материал из XIOT Wiki
Taxiot (обсуждение | вклад)
Новая страница: «---- → 🔙 Вернуться к установке плагина»
 
Taxiot (обсуждение | вклад)
Нет описания правки
Строка 1: Строка 1:
__NOTOC__
= 🧩 Описание кнопки «Автомаркировка» =
Кнопка '''Автомаркировка''' предназначена для автоматического присвоения маркировки устройствам, подключённым к кабелям. 
Процесс выполняется по заданному шаблону, с возможностью указания префикса, суффикса, разделителя и множителя.
== ▶️ Общие условия ==
* Перед запуском автомаркировки необходимо выбрать один или несколько кабелей (полилиний), к которым подключены устройства.
* Для корректной работы устройства должны быть физически подключены к кабелю.
* Первая вершина полилинии считается точкой подключения к '''щиту''' и не маркируется.
== 🧾 Структура окна ==
При выборе кабеля открывается окно параметров автомаркировки.
[[Файл:19ecd72e-1958-47aa-ae67-1f5075154a90.png|center|300px]]
1. '''Оригинальная запись''' 
  Отображает имя первого устройства, подключённого к кабелю (обычно щита). 
  Это поле предназначено для справки и недоступно для редактирования.
2. '''Префикс''' 
  Вводится вручную. Используется в начале маркировки. 
  Активация производится с помощью переключателя справа от поля. 
  При включении отображается результат в поле «Вариант записи».
3. '''Разделитель''' 
  Устанавливается между префиксом/номером/суффиксом. 
  Допустимы значения: точка, дефис, двоеточие и пр. (например: `-`, `.`, `:`).
4. '''Множитель''' 
  Числовой параметр, определяющий шаг нумерации. 
  Значение по умолчанию — `1`. 
  Пример:
  * множитель `1` → маркировка: 1, 2, 3, 4;
  * множитель `2` → маркировка: 1, 3, 5, 7 и т.д.
5. '''Суффикс''' 
  Вводится вручную. Используется в конце маркировки. 
  Также активируется переключателем, с отображением результата в блоке ниже.
6. '''Вариант записи''' 
  В реальном времени показывает, как будет формироваться маркировка в зависимости от указанных параметров.
== 📌 Пример 1: простая маркировка ==
Подключено 4 устройства, требуется маркировка: '''1-В, 2-В, 3-В, 4-В'''
Настройка:
* Префикс: `1`
* Разделитель: `-`
* Суффикс: `В`
* Множитель: `1`
Результат:
<code>1-В, 2-В, 3-В, 4-В</code>
== 📌 Пример 2: сложный шаблон с точкой и цифрами ==
4 устройства, требуется маркировка: '''1.R12, 1.R13, 1.R14, 1.R15'''
Настройка:
* Префикс: `1.R`
* Разделитель: (пусто)
* Суффикс: `12`
* Множитель: `1`
Результат:
<code>1.R12, 1.R13, 1.R14, 1.R15</code>
== 📌 Пример 3: маркировка по нескольким линиям (группам) ==
Линии сгруппированы по наименованию: '''Гр.1''', '''Гр.2''', '''Гр.3''' 
Для каждой группы требуется маркировка освещения в виде: '''Л.1, Л.2, Л.3...'''
Настройка:
* Префикс: `Л`
* Разделитель: `.`
* Суффикс: `1`
* Множитель: `1`
Устройства маркируются последовательно:
* сначала вся группа '''Гр.1''',
* затем '''Гр.2''',
* затем '''Гр.3''' — в порядке возрастания номера группы.
📌 Это особенно удобно при автоматическом назначении DMX-адресов, где необходимо промаркировать более 100 устройств — операция занимает не более 1 секунды.
== ⚠️ Важно ==
* Первая вершина кабеля (подключение к щиту) '''не участвует в маркировке'''.
* Автомаркировка не работает без подключения кабеля к устройствам.
* Для мультигрупповой маркировки требуется предварительная группировка линий.
----
'''ℹ️ Примечание:''' окно автомаркировки автоматически адаптирует шаблон записи в зависимости от выбора параметров, и позволяет гибко формировать логически понятную и системную нумерацию подключённых устройств.
----
----


→ [[Установка плагина XTA Tools|🔙 Вернуться к установке плагина]]
→ [[Установка плагина XTA Tools|🔙 Вернуться к установке плагина]]

Версия от 09:35, 3 июня 2025

🧩 Описание кнопки «Автомаркировка»

Кнопка Автомаркировка предназначена для автоматического присвоения маркировки устройствам, подключённым к кабелям. Процесс выполняется по заданному шаблону, с возможностью указания префикса, суффикса, разделителя и множителя.

▶️ Общие условия

  • Перед запуском автомаркировки необходимо выбрать один или несколько кабелей (полилиний), к которым подключены устройства.
  • Для корректной работы устройства должны быть физически подключены к кабелю.
  • Первая вершина полилинии считается точкой подключения к щиту и не маркируется.

🧾 Структура окна

При выборе кабеля открывается окно параметров автомаркировки.

Файл:19ecd72e-1958-47aa-ae67-1f5075154a90.png

1. Оригинальная запись

  Отображает имя первого устройства, подключённого к кабелю (обычно щита).  
  Это поле предназначено для справки и недоступно для редактирования.

2. Префикс

  Вводится вручную. Используется в начале маркировки.  
  Активация производится с помощью переключателя справа от поля.  
  При включении отображается результат в поле «Вариант записи».

3. Разделитель

  Устанавливается между префиксом/номером/суффиксом.  
  Допустимы значения: точка, дефис, двоеточие и пр. (например: `-`, `.`, `:`).

4. Множитель

  Числовой параметр, определяющий шаг нумерации.  
  Значение по умолчанию — `1`.  
  Пример:
  * множитель `1` → маркировка: 1, 2, 3, 4;
  * множитель `2` → маркировка: 1, 3, 5, 7 и т.д.

5. Суффикс

  Вводится вручную. Используется в конце маркировки.  
  Также активируется переключателем, с отображением результата в блоке ниже.

6. Вариант записи

  В реальном времени показывает, как будет формироваться маркировка в зависимости от указанных параметров.

📌 Пример 1: простая маркировка

Подключено 4 устройства, требуется маркировка: 1-В, 2-В, 3-В, 4-В

Настройка:

  • Префикс: `1`
  • Разделитель: `-`
  • Суффикс: `В`
  • Множитель: `1`

Результат: 1-В, 2-В, 3-В, 4-В

📌 Пример 2: сложный шаблон с точкой и цифрами

4 устройства, требуется маркировка: 1.R12, 1.R13, 1.R14, 1.R15

Настройка:

  • Префикс: `1.R`
  • Разделитель: (пусто)
  • Суффикс: `12`
  • Множитель: `1`

Результат: 1.R12, 1.R13, 1.R14, 1.R15

📌 Пример 3: маркировка по нескольким линиям (группам)

Линии сгруппированы по наименованию: Гр.1, Гр.2, Гр.3 Для каждой группы требуется маркировка освещения в виде: Л.1, Л.2, Л.3...

Настройка:

  • Префикс: `Л`
  • Разделитель: `.`
  • Суффикс: `1`
  • Множитель: `1`

Устройства маркируются последовательно:

  • сначала вся группа Гр.1,
  • затем Гр.2,
  • затем Гр.3 — в порядке возрастания номера группы.

📌 Это особенно удобно при автоматическом назначении DMX-адресов, где необходимо промаркировать более 100 устройств — операция занимает не более 1 секунды.

⚠️ Важно

  • Первая вершина кабеля (подключение к щиту) не участвует в маркировке.
  • Автомаркировка не работает без подключения кабеля к устройствам.
  • Для мультигрупповой маркировки требуется предварительная группировка линий.

ℹ️ Примечание: окно автомаркировки автоматически адаптирует шаблон записи в зависимости от выбора параметров, и позволяет гибко формировать логически понятную и системную нумерацию подключённых устройств.


→ 🔙 Вернуться к установке плагина