Расстояние¶

Расстояние¶

Вводится в Расстояние (DistanceReactor)

параметр Первый объект¶

параметр firstNodeReactor¶

Параметр позволяет выбрать первый объект для расчёта расстояния. Это может быть, например, система координат, метка, текст, модель и т.д.

параметр Второй объект¶

параметр secondNodeReactor¶

Аналогично параметру Первый объект (firstNodeReactor).

Расчет расстояния¶

действие Рассчитать расстояние¶

действие updateState()¶

Единственное действие объекта. Рассчитывает расстояние между выбранными объектами. При каждом вызове запускаются все события, удовлетворяющие текущемму расстоянию. Подробнее, см. Анализ расстояния.

Анализ расстояния¶

Очень часто во время использования приложения с дополненной реальностью оптический трекинг работает в неидеальных условиях: может дрожать рука со смартфоном или веб камерой, меняться освещение, метки перемещаются по поверхности. Все это не позволяет рассчитывать расстояние в реальном времени со стопроцентной точностью. В связи c этим некоторые события имеют параметры для указания погрешности вычислений для более стабильной и плавной работы приложения.

событие Равно¶

событие onEqual()¶

Приходит, когда расстояние равно заданному значению.

Параметры:	Значение / value – расстояние. Погрешность / measurementError – погрешность (радиус окрестности указанного значения).

событие Неравно¶

событие onNotEqual()¶

Приходит, когда расстояние не равно заданному значению

Параметры:	Значение / value – расстояние. Погрешность / measurementError – погрешность (радиус окрестности указанного значения).

События Равно (onEqual) и Неравно (onNotEqual) приходят, если текущее расстояние находится в пределах от Значение - Погрешность до Значение + Погрешность. На рисунке эта область обозначена оранжевым штрихом.

событие Больше чем¶

событие onGreater()¶

Приходит, когда расстояние больше заданного значения.

Параметры:	Значение / value – расстояние.

событие Меньше чем¶

событие onLess()¶

Приходит, когда расстояние меньше заданного значения.

Параметры:	Значение / value – расстояние.

событие Принадлежит отрезку¶

событие onInsideSegment()¶

Приходит, когда расстояние принадлежит заданному отрезку (включая его границы).

Параметры:	От / valueFrom – левая граница отрезка. До / valueTo – правая граница отрезка.

событие Не принадлежит отрезку¶

событие onOutsideSegment()¶

Приходит, когда расстояние не принадлежит заданному отрезку.

Параметры:	От / valueFrom – левая граница отрезка. До / valueTo – правая граница отрезка.

События Равно (onEqual), Неравно (onNotEqual), Больше чем (onGreater), Меньше чем (onLess), Принадлежит отрезку (onInsideSegment) и Не принадлежит отрезку (onOutsideSegment) приходят при каждом вызове Рассчитать расстояние (updateState), если текущее расстояние удовлетворяет указанным в событиях параметрам. Например, в следующем сценарии событие Больше чем (onGreater) будет запускаться на каждом кадре (обычно, 60 раз в секунду!), если текущее расстояние будет больше 15 сантиметров:

событие Объекты отдалились¶

событие onMovedAside()¶

Приходит, когда расстояние становится больше заданного.

Параметры:	Значение / value – значение, при котором приходит событие. Отклонение / minDeviation – величина, определяющая, на какой минимальное расстояние должны сблизиться два объекта, чтобы указанное событие пришло вновь (рассчитывается, как value - minDeviation).

событие Объекты сблизились¶

событие onMovedCloser()¶

Приходит, когда расстояние становится меньше заданного.

Параметры:	Значение / value – значение, при котором приходит событие. Отклонение / minDeviation – величина, определяющая, на какое максимальное расстояние должны отдалиться два объекта, чтобы указанное событие пришло вновь (рассчитывается, как value + minDeviation).

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