AStarGrid2D

public AStarGrid2D();

Создаёт пустую сетку. Задайте Region, CellSize/Offset/CellShape, вызовите Update, затем примените препятствия и веса. Соединения соседних клеток создаются алгоритмом, ConnectPoints не нужен. Собственный RefCounted-экземпляр освобождайте через Dispose.

public AStarGrid2D.CellShapeEnum CellShape { get; set; }

Выбирает Square, IsometricRight или IsometricDown для преобразования ID в позиции. Изменение требует Update. Изометрическое отображение не строит коллизии и не меняет ID или правило соседства DiagonalMode. Значение Max — граница enum, не форма.

public Vector2 CellSize { get; set; }

Масштаб геометрического отображения ID в Vector2. Для Square позиция = Offset + Vector2(id) * CellSize; ID не отсчитывается от начала Region. Изменение требует Update со сбросом cell overrides. Стандартные стоимости используют ID, поэтому этот масштаб не задаёт стоимость пути в мировых единицах. Передавайте конечный осмысленный размер.

public AStarGrid2D.Heuristic DefaultComputeHeuristic { get; set; }

Формула базовой стоимости перехода без _ComputeCost override. Работает по разности целочисленных ID: Euclidean=sqrt(dx²+dy²), Manhattan=dx+dy, Octile=max(dx,dy)+(sqrt(2)−1)*min(dx,dy), Chebyshev=max(dx,dy). Не зависит от CellSize/Offset. При обычном поиске ещё умножается на вес назначения. Меняется без Update.

public AStarGrid2D.Heuristic DefaultEstimateHeuristic { get; set; }

Формула оценки оставшейся стоимости без _EstimateCost override; не фактическая плата за переход. Должна не завышать и быть согласована с перемещениями и весами. Manhattan подходит 4-направленной сетке; не выбирайте его автоматически для дешёвых диагоналей. Веса <1/custom costs могут потребовать собственного return 0. Меняется без Update.

public AStarGrid2D.DiagonalModeEnum DiagonalMode { get; set; }

Правило диагоналей, меняется без Update: Always разрешает срезать угол даже между двумя solid-соседями; Never оставляет 4 направления; AtLeastOneWalkable требует хотя бы одну свободную боковую клетку; OnlyIfNoObstacles — обе. Диагональная целевая клетка всегда должна быть свободна. Это клеточное правило, не проверка радиуса персонажа.

public bool JumpingEnabled { get; set; }

Включает Jump Point Search без перестройки. В 1.0.0 эта ветка игнорирует weight_scale: дорогие клетки могут перестать обходиться. Результат может содержать только jump-точки без промежуточных соседних клеток; не считайте соседние элементы массива обязательно смежными. Используйте для подходящей однородной сетки; ускорение не гарантировано для любого случая.

public Vector2 Offset { get; set; }

Смещение выдаваемых Vector2-позиций, а не ID клеток или границ Region. Изменение помечает dirty. После Update позиции пересчитаются, solid/веса будут сброшены. Приблизительно равное значение может не пометить dirty.

public Rect2I Region { get; set; }

Прямоугольник целочисленных ID клеток: начало включено, конец исключён; начало может быть отрицательным. Размеры должны быть ≥0. Изменение помечает сетку dirty; перед доступом к клеткам/путям нужен Update. Перестройка сбросит solid и weight_scale: применяйте их после Update.

public Vector2I Size { get; set; }

Устаревшее C# свойство размера Region без управления его началом; используйте Region. Это не размер пикселя клетки. Запись изменённого размера требует Update и теряет cell overrides при перестройке.

public void Clear();

Очищает точки и делает Region пустым; не возвращает все настройки к defaults. Offset, CellSize и политики поиска сохраняются. Для новой карты задайте новый непустой Region, вызовите Update и снова нанесите препятствия/веса. Не используйте Clear как сброс только препятствий.

public void FillSolidRegion(Rect2I region, bool solid = true);

В готовой сетке ставит solid для пересечения переданного прямоугольника с Region; конец исключён. Клетки вне пересечения не меняются. Не требует Update; последующая dirty-перестройка сбросит значения. Пустое пересечение ничего не меняет.

public void FillWeightScaleRegion(Rect2I region, float weightScale);

Задаёт одинаковый конечный вес ≥0 клеткам пересечения с Region; не помечает dirty. Это не добавление к старому весу. В jumping-режиме веса игнорируются, при dirty Update сбрасываются в 1.

