Метка

объект Метка

Производный от Система координат

Маркер - ключевой объект дополненной реальности. К маркеру, который камера видит в реальном мире привязываются объекты виртуальной сцены. По сути своей маркер является объектом Система координат, видимостью и положением которого управляет система трекинга приложения. Таким образом, взаимодействие с меткой дополненной реальности ничем не отличается от взаимодействия с Система координат.

Для «соединения» метки и каких-либо объектов (например, Модель) достаточно добавить модель в маркер при помощи интерфейса панели «Проект». Для того, чтобы отследить показ или скрытие метки, следует использовать события onShow и onHide соответственно. Дополнительно для более точного взаимодействия добавлены события Маркер - исчез и Маркер - появился.

Работа с меткой

Вводится в Метка

Параметр

Описание

Технология распознавания

Технология распознования (маркерная или безмаркерная).

Ресурс метки

Файл изображения, используемый для распознавания.

gridSize

Размер двумерной сетки, используемой детектором при анализе и распознавании изображения (только для безмаркерной технологии). Распределение особых точек по сетке можно посмотреть в окне «Анализ метки».

Физический размер

Физический размер метки, которая будет использоваться для распознавания.

autoShow

Автоматическое отображение всех дочерних узлов метки при ее появлении (см событие Маркер - появился).

autoHide

Автоматическое скрытие всех дочерних узлов метки при ее исчезновении (см. событие Маркер - исчез).

Включен

Параметр, позволяющий временно отключить распознавание данной метки.

Событие

Описание

Маркер - исчез

Вызывается при мгновенном пропадании метки из поля зрения.

Маркер - появился

Вызывается при мгновенном появлении метки в поле зрения.

Включён

Вызывается при активации метки.

Выключен

Вызывается при деактивации метки.

Действие

Описание

Включить

Активировать метку.

Выключить

Деактивировать метку.

../_images/marker_marker_actions.png
параметр Технология распознавания

Тип метки: маркерная или безмаркерная.

Маркерная технология подразумевает наличие рамки вокруг метки дополненной реальности, безмаркерная лишь накладывает дополнительные требования к паттерну. Подробнее см. в Технология трекинга

Предупреждение

Данный параметр может быть выставлен только на старте приложения. Изменение данного параметра в процессе работы приложения не будет иметь никакого действия.

параметр Ресурс метки

Паттерн для метки дополненной реальности.

Подробно о требованиях к паттернам см. в разделе Технология трекинга

Предупреждение

Данный параметр может быть выставлен только на старте приложения. Изменение данного параметра в процессе работы приложения не будет иметь никакого действия.

параметр Физический размер

Ширина метки дополненной реальности.

Для маркерной технологии распознавания физический размер - расстояние между центрами крайних точек или краёв линий (см. изображение).

../_images/dashdot_tracking_size.png

Для безмаркерной технологии распознавания физический размер - ширина изображения.

Предупреждение

Данный параметр может быть выставлен только на старте приложения. Изменение данного параметра в процессе работы приложения не будет иметь никакого действия.

параметр Включен

Активен ли данный маркер.

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

Для управления данным параметром существуют действия Включить и Выключить, при изменении состояния будут вызываться события Включить и Выключить.

Примечание

При выключении метки в момент, когда она была показана в кадре, события Маркер - исчез, onHide и т.п. вызваны не будут.

событие Маркер - исчез

Вызывается при пропаже метки из кадра. В отличие от onHide данное событие вызывается сразу.

Вызов данного события не означает, что метка уже пропала. Параметр markerLeftTimeout настраивает время, которое будет проходить между вызовами событий Маркер - исчез и onHide.

см. также событие Маркер - появился.

событие Маркер - появился

Вызывается при появлении метки после кратковременной потери, меньшей markerLeftTimeout.

событие Включён

Вызывается при активации метки, т.е. при изменении параметра Включить на true или вызове действия Включить.

событие Выключен

Вызывается при деактивации метки, т.е. при изменении параметра Выключить на false или вызове действия Выключить.

действие Включить

Включить метку.

действие Выключить

Выключить метку.

Предупреждение

Если данное действие было вызвано в момент, когда метка была показана, то события Маркер - исчез и onHide вызваны не будут.

Положение объекта

Вводится в Система координат

Параметр

Описание

Перемещение

Перемещение объекта относительно родительского объекта.

Вращение

Поворот объекта относительно родительского объекта.

Масштаб

Масштаб объекта относительно родителя.

Действие

Описание

Объект - переместить

Установить новое перемещение объекта (значение параметра Перемещение)

Объект - повернуть

Установить новый поворот объекта (значение параметра Вращение)

Объект - масштабировать

Установить новый масштаб объекта (значение параметра Масштаб)

../_images/transform_transform_actions.png
параметр Перемещение

Вводится в Система координат

Параметр позволяет задать точный сдвиг объекта по координатам (x, y, z) относительно родительского объекта.

Доступны следующие действия:

  • img_reset сбросить в нулевое положение

  • img_auto поместить на метку автоматически (совместить центр с родительской меткой)

параметр Вращение

Вводится в Система координат

Параметр позволяет задать точный поворот объекта по осям (x, y, z) относительно родительского объекта.

В данном параметре используются углы Крылова (или углы Эйлера), где порядок поворота осей определяется в порядке: z, x, y. Все углы задаются в градусах.

Доступны следующие действия:

  • img_reset2 сбросить в начальное состояние

параметр Масштаб

Вводится в Система координат

Параметр позволяет задать точный масштаб по координатам (x, y, z) относительно родительского объекта.

Доступны следующие действия:

  • img_reset3 сбросить в начальное состояние

  • img_auto3 поместить на метку автоматически (совместить габариты объекта и родительской метки)

  • img_lock зафиксировать оси (масштабировать отдельно по каждой оси, или по всем одновременно)

действие Объект - переместить

Установить новое значение перемещения объекта (параметра Перемещение)

Параметры

Перемещение – Новое значение перемещения

действие Объект - повернуть

Установить новое значение вращения объекта (параметра Вращение).

Параметры

Вращение – Новое значение вращения

действие Объект - масштабировать

Установить новое значение масштабирования объекта (параметра Масштаб).

Параметры

Масштаб – Новое значение вращения

действие Объект - преобразование

Установить новые значения перемещения, вращения и масштаба (параметров Перемещение, Вращение, Масштаб. Данный вызов равносилен последовательным вызовам Объект - переместить, Объект - повернуть, Объект - масштабировать:

transform_set_transform_image

transform_set_transform_separated_image
Равносильная конструкция