TWPerfPatch

本模組為 TwilightWarsLib 的效能優化補丁。只要在專案中載入模組，優化邏輯即會自動生效，無需手動初始化。

優化項目

1. GAF 動畫循環控制 (GAFMovieClip)

• 自動切斷循環：執行 stop() 時會同步停止 requestAnimationFrame 遞迴，確保動畫停止時不再消耗 CPU 運算資源。
• 重啟時間校正：在執行 play() 時重置時間戳記，確保動畫從停止處精準接續播放。
• 記憶體壓力優化：透過手動管理動畫回呼函式，大幅減少重複產生暫存資料造成的記憶體堆積。

2. 深度資源清理 (Game Destroy)

• 強制遞迴清理：覆寫 destroy 邏輯並預設開啟 children: true，確保場景銷毀時會自動連同所有子物件掃描並清理乾淨。
• 紋理引用釋放：預設開啟 texture: true，在場景銷毀時主動釋放該場景佔用的圖片資源（Texture），提升系統回收記憶體的效率。
• 背景循環掃描：在執行 dispose() 時進行深度掃描，確保所有層級中還在執行的動畫循環皆已關閉。

注意事項 (Disclaimer)

• 非官方補丁：本模組非由 TwilightWarsLib 官方開發，屬於第三方效能優化。
• 使用風險：本補丁會直接修改函式庫的原型邏輯（Prototype）。
• 副作用說明：由於強制開啟了銷毀子物件與紋理的功能，若專案中有「跨場景共用且未重新加載」的圖片資源，可能導致顯示異常。建議載入後完整測試一次場景切換流程。
• 優化程度說明：本補丁並非 100% 解決所有洩漏問題。目前仍有部分潛在的 requestAnimationFrame 調用深埋於函式庫內部難以追蹤，且部分 GAFTexture 仍可能存在無法被完全釋放的情況，僅能就目前已知路徑進行最大化優化。

Authors

cook1470