Расстояние¶
Содержание
- объект Расстояние¶
Расстояние позволяет измерять расстояние между различными объектами в сцене, например, между двумя метками. Объекты, между которыми рассчитывается расстояние, должны поддерживать интерфейс node.transform
.
Примечание
Расстояние имеет смысл измерять только когда оба объекта в поле зрения камеры. В противном случае рассчитанное расстояние неопределено.
Примечание
Все значения, касаемые расстояния, указываются в метрах, если явно не оговорено иное.

При своей работе расстояние вызывает различные события, соответствующие различным условиям на расстояние: Больше чем, Меньше чем, Принадлежит отрезку и т.п.
Расстояние¶
Вводится в Расстояние
Параметр |
Описание |
---|---|
Первый объект для расчёта. |
|
Второй объект для расчёта. |
- параметр Первый объект¶
Параметр позволяет выбрать первый объект для расчёта расстояния. Это может быть, например, система координат, метка, текст, модель и т.д.
- параметр Второй объект¶
Аналогично параметру Первый объект.
Расчет расстояния¶
- действие Рассчитать расстояние¶
Единственное действие объекта. Рассчитывает расстояние между выбранными объектами. При каждом вызове запускаются все события, удовлетворяющие текущемму расстоянию. Подробнее, см. Анализ расстояния.
Анализ расстояния¶
Событие |
Описание |
---|---|
Приходит, когда расстояние равно заданному значению. |
|
Приходит, когда расстояние не равно заданному значению |
|
Приходит, когда расстояние больше заданного значения. |
|
Приходит, когда расстояние меньше заданного значения. |
|
Приходит, когда расстояние принадлежит заданному отрезку. |
|
Приходит, когда расстояние не принадлежит заданному отрезку. |
|
Приходит, когда расстояние становится больше заданного. |
|
Приходит, когда расстояние становится меньше заданного. |
Очень часто во время использования приложения с дополненной реальностью оптический трекинг работает в неидеальных условиях: может дрожать рука со смартфоном или веб камерой, меняться освещение, метки перемещаются по поверхности. Все это не позволяет рассчитывать расстояние в реальном времени со стопроцентной точностью. В связи c этим некоторые события имеют параметры для указания погрешности вычислений для более стабильной и плавной работы приложения.
- событие Равно¶
Приходит, когда расстояние равно заданному значению.
- Параметры
Значение – расстояние.
Погрешность – погрешность (радиус окрестности указанного значения).
- событие Неравно¶
Приходит, когда расстояние не равно заданному значению
- Параметры
Значение – расстояние.
Погрешность –
погрешность (радиус окрестности указанного значения).
События Равно и Неравно приходят, если текущее расстояние находится в пределах от Значение - Погрешность
до Значение + Погрешность
. На рисунке эта область обозначена оранжевым штрихом.

- событие Больше чем¶
Приходит, когда расстояние больше заданного значения.
- Параметры
Значение – расстояние.
- событие Меньше чем¶
Приходит, когда расстояние меньше заданного значения.
- Параметры
Значение – расстояние.
- событие Принадлежит отрезку¶
Приходит, когда расстояние принадлежит заданному отрезку (включая его границы).
- Параметры
От – левая граница отрезка.
До – правая граница отрезка.
Примечание
Если расстояние равно граничным значениям, событие приходит.
- событие Не принадлежит отрезку¶
Приходит, когда расстояние не принадлежит заданному отрезку.
- Параметры
От – левая граница отрезка.
До – правая граница отрезка.
Примечание
Если расстояние равно граничным значениям, событие не приходит.
События Равно, Неравно, Больше чем, Меньше чем, Принадлежит отрезку и Не принадлежит отрезку приходят при каждом вызове Рассчитать расстояние, если текущее расстояние удовлетворяет указанным в событиях параметрам. Например, в следующем сценарии событие Больше чем будет запускаться на каждом кадре (обычно, 60 раз в секунду!), если текущее расстояние будет больше 15 сантиметров:

- событие Объекты отдалились¶
Приходит, когда расстояние становится больше заданного.
- Параметры
Значение – значение, при котором приходит событие.
Отклонение – величина, определяющая, на какой минимальное расстояние должны сблизиться два объекта, чтобы указанное событие пришло вновь (рассчитывается, как value - minDeviation).
- событие Объекты сблизились¶
Приходит, когда расстояние становится меньше заданного.
- Параметры
Значение – значение, при котором приходит событие.
Отклонение – величина, определяющая, на какое максимальное расстояние должны отдалиться два объекта, чтобы указанное событие пришло вновь (рассчитывается, как value + minDeviation).
События Объекты отдалились и Объекты сблизились запускаются, если текущее расстояние между двумя объектами соответсвенно больше или меньше заданного. Так как объекты практически никогда не находятся в состоянии абсолютного покоя, расстояние между ними может постоянно колебаться и постоянно пересекать заданные значения. Чтобы этого не происходило, необходимо задать параметр «Отклонение». Он определяет разницу между текущим расстоянием и расстоянием, заданным параметром «Значение», до преодоления которой событие повторно не придет.