NavigationPathQueryParameters2D

public Reckfell.Collections.Array<Rid> ExcludedRegions { get; set; }

RID регионов, исключаемых из запроса. Регион, одновременно включённый и исключённый, не используется. Фильтр остаётся в объекте параметров до изменения или очистки.

public Reckfell.Collections.Array<Rid> IncludedRegions { get; set; }

Непустой список допускает только перечисленные регионы; ExcludedRegions имеет приоритет. Ограничение установленной 1.0.0: такой список блокирует проверенный путь через NavigationLink даже при включении обоих его регионов. Для этого случая оставьте список пустым и проверьте ограничение доступа слоями.

public Rid Map { get; set; }

RID живой навигационной карты для запроса. Новая карта должна быть опубликована сервером до запроса; ненулевой iteration ID не гарантирует, что последние изменения уже синхронизированы. Не используйте освобождённый RID.

public NavigationPathQueryParameters2D.PathMetadataFlags MetadataFlags { get; set; }

Выбирает метаданные точек: типы, RID и ID владельцев. По умолчанию All; None отключает их сбор. Читайте соответствующий массив только при включённом флаге; проверенный повторный запрос с None очищает прежние массивы метаданных.

public uint NavigationLayers { get; set; }

Беззнаковая 32-битная маска допустимых навигационных слоёв. Слой N — бит 1u << (N - 1), N от 1 до 32. Регион допускается при ненулевом пересечении масок; 0 не допускает ни одного региона. Маска не задаёт физические коллизии или размер агента.

public NavigationPathQueryParameters2D.PathPostProcessing PathPostprocessing { get; set; }

Обработка найденного коридора: Corridorfunnel сокращает путь внутри него, Edgecentered использует середины пересекаемых рёбер, None оставляет исходный вариант. Не выбирает другой глобально кратчайший коридор.

public float PathReturnMaxLength { get; set; }

Обрезает возвращаемый путь до заданной длины после поиска; 0 отключает предел. Обрезанный путь может не достигать цели. Это ограничение результата, а не бюджета поиска.

public float PathReturnMaxRadius { get; set; }

Обрезает результат по радиусу вокруг старта; 0 отключает предел. Конечная точка может намеренно остаться до цели. Не заменяет ограничение длины маршрута вдоль поворотов.

public float PathSearchMaxDistance { get; set; }

Максимальное расстояние, на которое может отдалиться искомый полигон от начального полигона, прежде чем поиск пути отменит поиск пути к целевому полигону (возможно, недостижимому или очень удалённому). В этом случае поиск пути сбрасывается и строит путь от начального полигона до полигона, который был найден ближайшим к целевой позиции. Значение 0 или ниже считается неограниченным. В случае неограниченного значения поиск пути будет искать все полигоны, соединённые с начальным полигоном, пока не будет найден целевой полигон или пока не будут исчерпаны все доступные варианты поиска полигонов.

public int PathSearchMaxPolygons { get; set; }

Максимальное количество полигонов, которые будут просмотрены до того, как поиск пути отменит поиск пути к целевому полигону (возможно, недостижимому или очень удалённому). В этом случае поиск пути сбрасывается и строит путь от начального полигона до полигона, который был найден ближайшим к целевой позиции. Значение 0 или меньше считается неограниченным. В случае неограниченного поиска пути поиск пути будет искать все полигоны, соединённые с начальным полигоном, пока не будет найден целевой полигон или пока не будут исчерпаны все доступные варианты поиска полигонов.

public NavigationPathQueryParameters2D.PathfindingAlgorithmEnum PathfindingAlgorithm { get; set; }

Алгоритм поиска пути, используемый в запросе пути.

public float SimplifyEpsilon { get; set; }

Допуск упрощения при включённом SimplifyPath, в единицах координат карты. Не является допустимым расстоянием до игровой цели.

public bool SimplifyPath { get; set; }

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

public Vector2 StartPosition { get; set; }

Старт в глобальных координатах навигационной карты. Запрос может спроецировать его на доступный полигон: проверяйте первую возвращённую точку, если старт должен оставаться исходным.

public Vector2 TargetPosition { get; set; }

Цель в глобальных координатах карты. Непустой результат может закончиться на ближайшей доступной границе вместо цели; сравнивайте последнюю точку с целью с допуском игры.