@recast-navigation/playcanvas 0.38.0 → 0.39.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License
 
-Copyright © 2022 Isaac Mason
+Copyright © 2025 Isaac Mason
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -92,18 +92,6 @@ this.entity.add(navMeshHelper);
 navMeshHelper.update();
 ```
 
-#### `OffMeshConnectionsHelper`
-
-```ts
-import { OffMeshConnectionsHelper } from '@recast-navigation/playcanvas';
-
-const offMeshConnectionsHelper = new OffMeshConnectionsHelper(
-  offMeshConnections
-);
-
-this.entity.add(offMeshConnectionsHelper);
-```
-
 #### `TileCacheHelper`
 
 Visualises obstacles in a `TileCache`.

package/dist/helpers/index.d.ts

@@ -1,4 +1,3 @@
 export * from './crowd-helper';
 export * from './nav-mesh-helper';
-export * from './off-mesh-connections-helper';
 export * from './tile-cache-helper';

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { DebugDrawerUtils } from '@recast-navigation/core';
-import { Entity, StandardMaterial, Color, BLEND_NORMAL, MeshInstance, VertexFormat, SEMANTIC_POSITION, TYPE_FLOAT32, SEMANTIC_COLOR, VertexBuffer, BUFFER_STATIC, Mesh, PRIMITIVE_POINTS, PRIMITIVE_LINES, PRIMITIVE_TRIANGLES, Vec3, GraphNode, CylinderGeometry, calculateNormals, createMesh, RENDERSTYLE_WIREFRAME, VertexIterator, INDEXFORMAT_UINT32 } from 'playcanvas';
+import { DebugDrawerUtils, getNavMeshPositionsAndIndices } from '@recast-navigation/core';
+import { Entity, StandardMaterial, Color, BLEND_NORMAL, MeshInstance, VertexFormat, SEMANTIC_POSITION, TYPE_FLOAT32, SEMANTIC_COLOR, VertexBuffer, BUFFER_STATIC, Mesh, PRIMITIVE_POINTS, PRIMITIVE_LINES, PRIMITIVE_TRIANGLES, Vec3, GraphNode, CylinderGeometry, calculateNormals, RENDERSTYLE_WIREFRAME, VertexIterator, INDEXFORMAT_UINT32 } from 'playcanvas';
 import { mergePositionsAndIndices, generateSoloNavMesh, generateTiledNavMesh, generateTileCache } from '@recast-navigation/generators';
 
 /**
@@ -179,7 +179,7 @@ class DebugDrawer extends Entity {
       positions.push(x, y, z);
       colors.push(r, g, b, a);
     }
-    const mesh = createLineMesh$1(graphicsDevice, positions, colors);
+    const mesh = createLineMesh(graphicsDevice, positions, colors);
     const meshInstance = new MeshInstance(mesh, this.lineMaterial);
     const entity = new Entity();
     entity.addComponent('render', {
@@ -269,7 +269,7 @@ function createPointMesh(graphicsDevice, positions, colors) {
 /**
  * Creates a line mesh.
  */
-function createLineMesh$1(graphicsDevice, positions, colors) {
+function createLineMesh(graphicsDevice, positions, colors) {
   const vertexFormat = new VertexFormat(graphicsDevice, [{
     semantic: SEMANTIC_POSITION,
     components: 3,
@@ -452,7 +452,7 @@ class NavMeshHelper extends Entity {
    * @private
    */
   updateMesh(graphicsDevice) {
-    const [positions, indices] = this.navMesh.getDebugNavMesh();
+    const [positions, indices] = getNavMeshPositionsAndIndices(this.navMesh);
     const normals = calculateNormals(positions, indices);
     // Create the mesh
     this.mesh = new Mesh(graphicsDevice);
@@ -475,163 +475,6 @@ class NavMeshHelper extends Entity {
   }
 }
 
-class OffMeshConnectionsHelper extends Entity {
-  constructor(offMeshConnections, params) {
-    super();
-    this.offMeshConnections = offMeshConnections;
-    // Initialize materials
-    if (params?.entryCircleMaterial) {
-      this.entryCircleMaterial = params.entryCircleMaterial;
-    } else {
-      const material = new StandardMaterial();
-      material.diffuse = new Color(0, 1, 0); // Green
-      material.useLighting = false;
-      material.update();
-      this.entryCircleMaterial = material;
-    }
-    if (params?.exitCircleMaterial) {
-      this.exitCircleMaterial = params.exitCircleMaterial;
-    } else {
-      const material = new StandardMaterial();
-      material.diffuse = new Color(0, 0, 1); // Blue
-      material.useLighting = false;
-      material.update();
-      this.exitCircleMaterial = material;
-    }
-    if (params?.lineMaterial) {
-      this.lineMaterial = params.lineMaterial;
-    } else {
-      const material = new StandardMaterial();
-      material.diffuse = new Color(1, 0, 0); // Red
-      material.useLighting = false;
-      material.update();
-      this.lineMaterial = material;
-    }
-    this.updateHelper();
-  }
-  /**
-   * Updates the visual representation of the off-mesh connections.
-   */
-  updateHelper() {
-    // Remove all child entities
-    while (this.children.length > 0) {
-      this.children[0].destroy();
-    }
-    const graphicsDevice = this.app.graphicsDevice;
-    for (const offMeshConnection of this.offMeshConnections) {
-      // Create circle mesh at start position
-      const circleMesh = createCircleMesh(graphicsDevice, offMeshConnection.radius, 16);
-      const circleEntity = new Entity();
-      circleEntity.addComponent('render', {
-        meshInstances: [new MeshInstance(circleMesh, this.entryCircleMaterial)]
-      });
-      circleEntity.setPosition(offMeshConnection.startPosition);
-      circleEntity.setLocalEulerAngles(-90, 0, 0); // Rotate to lie flat on XZ plane
-      this.addChild(circleEntity);
-      // Create circle mesh at end position
-      const endCircleEntity = new Entity();
-      endCircleEntity.addComponent('render', {
-        meshInstances: [new MeshInstance(circleMesh, offMeshConnection.bidirectional ? this.entryCircleMaterial : this.exitCircleMaterial)]
-      });
-      endCircleEntity.setPosition(offMeshConnection.endPosition);
-      endCircleEntity.setLocalEulerAngles(-90, 0, 0); // Rotate to lie flat on XZ plane
-      this.addChild(endCircleEntity);
-      // Create curve between points
-      const start = offMeshConnection.startPosition.clone();
-      const end = offMeshConnection.endPosition.clone();
-      const middle = new Vec3().add2(start, end).mulScalar(0.5);
-      middle.y *= 1.2; // Elevate the middle point for a curve effect
-      // Generate points along a quadratic Bezier curve
-      const curvePoints = generateBezierCurve([start, middle, end], 50);
-      // Create line mesh
-      const lineMesh = createLineMesh(graphicsDevice, curvePoints);
-      const lineEntity = new Entity();
-      lineEntity.addComponent('render', {
-        meshInstances: [new MeshInstance(lineMesh, this.lineMaterial)]
-      });
-      this.addChild(lineEntity);
-    }
-  }
-}
-/**
- * Creates a circle mesh.
- * @param {GraphicsDevice} graphicsDevice - The graphics device.
- * @param {number} radius - Radius of the circle.
- * @param {number} segments - Number of segments.
- * @returns {Mesh} - The circle mesh.
- */
-function createCircleMesh(graphicsDevice, radius, segments) {
-  const positions = [];
-  const indices = [];
-  // Create circle vertices
-  for (let i = 0; i <= segments; i++) {
-    const theta = i / segments * Math.PI * 2;
-    const x = radius * Math.cos(theta);
-    const z = radius * Math.sin(theta);
-    positions.push(x, 0, z);
-  }
-  // Center point
-  positions.push(0, 0, 0);
-  const centerIndex = positions.length / 3 - 1;
-  // Create indices
-  for (let i = 0; i < segments; i++) {
-    indices.push(i, (i + 1) % segments, centerIndex);
-  }
-  return createMesh(graphicsDevice, positions, {
-    indices: indices
-  });
-}
-/**
- * Generates points along a quadratic Bezier curve.
- * @param {Vec3[]} points - Control points.
- * @param {number} numPoints - Number of points to generate.
- * @returns {Vec3[]} - Points along the curve.
- */
-function generateBezierCurve(points, numPoints) {
-  const curvePoints = [];
-  for (let i = 0; i <= numPoints; i++) {
-    const t = i / numPoints;
-    const point = bezierQuadratic(points[0], points[1], points[2], t);
-    curvePoints.push(point);
-  }
-  return curvePoints;
-}
-/**
- * Computes a point on a quadratic Bezier curve.
- * @param {Vec3} p0 - Start point.
- * @param {Vec3} p1 - Control point.
- * @param {Vec3} p2 - End point.
- * @param {number} t - Parameter between 0 and 1.
- * @returns {Vec3} - Point on the curve.
- */
-function bezierQuadratic(p0, p1, p2, t) {
-  const oneMinusT = 1 - t;
-  const x = oneMinusT * oneMinusT * p0.x + 2 * oneMinusT * t * p1.x + t * t * p2.x;
-  const y = oneMinusT * oneMinusT * p0.y + 2 * oneMinusT * t * p1.y + t * t * p2.y;
-  const z = oneMinusT * oneMinusT * p0.z + 2 * oneMinusT * t * p1.z + t * t * p2.z;
-  return new Vec3(x, y, z);
-}
-/**
- * Creates a line mesh from an array of points.
- * @param {GraphicsDevice} graphicsDevice - The graphics device.
- * @param {Vec3[]} points - Points of the line.
- * @returns {Mesh} - The line mesh.
- */
-function createLineMesh(graphicsDevice, points) {
-  const positions = [];
-  const indices = [];
-  for (let i = 0; i < points.length; i++) {
-    positions.push(points[i].x, points[i].y, points[i].z);
-  }
-  for (let i = 0; i < points.length - 1; i++) {
-    indices.push(i, i + 1);
-  }
-  return createMesh(graphicsDevice, positions, {
-    indices: indices,
-    primitiveType: PRIMITIVE_LINES
-  });
-}
-
 /**
  * Represents a helper class to visualize tile cache obstacles in PlayCanvas.
  */
@@ -774,4 +617,4 @@ const threeToTileCache = (meshes, navMeshGeneratorConfig = {}, keepIntermediates
   return generateTileCache(positions, indices, navMeshGeneratorConfig, keepIntermediates);
 };
 
-export { CrowdHelper, DebugDrawer, NavMeshHelper, OffMeshConnectionsHelper, TileCacheHelper, getPositionsAndIndices, pcToSoloNavMesh, pcToTiledNavMesh, threeToTileCache };
+export { CrowdHelper, DebugDrawer, NavMeshHelper, TileCacheHelper, getPositionsAndIndices, pcToSoloNavMesh, pcToTiledNavMesh, threeToTileCache };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@recast-navigation/playcanvas",
   "description": "Utilities for using recast-navigation with PlayCanvas",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "license": "MIT",
   "homepage": "https://github.com/isaac-mason/recast-navigation-js",
   "bugs": {
@@ -22,8 +22,8 @@
     "lint": "eslint src"
   },
   "dependencies": {
-    "@recast-navigation/core": "0.38.0",
-    "@recast-navigation/generators": "0.38.0"
+    "@recast-navigation/core": "0.39.0",
+    "@recast-navigation/generators": "0.39.0"
   },
   "devDependencies": {
     "@babel/core": "^7.24.5",

package/dist/helpers/off-mesh-connections-helper.d.ts

@@ -1,29 +0,0 @@
-import { Entity, Material, Vec3 } from 'playcanvas';
-/**
- * Parameters for creating OffMeshConnectionsHelper.
- */
-export type OffMeshConnectionsHelperParams = {
-    entryCircleMaterial?: Material;
-    exitCircleMaterial?: Material;
-    lineMaterial?: Material;
-};
-/**
- * Represents an off-mesh connection between two points.
- */
-export type OffMeshConnectionParams = {
-    startPosition: Vec3;
-    endPosition: Vec3;
-    radius: number;
-    bidirectional: boolean;
-};
-export declare class OffMeshConnectionsHelper extends Entity {
-    offMeshConnections: OffMeshConnectionParams[];
-    entryCircleMaterial: Material;
-    exitCircleMaterial: Material;
-    lineMaterial: Material;
-    constructor(offMeshConnections: OffMeshConnectionParams[], params?: OffMeshConnectionsHelperParams);
-    /**
-     * Updates the visual representation of the off-mesh connections.
-     */
-    updateHelper(): void;
-}