@rpgjs/physic/dist/world/SpatialPartition.d.ts

A deterministic 2D top-down physics library for RPG, sandbox and MMO games

import { Entity } from '../physics/Entity';
import { AABB } from '../core/math/AABB';
import { Ray, RaycastHit } from '../collision/Ray';
/**
 * Interface for spatial partitioning systems
 *
 * Allows different spatial partitioning implementations (spatial hash, quadtree, etc.)
 */
export interface SpatialPartition {
    /**
     * Inserts an entity into the partition
     *
     * @param entity - Entity to insert
     */
    insert(entity: Entity): void;
    /**
     * Removes an entity from the partition
     *
     * @param entity - Entity to remove
     */
    remove(entity: Entity): void;
    /**
     * Updates an entity's position in the partition
     *
     * @param entity - Entity to update
     */
    update(entity: Entity): void;
    /**
     * Queries entities near a given entity
     *
     * @param entity - Entity to query around
     * @param results - Optional Set to store results in (avoids allocation)
     * @returns Set of nearby entities
     */
    query(entity: Entity, results?: Set<Entity>): Set<Entity>;
    /**
     * Queries entities in an AABB region
     *
     * @param bounds - AABB to query
     * @returns Set of entities in the region
     */
    queryAABB(bounds: AABB): Set<Entity>;
    /**
     * Clears all entities from the partition
     */
    clear(): void;
    /**
     * Casts a ray against entities in the partition
     *
     * @param ray - Ray to cast
     * @param mask - Optional collision mask (layer)
     * @param filter - Optional filter function (return true to include entity)
     * @returns Raycast hit info if hit, null otherwise
     */
    raycast(ray: Ray, mask?: number, filter?: (entity: Entity) => boolean): RaycastHit | null;
}
//# sourceMappingURL=SpatialPartition.d.ts.map