light-h5-core-lib 2.10.11 → 2.11.0

package/LightCore.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MapUtil = exports.CollisionDetectionUtil = exports.SelfDecrypt = exports.GetDecorateUtils = exports.NumberUtil = exports.BooleanUtil = exports.Crc32Util = exports.PromiseUtil = exports.BeizerUtil = exports.UniqueIDUtil = exports.StringUtil = exports.RandomNumUtil = exports.FloatDigitUtil = exports.DateUtil = exports.BitUtil = exports.MD5 = exports.BaseSingleton = exports.SetterGetterBase = exports.ClassNameUtil = exports.PoolObj = exports.PoolObjPutStatus = void 0;
+exports.MapUtil = exports.CollisionDetectionUtil = exports.SelfDecrypt = exports.GetDecorateUtils = exports.NumberUtil = exports.BooleanUtil = exports.Crc32Util = exports.PromiseUtil = exports.BeizerUtil = exports.UniqueIDUtil = exports.StringUtil = exports.RandomNumUtil = exports.FloatDigitUtil = exports.DateUtil = exports.BitUtil = exports.MD5 = exports.BaseSingleton = exports.SetterGetterBase = exports.ClassNameUtil = exports.PoolObj = exports.PoolObjPutStatus = exports.BeizerPositionsLerpUtil = void 0;
 const PoolObj_1 = require("./pool/PoolObj");
 Object.defineProperty(exports, "PoolObj", { enumerable: true, get: function () { return PoolObj_1.PoolObj; } });
 const BaseSingleton_1 = require("./common/base/BaseSingleton");
@@ -46,7 +46,10 @@ const MapUtil_1 = require("./common/util/MapUtil");
 Object.defineProperty(exports, "MapUtil", { enumerable: true, get: function () { return MapUtil_1.MapUtil; } });
 const PoolObjPutStatus_1 = require("./pool/PoolObjPutStatus");
 Object.defineProperty(exports, "PoolObjPutStatus", { enumerable: true, get: function () { return PoolObjPutStatus_1.PoolObjPutStatus; } });
