Class GraphicsBucketManager

图形桶管理器负责管理多个图形桶，实现基于索引分桶的局部渲染优化

核心功能：

按实体数组索引范围自动分桶
跟踪脏桶，只重新渲染修改过的桶
保持绘制顺序（桶按索引顺序添加到容器）
支持增删改实体时的局部更新

Constructors

constructor

new GraphicsBucketManager(
container: Container,
config?: GraphicsBucketManagerConfig,
): GraphicsBucketManager
构造函数
Parameters
- container: Container
  渲染容器
- config: GraphicsBucketManagerConfig = {}
  配置选项
Returns GraphicsBucketManager
- Defined in rendering/GraphicsBucketManager.ts:53

Accessors

isEnabled

get isEnabled(): boolean
判断是否启用桶管理

Returns boolean
- Defined in rendering/GraphicsBucketManager.ts:65

bucketCount

get bucketCount(): number
获取桶的数量

Returns number
- Defined in rendering/GraphicsBucketManager.ts:79

Methods

setEnabled

setEnabled(enabled: boolean): void
设置是否启用桶管理
Parameters
- enabled: boolean
Returns void
- Defined in rendering/GraphicsBucketManager.ts:72

getAllBuckets

getAllBuckets(): GraphicsBucket[]
获取所有桶

Returns GraphicsBucket[]
- Defined in rendering/GraphicsBucketManager.ts:86

initializeBuckets

initializeBuckets(entityCount: number): void
根据实体数组初始化桶
Parameters
- entityCount: number
  实体总数
Returns void
- Defined in rendering/GraphicsBucketManager.ts:94

findBucketByIndex

findBucketByIndex(index: number): GraphicsBucket
根据实体索引查找所属的桶
Parameters
- index: number
  实体索引
Returns GraphicsBucket
找到的桶，如果没找到返回null
- Defined in rendering/GraphicsBucketManager.ts:126

markDirtyByIndex

markDirtyByIndex(index: number): void
标记指定索引的实体所在桶为脏
Parameters
- index: number
  实体索引
Returns void
- Defined in rendering/GraphicsBucketManager.ts:134

markDirtyByIndices

markDirtyByIndices(indices: number[]): void
标记多个索引的实体所在桶为脏
Parameters
- indices: number[]
  实体索引数组
Returns void
- Defined in rendering/GraphicsBucketManager.ts:145

markAllDirty

markAllDirty(): void
标记所有桶为脏

Returns void
- Defined in rendering/GraphicsBucketManager.ts:161

getDirtyBuckets

getDirtyBuckets(): GraphicsBucket[]
获取所有脏桶

Returns GraphicsBucket[]
- Defined in rendering/GraphicsBucketManager.ts:168

regenDirtyBuckets

regenDirtyBuckets(entities: EntityBase[], renderer: EntityRenderer): number
重新渲染所有脏桶
Parameters
- entities: EntityBase[]
  完整的实体数组
- renderer: EntityRenderer
  实体渲染器
Returns number
重新渲染的桶数量
- Defined in rendering/GraphicsBucketManager.ts:178

regenAllBuckets

regenAllBuckets(entities: EntityBase[], renderer: EntityRenderer): void
重新渲染所有桶（全量渲染）
Parameters
- entities: EntityBase[]
  完整的实体数组
- renderer: EntityRenderer
  实体渲染器
Returns void
- Defined in rendering/GraphicsBucketManager.ts:276

handleEntityAdd

handleEntityAdd(index: number, totalCount: number): boolean
处理实体添加
Parameters
- index: number
  新添加实体的索引
- totalCount: number
  添加后的实体总数
Returns boolean
是否需要完整重绘（当桶结构被重置时返回 true）
- Defined in rendering/GraphicsBucketManager.ts:316

handleEntityModify

handleEntityModify(index: number): void
处理实体修改
Parameters
- index: number
  修改的实体索引
Returns void
- Defined in rendering/GraphicsBucketManager.ts:360

handleEntityDelete

handleEntityDelete(index: number): void
处理实体删除（标记删除，不真正移除）
Parameters
- index: number
  删除的实体索引
Returns void
- Defined in rendering/GraphicsBucketManager.ts:369

handleEntityPop

handleEntityPop(newLength: number): void
处理实体从数组末尾移除（pop操作）当通过undo操作移除实体时调用
Parameters
- newLength: number
  移除后的数组长度
Returns void
- Defined in rendering/GraphicsBucketManager.ts:379

handleEntityPush

handleEntityPush(newLength: number): void
处理实体添加到数组末尾（push操作）当通过redo操作恢复实体时调用
Parameters
- newLength: number
  添加后的数组长度
Returns void
- Defined in rendering/GraphicsBucketManager.ts:416

clear

clear(): void
清理所有桶

Returns void
- Defined in rendering/GraphicsBucketManager.ts:426

getStats

getStats(): {
    bucketCount: number;
    dirtyBucketCount: number;
    totalCapacity: number;
    averageFragmentation: number;
}
获取统计信息

Returns {
    bucketCount: number;
    dirtyBucketCount: number;
    totalCapacity: number;
    averageFragmentation: number;
}
- Defined in rendering/GraphicsBucketManager.ts:440

destroy

destroy(): void
销毁管理器

Returns void
- Defined in rendering/GraphicsBucketManager.ts:463