public AStarGrid2D.CellShapeEnum GetCellShape();

Читает текущее CellShape; ничего не перестраивает. Выбирает Square, IsometricRight или IsometricDown для преобразования ID в позиции. Изменение требует Update. Изометрическое отображение не строит коллизии и не меняет ID или правило соседства DiagonalMode. Значение Max — граница enum, не форма.

public Vector2 GetCellSize();

Читает текущее CellSize; ничего не перестраивает. Масштаб геометрического отображения ID в Vector2. Для Square позиция = Offset + Vector2(id) * CellSize; ID не отсчитывается от начала Region. Изменение требует Update со сбросом cell overrides. Стандартные стоимости используют ID, поэтому этот масштаб не задаёт стоимость пути в мировых единицах. Передавайте конечный осмысленный размер.

public AStarGrid2D.Heuristic GetDefaultComputeHeuristic();

Читает текущее DefaultComputeHeuristic; ничего не перестраивает. Формула базовой стоимости перехода без _ComputeCost override. Работает по разности целочисленных ID: Euclidean=sqrt(dx²+dy²), Manhattan=dx+dy, Octile=max(dx,dy)+(sqrt(2)−1)*min(dx,dy), Chebyshev=max(dx,dy). Не зависит от CellSize/Offset. При обычном поиске ещё умножается на вес назначения. Меняется без Update.

public AStarGrid2D.Heuristic GetDefaultEstimateHeuristic();

Читает текущее DefaultEstimateHeuristic; ничего не перестраивает. Формула оценки оставшейся стоимости без _EstimateCost override; не фактическая плата за переход. Должна не завышать и быть согласована с перемещениями и весами. Manhattan подходит 4-направленной сетке; не выбирайте его автоматически для дешёвых диагоналей. Веса <1/custom costs могут потребовать собственного return 0. Меняется без Update.

public AStarGrid2D.DiagonalModeEnum GetDiagonalMode();

Читает текущее DiagonalMode; ничего не перестраивает. Правило диагоналей, меняется без Update: Always разрешает срезать угол даже между двумя solid-соседями; Never оставляет 4 направления; AtLeastOneWalkable требует хотя бы одну свободную боковую клетку; OnlyIfNoObstacles — обе. Диагональная целевая клетка всегда должна быть свободна. Это клеточное правило, не проверка радиуса персонажа.

public Reckfell.Collections.Array<Vector2I> GetIdPath(Vector2I fromId, Vector2I toId);

Возвращает клеточные ID от начала к концу, включая endpoints. Сетка должна быть clean, оба ID — в Region, даже для partial. Solid start даёт пустой результат, свободный fromId==toId — один ID. При недостижимой/solid цели partial=false даёт пустой массив; true может закончить на достигнутом кандидате. Проверяйте последний ID перед объявлением достижения. Jumping может опускать промежуточные клетки. Не запускайте параллельные поиски/изменения на одном экземпляре.

public Reckfell.Collections.Array<Vector2I> GetIdPath(Vector2I fromId, Vector2I toId, bool allowPartialPath = false);

Возвращает клеточные ID от начала к концу, включая endpoints. Сетка должна быть clean, оба ID — в Region, даже для partial. Solid start даёт пустой результат, свободный fromId==toId — один ID. При недостижимой/solid цели partial=false даёт пустой массив; true может закончить на достигнутом кандидате. Проверяйте последний ID перед объявлением достижения. Jumping может опускать промежуточные клетки. Не запускайте параллельные поиски/изменения на одном экземпляре.

public Vector2 GetOffset();

Читает текущее Offset; ничего не перестраивает. Смещение выдаваемых Vector2-позиций, а не ID клеток или границ Region. Изменение помечает dirty. После Update позиции пересчитаются, solid/веса будут сброшены. Приблизительно равное значение может не пометить dirty.

public Reckfell.Collections.Array<Reckfell.Collections.Dictionary> GetPointDataInRegion(Rect2I region);

Возвращает новые Dictionary для пересечения с Region: id:Vector2I, position:Vector2, solid:bool, weight_scale:float. Сетка должна быть готова. Изменение Dictionary не меняет сетку. Полученные собственные Dictionary wrappers освобождайте после использования; типизированный Array не имеет Dispose.

