@recast-navigation/core 0.0.6 → 0.1.0

package/dist/nav-mesh-builder.d.ts

@@ -0,0 +1,40 @@
+import type R from '@recast-navigation/wasm';
+export declare type CreateNavMeshDataParams = {
+    verts: number[];
+    vertCount: number;
+    polys: number[];
+    polyFlags: number[];
+    polyAreas: number[];
+    polyCount: number;
+    nvp: number;
+    detailMeshes: number[];
+    detailVerts: number[];
+    detailVertsCount: number;
+    detailTris: number[];
+    detailTriCount: number;
+    offMeshConVerts: number[];
+    offMeshConRad: number[];
+    offMeshConFlags: number[];
+    offMeshConAreas: number[];
+    offMeshConDir: number[];
+    offMeshConUserID: number[];
+    offMeshConCount: number;
+    userId: number;
+    tileX: number;
+    tileY: number;
+    tileLayer: number;
+    bmin: number[];
+    bmax: number[];
+    walkableHeight: number;
+    walkableRadius: number;
+    walkableClimb: number;
+    cs: number;
+    ch: number;
+    buildBvTree: boolean;
+};
+export declare type CreateNavMeshDataResult = R.CreateNavMeshDataResult;
+export declare class NavMeshBuilder {
+    raw: R.NavMeshBuilder;
+    constructor();
+    createNavMeshData(params: CreateNavMeshDataParams): CreateNavMeshDataResult;
+}

package/dist/nav-mesh-exporter.d.ts

@@ -0,0 +1,12 @@
+import type R from '@recast-navigation/wasm';
+import { NavMesh } from './nav-mesh';
+import { TileCache } from './tile-cache';
+export declare class NavMeshExporter {
+    raw: R.NavMeshExporter;
+    constructor();
+    /**
+     * Returns a NavMesh export that can be used later. The NavMesh must be built before retrieving the data
+     * @returns data the Uint8Array that can be saved and reused
+     */
+    export(navMesh: NavMesh, tileCache?: TileCache): Uint8Array;
+}

package/dist/nav-mesh-generator.d.ts

@@ -0,0 +1,116 @@
+import type R from '@recast-navigation/wasm';
+import { NavMesh } from './nav-mesh';
+import { TileCache } from './tile-cache';
+export declare type NavMeshConfig = {
+    /**
+     * The size of the non-navigable border around the heightfield.
+     * [Limit: >=0] [Units: vx]
+     * @default 0
+     */
+    borderSize: number;
+    /**
+     * The width/height size of tile's on the xz-plane.
+     * [Limit: >= 0] [Units: vx]
+     *
+     * If tileSize is provided, a tiled navmesh will be created.
+     * If tileSize is not provided, or is set to zero, a solo navmesh will be created.
+     *
+     * To use obstacles, a tiled navmesh must be generated.
+     * @default 0
+     */
+    tileSize: number;
+    /**
+     * The xz-plane cell size to use for fields.
+     * [Limit: > 0] [Units: wu]
+     * @default 0.2
+     */
+    cs: number;
+    /**
+     * The y-axis cell size to use for fields.
+     * Limit: > 0] [Units: wu]
+     * @default 0.2
+     */
+    ch: number;
+    /**
+     * The maximum slope that is considered walkable.
+     * [Limits: 0 <= value < 90] [Units: Degrees]
+     * @default 60
+     */
+    walkableSlopeAngle: number;
+    /**
+     * Minimum floor to 'ceiling' height that will still allow the floor area to be considered walkable.
+     * [Limit: >= 3] [Units: vx]
+     * @default 2
+     */
+    walkableHeight: number;
+    /**
+     * Maximum ledge height that is considered to still be traversable.
+     * [Limit: >=0] [Units: vx]
+     * @default 2
+     */
+    walkableClimb: number;
+    /**
+     * The distance to erode/shrink the walkable area of the heightfield away from obstructions.
+     * [Limit: >=0] [Units: vx]
+     * @default 0.5
+     */
+    walkableRadius: number;
+    /**
+     * The maximum allowed length for contour edges along the border of the mesh.
+     * [Limit: >=0] [Units: vx]
+     * @default 12
+     */
+    maxEdgeLen: number;
+    /**
+     * The maximum distance a simplfied contour's border edges should deviate the original raw contour.
+     * [Limit: >=0] [Units: vx]
+     * @default 1.3
+     */
+    maxSimplificationError: number;
+    /**
+     * The minimum number of cells allowed to form isolated island areas.
+     * [Limit: >=0] [Units: vx]
+     * @default 8
+     */
+    minRegionArea: number;
+    /**
+     * Any regions with a span count smaller than this value will, if possible, be merged with larger regions.
+     * [Limit: >=0] [Units: vx]
+     * @default 20
+     */
+    mergeRegionArea: number;
+    /**
+     * The maximum number of vertices allowed for polygons generated during the be merged with larger regions.
+     * [Limit: >=0] [Units: vx]
+     * @default 6
+     */
+    maxVertsPerPoly: number;
+    /**
+     * Sets the sampling distance to use when generating the detail mesh. (For height detail only.)
+     * [Limits: 0 or >= 0.9] [Units: wu]
+     * @default 6
+     */
+    detailSampleDist: number;
+    /**
+     * The maximum distance the detail mesh surface should deviate from heightfield data. (For height detail only.)
+     * [Limit: >=0] [Units: wu]
+     * @default 1
+     */
+    detailSampleMaxError: number;
+};
+export declare type NavMeshGeneratorResult = {
+    success: boolean;
+    navMesh: NavMesh;
+    tileCache: TileCache;
+};
+export declare class NavMeshGenerator {
+    raw: R.NavMeshGenerator;
+    constructor();
+    /**
+     * Builds a NavMesh from the given positions and indices.
+     * @param positions a flat array of positions
+     * @param indices a flat array of indices
+     * @param navMeshConfig optional configuration for the NavMesh
+     */
+    generate(positions: ArrayLike<number>, indices: ArrayLike<number>, navMeshConfig?: Partial<NavMeshConfig>): NavMeshGeneratorResult;
+}

