chore: 添加第三方依赖库

thirdparty/rapier.js/src.ts/geometry/ray.ts

@@ -0,0 +1,192 @@
+import {Vector, VectorOps} from "../math";
+import {
+    RawFeatureType,
+    RawRayColliderIntersection,
+    RawRayColliderHit,
+    RawRayIntersection,
+} from "../raw";
+import {Collider} from "./collider";
+import {FeatureType} from "./feature";
+import {ColliderSet} from "./collider_set";
+
+/**
+ * A ray. This is a directed half-line.
+ */
+export class Ray {
+    /**
+     * The starting point of the ray.
+     */
+    public origin: Vector;
+    /**
+     * The direction of propagation of the ray.
+     */
+    public dir: Vector;
+
+    /**
+     * Builds a ray from its origin and direction.
+     *
+     * @param origin - The ray's starting point.
+     * @param dir - The ray's direction of propagation.
+     */
+    constructor(origin: Vector, dir: Vector) {
+        this.origin = origin;
+        this.dir = dir;
+    }
+
+    public pointAt(t: number): Vector {
+        return {
+            x: this.origin.x + this.dir.x * t,
+            y: this.origin.y + this.dir.y * t,
+            // #if DIM3
+            z: this.origin.z + this.dir.z * t,
+            // #endif
+        };
+    }
+}
+
+/**
+ * The intersection between a ray and a collider.
+ */
+export class RayIntersection {
+    /**
+     * The time-of-impact of the ray with the collider.
+     *
+     * The hit point is obtained from the ray's origin and direction: `origin + dir * timeOfImpact`.
+     */
+    timeOfImpact: number;
+    /**
+     * The normal of the collider at the hit point.
+     */
+    normal: Vector;
+
+    /**
+     * The type of the geometric feature the point was projected on.
+     */
+    featureType = FeatureType.Unknown;
+
+    /**
+     * The id of the geometric feature the point was projected on.
+     */
+    featureId: number | undefined = undefined;
+
+    constructor(
+        timeOfImpact: number,
+        normal: Vector,
+        featureType?: FeatureType,
+        featureId?: number,
+    ) {
+        this.timeOfImpact = timeOfImpact;
+        this.normal = normal;
+        if (featureId !== undefined) this.featureId = featureId;
+        if (featureType !== undefined) this.featureType = featureType;
+    }
+
+    public static fromRaw(raw: RawRayIntersection): RayIntersection {
+        if (!raw) return null;
+
+        const result = new RayIntersection(
+            raw.time_of_impact(),
+            VectorOps.fromRaw(raw.normal()),
+            raw.featureType() as number as FeatureType,
+            raw.featureId(),
+        );
+        raw.free();
+        return result;
+    }
+}
+
+/**
+ * The intersection between a ray and a collider (includes the collider handle).
+ */
+export class RayColliderIntersection {
+    /**
+     * The collider hit by the ray.
+     */
+    collider: Collider;
+    /**
+     * The time-of-impact of the ray with the collider.
+     *
+     * The hit point is obtained from the ray's origin and direction: `origin + dir * timeOfImpact`.
+     */
+    timeOfImpact: number;
+    /**
+     * The normal of the collider at the hit point.
+     */
+    normal: Vector;
+
+    /**
+     * The type of the geometric feature the point was projected on.
+     */
+    featureType = FeatureType.Unknown;
+
+    /**
+     * The id of the geometric feature the point was projected on.
+     */
+    featureId: number | undefined = undefined;
+
+    constructor(
+        collider: Collider,
+        timeOfImpact: number,
+        normal: Vector,
+        featureType?: FeatureType,
+        featureId?: number,
+    ) {
+        this.collider = collider;
+        this.timeOfImpact = timeOfImpact;
+        this.normal = normal;
+        if (featureId !== undefined) this.featureId = featureId;
+        if (featureType !== undefined) this.featureType = featureType;
+    }
+
+    public static fromRaw(
+        colliderSet: ColliderSet,
+        raw: RawRayColliderIntersection,
+    ): RayColliderIntersection {
+        if (!raw) return null;
+
+        const result = new RayColliderIntersection(
+            colliderSet.get(raw.colliderHandle()),
+            raw.time_of_impact(),
+            VectorOps.fromRaw(raw.normal()),
+            raw.featureType() as number as FeatureType,
+            raw.featureId(),
+        );
+        raw.free();
+        return result;
+    }
+}
+
+/**
+ * The time of impact between a ray and a collider.
+ */
+export class RayColliderHit {
+    /**
+     * The handle of the collider hit by the ray.
+     */
+    collider: Collider;
+    /**
+     * The time-of-impact of the ray with the collider.
+     *
+     * The hit point is obtained from the ray's origin and direction: `origin + dir * timeOfImpact`.
+     */
+    timeOfImpact: number;
+
+    constructor(collider: Collider, timeOfImpact: number) {
+        this.collider = collider;
+        this.timeOfImpact = timeOfImpact;
+    }
+
+    public static fromRaw(
+        colliderSet: ColliderSet,
+        raw: RawRayColliderHit,
+    ): RayColliderHit {
+        if (!raw) return null;
+
+        const result = new RayColliderHit(
+            colliderSet.get(raw.colliderHandle()),
+            raw.timeOfImpact(),
+        );
+        raw.free();
+        return result;
+    }
+}