Rect2I

public Rect2I(Vector2I position, Vector2I size);

Создаёт прямоугольник из Position и полного Size, а не из двух углов. Значения сохраняются напрямую: отрицательные размеры не нормализуются. default(Rect2I) имеет нулевую позицию и размер.

public Rect2I(Vector2I position, int width, int height);

Создаёт прямоугольник из Position и полного Size, а не из двух углов. Значения сохраняются напрямую: отрицательные размеры не нормализуются. default(Rect2I) имеет нулевую позицию и размер.

public Rect2I(int x, int y, Vector2I size);

Создаёт прямоугольник из Position и полного Size, а не из двух углов. Значения сохраняются напрямую: отрицательные размеры не нормализуются. default(Rect2I) имеет нулевую позицию и размер.

public Rect2I(int x, int y, int width, int height);

Создаёт прямоугольник из Position и полного Size, а не из двух углов. Значения сохраняются напрямую: отрицательные размеры не нормализуются. default(Rect2I) имеет нулевую позицию и размер.

public int Area { get; }

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

public Vector2I End { get; set; }

Конечная вершина Position + Size. Присваивание меняет Size на value - Position, не меняя Position. HasPoint() исключает правую и нижнюю границы с этими координатами.

public Vector2I Position { get; set; }

Начальная вершина. Присваивание сохраняет Size и переносит End на ту же величину. Система координат выбирается вызывающим кодом.

public Vector2I Size { get; set; }

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

public Rect2I Abs();

Возвращает копию с Position = покомпонентный минимум прежних Position и End и Size = модуль прежнего Size. Нулевые компоненты остаются нулевыми. Исходное значение не меняется. Size с int.MinValue вызывает OverflowException; также избегайте переполнения Position + Size.

public bool Encloses(Rect2I b);

Проверяет полное включение Position и End прямоугольника b с включёнными границами. Равный прямоугольник включён; нулевой прямоугольник на End тоже может быть включён, хотя HasPoint(End) возвращает false. Это разные проверки. Используйте неотрицательные размеры обоих прямоугольников.

public bool Equals(Rect2I other);

Сравнивает Position и Size точно, без нормализации, допуска или проверки перекрытия.

public override bool Equals(object? obj);

Сравнивает Position и Size точно, без нормализации, допуска или проверки перекрытия. Для obj принимается только упакованный Rect2I; null и другой тип дают false.

public Rect2I Expand(Vector2I to);

Возвращает минимальную копию, границы которой охватывают прежние границы и to. Если точка расширяет правую или нижнюю сторону, она становится частью End и всё ещё исключена HasPoint(). Метод не добавляет запас автоматически. Для включения целой ячейки используйте Merge(new Rect2I(to, Vector2I.One)), предварительно обеспечив отсутствие переполнения to + Vector2I.One.

public Vector2I GetCenter();

Вычисляет Position + Size / 2: сначала делит компоненты Size целочисленно с отбрасыванием дробной части к нулю, затем прибавляет Position. Для нечётного положительного размера центр смещён к Position, даже при отрицательных координатах. Например, Position.X = -10 и Size.X = 3 дают -9.

public override int GetHashCode();

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

public Rect2I Grow(int by);

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

public Rect2I GrowIndividual(int left, int top, int right, int bottom);

Возвращает копию с Position = Position - (left, top) и Size = Size + (left + right, top + bottom). Порядок аргументов: слева, сверху, справа, снизу. Отрицательный отступ уменьшает область. Ограничения до нуля нет: чрезмерное уменьшение создаёт отрицательный Size.

public Rect2I GrowSide(Side side, int by);

Возвращает копию, изменяя только сторону Side.Left, Side.Top, Side.Right или Side.Bottom. Для левой и верхней стороны меняется также Position. Неизвестное значение Side оставляет копию прежней. Отрицательный отступ уменьшает область. Ограничения до нуля нет: чрезмерное уменьшение создаёт отрицательный Size.

public bool HasArea();

Возвращает Size.X > 0 && Size.Y > 0. Это проверка положительных размеров; Area > 0 не заменяет её при отрицательных компонентах.

public bool HasPoint(Vector2I point);

Проверяет Position.X <= point.X < End.X и Position.Y <= point.Y < End.Y. Левая и верхняя границы включены, правая и нижняя исключены. При нулевой ширине или высоте точек внутри нет. Для отрицательного Size сначала вызовите Abs().

public Rect2I Intersection(Rect2I b);

Сначала вызывает Intersects(b) с его обычными правилами, затем обрезает общие границы. При раздельных прямоугольниках и простом касании положительных прямоугольников возвращает default(Rect2I), то есть нулевой прямоугольник в начале координат. Место касания в этом результате не сохраняется. Нормализуйте отрицательные размеры через Abs() до вызова.

public bool Intersects(Rect2I b);

Проверяет интервалы по X и Y. Для положительных размеров касание только стороной или углом даёт false. У этой перегрузки нет includeBorders. Проверки HasArea() внутри нет: вырожденный прямоугольник строго внутри другого может дать true. Оба прямоугольника должны иметь неотрицательный Size и одну систему координат.

public Rect2I Merge(Rect2I b);

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

public override string ToString();

Возвращает Position.ToString(format) + ", " + Size.ToString(format), с двумя векторами в круглых скобках. Числа используют InvariantCulture. Это диагностический текст, не формат сохранения или JSON. Эквивалентен ToString(null).

public string ToString(string? format);

Возвращает Position.ToString(format) + ", " + Size.ToString(format), с двумя векторами в круглых скобках. Числа используют InvariantCulture. Это диагностический текст, не формат сохранения или JSON. Формат применяется ко всем четырём компонентам; неверный формат может вызвать FormatException.

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

Сравнивает Position и Size точно, без нормализации, допуска или проверки перекрытия.

public static explicit operator Rect2I(Rect2 value);

Преобразует Rect2 в Rect2I, отдельно отбрасывая дробные части Position и Size к нулю. Например, (-1.9, 1.9), (2.9, 3.9) превращается в (-1, 1), (2, 3). Это не округление End и не построение охватывающего набора пикселей. Используйте конечные значения, представимые в int.

public static implicit operator Rect2(Rect2I value);

Преобразует Position и Size из int в float и создаёт Rect2. Преобразование не требует явного приведения, но большие целые могут терять точность: 16777217 в текущей float-SDK становится 16777216. Обратное преобразование не обязано восстановить исходные координаты.

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

Сравнивает Position и Size точно, без нормализации, допуска или проверки перекрытия. Оператор != возвращает отрицание этого сравнения.