Aabb

public Aabb(Vector3 position, Vector3 size);

Создаёт Aabb из начальной вершины и полного размера. Координаты и размеры сохраняются напрямую; отрицательные компоненты не исправляются. Для бокса нулевого размера в начале координат используйте default(Aabb).

public Aabb(Vector3 position, float width, float height, float depth);

Создаёт Aabb из начальной вершины и полного размера. Координаты и размеры сохраняются напрямую; отрицательные компоненты не исправляются. Для бокса нулевого размера в начале координат используйте default(Aabb).

public Aabb(float x, float y, float z, Vector3 size);

Создаёт Aabb из начальной вершины и полного размера. Координаты и размеры сохраняются напрямую; отрицательные компоненты не исправляются. Для бокса нулевого размера в начале координат используйте default(Aabb).

public Aabb(float x, float y, float z, float width, float height, float depth);

Создаёт Aabb из начальной вершины и полного размера. Координаты и размеры сохраняются напрямую; отрицательные компоненты не исправляются. Для бокса нулевого размера в начале координат используйте default(Aabb).

public Vector3 End { get; set; }

Конечная вершина: Position + Size. Присваивание меняет только Size на value - Position; Position остаётся прежней. Значение меньше Position может создать отрицательный размер.

public Vector3 Position { get; set; }

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

public Vector3 Size { get; set; }

Полный размер по осям, а не полуразмеры: End = Position + Size. Присваивание не меняет Position и не нормализует отрицательные компоненты. Перед методами границ с отрицательным Size используйте Abs().

public float Volume { get; }

Вычисляет Size.X * Size.Y * Size.Z без нормализации и проверки знаков. Результат может быть отрицательным; две отрицательные компоненты дают положительное произведение. Для проверки положительных размеров используйте HasVolume().

public Aabb Abs();

Возвращает эквивалентный бокс с неотрицательным Size: Position становится покомпонентным минимумом прежних Position и End. Нулевой размер остаётся нулевым. Исходное значение не меняется.

public bool Encloses(Aabb with);

Проверяет полное включение with по всем трём осям. Границы включены: бокс включает самого себя и меньший бокс, касающийся его граней. Предполагается неотрицательный Size у обоих боксов.

public bool Equals(Aabb other);

Сравнивает все компоненты Position и Size точно, без допуска и нормализации. Боксы с одинаковым геометрическим объёмом, но разными Position/Size, не равны. +0 и -0 сравниваются равными; NaN-компонента делает сравнение с копией false.

public override bool Equals(object? obj);

Если obj — упакованный Aabb, сравнивает все компоненты Position и Size точно, без допуска и нормализации. Боксы с одинаковым геометрическим объёмом, но разными Position/Size, не равны. +0 и -0 сравниваются равными; NaN-компонента делает сравнение с копией false. Для null и другого типа возвращает false.

public Aabb Expand(Vector3 point);

Возвращает минимальную копию бокса, включающую прежние границы и point. Точка внутри или на границе не изменяет результат. Чтобы сохранить расширение, присвойте результат переменной; исходный Aabb не меняется.

public Vector3 GetCenter();

Вычисляет Position + Size * 0.5f. Возвращает координаты центра в той же системе координат; не применяет Transform3D объекта.

public Vector3 GetEndpoint(int idx);

Возвращает одну из восьми вершин. Бит 0 индекса выбирает End.Z, бит 1 — End.Y, бит 2 — End.X; при сброшенном бите используется Position соответствующей оси. Индекс 0 возвращает Position, индекс 7 — End. В C# индекс вне 0..7 вызывает ArgumentOutOfRangeException.

public override int GetHashCode();

Возвращает HashCode.Combine(Position, Size) для хеш-коллекций C#. Точно равные боксы имеют одинаковый хеш, но совпадение хеша не доказывает равенство. Dictionary<Aabb, T> использует точный Equals(), а не IsEqualApprox(). Не сохраняйте этот хеш как идентификатор ресурса или стабильную контрольную сумму между запусками.

public Vector3 GetLongestAxis();

Возвращает положительный единичный вектор оси с большей компонентой Size: (1, 0, 0), (0, 1, 0) или (0, 0, 1). При равенстве приоритет X, затем Y, затем Z. Выбор основан на исходных знаковых значениях, не на модулях; для отрицательных размеров сначала используйте Abs(). Это ось бокса, не направление с учётом поворота объекта.

public Vector3.Axis GetLongestAxisIndex();

Выбирает наибольшую компоненту Size и возвращает соответствующий Vector3.Axis. При равенстве приоритет X, затем Y, затем Z. Сравнивает исходные знаковые значения, не модули; отрицательные размеры сначала нормализуйте через Abs().

public float GetLongestAxisSize();

Возвращает наибольшую компоненту Size без изменения знака. Это полный размер по выбранной оси, не полуразмер и не длина диагонали. Transform3D объекта не применяется.

public Vector3 GetShortestAxis();

Возвращает положительный единичный вектор оси с меньшей компонентой Size: (1, 0, 0), (0, 1, 0) или (0, 0, 1). При равенстве приоритет X, затем Y, затем Z. Выбор основан на исходных знаковых значениях, не на модулях; для отрицательных размеров сначала используйте Abs(). Это ось бокса, не направление с учётом поворота объекта.

public Vector3.Axis GetShortestAxisIndex();

Выбирает наименьшую компоненту Size и возвращает соответствующий Vector3.Axis. При равенстве приоритет X, затем Y, затем Z. Сравнивает исходные знаковые значения, не модули; отрицательные размеры сначала нормализуйте через Abs().

public float GetShortestAxisSize();

