@cjhd/cj-ecs 1.0.0 → 1.0.1

package/assets/lib/EcsTween.ts

@@ -1,486 +0,0 @@
-import { math } from 'cc';
-import { EcsComponent } from '../ecs/EcsComponent';
-
-// 将Base(类)对应实例中所有值为Type类型的key去除，返回string的复合类型(被过滤后的key)
-type KeyofFilterType<Base, ExcludedType> = {
-    [key in keyof Base]: Base[key] extends ExcludedType ? never : key;
-}[keyof Base];
-
-// 将Base(类)对应实例中所有键为Key类型的key去除，返回string的复合类型(被过滤后的key)
-type KeyofFilterKey<Base, ExcludedKey> = {
-    [key in keyof Base]: key extends ExcludedKey ? never : key;
-}[keyof Base];
-
-type ExcludedKey = keyof EcsComponent; //| keyof INodeReadonly;
-type PropType<Base> = Partial<
-    Pick<Base, KeyofFilterType<
-        Pick<Base, KeyofFilterKey<Base, ExcludedKey>>,
-        Function | string | object
-    >>
->;
-
-interface ITweenOption {
-    /**
-     * @en
-     * Easing function, you can pass in a string or custom function.
-     * @zh
-     * 缓动函数，可以使用已有的，也可以传入自定义的函数。
-     */
-    easing?: ((k: number) => number);
-}
-
-type IObject = { [key: string]: any };
-
-enum ActionType {
-    None,
-    To,
-    By
-}
-
-// 动作基类
-class Action {
-}
-
-// 属性动作
-class PropAction extends Action {
-    type: ActionType = ActionType.None;
-    /**进度 */
-    ratio: number = 0;
-    /**时间 */
-    time: number = 0;
-    /**结束属性 */
-    end: { [key: string]: any } | null = null;
-    /**开始属性 */
-    start: { [key: string]: any } | null = null;
-    /**缓动函数 */
-    easing: ITweenOption['easing'] | null = null;
-}
-
-// 贝塞尔属性动作
-class BezierPropAction extends PropAction {
-    /**控制位属性 */
-    control: { [key: string]: any } | null = null;
-}
-
-// 等待动作
-class DelayAction extends Action {
-    delay: number = 0;
-}
-
-// 回调动作
-class CallAction extends Action {
-    callback: Function | null = null;
-}
-
-let tid = 0;
-
-/**
- * 缓动
- */
-export class Tween<T extends EcsComponent> {
-    static step(tween: Tween<EcsComponent>, dt: number) {
-        const action = tween.actions[0];
-        if (action instanceof DelayAction) {
-            action.delay -= dt;
-            if (action.delay <= 0) {
-                tween.actions.shift();
-            }
-        } else if (action instanceof CallAction) {
-            if (action.callback) {
-                tween.actions.shift();
-                action.callback();
-            }
-        } else if (action instanceof PropAction) {
-            if (tween.target.isValid) {
-                // 整体进度
-                action.ratio = Math.min(action.ratio + dt / action.time, 1);
-                // 完成移除
-                if (action.ratio >= 1) {
-                    tween.actions.shift();
-                }
-                // 应用缓动函数后的进度
-                const ratio = action.easing ? action.easing(action.ratio) : action.ratio;
-                // 计算动态数值
-                if (!action.start) {
-                    // 初始化起点坐标
-                    action.start = Tween.getStartValue(action.end!, tween.target);
-                    if (action.type === ActionType.By) {
-                        if (action instanceof BezierPropAction) {
-                            action.end = Tween.getEndValue(action.end!, tween.target);
-                            action.control = Tween.getStartValue(action.control!, tween.target);
-                        } else {
-                            action.end = Tween.getEndValue(action.end!, tween.target);
-                        }
-                    }
-                }
-                // 插值运算
-                if (action instanceof BezierPropAction) {
-                    Tween.bezier(ratio, action.start, action.control!, action.end!, tween.target);
-                } else {
-                    Tween.lerp(ratio, action.start, action.end!, tween.target);
-                }
-            } else {
-                tween.actions.shift();
-            }
-        } else {
-            tween.actions.shift();
-        }
-
-        return tween.actions.length > 0;
-    }
-
-    private _id = ++tid;
-    public get id() {
-        return this._id;
-    }
-
-    /**动作列表 */
-    private actions: Action[] = [];
-
-    private _target!: T;
-    public get target(): T {
-        return this._target;
-    }
-
-    constructor(target: T) {
-        this._target = target;
-    }
-
-    /**
-     * 等待
-     * @param delay
-     * @returns 
-     */
-    delay(delay: number) {
-        const action = new DelayAction();
-        action.delay = delay;
-        this.actions.push(action);
-        return this;
-    }
-
-    /**
-     * 执行
-     * @param callback 
-     * @returns 
-     */
-    call(callback: Function) {
-        const action = new CallAction();
-        action.callback = callback;
-        this.actions.push(action);
-        return this;
-    }
-
-    /**
-     * 绝对缓动
-     * @param time 时间
-     * @param props 属性(只能是简单类型)
-     * @param opts 选项
-     * @returns 
-     */
-    to(time: number, props: PropType<T>, opts?: ITweenOption) {
-        const action = new PropAction();
-        action.type = ActionType.To;
-        action.ratio = 0;
-        action.time = Math.max(time, 0);
-        action.end = Tween.getCopyValue(props);
-        action.start = null;// 运行时动态计算
-        action.easing = opts?.easing || null;
-        this.actions.push(action);
-        return this;
-    }
-
-    /**
-     * 相对缓动
-     * @param time 时间
-     * @param props 属性(只能是简单类型)
-     * @param opts 选项
-     * @returns 
-     */
-    by<T extends EcsComponent>(time: number, target: T, props: PropType<T>, opts?: ITweenOption) {
-        const action = new PropAction();
-        action.type = ActionType.By;
-        action.ratio = 0;
-        action.time = Math.max(time, 0);
-        action.end = Tween.getCopyValue(props);// 运行时动态计算
-        action.start = null;// 运行时动态计算
-        action.easing = opts?.easing || null;
-        this.actions.push(action);
-        return this;
-    }
-
-    /**
-     * 绝对贝塞尔缓动
-     * @param time 时间
-     * @param target 目标
-     * @param props 属性(只能是简单类型)
-     * @param control 控制值(影响曲线幅度)
-     * @param opts 选项
-     * @returns 
-     */
-    bezierTo<T extends EcsComponent, K extends PropType<T>>(time: number, target: T, props: K, control: Required<K>, opts?: ITweenOption) {
-        const action = new BezierPropAction();
-        action.type = ActionType.To;
-        action.ratio = 0;
-        action.time = Math.max(time, 0);
-        action.control = Tween.getStartValue(props, control);
-        action.end = Tween.getCopyValue(props);
-        action.start = null;// 运行时动态计算
-        action.easing = opts?.easing || null;
-        this.actions.push(action);
-        return this;
-    }
-
-    /**
-     * 相对贝塞尔缓动
-     * @param time 时间
-     * @param target 目标
-     * @param props 属性(只能是简单类型)
-     * @param control 控制值(影响曲线幅度)
-     * @param opts 选项
-     */
-    bezierBy<T extends EcsComponent, K extends PropType<T>>(time: number, target: T, props: K, control: Required<K>, opts?: ITweenOption) {
-        const action = new BezierPropAction();
-        action.type = ActionType.By;
-        action.ratio = 0;
-        action.time = Math.max(time, 0);
-        action.end = Tween.getCopyValue(props);// 运行时动态计算
-        action.control = Tween.getCopyValue(control);// 运行时动态计算
-        action.start = null;// 运行时动态计算
-        action.easing = opts?.easing || null;
-        this.actions.push(action);
-        this.actions.push(action);
-    }
-
-    /**
-     * 拷贝数值
-     */
-    private static getCopyValue(props: IObject) {
-        const copy: IObject = {};
-
-        for (const key in props) {
-            if (Object.prototype.hasOwnProperty.call(props, key)) {
-                if (typeof props[key] === 'number' || typeof props[key] === 'boolean') {
-                    copy[key] = props[key];
-                } else if (props[key] && typeof props[key] === 'object') {
-                    copy[key] = this.getCopyValue(props[key]);
-                }
-            }
-        }
-        return copy;
-    }
-
-    /**
-     * 获取目标值
-     * @param props 差值
-     * @param target 原始值
-     */
-    private static getEndValue(props: IObject, target: IObject = {}) {
-        const end: IObject = {};
-
-        for (const key in props) {
-            if (Object.prototype.hasOwnProperty.call(props, key)) {
-                if (typeof props[key] === 'number') {
-                    end[key] = props[key] + (target[key] || 0);
-                } else if (typeof props[key] === 'boolean') {
-                    end[key] = props[key];
-                } else if (props[key] && typeof props[key] === 'object') {
-                    end[key] = this.getEndValue(props[key], target[key]);
-                }
-            }
-        }
-        return end;
-    }
-
-    /**
-     * 获取初始值
-     * @param props 作为过滤使用
-     * @param target 原始值
-     */
-    private static getStartValue(props: IObject, target: IObject = {}) {
-        const start: IObject = {};
-
-        for (const key in props) {
-            if (Object.prototype.hasOwnProperty.call(props, key)) {
-                if (typeof props[key] === 'number') {
-                    start[key] = target[key] || 0;
-                } else if (typeof props[key] === 'boolean') {
-                    start[key] = target[key] || false;
-                } else if (props[key] && typeof props[key] === 'object') {
-                    start[key] = this.getStartValue(props[key], target[key]);
-                }
-            }
-        }
-        return start;
-    }
-
-    private static lerp(ratio: number, start: IObject, end: IObject, data: IObject = {}) {
-        for (const key in start) {
-            if (Object.prototype.hasOwnProperty.call(start, key)) {
-                if (typeof start[key] === 'number') {
-                    data[key] = math.lerp(start[key], end[key], ratio);
-                } else if (typeof start[key] === 'boolean') {
-                    data[key] = ratio >= 1 ? end[key] : start[key];
-                } else if (start[key] && typeof start[key] === 'object') {
-                    this.lerp(ratio, start[key], end[key], data[key]);
-                }
-            }
-        }
-    }
-
-    private static bezier(ratio: number, start: IObject, control: IObject, end: IObject, data: IObject = {}) {
-        for (const key in start) {
-            if (Object.prototype.hasOwnProperty.call(start, key)) {
-                if (typeof start[key] === 'number') {
-                    const n1 = math.lerp(start[key], control[key], ratio);
-                    const n2 = math.lerp(control[key], end[key], ratio);
-                    data[key] = math.lerp(n1, n2, ratio);
-                } else if (typeof start[key] === 'boolean') {
-                    data[key] = ratio >= 1 ? end[key] : start[key];
-                } else if (start[key] && typeof start[key] === 'object') {
-                    this.lerp(ratio, start[key], end[key], data[key]);
-                }
-            }
-        }
-    }
-}
-
-/**
- * 创建一个缓动
- */
-export function tween<T extends EcsComponent>(target: T) {
-    return new Tween<T>(target);
-}
-
-/**
- * 缓动管理器
- */
-export class TweenManager {
-    private map = new Map<number, Tween<EcsComponent>>();
-    private pausing = new Map<number, true>();
-
-    /**
-     * 添加tween
-     * @param tween 
-     * @returns id 永远大于0
-     */
-    add(tween: Tween<EcsComponent>) {
-        this.map.set(tween.id, tween);
-        return tween.id;
-    }
-
-    /**
-     * 移除指定的tween
-     * @param id 
-     */
-    remove(id: number): void;
-    /**
-     * 移除指定的tween
-     * @param tween 
-     */
-    remove(tween: Tween<EcsComponent>): void;
-    /**
-     * 移除指定target的所有tween
-     * @param target 
-     */
-    remove(target: EcsComponent): void;
-    remove(param: number | EcsComponent | Tween<EcsComponent>) {
-        if (typeof param === 'number') {
-            this.map.delete(param);
-            this.pausing.delete(param);
-        } else if (param instanceof Tween) {
-            this.map.delete(param.id);
-            this.pausing.delete(param.id);
-        } else {
-            this.map.forEach((tween, tid) => {
-                if (tween.target === param) {
-                    this.map.delete(tid);
-                    this.pausing.delete(tid);
-                }
-            });
-        }
-    }
-
-    /**
-     * 暂停指定的tween
-     * @param id 
-     */
-    pause(id: number): void;
-    /**
-     * 暂停指定的tween
-     * @param tween 
-     */
-    pause(tween: Tween<EcsComponent>): void;
-    /**
-     * 暂停指定target的所有tween
-     * @param target 
-     */
-    pause(target: EcsComponent): void;
-    pause(param: number | EcsComponent | Tween<EcsComponent>) {
-        if (typeof param === 'number') {
-            this.pausing.set(param, true);
-        } else if (param instanceof Tween) {
-            this.pausing.set(param.id, true);
-        } else {
-            this.map.forEach((tween, tid) => {
-                if (tween.target === param) {
-                    this.pausing.set(tid, true);
-                }
-            });
-        }
-    }
-
-    /**
-     * 恢复指定的tween
-     * @param id 
-     */
-    resume(id: number): void;
-    /**
-     * 恢复指定的tween
-     * @param tween 
-     */
-    resume(tween: Tween<EcsComponent>): void;
-    /**
-     * 恢复指定target的所有tween
-     * @param target 
-     */
-    resume(target: EcsComponent): void;
-    resume(param: number | EcsComponent | Tween<EcsComponent>) {
-        if (typeof param === 'number') {
-            this.pausing.delete(param);
-        } else if (param instanceof Tween) {
-            this.pausing.delete(param.id);
-        } else {
-            this.map.forEach((tween, tid) => {
-                if (tween.target === param) {
-                    this.pausing.delete(tid);
-                }
-            });
-        }
-    }
-
-    /**
-     * 迭代一次
-     */
-    step(dt: number) {
-        this.map.forEach((tween, tid) => {
-            // 暂停中，则跳过
-            if (this.pausing.has(tid)) return;
-            // 执行次数达到上限，则移除
-            if (Tween.step(tween, dt) === false) {
-                this.map.delete(tid);
-            }
-        });
-    }
-
-    get size() {
-        return this.map.size;
-    }
-
-    /**
-     * 清空
-     */
-    clear() {
-        this.map.clear();
-        this.pausing.clear();
-    }
-}

package/assets/lib/EcsTween.ts.meta

@@ -1,9 +0,0 @@
-{
-  "ver": "4.0.24",
-  "importer": "typescript",
-  "imported": true,
-  "uuid": "3fccdc1f-0ce5-4af7-a3a2-bbe54230fd6e",
-  "files": [],
-  "subMetas": {},
-  "userData": {}
-}