+const BeizerPositionsLerpUtil_1 = require("./common/util/BeizerPositionsLerpUtil");
+Object.defineProperty(exports, "BeizerPositionsLerpUtil", { enumerable: true, get: function () { return BeizerPositionsLerpUtil_1.BeizerPositionsLerpUtil; } });
 module.exports = {
+    BeizerPositionsLerpUtil: BeizerPositionsLerpUtil_1.BeizerPositionsLerpUtil,
     PoolObjPutStatus: PoolObjPutStatus_1.PoolObjPutStatus,
     PoolObj: PoolObj_1.PoolObj,
     ClassNameUtil: ClassNameUtil_1.ClassNameUtil,

package/common/util/BeizerPositionsLerpUtil.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BeizerPositionsLerpUtil = void 0;
+/**
+ * 贝塞尔曲线坐标点插值算法
+ * @author Aonaufly
+ */
+class BeizerPositionsLerpUtil {
+    /**
+     * 根据开始坐标和结束坐标计算整个贝塞尔曲线的坐标点集合
+     * @param startPosition 开始坐标
+     * @param endPosition 结束坐标
+     * @param addCount 再添加的坐标点数(startPosition + addCount + endPosition) default 1
+     * @param amplitude 幅度（1: 最大为开始坐标与结束坐标的距离的一半）default 0.4
+     * @param distanceMultiple 距离倍数（1=线段内, >1则控制点可向两端外延，如1.5=两端各外延0.25倍线段长度）default 1.0
+     * @returns 控制点集合
+     */
+    static generateControlPoints(startPosition, endPosition, addCount = 1, amplitude = 0.4, distanceMultiple = 1.0) {
+        const result = [{ x: startPosition.x, y: startPosition.y }];
+        if (addCount <= 0) {
+            result.push({ x: endPosition.x, y: endPosition.y });
+            return result;
+        }
+        // 连接线方向向量
+        const dx = endPosition.x - startPosition.x;
+        const dy = endPosition.y - startPosition.y;
+        const len = Math.sqrt(dx * dx + dy * dy);
+        if (len < 0.000001) {
+            // 起点与终点重合，直接返回
+            for (let i = 0; i < addCount; i++) {
+                result.push({ x: startPosition.x, y: startPosition.y });
+            }
+            result.push({ x: endPosition.x, y: endPosition.y });
+            return result;
+        }
+        // 单位方向向量
+        const ux = dx / len;
+        const uy = dy / len;
+        // 垂直方向向量（法向量），旋转90度
+        const nx = -uy;
+        const ny = ux;
+        // 添加点到连接线的最大距离：amplitude * 0.5 * 连接线长度
+        const maxDistance = amplitude * 0.5 * len;
+        // 投影延伸：distanceMultiple=1时投影范围在[0,1]内，>1时向两端外延
+        const extension = (distanceMultiple - 1) * 0.5;
+        // 上一个添加点所在的侧（1 或 -1），用于交替偏向
+        let prevSide = 0;
+        for (let i = 0; i < addCount; i++) {
+            // 在连接线上的投影比例 t ∈ (0, 1)，均匀分布
+            const t = (i + 1) / (addCount + 1);
+            // 映射到实际投影比例：t=0时映射到-extension（起点外侧），t=1时映射到1+extension（终点外侧）
+            const effectiveT = t * distanceMultiple - extension;
+            // 投影点坐标
+            const px = startPosition.x + dx * effectiveT;
+            const py = startPosition.y + dy * effectiveT;
+            // 随机距离 ∈ (0, maxDistance]，确保不在连接线上
+            const randomFactor = 0.1 + Math.random() * 0.9;
+            const distance = randomFactor * maxDistance;
+            // 选择连接线的一侧
+            // 若有上一个点，偏向另一侧的概率为 75%（基础50%增加50%）
+            // 若无上一个点（第一个添加点），各侧50%
+            let side;
+            if (prevSide === 0) {
+                side = Math.random() > 0.5 ? 1 : -1;
+            }
+            else {
+                side = Math.random() < 0.75 ? -prevSide : prevSide;
+            }
+            // 沿法向量偏移得到最终坐标
+            result.push({
+                x: px + nx * distance * side,
+                y: py + ny * distance * side,
+            });
+            prevSide = side;
+        }
+        result.push({ x: endPosition.x, y: endPosition.y });
+        return result;
+    }
+}
+exports.BeizerPositionsLerpUtil = BeizerPositionsLerpUtil;

package/common/util/BeizerUtil.js

@@ -24,6 +24,29 @@ class BeizerUtil {
         }
         return { x, y };
     }