public Vector2[] GetPointPath(Vector2I fromId, Vector2I toId);

Возвращает Vector2-позиции найденного пути; условия и partial-правила те же, что GetIdPath. Геометрия берётся из CellSize/Offset/CellShape, а не из Entity transforms. Это не сглаживание, физическая проходимость или управление персонажем. Jumping может пропускать промежуточные клетки; массив — независимый снимок.

public Vector2[] GetPointPath(Vector2I fromId, Vector2I toId, bool allowPartialPath = false);

Возвращает Vector2-позиции найденного пути; условия и partial-правила те же, что GetIdPath. Геометрия берётся из CellSize/Offset/CellShape, а не из Entity transforms. Это не сглаживание, физическая проходимость или управление персонажем. Jumping может пропускать промежуточные клетки; массив — независимый снимок.

public Vector2 GetPointPosition(Vector2I id);

Возвращает рассчитанную Vector2-позицию готовой клетки. Для Square это Offset + Vector2(id) * CellSize, без вычитания Region.Position; изометрические формы используют половину размера и преобразованные оси. Это не автоматическая world-позиция Entity.

public float GetPointWeightScale(Vector2I id);

Читает сохранённый вес готовой клетки. Значение не доказывает, что jumping-поиск его учитывает. Dirty/неверный ID даёт диагностику и нулевой fallback.

public Rect2I GetRegion();

Читает текущее Region; ничего не перестраивает. Прямоугольник целочисленных ID клеток: начало включено, конец исключён; начало может быть отрицательным. Размеры должны быть ≥0. Изменение помечает сетку dirty; перед доступом к клеткам/путям нужен Update. Перестройка сбросит solid и weight_scale: применяйте их после Update.

public Vector2I GetSize();

Читает только Region.Size. Метод SDK не помечен Obsolete, хотя свойство Size помечено; для нового кода читайте Region.Size. Не возвращает CellSize и не перестраивает сетку.

public bool IsDirty();

Сообщает, что геометрия изменена и нужен Update. false не означает непустую/проходимую сетку: новый экземпляр имеет пустой Region и dirty=false. IsInBounds проверяет Region, но не готовность клеточных данных.

public bool IsInBounds(int x, int y);

Проверяет x/y по текущему Region с исключённой конечной границей. Не проверяет solid, достижимость, dirty или наличие уже перестроенных данных.

public bool IsInBoundsv(Vector2I id);

Та же проверка Region, что IsInBounds, с ID Vector2I. Попадание в Region не разрешает обращаться к dirty-сетке до Update.

public bool IsJumpingEnabled();

Читает текущее JumpingEnabled; ничего не перестраивает. Включает Jump Point Search без перестройки. В 1.0.0 эта ветка игнорирует weight_scale: дорогие клетки могут перестать обходиться. Результат может содержать только jump-точки без промежуточных соседних клеток; не считайте соседние элементы массива обязательно смежными. Используйте для подходящей однородной сетки; ускорение не гарантировано для любого случая.

public bool IsPointSolid(Vector2I id);

Читает препятствие готовой клетки в Region. При dirty или неверном ID нативный fallback false сопровождается ошибкой: это не доказательство проходимости. Проверяйте IsDirty и IsInBoundsv до вызова.

public void SetCellShape(AStarGrid2D.CellShapeEnum cellShape);

Устанавливает CellShape. Выбирает Square, IsometricRight или IsometricDown для преобразования ID в позиции. Изменение требует Update. Изометрическое отображение не строит коллизии и не меняет ID или правило соседства DiagonalMode. Значение Max — граница enum, не форма.

public void SetCellSize(Vector2 cellSize);

Устанавливает CellSize. Масштаб геометрического отображения ID в Vector2. Для Square позиция = Offset + Vector2(id) * CellSize; ID не отсчитывается от начала Region. Изменение требует Update со сбросом cell overrides. Стандартные стоимости используют ID, поэтому этот масштаб не задаёт стоимость пути в мировых единицах. Передавайте конечный осмысленный размер.

public void SetDefaultComputeHeuristic(AStarGrid2D.Heuristic heuristic);

Устанавливает DefaultComputeHeuristic. Формула базовой стоимости перехода без _ComputeCost override. Работает по разности целочисленных ID: Euclidean=sqrt(dx²+dy²), Manhattan=dx+dy, Octile=max(dx,dy)+(sqrt(2)−1)*min(dx,dy), Chebyshev=max(dx,dy). Не зависит от CellSize/Offset. При обычном поиске ещё умножается на вес назначения. Меняется без Update.

