OpenXRPlaneTracker

public OpenXRPlaneTracker();

Создаёт принадлежащий вызывающему RefCounted tracker без запуска OpenXR, регистрации в XRServer или обнаружения. Базовое состояние Paused, категория Anchor; Entity/context RID пусты. Для реального приложения обычно используйте заимствованный tracker, зарегистрированный provider, а не synthetic ресурс. Собственный экземпляр освобождайте после удаления своих ссылок/регистрации.

public Vector2 BoundsSize { get; set; }

Размер прямоугольной границы в локальной XY-плоскости, изначально Vector2.Zero. Setter применяет изменение, только если разница хотя бы одной компоненты >0.001. Без polygon data сбрасывает кеши и испускает MeshChanged; при polygon data граница не заменяет mesh. Положительные обе компоненты нужны для прямоугольного fallback.

public OpenXRSpatialComponentPlaneAlignmentList.PlaneAlignment PlaneAlignment { get; set; }

Metadata ориентации плоскости, по умолчанию HorizontalUpward даже без данных детектора. Setter сохраняет значение без геометрического поворота и без MeshChanged. Не выводите из этого значения наличие пола, tracking или реальную классификацию runtime.

public string PlaneLabel { get; set; }

Семантическая метка плоскости либо пустая строка при отсутствии данных. Setter также копирует строку в Description трекера; не перестраивает mesh/shape и не испускает MeshChanged. Не считайте пустую/незнакомую метку полом; поддержка меток зависит от runtime.

public void ClearMeshData();

Сбрасывает polygon vertices/indices, origin и кеши mesh/shape, сохраняя BoundsSize. Поэтому следующий GetMesh/GetShape может вернуть прямоугольный fallback, а не null. MeshChanged испускается только если polygon data действительно были; после явного сброса обновите свои mesh/collider независимо от события.

public Vector2 GetBoundsSize();

Размер прямоугольной границы в локальной XY-плоскости, изначально Vector2.Zero. Setter применяет изменение, только если разница хотя бы одной компоненты >0.001. Без polygon data сбрасывает кеши и испускает MeshChanged; при polygon data граница не заменяет mesh. Положительные обе компоненты нужны для прямоугольного fallback.

public int[] GetIndices();

Сохранённые triangle indices либо пустой массив. После SetMeshData без indices содержит сгенерированный fan, не исходный контур; прямоугольный fallback список не заполняет. C# int[] — данные для чтения/копирования, не редактирование tracker на месте.

public Mesh GetMesh();

Лениво создаёт и кеширует mesh из polygon data или положительных BoundsSize; при отсутствии обоих null. Геометрия в локальной XY, не world space; отдельно примените GetMeshOffset. Возвращённая обёртка заимствованная: не Dispose. MeshChanged требует обновить собственный MeshInstance3D.Mesh; setter tracker не обновит вашу Entity автоматически.

public Transform3D GetMeshOffset();

Transform геометрии относительно default pose: для polygon data inverse(raw pose) × mesh origin, затем translation умножается на WorldScale. Без polygon data — Identity. Применяйте к общему дочернему Entity3D для mesh/collider. Origin-only обновление может не дать MeshChanged: читайте offset каждый кадр при валидном tracking. Проверка ограничена WorldScale=1.

public OpenXRSpatialComponentPlaneAlignmentList.PlaneAlignment GetPlaneAlignment();

Metadata ориентации плоскости, по умолчанию HorizontalUpward даже без данных детектора. Setter сохраняет значение без геометрического поворота и без MeshChanged. Не выводите из этого значения наличие пола, tracking или реальную классификацию runtime.

public string GetPlaneLabel();

Семантическая метка плоскости либо пустая строка при отсутствии данных. Setter также копирует строку в Description трекера; не перестраивает mesh/shape и не испускает MeshChanged. Не считайте пустую/незнакомую метку полом; поддержка меток зависит от runtime.

public Shape3D GetShape(float thickness = 0.01f);

Лениво создаёт и кеширует Shape3D: polygon data дают ConcavePolygonShape3D, положительные BoundsSize — BoxShape3D; иначе null. Заимствованная обёртка, не Dispose. thickness по умолчанию 0.01, задавайте положительное конечное значение. Если shape уже кеширована, другая thickness не перестраивает её; очистите/обновите данные или создайте собственную форму. Сам getter не включает collision.

public Vector2[] GetVertices();

Сохранённые polygon vertices в локальной XY, либо пустой массив; прямоугольный fallback не заполняет этот список. C# getter возвращает Vector2[]-копию: её изменение не редактирует tracker. Для обновления используйте SetMeshData.

public void SetBoundsSize(Vector2 boundsSize);

Размер прямоугольной границы в локальной XY-плоскости, изначально Vector2.Zero. Setter применяет изменение, только если разница хотя бы одной компоненты >0.001. Без polygon data сбрасывает кеши и испускает MeshChanged; при polygon data граница не заменяет mesh. Положительные обе компоненты нужны для прямоугольного fallback.

public void SetMeshData(Transform3D origin, Vector2[] vertices, int[] indices = null);

Назначает локальные XY vertices, transform их origin и triangle indices. Нужны >=3 vertices; меньшее число очищает имеющиеся polygon data. Пустые indices дают fan от вершины 0, поэтому для вогнутого контура передавайте собственную корректную триангуляцию. Проверяйте индексы и кратность трём самостоятельно. Изменение геометрии сбрасывает mesh/shape и испускает MeshChanged; только новый origin при прежних массивах события не даёт.

public void SetMeshData(Transform3D origin, ReadOnlySpan<Vector2> vertices, ReadOnlySpan<int> indices);

Назначает локальные XY vertices, transform их origin и triangle indices. Нужны >=3 vertices; меньшее число очищает имеющиеся polygon data. Пустые indices дают fan от вершины 0, поэтому для вогнутого контура передавайте собственную корректную триангуляцию. Проверяйте индексы и кратность трём самостоятельно. Изменение геометрии сбрасывает mesh/shape и испускает MeshChanged; только новый origin при прежних массивах события не даёт.

public void SetPlaneAlignment(OpenXRSpatialComponentPlaneAlignmentList.PlaneAlignment planeAlignment);

Metadata ориентации плоскости, по умолчанию HorizontalUpward даже без данных детектора. Setter сохраняет значение без геометрического поворота и без MeshChanged. Не выводите из этого значения наличие пола, tracking или реальную классификацию runtime.

public void SetPlaneLabel(string planeLabel);

Семантическая метка плоскости либо пустая строка при отсутствии данных. Setter также копирует строку в Description трекера; не перестраивает mesh/shape и не испускает MeshChanged. Не считайте пустую/незнакомую метку полом; поддержка меток зависит от runtime.

public event Action MeshChanged;

Сигнал изменения геометрии/части кешей; заново назначьте mesh/shape своим визуальным и физическим Entity. Не сообщает обо всех metadata и origin-only изменениях. GetMeshOffset обновляйте отдельно при валидном tracking; не предполагайте один сигнал на каждую операцию.