+    /**
+     * 获得当前时间的切线（运动方向）(慎用: 耗性能)
+     * @param timer 时间[0,1]
+     * @returns 切线
+     */
+    static getTangent(points, timer) {
+        if (points.length < 2) {
+            return { x: 0, y: 0 };
+        }
+        // 导数控制点: Q_i = P_{i+1} - P_i
+        const derivativePoints = [];
+        for (let i = 0; i < points.length - 1; i++) {
+            derivativePoints.push({
+                x: points[i + 1].x - points[i].x,
+                y: points[i + 1].y - points[i].y,
+            });
+        }
+        // 在导数控制点上计算 n-2 阶贝塞尔值
+        const pos = BeizerUtil.getPosition(derivativePoints, timer);
+        // 乘以 (n-1) 得到最终切线
+        const n = points.length;
+        return { x: pos.x * (n - 1), y: pos.y * (n - 1) };
+    }
     //#endregion
     //region 获得路线的长度
     static distance(p1, p2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "light-h5-core-lib",
-  "version": "2.10.11",
+  "version": "2.11.0",
   "description": "light core lib",
   "main": "./LightCore.js",
   "types": "./type/index.d.ts",

package/type/index.d.ts

@@ -309,6 +309,18 @@ export declare class BeizerUtil {
 		x: number;
 		y: number;
 	};
+	/**
+	 * 获得当前时间的切线（运动方向）(慎用: 耗性能)
+	 * @param timer 时间[0,1]
+	 * @returns 切线
+	 */
+	static getTangent(points: {
+		x: number;
+		y: number;
+	}[], timer: number): {
+		x: number;
+		y: number;
+	};
 	private static calculationC;
 	private static factorial;
 	private static distance;
@@ -442,7 +454,7 @@ export declare class CollisionDetectionUtil {
 	 * @param aBox
 	 * @param bBox
 	 */
-	static aABB(aAnchor: Vec2, bAnchor: Vec2, aBox: IBoxInfo, bBox: IBoxInfo): boolean;
+	static aABB(aAnchor: CoreVec2, bAnchor: CoreVec2, aBox: IBoxInfo, bBox: IBoxInfo): boolean;
 	/**
 	 * OBB检测
 	 * @param aCenter A的中心位置
@@ -450,13 +462,13 @@ export declare class CollisionDetectionUtil {
 	 * @param aOBB
 	 * @param bOBB
 	 */
-	static oBB(aCenter: Vec2, bCenter: Vec2, aOBB: IOBBInfo, bOBB: IOBBInfo): boolean;
+	static oBB(aCenter: CoreVec2, bCenter: CoreVec2, aOBB: IOBBInfo, bOBB: IOBBInfo): boolean;
 	/**
 	 * 多边形检测
 	 * @param aVertices A的每个点的位置
 	 * @param bVertices B的每个点的位置
 	 */
-	static polygon(aVertices: Vec2[], bVertices: Vec2[]): boolean;
+	static polygon(aVertices: CoreVec2[], bVertices: CoreVec2[]): boolean;
 	/**
 	 * 检测旋转矩形和圆形是否相交<br>
 	 * <div style="color: #FF0000;">锚点都为0.5</div>
@@ -464,10 +476,10 @@ export declare class CollisionDetectionUtil {
 	 * @param rect 矩形
 	 */
 	static circle2Rect(circle: {
-		position: Vec2;
+		position: CoreVec2;
 		radius: number;
 	}, rect: {
-		position: Vec2;
+		position: CoreVec2;
 		width: number;
 		height: number;
 		angle: number;
@@ -476,10 +488,10 @@ export declare class CollisionDetectionUtil {
 	 * 2个圆形是否碰撞
 	 */
 	static circle2Circle(aCircle: {
-		position: Vec2;
+		position: CoreVec2;
 		radius: number;
 	}, bCircle: {
-		position: Vec2;
+		position: CoreVec2;
 		radius: number;
 	}): boolean;
 	/**
@@ -489,7 +501,7 @@ export declare class CollisionDetectionUtil {
 	 * @param ellipseAxis 椭圆轴
 	 * @returns
 	 */
-	static IsInEllipse(pos: Vec2, centerPos: Vec2, ellipseAxis: Vec2): boolean;
+	static IsInEllipse(pos: CoreVec2, centerPos: CoreVec2, ellipseAxis: CoreVec2): boolean;
 }
 export interface IBoxInfo {
 	x: number;
@@ -497,7 +509,7 @@ export interface IBoxInfo {
 	width: number;
 	height: number;
 }
-export interface Vec2 {
+export interface CoreVec2 {
 	x: number;
 	y: number;
 }
@@ -594,5 +606,21 @@ export declare class MapUtil {
 	 */
 	static clearEmptyValue<KEY, VALUE>(targetMap: Map<KEY, VALUE>, isNeedClearCallback?: (item: VALUE) => boolean): void;
 }
+/**
+ * 贝塞尔曲线坐标点插值算法
+ * @author Aonaufly
+ */
+export declare class BeizerPositionsLerpUtil {
+	/**
+	 * 根据开始坐标和结束坐标计算整个贝塞尔曲线的坐标点集合
+	 * @param startPosition 开始坐标
+	 * @param endPosition 结束坐标
+	 * @param addCount 再添加的坐标点数(startPosition + addCount + endPosition) default 1
+	 * @param amplitude 幅度（1: 最大为开始坐标与结束坐标的距离的一半）default 0.4
+	 * @param distanceMultiple 距离倍数（1=线段内, >1则控制点可向两端外延，如1.5=两端各外延0.25倍线段长度）default 1.0
+	 * @returns 控制点集合
+	 */
+	static generateControlPoints(startPosition: CoreVec2, endPosition: CoreVec2, addCount?: number, amplitude?: number, distanceMultiple?: number): CoreVec2[];
+}
 
 export {};