package/dist/nav-mesh-importer.d.ts

@@ -0,0 +1,16 @@
+import type R from '@recast-navigation/wasm';
+import { NavMesh } from './nav-mesh';
+import { TileCache } from './tile-cache';
+export declare type NavMeshImporterResult = {
+    navMesh: NavMesh;
+    tileCache: TileCache;
+};
+export declare class NavMeshImporter {
+    raw: R.NavMeshImporter;
+    constructor();
+    /**
+     * Build the navmesh from a previously saved state using getNavMeshExport
+     * @param data the Uint8Array returned by `getNavMeshExport`
+     */
+    import(data: Uint8Array): NavMeshImporterResult;
+}

package/dist/nav-mesh-query.d.ts

@@ -0,0 +1,46 @@
+import type R from '@recast-navigation/wasm';
+import { NavMesh } from './nav-mesh';
+import { Vector3 } from './utils';
+export declare type NavMeshQueryParams = {
+    navMesh: NavMesh;
+    /**
+     * @default 2048
+     */
+    maxNodes?: number;
+};
+export declare class NavMeshQuery {
+    raw: R.NavMeshQuery;
+    constructor({ navMesh, maxNodes }: NavMeshQueryParams);
+    /**
+     * Returns the closest point on the NavMesh to the given position.
+     */
+    getClosestPoint(position: Vector3): Vector3;
+    /**
+     * Returns a random point on the NavMesh within the given radius of the given position.
+     */
+    getRandomPointAround(position: Vector3, radius: number): Vector3;
+    /**
+     * Compute the final position from a segment made of destination-position
+     */
+    moveAlong(position: Vector3, destination: Vector3): Vector3;
+    /**
+     * Finds a path from the start position to the end position.
+     *g
+     * @returns an array of Vector3 positions that make up the path, or an empty array if no path was found.
+     */
+    computePath(start: Vector3, end: Vector3): Vector3[];
+    /**
+     * Gets the Bounding box extent specified by setDefaultQueryExtent
+     */
+    getDefaultQueryExtent(): Vector3;
+    /**
+     * Sets the Bounding box extent for doing spatial queries (getClosestPoint, getRandomPointAround, ...)
+     * The queries will try to find a solution within those bounds.
+     * The default is (1,1,1)
+     */
+    setDefaultQueryExtent(extent: Vector3): void;
+    /**
+     * Destroys the NavMeshQuery instance
+     */
+    destroy(): void;
+}