Bitmap

public Bitmap();

Создаёт собственный Resource с размером (0, 0) и без выделенных ячеек. Перед работой вызовите Create/CreateFromImageAlpha; после работы Dispose.

public Reckfell.Collections.Dictionary Data { get; set; }

Внутренний Dictionary с ключами size (Vector2I) и data (byte[]). Getter создаёт словарь со снимком битовых данных; setter сначала Create(size), затем заменяет байты без проверки их длины и хвостовых битов. Используйте только корректное представление, созданное этим runtime; повреждённое содержимое может сделать последующие операции небезопасными. Getter-словарь освобождайте после использования.

public Image ConvertToImage();

Создаёт отдельный Image того же размера, L8 без mipmaps. true → белый, false → чёрный, альфа непрозрачна в обоих случаях. Не обновляет ранее созданный Image и не создаёт GPU-текстуру. Маска должна быть выделена; собственный результат освобождайте через Dispose.

public void Create(Vector2I size);

Заменяет размер и очищает все биты, включая прежнее содержимое при том же размере. Обе стороны должны быть положительными; произведение не больше Int32.MaxValue. Не испускает Changed.

public void CreateFromImageAlpha(Image image, float threshold = 0.1f);

Заменяет маску размером изображения. Копия Image преобразуется в LA8; бит true только при alpha/255 > threshold. Источник не изменяется, яркость RGB не влияет. Нужен непустой Image с поддерживаемым преобразованием формата.

public bool GetBit(int x, int y);

Читает один бит по x/y. Допустимы только координаты внутри маски; выход за пределы диагностируется и возвращает false, поэтому false сам по себе не доказывает корректность координат.

public bool GetBitv(Vector2I position);

То же чтение, что GetBit, с координатами Vector2I. Не выполняет обрезку или циклическое отображение координат.

public Vector2I GetSize();

Возвращает ширину и высоту в ячейках. Новый ресурс без Create имеет размер (0, 0).

public int GetTrueBitCount();

Считает установленные биты. Для корректного представления это число занятых ячеек. Реализация считает все байты, включая хвостовые биты последнего байта: произвольный Data может нарушить этот смысл.

public void GrowMask(int pixels, Rect2I rect);

Положительный pixels расширяет true-области, отрицательный сужает, 0 ничего не меняет. Круговая окрестность читается из исходного снимка, без каскадного роста внутри вызова. При эрозии пространство вне rect считается false; ячейки вне rect не меняются. Передавайте rect внутри маски и разумный радиус: большой радиус дорог, крайние int не поддержаны этим обзором.

public Reckfell.Collections.Array<Vector2[]> OpaqueToPolygons(Rect2I rect, float epsilon = 2f);

Ищет контуры true-ячеек в пересечении rect с маской методом marching squares, затем упрощает RDP. Вершины относительны позиции пересечения, не исходной маске. Пустая область даёт пустой массив; контуры с менее чем тремя вершинами пропускаются. Для контуров от 9 вершин epsilon ограничивается диапазоном 0…половина меньшей стороны области; меньшие обходят RDP. Результат не создаёт коллизию автоматически.

public void Resize(Vector2I newSize);

Масштабирует маску ближайшим соседом: исходная ячейка выбирается усечением xoldWidth/newWidth и yoldHeight/newHeight. Это не добавление пустых строк/столбцов. Тот же размер ничего не меняет; используйте положительные стороны. Нулевой размер не является безопасным способом очистки.

public void SetBit(int x, int y, bool bit);

Устанавливает или сбрасывает ячейку. Координаты должны быть внутри маски; неверные диагностируются без записи. Resource.Changed автоматически не испускается.

public void SetBitRect(Rect2I rect, bool bit);

Заполняет пересечение rect с границами маски значением bit. Правая/нижняя границы исключены; непересекающаяся область ничего не меняет. Это заполнение, а не переключение битов.

public void SetBitv(Vector2I position, bool bit);

То же изменение, что SetBit, с координатами Vector2I. Не меняет размер маски.