Class TilemapAnimationSystem

packages/tilemap/src/TilemapAnimationSystem.ts:26–204

 * 瓦片地图动画系统
 */
export class TilemapAnimationSystem {
    /** Animation states keyed by "tilesetIndex:tileId" | 按"图块集索引:瓦片ID"索引的动画状态 */
    private animationStates: Map<string, TileAnimationState> = new Map();

    /** Cached animated tile metadata for quick lookup | 缓存的动画瓦片元数据用于快速查找 */
    private animatedTiles: Map<string, ITileMetadata> = new Map();

    /** Whether animations are playing | 动画是否正在播放 */
    private _isPlaying: boolean = true;

    /**
     * Register a tileset's animated tiles
     * 注册图块集的动画瓦片
     */
    registerTileset(tilesetIndex: number, tileset: ITilesetData): void {
        if (!tileset.tiles) return;

        for (const tile of tileset.tiles) {
            if (tile.animation && tile.animation.frames.length > 0) {
                const key = `${tilesetIndex}:${tile.id}`;
                this.animatedTiles.set(key, tile);
                this.animationStates.set(key, {
                    currentFrame: 0,
                    elapsedTime: 0
                });
            }
        }
    }

    /**
     * Unregister a tileset
     * 注销图块集
     */
    unregisterTileset(tilesetIndex: number): void {
        const keysToRemove: string[] = [];
        for (const key of this.animationStates.keys()) {
            if (key.startsWith(`${tilesetIndex}:`)) {
                keysToRemove.push(key);
            }
        }
        for (const key of keysToRemove) {
            this.animationStates.delete(key);
            this.animatedTiles.delete(key);
        }
    }

    /**
     * Clear all animation states
     * 清除所有动画状态
     */
    clear(): void {
        this.animationStates.clear();
        this.animatedTiles.clear();
    }

    /**
     * Update all animations
     * 更新所有动画