Class Crowd

constructor

• new Crowd(navMesh: NavMesh, param1: CrowdParams): Crowd

  Parameters

  • navMesh: NavMesh

    the navmesh the crowd will use for planning

  • param1: CrowdParams

    the crowd parameters

  Returns Crowd

  Example

  const crowd = new Crowd(navMesh, {
    maxAgents: 100,
    maxAgentRadius: 1,
  });
  Copy

agents

navMesh

navMeshQuery

raw

addAgent

• addAgent(
      position: Vector3,
      crowdAgentParams: Partial<CrowdAgentParams>,
  ): CrowdAgent

  Adds a new agent to the crowd.

  Parameters

  • position: Vector3
  • crowdAgentParams: Partial<CrowdAgentParams>

  Returns CrowdAgent

destroy

• destroy(): void

  Destroys the crowd.

  Returns void

getActiveAgentCount

• getActiveAgentCount(): number

  Returns the number of active agents in the crowd.

  Returns number

getAgent

• getAgent(agentIndex: number): CrowdAgent | null

  Gets the agent for the specified index, or null if no agent has the given index.

  Parameters

  • agentIndex: number

  Returns CrowdAgent | null

getAgentCount

• getAgentCount(): number

  Returns the maximum number of agents that can be managed by the crowd.

  Returns number

getAgents

• getAgents(): CrowdAgent[]

  Returns all the agents managed by the crowd.

  Returns CrowdAgent[]

getFilter

• getFilter(filterIndex: number): QueryFilter

  Gets the query filter for the specified index.

  Parameters

  • filterIndex: number

    the index of the query filter to retrieve, (min 0, max 15)

  Returns QueryFilter

  the query filter

removeAgent

• removeAgent(agent: number | CrowdAgent): void

  Removes the agent from the crowd.

  Parameters

  • agent: number | CrowdAgent

  Returns void

update

• update(dt: number, timeSinceLastCalled?: number, maxSubSteps?: number): void

  Steps the crowd forward in time with a fixed time step.

  There are two modes. The simple mode is fixed timestepping without interpolation. In this case you only use the first argument. The second case uses interpolation. In that you also provide the time since the function was last used, as well as the maximum fixed timesteps to take.

  Parameters

  • dt: number

    The fixed time step size to use.

  • OptionaltimeSinceLastCalled: number

    The time elapsed since the function was last called.

  • OptionalmaxSubSteps: number

    Maximum number of fixed steps to take per function call.

  Returns void

  Example: fixed time stepping

  const deltaTime = 1 / 60;
  crowd.update(deltaTime);
  Copy

  Example: variable time stepping

  crowd.update(timeSinceLastUpdate);
  Copy

  Example: fixed time stepping with interpolation

  const deltaTime = 1 / 60;
  const maxSubSteps = 10;
  crowd.update(deltaTime, timeSinceLastUpdate, maxSubSteps);
  
  console.log(agent.interpolatedPosition);
  Copy