public void SetDefaultEstimateHeuristic(AStarGrid2D.Heuristic heuristic);

Устанавливает DefaultEstimateHeuristic. Формула оценки оставшейся стоимости без _EstimateCost override; не фактическая плата за переход. Должна не завышать и быть согласована с перемещениями и весами. Manhattan подходит 4-направленной сетке; не выбирайте его автоматически для дешёвых диагоналей. Веса <1/custom costs могут потребовать собственного return 0. Меняется без Update.

public void SetDiagonalMode(AStarGrid2D.DiagonalModeEnum mode);

Устанавливает DiagonalMode. Правило диагоналей, меняется без Update: Always разрешает срезать угол даже между двумя solid-соседями; Never оставляет 4 направления; AtLeastOneWalkable требует хотя бы одну свободную боковую клетку; OnlyIfNoObstacles — обе. Диагональная целевая клетка всегда должна быть свободна. Это клеточное правило, не проверка радиуса персонажа.

public void SetJumpingEnabled(bool enabled);

Устанавливает JumpingEnabled. Включает Jump Point Search без перестройки. В 1.0.0 эта ветка игнорирует weight_scale: дорогие клетки могут перестать обходиться. Результат может содержать только jump-точки без промежуточных соседних клеток; не считайте соседние элементы массива обязательно смежными. Используйте для подходящей однородной сетки; ускорение не гарантировано для любого случая.

public void SetOffset(Vector2 offset);

Устанавливает Offset. Смещение выдаваемых Vector2-позиций, а не ID клеток или границ Region. Изменение помечает dirty. После Update позиции пересчитаются, solid/веса будут сброшены. Приблизительно равное значение может не пометить dirty.

public void SetPointSolid(Vector2I id, bool solid = true);

В готовой сетке помечает существующую клетку solid=true по умолчанию; false открывает её. ID должен быть в Region. Не помечает dirty и не требует Update. Solid start не даёт пути, solid goal допускает только partial. Dirty-перестройка позже сотрёт этот флаг.

public void SetPointWeightScale(Vector2I id, float weightScale);

Задаёт конечный неотрицательный множитель стоимости входа в готовую клетку; не требует Update. Начальная клетка не получает плату входа. Не блокирует клетку: для запрета нужен solid. При JumpingEnabled вес хранится, но поиск его игнорирует. Проверяйте NaN/Infinity самостоятельно.

public void SetRegion(Rect2I region);

Устанавливает Region. Прямоугольник целочисленных ID клеток: начало включено, конец исключён; начало может быть отрицательным. Размеры должны быть ≥0. Изменение помечает сетку dirty; перед доступом к клеткам/путям нужен Update. Перестройка сбросит solid и weight_scale: применяйте их после Update.

public void SetSize(Vector2I size);

Устаревший путь изменения размера Region: нативный setter выдаёт предупреждение. Сам C# метод не помечен Obsolete в SDK, в отличие от свойства Size. Используйте Region; начало Region сохраняется, изменённый размер требует Update.

public void Update();

Если dirty=false, ничего не делает. Иначе заново создаёт клетки Region, позиции и границы, помечает clean; ВСЕ solid-флаги сбрасываются в false, веса — в 1. Сначала геометрия → Update → препятствия/веса → путь. После SetPointSolid/SetPointWeightScale Update не требуется.

public virtual float _ComputeCost(Vector2I fromId, Vector2I toId);

Переопределяет базовую стоимость перехода между ID. В обычном поиске результат ещё умножается на вес назначения, в jumping веса игнорируются и callback может получить несмежные jump-точки. Без override используется DefaultComputeHeuristic по ID. C# base._ComputeCost возвращает default(float), не нативную формулу. Возвращайте конечную неотрицательную стоимость.

public virtual float _EstimateCost(Vector2I fromId, Vector2I endId);

Переопределяет оценку оставшейся стоимости. Для оптимальности нужна допустимая согласованная эвристика; закрытые клетки не переоткрываются. При произвольных неотрицательных стоимостях return 0 — безопасная исходная оценка обычного поиска. Без override действует DefaultEstimateHeuristic; C# base-вызов возвращает default(float). Произвольные custom costs с Jumping требуют отдельной проверки.