feat(fairygui): FairyGUI 完整集成 (#314)
* feat(fairygui): FairyGUI ECS 集成核心架构 实现 FairyGUI 的 ECS 原生集成,完全替代旧 UI 系统: 核心类: - GObject: UI 对象基类,支持变换、可见性、关联、齿轮 - GComponent: 容器组件,管理子对象和控制器 - GRoot: 根容器,管理焦点、弹窗、输入分发 - GGroup: 组容器,支持水平/垂直布局 抽象层: - DisplayObject: 显示对象基类 - EventDispatcher: 事件分发 - Timer: 计时器 - Stage: 舞台,管理输入和缩放 布局系统: - Relations: 约束关联管理 - RelationItem: 24 种关联类型 基础设施: - Controller: 状态控制器 - Transition: 过渡动画 - ScrollPane: 滚动面板 - UIPackage: 包管理 - ByteBuffer: 二进制解析 * refactor(ui): 删除旧 UI 系统,使用 FairyGUI 替代 * feat(fairygui): 实现 UI 控件 - 添加显示类:Image、TextField、Graph - 添加基础控件:GImage、GTextField、GGraph - 添加交互控件:GButton、GProgressBar、GSlider - 更新 IRenderCollector 支持 Graph 渲染 - 扩展 Controller 添加 selectedPageId - 添加 STATE_CHANGED 事件类型 * feat(fairygui): 现代化架构重构 - 增强 EventDispatcher 支持类型安全、优先级和传播控制 - 添加 PropertyBinding 响应式属性绑定系统 - 添加 ServiceContainer 依赖注入容器 - 添加 UIConfig 全局配置系统 - 添加 UIObjectFactory 对象工厂 - 实现 RenderBridge 渲染桥接层 - 实现 Canvas2DBackend 作为默认渲染后端 - 扩展 IRenderCollector 支持更多图元类型 * feat(fairygui): 九宫格渲染和资源加载修复 - 修复 FGUIUpdateSystem 支持路径和 GUID 两种加载方式 - 修复 GTextInput 同时设置 _displayObject 和 _textField - 实现九宫格渲染展开为 9 个子图元 - 添加 sourceWidth/sourceHeight 用于九宫格计算 - 添加 DOMTextRenderer 文本渲染层(临时方案) * fix(fairygui): 修复 GGraph 颜色读取 * feat(fairygui): 虚拟节点 Inspector 和文本渲染支持 * fix(fairygui): 编辑器状态刷新和遗留引用修复 - 修复切换 FGUI 包后组件列表未刷新问题 - 修复切换组件后 viewport 未清理旧内容问题 - 修复虚拟节点在包加载后未刷新问题 - 重构为事件驱动架构,移除轮询机制 - 修复 @esengine/ui 遗留引用,统一使用 @esengine/fairygui * fix: 移除 tsconfig 中的 @esengine/ui 引用
This commit is contained in:
159
packages/fairygui/src/tween/GTween.ts
Normal file
159
packages/fairygui/src/tween/GTween.ts
Normal file
@@ -0,0 +1,159 @@
|
||||
import { GTweener } from './GTweener';
|
||||
import { TweenManager } from './TweenManager';
|
||||
import { TweenValue } from './TweenValue';
|
||||
|
||||
/**
|
||||
* GTween
|
||||
*
|
||||
* Main entry point for the tween system.
|
||||
* Provides static factory methods for creating tweens.
|
||||
*
|
||||
* 补间系统的主入口点
|
||||
* 提供创建补间的静态工厂方法
|
||||
*
|
||||
* @example
|
||||
* ```typescript
|
||||
* // Simple tween
|
||||
* GTween.to(0, 100, 0.5)
|
||||
* .setTarget(sprite, 'x')
|
||||
* .setEase(EEaseType.QuadOut);
|
||||
*
|
||||
* // Vector tween
|
||||
* GTween.to2(0, 0, 100, 200, 0.5)
|
||||
* .setTarget(sprite)
|
||||
* .onUpdate((tweener) => {
|
||||
* sprite.x = tweener.value.x;
|
||||
* sprite.y = tweener.value.y;
|
||||
* });
|
||||
*
|
||||
* // Delayed call
|
||||
* GTween.delayedCall(1.0)
|
||||
* .onComplete(() => console.log('Done!'));
|
||||
* ```
|
||||
*/
|
||||
export class GTween {
|
||||
/**
|
||||
* Catch all uncaught tween callback exceptions
|
||||
* 捕获所有未捕获的补间回调异常
|
||||
*/
|
||||
public static catchCallbackExceptions: boolean = true;
|
||||
|
||||
/**
|
||||
* Create a tween from start to end value
|
||||
* 创建从起始值到结束值的补间
|
||||
*/
|
||||
public static to(start: number, end: number, duration: number): GTweener {
|
||||
return TweenManager.createTween()._to(start, end, duration);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a 2D tween
|
||||
* 创建2D补间
|
||||
*/
|
||||
public static to2(
|
||||
startX: number,
|
||||
startY: number,
|
||||
endX: number,
|
||||
endY: number,
|
||||
duration: number
|
||||
): GTweener {
|
||||
return TweenManager.createTween()._to2(startX, startY, endX, endY, duration);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a 3D tween
|
||||
* 创建3D补间
|
||||
*/
|
||||
public static to3(
|
||||
startX: number,
|
||||
startY: number,
|
||||
startZ: number,
|
||||
endX: number,
|
||||
endY: number,
|
||||
endZ: number,
|
||||
duration: number
|
||||
): GTweener {
|
||||
return TweenManager.createTween()._to3(startX, startY, startZ, endX, endY, endZ, duration);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a 4D tween
|
||||
* 创建4D补间
|
||||
*/
|
||||
public static to4(
|
||||
startX: number,
|
||||
startY: number,
|
||||
startZ: number,
|
||||
startW: number,
|
||||
endX: number,
|
||||
endY: number,
|
||||
endZ: number,
|
||||
endW: number,
|
||||
duration: number
|
||||
): GTweener {
|
||||
return TweenManager.createTween()._to4(
|
||||
startX,
|
||||
startY,
|
||||
startZ,
|
||||
startW,
|
||||
endX,
|
||||
endY,
|
||||
endZ,
|
||||
endW,
|
||||
duration
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a color tween
|
||||
* 创建颜色补间
|
||||
*/
|
||||
public static toColor(start: number, end: number, duration: number): GTweener {
|
||||
return TweenManager.createTween()._toColor(start, end, duration);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a delayed call
|
||||
* 创建延迟调用
|
||||
*/
|
||||
public static delayedCall(delay: number): GTweener {
|
||||
return TweenManager.createTween().setDelay(delay);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a shake tween
|
||||
* 创建震动补间
|
||||
*/
|
||||
public static shake(
|
||||
startX: number,
|
||||
startY: number,
|
||||
amplitude: number,
|
||||
duration: number
|
||||
): GTweener {
|
||||
return TweenManager.createTween()._shake(startX, startY, amplitude, duration);
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if target is being tweened
|
||||
* 检查目标是否正在被补间
|
||||
*/
|
||||
public static isTweening(target: any, propType?: any): boolean {
|
||||
return TweenManager.isTweening(target, propType);
|
||||
}
|
||||
|
||||
/**
|
||||
* Kill all tweens on target
|
||||
* 终止目标上的所有补间
|
||||
*/
|
||||
public static kill(target: any, bComplete?: boolean, propType?: any): void {
|
||||
TweenManager.killTweens(target, bComplete, propType);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get tween for target
|
||||
* 获取目标的补间
|
||||
*/
|
||||
public static getTween(target: any, propType?: any): GTweener | null {
|
||||
return TweenManager.getTween(target, propType);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user