@esengine/ecs-framework-math 1.0.5 → 2.8.0

package/bin/MathUtils.d.ts

@@ -0,0 +1,312 @@
+import { Vector2 } from './Vector2';
+/**
+ * 数学工具函数集合
+ *
+ * 提供常用的数学运算、插值、随机数生成等实用工具函数
+ */
+export declare class MathUtils {
+    /** 圆周率 */
+    static readonly PI: number;
+    /** 2π */
+    static readonly TWO_PI: number;
+    /** π/2 */
+    static readonly HALF_PI: number;
+    /** π/4 */
+    static readonly QUARTER_PI: number;
+    /** 角度到弧度转换系数 */
+    static readonly DEG_TO_RAD: number;
+    /** 弧度到角度转换系数 */
+    static readonly RAD_TO_DEG: number;
+    /** 黄金比例 */
+    static readonly GOLDEN_RATIO: number;
+    /** 默认浮点数比较容差 */
+    static readonly EPSILON: number;
+    /**
+   * 角度转弧度
+   * @param degrees 角度值
+   * @returns 弧度值
+   */
+    static degToRad(degrees: number): number;
+    /**
+   * 弧度转角度
+   * @param radians 弧度值
+   * @returns 角度值
+   */
+    static radToDeg(radians: number): number;
+    /**
+   * 规范化角度到[0, 2π)范围
+   * @param radians 角度（弧度）
+   * @returns 规范化后的角度
+   */
+    static normalizeAngle(radians: number): number;
+    /**
+   * 规范化角度到(-π, π]范围
+   * @param radians 角度（弧度）
+   * @returns 规范化后的角度
+   */
+    static normalizeAngleSigned(radians: number): number;
+    /**
+   * 计算两个角度之间的最短角度差
+   * @param from 起始角度（弧度）
+   * @param to 目标角度（弧度）
+   * @returns 角度差（-π到π）
+   */
+    static angleDifference(from: number, to: number): number;
+    /**
+   * 角度插值（处理角度环绕）
+   * @param from 起始角度（弧度）
+   * @param to 目标角度（弧度）
+   * @param t 插值参数（0到1）
+   * @returns 插值结果角度
+   */
+    static lerpAngle(from: number, to: number, t: number): number;
+    /**
+   * 限制数值在指定范围内
+   * @param value 待限制的值
+   * @param min 最小值
+   * @param max 最大值
+   * @returns 限制后的值
+   */
+    static clamp(value: number, min: number, max: number): number;
+    /**
+   * 限制数值在0到1之间
+   * @param value 待限制的值
+   * @returns 限制后的值
+   */
+    static clamp01(value: number): number;
+    /**
+   * 线性插值
+   * @param a 起始值
+   * @param b 目标值
+   * @param t 插值参数（0到1）
+   * @returns 插值结果
+   */
+    static lerp(a: number, b: number, t: number): number;
+    /**
+   * 反向线性插值（获取插值参数）
+   * @param a 起始值
+   * @param b 目标值
+   * @param value 当前值
+   * @returns 插值参数
+   */
+    static inverseLerp(a: number, b: number, value: number): number;
+    /**
+   * 重映射数值从一个范围到另一个范围
+   * @param value 输入值
+   * @param inMin 输入范围最小值
+   * @param inMax 输入范围最大值
+   * @param outMin 输出范围最小值
+   * @param outMax 输出范围最大值
+   * @returns 重映射后的值
+   */
+    static remap(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
+    /**
+   * 平滑阶跃函数（Hermite插值）
+   * @param t 输入参数（0到1）
+   * @returns 平滑输出（0到1）
+   */
+    static smoothStep(t: number): number;
+    /**
+   * 更平滑的阶跃函数
+   * @param t 输入参数（0到1）
+   * @returns 平滑输出（0到1）
+   */
+    static smootherStep(t: number): number;
+    /**
+   * 浮点数相等比较
+   * @param a 数值a
+   * @param b 数值b
+   * @param epsilon 容差，默认为EPSILON
+   * @returns 是否相等
+   */
+    static approximately(a: number, b: number, epsilon?: number): boolean;
+    /**
+   * 检查数值是否为零
+   * @param value 数值
+   * @param epsilon 容差，默认为EPSILON
+   * @returns 是否为零
+   */
+    static isZero(value: number, epsilon?: number): boolean;
+    /**
+   * 获取数值的符号
+   * @param value 数值
+   * @returns 1、-1或0
+   */
+    static sign(value: number): number;
+    /**
+   * 生成指定范围内的随机数
+   * @param min 最小值（包含）
+   * @param max 最大值（不包含）
+   * @returns 随机数
+   */
+    static random(min?: number, max?: number): number;
+    /**
+   * 生成指定范围内的随机整数
+   * @param min 最小值（包含）
+   * @param max 最大值（包含）
+   * @returns 随机整数
+   */
+    static randomInt(min: number, max: number): number;
+    /**
+   * 随机选择数组中的一个元素
+   * @param array 数组
+   * @returns 随机元素
+   */
+    static randomChoice<T>(array: T[]): T;
+    /**
+   * 生成随机布尔值
+   * @param probability 为true的概率（0到1），默认0.5
+   * @returns 随机布尔值
+   */
+    static randomBoolean(probability?: number): boolean;
+    /**
+   * 生成单位圆内的随机点
+   * @returns 随机向量
+   */
+    static randomInUnitCircle(): Vector2;
+    /**
+   * 生成单位圆上的随机点
+   * @returns 随机单位向量
+   */
+    static randomOnUnitCircle(): Vector2;
+    /**
+   * 快速平方根倒数（用于归一化）
+   * @param value 输入值
+   * @returns 平方根倒数
+   */
+    static fastInverseSqrt(value: number): number;
+    /**
+   * 快速幂运算（整数指数）
+   * @param base 底数
+   * @param exponent 指数（整数）
+   * @returns 幂运算结果
+   */
+    static fastPow(base: number, exponent: number): number;
+    /**
+   * 阶乘
+   * @param n 非负整数
+   * @returns 阶乘结果
+   */
+    static factorial(n: number): number;
+    /**
+   * 最大公约数
+   * @param a 整数a
+   * @param b 整数b
+   * @returns 最大公约数
+   */
+    static gcd(a: number, b: number): number;
+    /**
+   * 最小公倍数
+   * @param a 整数a
+   * @param b 整数b
+   * @returns 最小公倍数
+   */
+    static lcm(a: number, b: number): number;
+    /**
+   * 斐波那契数列
+   * @param n 项数
+   * @returns 第n项斐波那契数
+   */
+    static fibonacci(n: number): number;
+    /**
+   * 等差数列求和
+   * @param first 首项
+   * @param last 末项
+   * @param count 项数
+   * @returns 等差数列和
+   */
+    static arithmeticSum(first: number, last: number, count: number): number;
+    /**
+   * 等比数列求和
+   * @param first 首项
+   * @param ratio 公比
+   * @param count 项数
+   * @returns 等比数列和
+   */
+    static geometricSum(first: number, ratio: number, count: number): number;
+    /**
+   * 贝塞尔二次曲线
+   * @param p0 控制点0
+   * @param p1 控制点1
+   * @param p2 控制点2
+   * @param t 参数（0到1）
+   * @returns 曲线上的点
+   */
+    static quadraticBezier(p0: Vector2, p1: Vector2, p2: Vector2, t: number): Vector2;
+    /**
+   * 贝塞尔三次曲线
+   * @param p0 控制点0
+   * @param p1 控制点1
+   * @param p2 控制点2
+   * @param p3 控制点3
+   * @param t 参数（0到1）
+   * @returns 曲线上的点
+   */
+    static cubicBezier(p0: Vector2, p1: Vector2, p2: Vector2, p3: Vector2, t: number): Vector2;
+    /**
+   * Catmull-Rom样条插值
+   * @param p0 控制点0
+   * @param p1 控制点1
+   * @param p2 控制点2
+   * @param p3 控制点3
+   * @param t 参数（0到1）
+   * @returns 插值结果点
+   */
+    static catmullRom(p0: Vector2, p1: Vector2, p2: Vector2, p3: Vector2, t: number): Vector2;
+    /**
+   * 简单伪随机噪声（基于种子）
+   * @param x 输入X
+   * @param y 输入Y
+   * @param seed 种子
+   * @returns 噪声值（0到1）
+   */
+    static noise(x: number, y?: number, seed?: number): number;
+    /**
+   * 平滑噪声
+   * @param x 输入X
+   * @param y 输入Y
+   * @param seed 种子
+   * @returns 平滑噪声值（0到1）
+   */
+    static smoothNoise(x: number, y?: number, seed?: number): number;
+    /**
+   * 将数值转换为指定精度
+   * @param value 数值
+   * @param precision 精度（小数位数）
+   * @returns 转换后的数值
+   */
+    static toPrecision(value: number, precision: number): number;
+    /**
+   * 检查数值是否在指定范围内
+   * @param value 数值
+   * @param min 最小值
+   * @param max 最大值
+   * @returns 是否在范围内
+   */
+    static inRange(value: number, min: number, max: number): boolean;
+    /**
+   * 获取数组中的最小值
+   * @param values 数值数组
+   * @returns 最小值
+   */
+    static min(...values: number[]): number;
+    /**
+   * 获取数组中的最大值
+   * @param values 数值数组
+   * @returns 最大值
+   */
+    static max(...values: number[]): number;
+    /**
+   * 计算数组的平均值
+   * @param values 数值数组
+   * @returns 平均值
+   */
+    static average(values: number[]): number;
+    /**
+   * 计算数组的中位数
+   * @param values 数值数组
+   * @returns 中位数
+   */
+    static median(values: number[]): number;
+}
+//# sourceMappingURL=MathUtils.d.ts.map

package/bin/MathUtils.d.ts.map

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