Get Extent
ARPlaneGeometryЧто это
Pure-функция, возвращает экстент (размер) обнаруженной AR‑плоскости в локальном пространстве. Экстент представлен вектором (Vector) и описывает габариты плоскости. Функция не имеет exec-пинов (pure).
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (ARPlaneGeometry Object) — ссылка на геометрию плоскости, из которой извлекается экстент.
Выходы (данные):
- ReturnValue (Vector) — экстент плоскости в локальных координатах.
Когда используется
При работе с AR‑плоскостями: для определения размеров плоскости перед размещением объектов, для проверки попадания точки в границы плоскости, для масштабирования контента относительно реальной поверхности.
Типичные проблемы
- Локальные vs мировые координаты: экстент задан в локальной системе плоскости; для использования в мировом пространстве требуется трансформация.
- Валидность плоскости: если плоскость не обнаружена или потеряно отслеживание, вызов может вернуть нулевой вектор. Рекомендуется проверять состояние плоскости перед чтением экстента.
- Интерпретация значения: на разных платформах (ARKit, ARCore) экстент может означать половину или полный размер плоскости — уточняйте поведение для целевой платформы.