@esengine/ecs-framework 2.0.6 → 2.0.7

package/bin/ECS/Core/IndexUpdateBatcher.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexUpdateBatcher = exports.IndexUpdateType = void 0;
+/**
+ * 索引更新操作类型
+ */
+var IndexUpdateType;
+(function (IndexUpdateType) {
+    IndexUpdateType["ADD_ENTITY"] = "add_entity";
+    IndexUpdateType["REMOVE_ENTITY"] = "remove_entity";
+    IndexUpdateType["UPDATE_ENTITY"] = "update_entity";
+})(IndexUpdateType || (exports.IndexUpdateType = IndexUpdateType = {}));
+/**
+ * 延迟索引更新器，用于批量更新查询索引以提高性能
+ */
+class IndexUpdateBatcher {
+    constructor() {
+        this.pendingOperations = [];
+        this.isProcessing = false;
+        this.batchSize = 1000;
+        this.flushTimeout = null;
+        this.flushDelay = 16; // 16ms，约60fps
+    }
+    /**
+     * 添加索引更新操作
+     */
+    addOperation(operation) {
+        this.pendingOperations.push(operation);
+        // 如果达到批量大小，立即处理
+        if (this.pendingOperations.length >= this.batchSize) {
+            this.flush();
+        }
+        else {
+            // 否则延迟处理
+            this.scheduleFlush();
+        }
+    }
+    /**
+     * 批量添加实体
+     */
+    addEntities(entities) {
+        for (const entity of entities) {
+            this.pendingOperations.push({
+                type: IndexUpdateType.ADD_ENTITY,
+                entity
+            });
+        }
+        if (this.pendingOperations.length >= this.batchSize) {
+            this.flush();
+        }
+        else {
+            this.scheduleFlush();
+        }
+    }
+    /**
+     * 批量移除实体
+     */
+    removeEntities(entities) {
+        for (const entity of entities) {
+            this.pendingOperations.push({
+                type: IndexUpdateType.REMOVE_ENTITY,
+                entity
+            });
+        }
+        if (this.pendingOperations.length >= this.batchSize) {
+            this.flush();
+        }
+        else {
+            this.scheduleFlush();
+        }
+    }
+    /**
+     * 批量更新实体
+     */
+    updateEntities(updates) {
+        for (const update of updates) {
+            this.pendingOperations.push({
+                type: IndexUpdateType.UPDATE_ENTITY,
+                entity: update.entity,
+                oldMask: update.oldMask,
+                newMask: update.newMask
+            });
+        }
+        if (this.pendingOperations.length >= this.batchSize) {
+            this.flush();
+        }
+        else {
+            this.scheduleFlush();
+        }
+    }
+    /**
+     * 安排延迟刷新
+     */
+    scheduleFlush() {
+        if (this.flushTimeout) {
+            return;
+        }
+        this.flushTimeout = setTimeout(() => {
+            this.flush();
+        }, this.flushDelay);
+    }
+    /**
+     * 立即处理所有待处理的操作
+     */
+    flush() {
+        if (this.isProcessing || this.pendingOperations.length === 0) {
+            return;
+        }
+        this.isProcessing = true;
+        if (this.flushTimeout) {
+            clearTimeout(this.flushTimeout);
+            this.flushTimeout = null;
+        }
+        try {
+            this.processBatch();
+        }
+        finally {
+            this.isProcessing = false;
+        }
+    }
+    /**
+     * 处理批量操作
+     */
+    processBatch() {
+        const operations = this.pendingOperations;
+        this.pendingOperations = [];
+        // 按操作类型分组以优化处理
+        const addOperations = [];
+        const removeOperations = [];
+        const updateOperations = [];
+        for (const operation of operations) {
+            switch (operation.type) {
+                case IndexUpdateType.ADD_ENTITY:
+                    addOperations.push(operation.entity);
+                    break;
+                case IndexUpdateType.REMOVE_ENTITY:
+                    removeOperations.push(operation.entity);
+                    break;
+                case IndexUpdateType.UPDATE_ENTITY:
+                    if (operation.oldMask !== undefined && operation.newMask !== undefined) {
+                        updateOperations.push({
+                            entity: operation.entity,
+                            oldMask: operation.oldMask,
+                            newMask: operation.newMask
+                        });
+                    }
+                    break;
+            }
+        }
+        // 批量处理每种类型的操作
+        if (addOperations.length > 0) {
+            this.processBatchAdd(addOperations);
+        }
+        if (removeOperations.length > 0) {
+            this.processBatchRemove(removeOperations);
+        }
+        if (updateOperations.length > 0) {
+            this.processBatchUpdate(updateOperations);
+        }
+    }
+    /**
+     * 批量处理添加操作
+     */
+    processBatchAdd(entities) {
+        // 这里应该调用QuerySystem的批量添加方法
+        // 由于需要访问QuerySystem，这个方法应该由外部注入处理函数
+        if (this.onBatchAdd) {
+            this.onBatchAdd(entities);
+        }
+    }
+    /**
+     * 批量处理移除操作
+     */
+    processBatchRemove(entities) {
+        if (this.onBatchRemove) {
+            this.onBatchRemove(entities);
+        }
+    }
+    /**
+     * 批量处理更新操作
+     */
+    processBatchUpdate(updates) {
+        if (this.onBatchUpdate) {
+            this.onBatchUpdate(updates);
+        }
+    }
+    /**
+     * 设置批量大小
+     */
+    setBatchSize(size) {
+        this.batchSize = Math.max(1, size);
+    }
+    /**
+     * 设置刷新延迟
+     */
+    setFlushDelay(delay) {
+        this.flushDelay = Math.max(0, delay);
+    }
+    /**
+     * 获取待处理操作数量
+     */
+    getPendingCount() {
+        return this.pendingOperations.length;
+    }
+    /**
+     * 清空所有待处理操作
+     */
+    clear() {
+        this.pendingOperations.length = 0;
+        if (this.flushTimeout) {
+            clearTimeout(this.flushTimeout);
+            this.flushTimeout = null;
+        }
+    }
+    /**
+     * 检查是否有待处理操作
+     */
+    hasPendingOperations() {
+        return this.pendingOperations.length > 0;
+    }
+}
+exports.IndexUpdateBatcher = IndexUpdateBatcher;
+//# sourceMappingURL=IndexUpdateBatcher.js.map

package/bin/ECS/Core/IndexUpdateBatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexUpdateBatcher.js","sourceRoot":"","sources":["../../../src/ECS/Core/IndexUpdateBatcher.ts"],"names":[],"mappings":"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"}