Возвращает наименьшую компоненту Size без изменения знака. Это полный размер по выбранной оси, не полуразмер и не длина диагонали. Transform3D объекта не применяется.

public Vector3 GetSupport(Vector3 dir);

Выбирает вершину, наиболее удалённую в направлении dir, для бокса с неотрицательным Size. Для положительной компоненты dir берёт соответствующую компоненту End, иначе — Position. Нормализация направления не нужна. При нулевой компоненте несколько вершин равноценны; dir == Vector3.Zero возвращает Position.

public Aabb Grow(float by);

Возвращает копию с Position - Vector3.One * by и Size + Vector3.One * (2 * by). Отрицательное by уменьшает бокс. Ограничения снизу нет: чрезмерное уменьшение создаёт отрицательный Size; метод не зажимает его до нуля.

public bool HasPoint(Vector3 point);

Для конечных координат: Проверяет Position <= point <= End по каждой оси. Все шесть граней, рёбра и вершины включены, в том числе End. Для отрицательного Size сначала используйте Abs(). Это проверка координат бокса, а не попадания в геометрию меша. Метод не отбрасывает NaN автоматически и может вернуть true для такой точки. Проверяйте IsFinite() у прямоугольника или бокса и у входной точки отдельно.

public bool HasSurface();

Возвращает true, если хотя бы одна компонента Size больше нуля. Несмотря на название, отрезок с Size = (2, 0, 0) тоже даёт true. Метод не вычисляет площадь поверхности и не проверяет корректность остальных компонент.

public bool HasVolume();

Возвращает true, только если все три компоненты Size положительны. Плоский бокс, отрезок и точка дают false. Используйте эту проверку вместо Volume > 0: произведение двух отрицательных размеров тоже может быть положительным.

public Aabb Intersection(Aabb with);

Вычисляет общий бокс для двух боксов с неотрицательным Size. Касание сохраняется: общая грань даёт одну нулевую компоненту Size, общее ребро — две, вершина — три. При раздельных боксах возвращает default(Aabb), то есть нулевой бокс в начале координат. Поэтому один результат default не позволяет отличить отсутствие пересечения от контакта в начале координат.

public bool Intersects(Aabb with);

Сравнивает интервалы по трём осям строгими неравенствами. Для обычных боксов с положительным Size касание только гранью, ребром или вершиной даёт false. Метод не проверяет HasVolume(): вырожденный бокс внутри другого может дать true. Для требования ненулевого объёма у обоих боксов отдельно проверьте HasVolume().

public bool IntersectsPlane(Plane plane);

Проверяет расстояния восьми вершин до plane. Возвращает true, если есть хотя бы одна вершина с DistanceTo > 0 и хотя бы одна с DistanceTo <= 0. При строгом пересечении это обычный тест плоскости и бокса. При одном касании результат зависит от направления нормали: нулевое расстояние относится только к неположительной стороне. Не используйте метод как симметричную проверку касания с допуском.

public bool IntersectsSegment(Vector3 from, Vector3 to);

Проверяет конечный отрезок от from до to, включая оба конца и границу бокса. Касание грани считается пересечением. Если from == to, результат соответствует включению этой точки в бокс. Предполагается неотрицательный Size. Метод возвращает только bool, без точки попадания, нормали или расстояния.

public bool IsEqualApprox(Aabb other);

Покомпонентно сравнивает Position и Size через Mathf.IsEqualApprox(). В текущей float-SDK точное равенство принимается сразу; иначе требуется abs(a - b) < max(0.000001, 0.000001 * abs(a)), где a — компонента этого бокса. Допуск не задаётся параметром и растёт с величиной первого значения. На границе допуска порядок операндов может менять результат; проверка также не транзитивна. Не используйте её как равенство ключей Dictionary или вместо проверки конечности: одинаковые бесконечности проходят точное сравнение, NaN — нет.

public bool IsFinite();

Проверяет все шесть компонент Position и Size на NaN и бесконечность. Отрицательный или нулевой размер сам по себе даёт true: это проверка конечности чисел, а не пригодности бокса для конкретного алгоритма.

public Aabb Merge(Aabb with);

Возвращает минимальный Aabb, включающий оба исходных бокса. Это охватывающий прямоугольный объём: свободное пространство между раздельными боксами тоже входит в результат. Оба бокса должны находиться в одной системе координат и иметь неотрицательный Size. Исходные значения не меняются.

public override string ToString();

Формирует строку Position.ToString(format) + ", " + Size.ToString(format): например, (1.25, -2.5, 3), (1, 1, 1). Координаты используют InvariantCulture: десятичная точка не зависит от языка системы. Это диагностическая строка, не формат JSON или сохранения игры. Эквивалентен ToString(null).

public string ToString(string? format);

Формирует строку Position.ToString(format) + ", " + Size.ToString(format): например, (1.25, -2.5, 3), (1, 1, 1). Координаты используют InvariantCulture: десятичная точка не зависит от языка системы. Это диагностическая строка, не формат JSON или сохранения игры. Формат применяется ко всем шести числам; F2 округляет вывод до двух знаков, не изменяя бокс. Неподдерживаемый числовой формат может вызвать FormatException.

public static bool operator ==(Aabb left, Aabb right);

Точное сравнение Equals(right). Сравнивает компоненты Position и Size, без допуска, Abs() или проверки перекрытия. +0 и -0 равны. При NaN в компоненте равенство с копией false, а неравенство true.

public static bool operator !=(Aabb left, Aabb right);

Отрицание точного сравнения Equals(right). Сравнивает компоненты Position и Size, без допуска, Abs() или проверки перекрытия. +0 и -0 равны. При NaN в компоненте равенство с копией false, а неравенство true.