Class SpatialIndexManager

空间索引管理器使用 rbush 对实体进行空间索引，优化拾取性能

设计思路：

对所有实体建立空间索引（而不是只对屏幕内的）
通过屏幕空间范围查询rbush来获取实体
拾取时先用索引快速筛选，再进行精确测试
在查询时检查并更新dirty实体的索引（参考屏幕索引的重构方式）

Index

Constructors

Accessors

enabled isInitialized

Methods

setEnabled load insert remove update search collides clear getStats disposeDoc

Constructors

constructor

new SpatialIndexManager(): SpatialIndexManager
Returns SpatialIndexManager
- Defined in spatial/SpatialIndexManager.ts:24

Accessors

enabled

get enabled(): boolean
检查索引是否启用

Returns boolean
- Defined in spatial/SpatialIndexManager.ts:84

isInitialized

get isInitialized(): boolean
检查索引是否已初始化

Returns boolean
- Defined in spatial/SpatialIndexManager.ts:401

Methods

setEnabled

setEnabled(enabled: boolean): void
启用或禁用索引
Parameters
- enabled: boolean
  是否启用
Returns void
- Defined in spatial/SpatialIndexManager.ts:74

load

load(entities?: any[], doc?: CadDocument): void
批量加载实体到索引使用 bulk loading 以获得最佳性能
Parameters
- Optionalentities: any[]
  实体数组（如果为空，则从 Engine.currentSpace.items 获取所有实体）
- Optionaldoc: CadDocument
Returns void
- Defined in spatial/SpatialIndexManager.ts:119

insert

insert(entity: any): void
添加单个实体到索引
Parameters
- entity: any
  实体对象
Returns void
- Defined in spatial/SpatialIndexManager.ts:186

remove

remove(entity: any): void
从索引中移除实体
Parameters
- entity: any
  实体对象
Returns void
- Defined in spatial/SpatialIndexManager.ts:213

update

update(entity: any, onlyIfExists?: boolean): void
更新实体在索引中的位置
Parameters
- entity: any
  实体对象
- onlyIfExists: boolean = false
  是否只在索引中存在时才更新（默认 false）
Returns void
- Defined in spatial/SpatialIndexManager.ts:235

search

search(bounds: BoundingBox, entityArray?: any[], doc?: CadDocument): any[]
搜索与给定边界框相交的实体在查询前自动检查并更新dirty实体的索引
Parameters
- bounds: BoundingBox
  搜索边界框（世界坐标系）
- OptionalentityArray: any[]
  可选的实体数组，如果指定，只返回在此数组中的实体
- Optionaldoc: CadDocument
Returns any[]
可能相交的实体数组（需要进一步精确测试）
- Defined in spatial/SpatialIndexManager.ts:303

collides

collides(bounds: BoundingBox, doc?: CadDocument): boolean
检查是否有实体与给定边界框相交在查询前自动检查并更新dirty实体的索引
Parameters
- bounds: BoundingBox
  搜索边界框（世界坐标系）
- Optionaldoc: CadDocument
Returns boolean
是否有相交的实体
- Defined in spatial/SpatialIndexManager.ts:362

clear

clear(doc?: number | CadDocument): void
清除所有索引
Parameters
- Optionaldoc: number | CadDocument
Returns void
- Defined in spatial/SpatialIndexManager.ts:385

getStats

getStats(
doc?: number | CadDocument,
): { itemCount: number; enabled: boolean; initialized: boolean }
获取索引统计信息
Parameters
- Optionaldoc: number | CadDocument
Returns { itemCount: number; enabled: boolean; initialized: boolean }
- Defined in spatial/SpatialIndexManager.ts:409

disposeDoc

disposeDoc(doc?: number | CadDocument): void
移除指定文档的索引状态（用于关闭文档）
Parameters
- Optionaldoc: number | CadDocument
Returns void
- Defined in spatial/SpatialIndexManager.ts:426