@carbonenginejs/runtime-trinity 0.4.3 → 0.5.0

package/dist/trinityCore/TriFrustum.js

@@ -0,0 +1,374 @@
+import { mat4 } from '@carbonenginejs/core-math/mat4';
+import { vec3 } from '@carbonenginejs/core-math/vec3';
+import { vec4 } from '@carbonenginejs/core-math/vec4';
+import { TriFrustumTestResult } from '../generated/trinityCore/enums.js';
+
+// Source: E:\carbonengine\trinity\trinity\TriFrustum.h
+// Source: E:\carbonengine\trinity\trinity\TriFrustum.cpp
+// Source: E:\carbonengine\math\include\Plane_inline.h (Normalize/DotCoord/DotNormal)
+// Source: E:\carbonengine\trinity\trinity\Utilities\MatrixUtils.cpp:28-42 (DeconstructProjectionMatrix)
+//
+// Native CPU helper (not Blue-exposed in Carbon - no TriFrustum_Blue.cpp
+// exists), so no schema registration; plain class per the EveLODHelper /
+// CjsBatchManager precedent. Carbon's TRINITYDEV-only test/rejection counters
+// are omitted. Matrix element mapping: Carbon row-major _rc lands at flat
+// index (r-1)*4+(c-1), which is the SAME flat index in the shared gl-matrix
+// byte layout, so every _rc below is ported as m[(r-1)*4+(c-1)] unchanged.
+
+/** std::numeric_limits<float>::max() - Carbon's "camera inside sphere" result. */
+const FLOAT_MAX = 3.4028234663852886e38;
+const DERIVE_SCRATCH = mat4.create();
+
+/**
+ * Carbon DotCoord (Plane_inline.h:123-126), prefixed to keep the flat package
+ * namespace unambiguous: plane.a*v.x + plane.b*v.y + plane.c*v.z + plane.d.
+ * @param {Float32Array} plane - (a, b, c, d)
+ * @param {Float32Array|Array} point
+ * @returns {Number}
+ */
+function PlaneDotCoord(plane, point) {
+  return plane[0] * point[0] + plane[1] * point[1] + plane[2] * point[2] + plane[3];
+}
+
+/**
+ * Carbon DotNormal (Plane_inline.h:129-132): plane.a*v.x + plane.b*v.y + plane.c*v.z.
+ * @param {Float32Array} plane - (a, b, c, d)
+ * @param {Float32Array|Array} v
+ * @returns {Number}
+ */
+function PlaneDotNormal(plane, v) {
+  return plane[0] * v[0] + plane[1] * v[1] + plane[2] * v[2];
+}
+
+/**
+ * Carbon TriFrustum (TriFrustum.h:16-77): world-space frustum planes extracted
+ * from a composed view*projection matrix, plus the cached projection data used
+ * for on-screen pixel-coverage estimates.
+ */
+class TriFrustum {
+  /** m_planes[PLANE_COUNT] - normalized world-space planes (a, b, c, d). */
+  planes = [vec4.create(), vec4.create(), vec4.create(), vec4.create(), vec4.create(), vec4.create()];
+
+  /** m_projectionMatrix */
+  projectionMatrix = mat4.create();
+
+  /** m_viewPos - camera world position supplied to DeriveFrustum. */
+  viewPos = vec3.create();
+
+  /** m_viewDir - third column of the view matrix (view->_13/_23/_33). */
+  viewDir = vec3.create();
+
+  /** m_halfWidthProjection = projection._11 * viewport.width * 0.5 */
+  halfWidthProjection = 0;
+
+  /** m_zNear */
+  zNear = 0;
+
+  /** m_zFar */
+  zFar = 0;
+
+  /** m_aspectRatio */
+  aspectRatio = 1;
+
+  /** m_fov */
+  fov = 1;
+
+  /**
+   * Carbon TriFrustum::DeriveFrustum (cpp:26-36) - extracts the frustum planes
+   * from the view and projection matrix in world coordinates.
+   * @param {Float32Array} view
+   * @param {Float32Array} viewPos - camera world position
+   * @param {Float32Array} projection
+   * @param {Object} viewport - TriViewport duck ({ width })
+   */
+  DeriveFrustum(view, viewPos, projection, viewport) {
+    this.#CacheTransformationData(view, viewPos, projection, viewport);
+
+    // Carbon (row-vector): worldMat = view * projection - view applied first,
+    // then projection, so gl-matrix swaps the operands.
+    mat4.multiply(DERIVE_SCRATCH, projection, view);
+    this.ExtractFrustum(DERIVE_SCRATCH);
+  }
+
+  /**
+   * Carbon TriFrustum::ExtractFrustum (cpp:38-119) - Gribb/Hartmann plane
+   * extraction by adding/subtracting matrix columns, then normalizing.
+   * Carbon _rc flat indices: col1 = (0, 4, 8, 12), col2 = (1, 5, 9, 13),
+   * col3 = (2, 6, 10, 14), col4 = (3, 7, 11, 15).
+   * @param {Float32Array} proj - composed view*projection (or projection alone)
+   */
+  ExtractFrustum(proj) {
+    const planes = this.planes;
+
+    // front: the near-plane normal is column 3 (proj->_13/_23/_33/_43)
+    vec4.set(planes[TriFrustum.PLANE_FRONT], proj[2], proj[6], proj[10], proj[14]);
+    // left: col4 + col1
+    vec4.set(planes[TriFrustum.PLANE_LEFT], proj[3] + proj[0], proj[7] + proj[4], proj[11] + proj[8], proj[15] + proj[12]);
+    // top: col4 - col2
+    vec4.set(planes[TriFrustum.PLANE_TOP], proj[3] - proj[1], proj[7] - proj[5], proj[11] - proj[9], proj[15] - proj[13]);
+    // right: col4 - col1
+    vec4.set(planes[TriFrustum.PLANE_RIGHT], proj[3] - proj[0], proj[7] - proj[4], proj[11] - proj[8], proj[15] - proj[12]);
+    // bottom: col4 + col2
+    vec4.set(planes[TriFrustum.PLANE_BOTTOM], proj[3] + proj[1], proj[7] + proj[5], proj[11] + proj[9], proj[15] + proj[13]);
+    // back: col4 - col3
+    vec4.set(planes[TriFrustum.PLANE_BACK], proj[3] - proj[2], proj[7] - proj[6], proj[11] - proj[10], proj[15] - proj[14]);
+    for (let i = 0; i < TriFrustum.PLANE_COUNT; i++) {
+      // Plane Normalize (Plane_inline.h:112-120): scale by 1/|normal|.
+      const plane = planes[i];
+      const scale = 1 / Math.hypot(plane[0], plane[1], plane[2]);
+      plane[0] *= scale;
+      plane[1] *= scale;
+      plane[2] *= scale;
+      plane[3] *= scale;
+    }
+  }
+
+  /**
+   * Carbon's two IsSphereVisible overloads (cpp:121-148), dispatched on the
+   * second argument: a number selects the (center, radius) overload, anything
+   * else treats the first argument as a packed vec4 sphere with the second as
+   * cullBackPlane. Returns true if any part of the sphere is inside the
+   * frustum. Carbon deliberately skips the back plane unless cullBackPlane
+   * ("For some reason the old code ignored the back plane").
+   * @param {Float32Array} sphereOrCenter - packed (x, y, z, radius) or center
+   * @param {Number|Boolean} [radiusOrCullBackPlane]
+   * @param {Boolean} [cullBackPlane]
+   * @returns {Boolean}
+   */
+  IsSphereVisible(sphereOrCenter, radiusOrCullBackPlane = false, cullBackPlane = false) {
+    let radius;
+    let cullBack;
+    if (typeof radiusOrCullBackPlane === "number") {
+      radius = radiusOrCullBackPlane;
+      cullBack = !!cullBackPlane;
+    } else {
+      radius = sphereOrCenter[3];
+      cullBack = !!radiusOrCullBackPlane;
+    }
+    if (TriFrustum.frustumCullingDisabled) {
+      return true;
+    }
+    const planeCount = TriFrustum.PLANE_COUNT - 1 + (cullBack ? 1 : 0);
+    for (let i = 0; i < planeCount; i++) {
+      if (PlaneDotCoord(this.planes[i], sphereOrCenter) < -radius) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  /**
+   * Carbon TriFrustum::SphereTest (cpp:150-166) - full six-plane classification.
+   * @param {Object|Float32Array} sphere - { center, radius } or packed vec4
+   * @returns {Number} TriFrustumTestResult
+   */
+  SphereTest(sphere) {
+    const packed = typeof sphere?.length === "number" && sphere.length >= 4;
+    const center = packed ? sphere : sphere.center;
+    const radius = packed ? sphere[3] : sphere.radius;
+    let result = TriFrustumTestResult.Inside;
+    for (let i = 0; i < TriFrustum.PLANE_COUNT; i++) {
+      const d = PlaneDotCoord(this.planes[i], center);
+      if (d < -radius) {
+        return TriFrustumTestResult.Outside;
+      }
+      if (d < radius) {
+        result = TriFrustumTestResult.Intersect;
+      }
+    }
+    return result;
+  }
+
+  /**
+   * Carbon TriFrustum::IsPointVisible (cpp:168-174) - wraps the sphere test
+   * with a radius of zero.
+   * @param {Float32Array} point
+   * @returns {Boolean}
+   */
+  IsPointVisible(point) {
+    return this.IsSphereVisible(point, 0);
+  }
+
+  /**
+   * Carbon's two IsBoxVisible overloads (cpp:187-232): (boundsMin, boundsMax)
+   * or a single AABB duck ({ min, max }; a missing/uninitialized box is not
+   * visible). Frustum-AABB test via the positive vertex; may return false
+   * positives, never false negatives.
+   * @param {Float32Array|Object} boundsMinOrBox
+   * @param {Float32Array} [boundsMax]
+   * @returns {Boolean}
+   */
+  IsBoxVisible(boundsMinOrBox, boundsMax = null) {
+    let min = boundsMinOrBox;
+    let max = boundsMax;
+    if (!boundsMax) {
+      const box = boundsMinOrBox;
+      if (!box?.min || !box?.max) {
+        return false;
+      }
+      min = box.min;
+      max = box.max;
+    }
+    for (let i = 0; i < TriFrustum.PLANE_COUNT; i++) {
+      const plane = this.planes[i];
+      const vmaxX = plane[0] > 0 ? max[0] : min[0];
+      const vmaxY = plane[1] > 0 ? max[1] : min[1];
+      const vmaxZ = plane[2] > 0 ? max[2] : min[2];
+      if (plane[0] * vmaxX + plane[1] * vmaxY + plane[2] * vmaxZ + plane[3] < 0) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  /**
+   * Carbon's GetPixelSizeAccross overload family (cpp:234-307): the pixel
+   * coverage of a bounding sphere on screen. Dispatch: (center, radius) when
+   * the second argument is a number; packed vec4 (x, y, z, radius); a
+   * { center, radius } sphere duck (Carbon's CcpMath::Sphere overload, which
+   * delegates to GetPixelSizeAccrossEst); or an AABB duck ({ min, max },
+   * bounding-sphere'd first, 0 when missing).
+   * @param {Float32Array|Object} sphereOrCenter
+   * @param {Number} [radius]
+   * @returns {Number}
+   */
+  GetPixelSizeAccross(sphereOrCenter, radius = undefined) {
+    if (typeof radius === "number") {
+      return this.#GetPixelSizeAccrossCenterRadius(sphereOrCenter, radius);
+    }
+    const value = sphereOrCenter;
+    if (typeof value?.length === "number" && value.length >= 4) {
+      return this.#GetPixelSizeAccrossCenterRadius(value, value[3]);
+    }
+    if (typeof value?.radius === "number") {
+      // Carbon (cpp:295-298): the Sphere overload calls GetPixelSizeAccrossEst.
+      return this.#GetPixelSizeAccrossEstCenterRadius(value.center, value.radius);
+    }
+    if (value?.min && value?.max) {
+      // Carbon (cpp:300-307): Sphere(box) - center of the box, half-diagonal radius.
+      const min = value.min;
+      const max = value.max;
+      TriFrustum.#boxCenterScratch[0] = (min[0] + max[0]) * 0.5;
+      TriFrustum.#boxCenterScratch[1] = (min[1] + max[1]) * 0.5;
+      TriFrustum.#boxCenterScratch[2] = (min[2] + max[2]) * 0.5;
+      const boxRadius = Math.hypot(max[0] - min[0], max[1] - min[1], max[2] - min[2]) * 0.5;
+      return this.#GetPixelSizeAccrossEstCenterRadius(TriFrustum.#boxCenterScratch, boxRadius);
+    }
+    return 0;
+  }
+
+  /**
+   * Carbon's GetPixelSizeAccrossEst overloads (cpp:239-242, 274-293) - cheaper
+   * distance-based estimate that properly goes to infinity as the camera
+   * enters the sphere. Same vec4 / (center, radius) dispatch as
+   * GetPixelSizeAccross.
+   * @param {Float32Array} sphereOrCenter
+   * @param {Number} [radius]
+   * @returns {Number}
+   */
+  GetPixelSizeAccrossEst(sphereOrCenter, radius = undefined) {
+    if (typeof radius === "number") {
+      return this.#GetPixelSizeAccrossEstCenterRadius(sphereOrCenter, radius);
+    }
+    return this.#GetPixelSizeAccrossEstCenterRadius(sphereOrCenter, sphereOrCenter[3]);
+  }
+
+  /**
+   * Carbon TriFrustum::GetPixelSizeAccross(center, radius) (cpp:245-272).
+   * @param {Float32Array} center
+   * @param {Number} radius
+   * @returns {Number}
+   */
+  #GetPixelSizeAccrossCenterRadius(center, radius) {
+    // Carbon: Vector3 d(center - m_viewPos); d = -d; => d = viewPos - center.
+    const dx = this.viewPos[0] - center[0];
+    const dy = this.viewPos[1] - center[1];
+    const dz = this.viewPos[2] - center[2];
+    if (dx * dx + dy * dy + dz * dz < radius * radius) {
+      return FLOAT_MAX;
+    }
+    let depth = this.viewDir[0] * dx + this.viewDir[1] * dy + this.viewDir[2] * dz;
+    // clamp values close to zero and below
+    const epsilon = 1e-5;
+    if (depth < epsilon) {
+      depth = epsilon;
+    }
+    if (radius < epsilon) {
+      return 0;
+    }
+    return radius / depth * this.halfWidthProjection * 2;
+  }
+
+  /**
+   * Carbon TriFrustum::GetPixelSizeAccrossEst(center, radius) (cpp:274-293).
+   * @param {Float32Array} center
+   * @param {Number} radius
+   * @returns {Number}
+   */
+  #GetPixelSizeAccrossEstCenterRadius(center, radius) {
+    if (radius <= 0) {
+      return 0;
+    }
+    const dx = center[0] - this.viewPos[0];
+    const dy = center[1] - this.viewPos[1];
+    const dz = center[2] - this.viewPos[2];
+    const lengthSqrd = dx * dx + dy * dy + dz * dz;
+    const radiusSqrd = radius * radius;
+    if (lengthSqrd < radiusSqrd) {
+      // The camera is inside the object, it essentially has infinite screen size.
+      return FLOAT_MAX;
+    }
+
+    // adjusted distance based on the visible part of the sphere
+    const distance = Math.sqrt(lengthSqrd - radiusSqrd);
+    return radius / distance * this.halfWidthProjection * 2;
+  }
+
+  /**
+   * Carbon TriFrustum::CacheTransformationData (cpp:309-325, private) - stores
+   * the view/projection data needed for pixel-diameter extraction, then
+   * DeconstructProjectionMatrix (MatrixUtils.cpp:28-42) recovers aspect, fov
+   * and the clip planes from the projection matrix.
+   * @param {Float32Array} view
+   * @param {Float32Array} viewPos
+   * @param {Float32Array} projection
+   * @param {Object} viewport
+   */
+  #CacheTransformationData(view, viewPos, projection, viewport) {
+    mat4.copy(this.projectionMatrix, projection);
+    vec3.copy(this.viewPos, viewPos);
+
+    // m_viewDir = view->_13/_23/_33 (flat 2/6/10) - third column of the
+    // row-vector view matrix; single-matrix data, no composition involved.
+    this.viewDir[0] = view[2];
+    this.viewDir[1] = view[6];
+    this.viewDir[2] = view[10];
+
+    // m_halfWidthProjection = projection->_11 (flat 0) * viewport.width * 0.5
+    this.halfWidthProjection = projection[0] * viewport.width * 0.5;
+
+    // DeconstructProjectionMatrix: asp = _22/_11, fov = 2*atan(1/_22),
+    // frontClip = _43/_33, backClip = frontClip*_33/(_33+1).
+    this.aspectRatio = projection[0] ? projection[5] / projection[0] : 0;
+    this.fov = projection[5] ? 2 * Math.atan(1 / projection[5]) : 0;
+    this.zNear = projection[10] ? projection[14] / projection[10] : 0;
+    this.zFar = this.zNear * projection[10] / (projection[10] + 1);
+  }
+
+  /** Carbon TriFrustum plane-index enum (TriFrustum.h:19-28). */
+  static PLANE_FRONT = 0;
+  static PLANE_LEFT = 1;
+  static PLANE_TOP = 2;
+  static PLANE_RIGHT = 3;
+  static PLANE_BOTTOM = 4;
+  static PLANE_BACK = 5;
+  static PLANE_COUNT = 6;
+
+  /** g_frustumCullingDisabled (TRI_REGISTER_SETTING "frustumCullingDisabled",
+   * cpp:9-10) - debug escape hatch that forces every sphere test to pass. */
+  static frustumCullingDisabled = false;
+  static #boxCenterScratch = vec3.create();
+}
+
+export { FLOAT_MAX, PlaneDotCoord, PlaneDotNormal, TriFrustum };
+//# sourceMappingURL=TriFrustum.js.map

package/dist/trinityCore/TriFrustum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriFrustum.js","sources":["../../../src/trinityCore/TriFrustum.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\TriFrustum.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\TriFrustum.cpp\r\n// Source: E:\\carbonengine\\math\\include\\Plane_inline.h (Normalize/DotCoord/DotNormal)\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Utilities\\MatrixUtils.cpp:28-42 (DeconstructProjectionMatrix)\r\n//\r\n// Native CPU helper (not Blue-exposed in Carbon - no TriFrustum_Blue.cpp\r\n// exists), so no schema registration; plain class per the EveLODHelper /\r\n// CjsBatchManager precedent. Carbon's TRINITYDEV-only test/rejection counters\r\n// are omitted. Matrix element mapping: Carbon row-major _rc lands at flat\r\n// index (r-1)*4+(c-1), which is the SAME flat index in the shared gl-matrix\r\n// byte layout, so every _rc below is ported as m[(r-1)*4+(c-1)] unchanged.\r\nimport { mat4 } from \"@carbonenginejs/core-math/mat4\";\r\nimport { vec3 } from \"@carbonenginejs/core-math/vec3\";\r\nimport { vec4 } from \"@carbonenginejs/core-math/vec4\";\r\nimport { TriFrustumTestResult } from \"../generated/trinityCore/enums.js\";\r\n\r\n/** std::numeric_limits<float>::max() - Carbon's \"camera inside sphere\" result. */\r\nexport const FLOAT_MAX = 3.4028234663852886e38;\r\n\r\nconst DERIVE_SCRATCH = mat4.create();\r\n\r\n/**\r\n * Carbon DotCoord (Plane_inline.h:123-126), prefixed to keep the flat package\r\n * namespace unambiguous: plane.a*v.x + plane.b*v.y + plane.c*v.z + plane.d.\r\n * @param {Float32Array} plane - (a, b, c, d)\r\n * @param {Float32Array|Array} point\r\n * @returns {Number}\r\n */\r\nexport function PlaneDotCoord(plane, point)\r\n{\r\n  return plane[0] * point[0] + plane[1] * point[1] + plane[2] * point[2] + plane[3];\r\n}\r\n\r\n/**\r\n * Carbon DotNormal (Plane_inline.h:129-132): plane.a*v.x + plane.b*v.y + plane.c*v.z.\r\n * @param {Float32Array} plane - (a, b, c, d)\r\n * @param {Float32Array|Array} v\r\n * @returns {Number}\r\n */\r\nexport function PlaneDotNormal(plane, v)\r\n{\r\n  return plane[0] * v[0] + plane[1] * v[1] + plane[2] * v[2];\r\n}\r\n\r\n/**\r\n * Carbon TriFrustum (TriFrustum.h:16-77): world-space frustum planes extracted\r\n * from a composed view*projection matrix, plus the cached projection data used\r\n * for on-screen pixel-coverage estimates.\r\n */\r\nexport class TriFrustum\r\n{\r\n  /** m_planes[PLANE_COUNT] - normalized world-space planes (a, b, c, d). */\r\n  planes = [\r\n    vec4.create(),\r\n    vec4.create(),\r\n    vec4.create(),\r\n    vec4.create(),\r\n    vec4.create(),\r\n    vec4.create()\r\n  ];\r\n\r\n  /** m_projectionMatrix */\r\n  projectionMatrix = mat4.create();\r\n\r\n  /** m_viewPos - camera world position supplied to DeriveFrustum. */\r\n  viewPos = vec3.create();\r\n\r\n  /** m_viewDir - third column of the view matrix (view->_13/_23/_33). */\r\n  viewDir = vec3.create();\r\n\r\n  /** m_halfWidthProjection = projection._11 * viewport.width * 0.5 */\r\n  halfWidthProjection = 0;\r\n\r\n  /** m_zNear */\r\n  zNear = 0;\r\n\r\n  /** m_zFar */\r\n  zFar = 0;\r\n\r\n  /** m_aspectRatio */\r\n  aspectRatio = 1;\r\n\r\n  /** m_fov */\r\n  fov = 1;\r\n\r\n  /**\r\n   * Carbon TriFrustum::DeriveFrustum (cpp:26-36) - extracts the frustum planes\r\n   * from the view and projection matrix in world coordinates.\r\n   * @param {Float32Array} view\r\n   * @param {Float32Array} viewPos - camera world position\r\n   * @param {Float32Array} projection\r\n   * @param {Object} viewport - TriViewport duck ({ width })\r\n   */\r\n  DeriveFrustum(view, viewPos, projection, viewport)\r\n  {\r\n    this.#CacheTransformationData(view, viewPos, projection, viewport);\r\n\r\n    // Carbon (row-vector): worldMat = view * projection - view applied first,\r\n    // then projection, so gl-matrix swaps the operands.\r\n    mat4.multiply(DERIVE_SCRATCH, projection, view);\r\n\r\n    this.ExtractFrustum(DERIVE_SCRATCH);\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustum::ExtractFrustum (cpp:38-119) - Gribb/Hartmann plane\r\n   * extraction by adding/subtracting matrix columns, then normalizing.\r\n   * Carbon _rc flat indices: col1 = (0, 4, 8, 12), col2 = (1, 5, 9, 13),\r\n   * col3 = (2, 6, 10, 14), col4 = (3, 7, 11, 15).\r\n   * @param {Float32Array} proj - composed view*projection (or projection alone)\r\n   */\r\n  ExtractFrustum(proj)\r\n  {\r\n    const planes = this.planes;\r\n\r\n    // front: the near-plane normal is column 3 (proj->_13/_23/_33/_43)\r\n    vec4.set(planes[TriFrustum.PLANE_FRONT], proj[2], proj[6], proj[10], proj[14]);\r\n    // left: col4 + col1\r\n    vec4.set(planes[TriFrustum.PLANE_LEFT], proj[3] + proj[0], proj[7] + proj[4], proj[11] + proj[8], proj[15] + proj[12]);\r\n    // top: col4 - col2\r\n    vec4.set(planes[TriFrustum.PLANE_TOP], proj[3] - proj[1], proj[7] - proj[5], proj[11] - proj[9], proj[15] - proj[13]);\r\n    // right: col4 - col1\r\n    vec4.set(planes[TriFrustum.PLANE_RIGHT], proj[3] - proj[0], proj[7] - proj[4], proj[11] - proj[8], proj[15] - proj[12]);\r\n    // bottom: col4 + col2\r\n    vec4.set(planes[TriFrustum.PLANE_BOTTOM], proj[3] + proj[1], proj[7] + proj[5], proj[11] + proj[9], proj[15] + proj[13]);\r\n    // back: col4 - col3\r\n    vec4.set(planes[TriFrustum.PLANE_BACK], proj[3] - proj[2], proj[7] - proj[6], proj[11] - proj[10], proj[15] - proj[14]);\r\n\r\n    for (let i = 0; i < TriFrustum.PLANE_COUNT; i++)\r\n    {\r\n      // Plane Normalize (Plane_inline.h:112-120): scale by 1/|normal|.\r\n      const plane = planes[i];\r\n      const scale = 1 / Math.hypot(plane[0], plane[1], plane[2]);\r\n      plane[0] *= scale;\r\n      plane[1] *= scale;\r\n      plane[2] *= scale;\r\n      plane[3] *= scale;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Carbon's two IsSphereVisible overloads (cpp:121-148), dispatched on the\r\n   * second argument: a number selects the (center, radius) overload, anything\r\n   * else treats the first argument as a packed vec4 sphere with the second as\r\n   * cullBackPlane. Returns true if any part of the sphere is inside the\r\n   * frustum. Carbon deliberately skips the back plane unless cullBackPlane\r\n   * (\"For some reason the old code ignored the back plane\").\r\n   * @param {Float32Array} sphereOrCenter - packed (x, y, z, radius) or center\r\n   * @param {Number|Boolean} [radiusOrCullBackPlane]\r\n   * @param {Boolean} [cullBackPlane]\r\n   * @returns {Boolean}\r\n   */\r\n  IsSphereVisible(sphereOrCenter, radiusOrCullBackPlane = false, cullBackPlane = false)\r\n  {\r\n    let radius;\r\n    let cullBack;\r\n    if (typeof radiusOrCullBackPlane === \"number\")\r\n    {\r\n      radius = radiusOrCullBackPlane;\r\n      cullBack = !!cullBackPlane;\r\n    }\r\n    else\r\n    {\r\n      radius = sphereOrCenter[3];\r\n      cullBack = !!radiusOrCullBackPlane;\r\n    }\r\n\r\n    if (TriFrustum.frustumCullingDisabled)\r\n    {\r\n      return true;\r\n    }\r\n\r\n    const planeCount = (TriFrustum.PLANE_COUNT - 1) + (cullBack ? 1 : 0);\r\n    for (let i = 0; i < planeCount; i++)\r\n    {\r\n      if (PlaneDotCoord(this.planes[i], sphereOrCenter) < -radius)\r\n      {\r\n        return false;\r\n      }\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustum::SphereTest (cpp:150-166) - full six-plane classification.\r\n   * @param {Object|Float32Array} sphere - { center, radius } or packed vec4\r\n   * @returns {Number} TriFrustumTestResult\r\n   */\r\n  SphereTest(sphere)\r\n  {\r\n    const packed = typeof sphere?.length === \"number\" && sphere.length >= 4;\r\n    const center = packed ? sphere : sphere.center;\r\n    const radius = packed ? sphere[3] : sphere.radius;\r\n\r\n    let result = TriFrustumTestResult.Inside;\r\n    for (let i = 0; i < TriFrustum.PLANE_COUNT; i++)\r\n    {\r\n      const d = PlaneDotCoord(this.planes[i], center);\r\n      if (d < -radius)\r\n      {\r\n        return TriFrustumTestResult.Outside;\r\n      }\r\n      if (d < radius)\r\n      {\r\n        result = TriFrustumTestResult.Intersect;\r\n      }\r\n    }\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustum::IsPointVisible (cpp:168-174) - wraps the sphere test\r\n   * with a radius of zero.\r\n   * @param {Float32Array} point\r\n   * @returns {Boolean}\r\n   */\r\n  IsPointVisible(point)\r\n  {\r\n    return this.IsSphereVisible(point, 0);\r\n  }\r\n\r\n  /**\r\n   * Carbon's two IsBoxVisible overloads (cpp:187-232): (boundsMin, boundsMax)\r\n   * or a single AABB duck ({ min, max }; a missing/uninitialized box is not\r\n   * visible). Frustum-AABB test via the positive vertex; may return false\r\n   * positives, never false negatives.\r\n   * @param {Float32Array|Object} boundsMinOrBox\r\n   * @param {Float32Array} [boundsMax]\r\n   * @returns {Boolean}\r\n   */\r\n  IsBoxVisible(boundsMinOrBox, boundsMax = null)\r\n  {\r\n    let min = boundsMinOrBox;\r\n    let max = boundsMax;\r\n    if (!boundsMax)\r\n    {\r\n      const box = boundsMinOrBox;\r\n      if (!box?.min || !box?.max)\r\n      {\r\n        return false;\r\n      }\r\n      min = box.min;\r\n      max = box.max;\r\n    }\r\n\r\n    for (let i = 0; i < TriFrustum.PLANE_COUNT; i++)\r\n    {\r\n      const plane = this.planes[i];\r\n      const vmaxX = plane[0] > 0 ? max[0] : min[0];\r\n      const vmaxY = plane[1] > 0 ? max[1] : min[1];\r\n      const vmaxZ = plane[2] > 0 ? max[2] : min[2];\r\n      if (plane[0] * vmaxX + plane[1] * vmaxY + plane[2] * vmaxZ + plane[3] < 0)\r\n      {\r\n        return false;\r\n      }\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Carbon's GetPixelSizeAccross overload family (cpp:234-307): the pixel\r\n   * coverage of a bounding sphere on screen. Dispatch: (center, radius) when\r\n   * the second argument is a number; packed vec4 (x, y, z, radius); a\r\n   * { center, radius } sphere duck (Carbon's CcpMath::Sphere overload, which\r\n   * delegates to GetPixelSizeAccrossEst); or an AABB duck ({ min, max },\r\n   * bounding-sphere'd first, 0 when missing).\r\n   * @param {Float32Array|Object} sphereOrCenter\r\n   * @param {Number} [radius]\r\n   * @returns {Number}\r\n   */\r\n  GetPixelSizeAccross(sphereOrCenter, radius = undefined)\r\n  {\r\n    if (typeof radius === \"number\")\r\n    {\r\n      return this.#GetPixelSizeAccrossCenterRadius(sphereOrCenter, radius);\r\n    }\r\n\r\n    const value = sphereOrCenter;\r\n    if (typeof value?.length === \"number\" && value.length >= 4)\r\n    {\r\n      return this.#GetPixelSizeAccrossCenterRadius(value, value[3]);\r\n    }\r\n    if (typeof value?.radius === \"number\")\r\n    {\r\n      // Carbon (cpp:295-298): the Sphere overload calls GetPixelSizeAccrossEst.\r\n      return this.#GetPixelSizeAccrossEstCenterRadius(value.center, value.radius);\r\n    }\r\n    if (value?.min && value?.max)\r\n    {\r\n      // Carbon (cpp:300-307): Sphere(box) - center of the box, half-diagonal radius.\r\n      const min = value.min;\r\n      const max = value.max;\r\n      TriFrustum.#boxCenterScratch[0] = (min[0] + max[0]) * 0.5;\r\n      TriFrustum.#boxCenterScratch[1] = (min[1] + max[1]) * 0.5;\r\n      TriFrustum.#boxCenterScratch[2] = (min[2] + max[2]) * 0.5;\r\n      const boxRadius = Math.hypot(max[0] - min[0], max[1] - min[1], max[2] - min[2]) * 0.5;\r\n      return this.#GetPixelSizeAccrossEstCenterRadius(TriFrustum.#boxCenterScratch, boxRadius);\r\n    }\r\n    return 0;\r\n  }\r\n\r\n  /**\r\n   * Carbon's GetPixelSizeAccrossEst overloads (cpp:239-242, 274-293) - cheaper\r\n   * distance-based estimate that properly goes to infinity as the camera\r\n   * enters the sphere. Same vec4 / (center, radius) dispatch as\r\n   * GetPixelSizeAccross.\r\n   * @param {Float32Array} sphereOrCenter\r\n   * @param {Number} [radius]\r\n   * @returns {Number}\r\n   */\r\n  GetPixelSizeAccrossEst(sphereOrCenter, radius = undefined)\r\n  {\r\n    if (typeof radius === \"number\")\r\n    {\r\n      return this.#GetPixelSizeAccrossEstCenterRadius(sphereOrCenter, radius);\r\n    }\r\n    return this.#GetPixelSizeAccrossEstCenterRadius(sphereOrCenter, sphereOrCenter[3]);\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustum::GetPixelSizeAccross(center, radius) (cpp:245-272).\r\n   * @param {Float32Array} center\r\n   * @param {Number} radius\r\n   * @returns {Number}\r\n   */\r\n  #GetPixelSizeAccrossCenterRadius(center, radius)\r\n  {\r\n    // Carbon: Vector3 d(center - m_viewPos); d = -d; => d = viewPos - center.\r\n    const dx = this.viewPos[0] - center[0];\r\n    const dy = this.viewPos[1] - center[1];\r\n    const dz = this.viewPos[2] - center[2];\r\n\r\n    if (dx * dx + dy * dy + dz * dz < radius * radius)\r\n    {\r\n      return FLOAT_MAX;\r\n    }\r\n\r\n    let depth = this.viewDir[0] * dx + this.viewDir[1] * dy + this.viewDir[2] * dz;\r\n    // clamp values close to zero and below\r\n    const epsilon = 1e-5;\r\n    if (depth < epsilon)\r\n    {\r\n      depth = epsilon;\r\n    }\r\n\r\n    if (radius < epsilon)\r\n    {\r\n      return 0;\r\n    }\r\n\r\n    return (radius / depth) * this.halfWidthProjection * 2;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustum::GetPixelSizeAccrossEst(center, radius) (cpp:274-293).\r\n   * @param {Float32Array} center\r\n   * @param {Number} radius\r\n   * @returns {Number}\r\n   */\r\n  #GetPixelSizeAccrossEstCenterRadius(center, radius)\r\n  {\r\n    if (radius <= 0)\r\n    {\r\n      return 0;\r\n    }\r\n\r\n    const dx = center[0] - this.viewPos[0];\r\n    const dy = center[1] - this.viewPos[1];\r\n    const dz = center[2] - this.viewPos[2];\r\n    const lengthSqrd = dx * dx + dy * dy + dz * dz;\r\n    const radiusSqrd = radius * radius;\r\n    if (lengthSqrd < radiusSqrd)\r\n    {\r\n      // The camera is inside the object, it essentially has infinite screen size.\r\n      return FLOAT_MAX;\r\n    }\r\n\r\n    // adjusted distance based on the visible part of the sphere\r\n    const distance = Math.sqrt(lengthSqrd - radiusSqrd);\r\n    return (radius / distance) * this.halfWidthProjection * 2;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustum::CacheTransformationData (cpp:309-325, private) - stores\r\n   * the view/projection data needed for pixel-diameter extraction, then\r\n   * DeconstructProjectionMatrix (MatrixUtils.cpp:28-42) recovers aspect, fov\r\n   * and the clip planes from the projection matrix.\r\n   * @param {Float32Array} view\r\n   * @param {Float32Array} viewPos\r\n   * @param {Float32Array} projection\r\n   * @param {Object} viewport\r\n   */\r\n  #CacheTransformationData(view, viewPos, projection, viewport)\r\n  {\r\n    mat4.copy(this.projectionMatrix, projection);\r\n    vec3.copy(this.viewPos, viewPos);\r\n\r\n    // m_viewDir = view->_13/_23/_33 (flat 2/6/10) - third column of the\r\n    // row-vector view matrix; single-matrix data, no composition involved.\r\n    this.viewDir[0] = view[2];\r\n    this.viewDir[1] = view[6];\r\n    this.viewDir[2] = view[10];\r\n\r\n    // m_halfWidthProjection = projection->_11 (flat 0) * viewport.width * 0.5\r\n    this.halfWidthProjection = projection[0] * viewport.width * 0.5;\r\n\r\n    // DeconstructProjectionMatrix: asp = _22/_11, fov = 2*atan(1/_22),\r\n    // frontClip = _43/_33, backClip = frontClip*_33/(_33+1).\r\n    this.aspectRatio = projection[0] ? projection[5] / projection[0] : 0;\r\n    this.fov = projection[5] ? 2 * Math.atan(1 / projection[5]) : 0;\r\n    this.zNear = projection[10] ? projection[14] / projection[10] : 0;\r\n    this.zFar = this.zNear * projection[10] / (projection[10] + 1);\r\n  }\r\n\r\n  /** Carbon TriFrustum plane-index enum (TriFrustum.h:19-28). */\r\n  static PLANE_FRONT = 0;\r\n\r\n  static PLANE_LEFT = 1;\r\n\r\n  static PLANE_TOP = 2;\r\n\r\n  static PLANE_RIGHT = 3;\r\n\r\n  static PLANE_BOTTOM = 4;\r\n\r\n  static PLANE_BACK = 5;\r\n\r\n  static PLANE_COUNT = 6;\r\n\r\n  /** g_frustumCullingDisabled (TRI_REGISTER_SETTING \"frustumCullingDisabled\",\r\n   * cpp:9-10) - debug escape hatch that forces every sphere test to pass. */\r\n  static frustumCullingDisabled = false;\r\n\r\n  static #boxCenterScratch = vec3.create();\r\n}\r\n"],"names":["FLOAT_MAX","DERIVE_SCRATCH","mat4","create","PlaneDotCoord","plane","point","PlaneDotNormal","v","TriFrustum","planes","vec4","projectionMatrix","viewPos","vec3","viewDir","halfWidthProjection","zNear","zFar","aspectRatio","fov","DeriveFrustum","view","projection","viewport","multiply","ExtractFrustum","proj","set","PLANE_FRONT","PLANE_LEFT","PLANE_TOP","PLANE_RIGHT","PLANE_BOTTOM","PLANE_BACK","i","PLANE_COUNT","scale","Math","hypot","IsSphereVisible","sphereOrCenter","radiusOrCullBackPlane","cullBackPlane","radius","cullBack","frustumCullingDisabled","planeCount","SphereTest","sphere","packed","length","center","result","TriFrustumTestResult","Inside","d","Outside","Intersect","IsPointVisible","IsBoxVisible","boundsMinOrBox","boundsMax","min","max","box","vmaxX","vmaxY","vmaxZ","GetPixelSizeAccross","undefined","value","boxRadius","GetPixelSizeAccrossEst","#GetPixelSizeAccrossCenterRadius","dx","dy","dz","depth","epsilon","#GetPixelSizeAccrossEstCenterRadius","lengthSqrd","radiusSqrd","distance","sqrt","#CacheTransformationData","copy","width","atan"],"mappings":"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"}

package/dist/trinityCore/TriFrustumOrtho.js

@@ -0,0 +1,158 @@
+import { mat4 } from '@carbonenginejs/core-math/mat4';
+import { vec3 } from '@carbonenginejs/core-math/vec3';
+import { TriFrustumTestResult } from '../generated/trinityCore/enums.js';
+
+// Source: E:\carbonengine\trinity\trinity\TriFrustumOrtho.h
+// Source: E:\carbonengine\trinity\trinity\TriFrustumOrtho.cpp
+//
+// Native CPU helper (not Blue-exposed in Carbon), plain class like TriFrustum.
+// The orthographic frustum is a view-space AABB: DeriveFrustum captures the
+// (shadow) view matrix and the bounds, and every test transforms the query
+// center into view space with a single-matrix TransformCoord (which is
+// vec3.transformMat4 on the shared byte layout - no composition, no operand
+// order to swap).
+const CENTER_SCRATCH = vec3.create();
+
+/**
+ * Carbon TriFrustumOrtho (TriFrustumOrtho.h:9-27): orthographic shadow frustum
+ * as view matrix + view-space bounds.
+ */
+class TriFrustumOrtho {
+  /** m_view - identity until DeriveFrustum. */
+  view = mat4.create();
+
+  /** m_boundsMin (view space) */
+  boundsMin = vec3.create();
+
+  /** m_boundsMax (view space) */
+  boundsMax = vec3.create();
+  #eyePos = vec3.create();
+
+  /**
+   * Carbon TriFrustumOrtho::DeriveFrustum (cpp:13-18) - copies the view matrix
+   * and view-space bounds.
+   * @param {Float32Array} view
+   * @param {Float32Array} minBounds
+   * @param {Float32Array} maxBounds
+   */
+  DeriveFrustum(view, minBounds, maxBounds) {
+    mat4.copy(this.view, view);
+    vec3.copy(this.boundsMin, minBounds);
+    vec3.copy(this.boundsMax, maxBounds);
+  }
+
+  /**
+   * Carbon's two IsSphereVisibleAndInsideNearPlane overloads (cpp:20-61),
+   * dispatched on the second argument like TriFrustum.IsSphereVisible: sphere
+   * fully beyond the far bound (z - radius > boundsMax.z) is rejected, then a
+   * squared-distance sphere-vs-AABB test in view space.
+   * @param {Float32Array} sphereOrCenter - packed (x, y, z, radius) or center
+   * @param {Number} [radius]
+   * @returns {Boolean}
+   */
+  IsSphereVisibleAndInsideNearPlane(sphereOrCenter, radius = undefined) {
+    const r = typeof radius === "number" ? radius : sphereOrCenter[3];
+    const center = vec3.transformMat4(CENTER_SCRATCH, sphereOrCenter, this.view);
+    if (center[2] - r > this.boundsMax[2]) {
+      return false;
+    }
+    let d = 0;
+    for (let i = 0; i < 3; ++i) {
+      if (center[i] < this.boundsMin[i]) {
+        const a = center[i] - this.boundsMin[i];
+        d += a * a;
+      } else if (center[i] > this.boundsMax[i]) {
+        const a = center[i] - this.boundsMax[i];
+        d += a * a;
+      }
+    }
+    return d <= r * r;
+  }
+
+  /**
+   * Carbon TriFrustumOrtho::IsSphereVisibleIgnoreFarPlane (cpp:63-93) - same
+   * squared-distance test but the +z (far) bound never rejects.
+   * @param {Float32Array} sphereOrCenter - packed (x, y, z, radius) or center
+   * @param {Number} [radius]
+   * @returns {Boolean}
+   */
+  IsSphereVisibleIgnoreFarPlane(sphereOrCenter, radius = undefined) {
+    const r = typeof radius === "number" ? radius : sphereOrCenter[3];
+    const center = vec3.transformMat4(CENTER_SCRATCH, sphereOrCenter, this.view);
+    let d = 0;
+    for (let i = 0; i < 3; ++i) {
+      if (center[i] < this.boundsMin[i]) {
+        const a = center[i] - this.boundsMin[i];
+        d += a * a;
+      } else if (i !== 2 && center[i] > this.boundsMax[i]) {
+        const a = center[i] - this.boundsMax[i];
+        d += a * a;
+      }
+    }
+    return d <= r * r;
+  }
+
+  /**
+   * Carbon TriFrustumOrtho::SphereTestIgnoreFarPlane (cpp:95-135), the
+   * XMVector lane math ported scalar-wise: Outside when the clamped
+   * squared distance (far bound ignored) exceeds radius^2; Inside when the
+   * sphere clears every bound by at least the radius (the far-bound lane is
+   * substituted with the radius, so it always passes); Intersect otherwise.
+   * @param {Object|Float32Array} sphere - { center, radius } or packed vec4
+   * @returns {Number} TriFrustumTestResult
+   */
+  SphereTestIgnoreFarPlane(sphere) {
+    const packed = typeof sphere?.length === "number" && sphere.length >= 4;
+    const radius = packed ? sphere[3] : sphere.radius;
+    const center = vec3.transformMat4(CENTER_SCRATCH, packed ? sphere : sphere.center, this.view);
+    const fromMinX = center[0] - this.boundsMin[0];
+    const fromMinY = center[1] - this.boundsMin[1];
+    const fromMinZ = center[2] - this.boundsMin[2];
+    const fromMaxX = this.boundsMax[0] - center[0];
+    const fromMaxY = this.boundsMax[1] - center[1];
+    const outsideMinX = Math.min(fromMinX, 0);
+    const outsideMinY = Math.min(fromMinY, 0);
+    const outsideMinZ = Math.min(fromMinZ, 0);
+    const outsideMaxX = Math.min(fromMaxX, 0);
+    const outsideMaxY = Math.min(fromMaxY, 0);
+    // because we are ignoring far plane, zero out the Z component
+
+    const d = outsideMinX * outsideMinX + outsideMinY * outsideMinY + outsideMinZ * outsideMinZ + outsideMaxX * outsideMaxX + outsideMaxY * outsideMaxY;
+    if (d > radius * radius) {
+      return TriFrustumTestResult.Outside;
+    }
+    const inside = fromMinX >= radius && fromMinY >= radius && fromMinZ >= radius && fromMaxX >= radius && fromMaxY >= radius;
+    return inside ? TriFrustumTestResult.Inside : TriFrustumTestResult.Intersect;
+  }
+
+  /**
+   * Carbon TriFrustumOrtho::GetPixelSize (cpp:137-150) - shadow-map pixel
+   * coverage of a packed sphere: diameter over the larger relative frustum
+   * extent, scaled by the texture size.
+   * @param {Float32Array} sphere - packed (x, y, z, radius)
+   * @param {Number} textureSize
+   * @returns {Number}
+   */
+  GetPixelSize(sphere, textureSize) {
+    const frustumWidth = this.boundsMax[0] - this.boundsMin[0];
+    const frustumHeight = this.boundsMax[1] - this.boundsMin[1];
+    const dx = sphere[3] * 2 / frustumWidth;
+    const dy = sphere[3] * 2 / frustumHeight;
+    return Math.max(dx, dy) * textureSize;
+  }
+
+  /**
+   * Carbon TriFrustumOrtho::GetEyePos (cpp:152-155) - the view matrix
+   * translation (m_view.GetTranslation(), flat 12..14).
+   * @returns {Float32Array}
+   */
+  GetEyePos() {
+    this.#eyePos[0] = this.view[12];
+    this.#eyePos[1] = this.view[13];
+    this.#eyePos[2] = this.view[14];
+    return this.#eyePos;
+  }
+}
+
+export { TriFrustumOrtho };
+//# sourceMappingURL=TriFrustumOrtho.js.map

package/dist/trinityCore/TriFrustumOrtho.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriFrustumOrtho.js","sources":["../../../src/trinityCore/TriFrustumOrtho.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\TriFrustumOrtho.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\TriFrustumOrtho.cpp\r\n//\r\n// Native CPU helper (not Blue-exposed in Carbon), plain class like TriFrustum.\r\n// The orthographic frustum is a view-space AABB: DeriveFrustum captures the\r\n// (shadow) view matrix and the bounds, and every test transforms the query\r\n// center into view space with a single-matrix TransformCoord (which is\r\n// vec3.transformMat4 on the shared byte layout - no composition, no operand\r\n// order to swap).\r\nimport { mat4 } from \"@carbonenginejs/core-math/mat4\";\r\nimport { vec3 } from \"@carbonenginejs/core-math/vec3\";\r\nimport { TriFrustumTestResult } from \"../generated/trinityCore/enums.js\";\r\n\r\nconst CENTER_SCRATCH = vec3.create();\r\n\r\n/**\r\n * Carbon TriFrustumOrtho (TriFrustumOrtho.h:9-27): orthographic shadow frustum\r\n * as view matrix + view-space bounds.\r\n */\r\nexport class TriFrustumOrtho\r\n{\r\n  /** m_view - identity until DeriveFrustum. */\r\n  view = mat4.create();\r\n\r\n  /** m_boundsMin (view space) */\r\n  boundsMin = vec3.create();\r\n\r\n  /** m_boundsMax (view space) */\r\n  boundsMax = vec3.create();\r\n\r\n  #eyePos = vec3.create();\r\n\r\n  /**\r\n   * Carbon TriFrustumOrtho::DeriveFrustum (cpp:13-18) - copies the view matrix\r\n   * and view-space bounds.\r\n   * @param {Float32Array} view\r\n   * @param {Float32Array} minBounds\r\n   * @param {Float32Array} maxBounds\r\n   */\r\n  DeriveFrustum(view, minBounds, maxBounds)\r\n  {\r\n    mat4.copy(this.view, view);\r\n    vec3.copy(this.boundsMin, minBounds);\r\n    vec3.copy(this.boundsMax, maxBounds);\r\n  }\r\n\r\n  /**\r\n   * Carbon's two IsSphereVisibleAndInsideNearPlane overloads (cpp:20-61),\r\n   * dispatched on the second argument like TriFrustum.IsSphereVisible: sphere\r\n   * fully beyond the far bound (z - radius > boundsMax.z) is rejected, then a\r\n   * squared-distance sphere-vs-AABB test in view space.\r\n   * @param {Float32Array} sphereOrCenter - packed (x, y, z, radius) or center\r\n   * @param {Number} [radius]\r\n   * @returns {Boolean}\r\n   */\r\n  IsSphereVisibleAndInsideNearPlane(sphereOrCenter, radius = undefined)\r\n  {\r\n    const r = typeof radius === \"number\" ? radius : sphereOrCenter[3];\r\n    const center = vec3.transformMat4(CENTER_SCRATCH, sphereOrCenter, this.view);\r\n\r\n    if (center[2] - r > this.boundsMax[2])\r\n    {\r\n      return false;\r\n    }\r\n\r\n    let d = 0;\r\n    for (let i = 0; i < 3; ++i)\r\n    {\r\n      if (center[i] < this.boundsMin[i])\r\n      {\r\n        const a = center[i] - this.boundsMin[i];\r\n        d += a * a;\r\n      }\r\n      else if (center[i] > this.boundsMax[i])\r\n      {\r\n        const a = center[i] - this.boundsMax[i];\r\n        d += a * a;\r\n      }\r\n    }\r\n\r\n    return d <= r * r;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustumOrtho::IsSphereVisibleIgnoreFarPlane (cpp:63-93) - same\r\n   * squared-distance test but the +z (far) bound never rejects.\r\n   * @param {Float32Array} sphereOrCenter - packed (x, y, z, radius) or center\r\n   * @param {Number} [radius]\r\n   * @returns {Boolean}\r\n   */\r\n  IsSphereVisibleIgnoreFarPlane(sphereOrCenter, radius = undefined)\r\n  {\r\n    const r = typeof radius === \"number\" ? radius : sphereOrCenter[3];\r\n    const center = vec3.transformMat4(CENTER_SCRATCH, sphereOrCenter, this.view);\r\n\r\n    let d = 0;\r\n    for (let i = 0; i < 3; ++i)\r\n    {\r\n      if (center[i] < this.boundsMin[i])\r\n      {\r\n        const a = center[i] - this.boundsMin[i];\r\n        d += a * a;\r\n      }\r\n      else if (i !== 2 && center[i] > this.boundsMax[i])\r\n      {\r\n        const a = center[i] - this.boundsMax[i];\r\n        d += a * a;\r\n      }\r\n    }\r\n\r\n    return d <= r * r;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustumOrtho::SphereTestIgnoreFarPlane (cpp:95-135), the\r\n   * XMVector lane math ported scalar-wise: Outside when the clamped\r\n   * squared distance (far bound ignored) exceeds radius^2; Inside when the\r\n   * sphere clears every bound by at least the radius (the far-bound lane is\r\n   * substituted with the radius, so it always passes); Intersect otherwise.\r\n   * @param {Object|Float32Array} sphere - { center, radius } or packed vec4\r\n   * @returns {Number} TriFrustumTestResult\r\n   */\r\n  SphereTestIgnoreFarPlane(sphere)\r\n  {\r\n    const packed = typeof sphere?.length === \"number\" && sphere.length >= 4;\r\n    const radius = packed ? sphere[3] : sphere.radius;\r\n    const center = vec3.transformMat4(CENTER_SCRATCH, packed ? sphere : sphere.center, this.view);\r\n\r\n    const fromMinX = center[0] - this.boundsMin[0];\r\n    const fromMinY = center[1] - this.boundsMin[1];\r\n    const fromMinZ = center[2] - this.boundsMin[2];\r\n    const fromMaxX = this.boundsMax[0] - center[0];\r\n    const fromMaxY = this.boundsMax[1] - center[1];\r\n\r\n    const outsideMinX = Math.min(fromMinX, 0);\r\n    const outsideMinY = Math.min(fromMinY, 0);\r\n    const outsideMinZ = Math.min(fromMinZ, 0);\r\n    const outsideMaxX = Math.min(fromMaxX, 0);\r\n    const outsideMaxY = Math.min(fromMaxY, 0);\r\n    // because we are ignoring far plane, zero out the Z component\r\n\r\n    const d = outsideMinX * outsideMinX + outsideMinY * outsideMinY + outsideMinZ * outsideMinZ +\r\n      outsideMaxX * outsideMaxX + outsideMaxY * outsideMaxY;\r\n\r\n    if (d > radius * radius)\r\n    {\r\n      return TriFrustumTestResult.Outside;\r\n    }\r\n\r\n    const inside = fromMinX >= radius && fromMinY >= radius && fromMinZ >= radius &&\r\n      fromMaxX >= radius && fromMaxY >= radius;\r\n    return inside ? TriFrustumTestResult.Inside : TriFrustumTestResult.Intersect;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustumOrtho::GetPixelSize (cpp:137-150) - shadow-map pixel\r\n   * coverage of a packed sphere: diameter over the larger relative frustum\r\n   * extent, scaled by the texture size.\r\n   * @param {Float32Array} sphere - packed (x, y, z, radius)\r\n   * @param {Number} textureSize\r\n   * @returns {Number}\r\n   */\r\n  GetPixelSize(sphere, textureSize)\r\n  {\r\n    const frustumWidth = this.boundsMax[0] - this.boundsMin[0];\r\n    const frustumHeight = this.boundsMax[1] - this.boundsMin[1];\r\n\r\n    const dx = (sphere[3] * 2) / frustumWidth;\r\n    const dy = (sphere[3] * 2) / frustumHeight;\r\n\r\n    return Math.max(dx, dy) * textureSize;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriFrustumOrtho::GetEyePos (cpp:152-155) - the view matrix\r\n   * translation (m_view.GetTranslation(), flat 12..14).\r\n   * @returns {Float32Array}\r\n   */\r\n  GetEyePos()\r\n  {\r\n    this.#eyePos[0] = this.view[12];\r\n    this.#eyePos[1] = this.view[13];\r\n    this.#eyePos[2] = this.view[14];\r\n    return this.#eyePos;\r\n  }\r\n}\r\n"],"names":["CENTER_SCRATCH","vec3","create","TriFrustumOrtho","view","mat4","boundsMin","boundsMax","DeriveFrustum","minBounds","maxBounds","copy","IsSphereVisibleAndInsideNearPlane","sphereOrCenter","radius","undefined","r","center","transformMat4","d","i","a","IsSphereVisibleIgnoreFarPlane","SphereTestIgnoreFarPlane","sphere","packed","length","fromMinX","fromMinY","fromMinZ","fromMaxX","fromMaxY","outsideMinX","Math","min","outsideMinY","outsideMinZ","outsideMaxX","outsideMaxY","TriFrustumTestResult","Outside","inside","Inside","Intersect","GetPixelSize","textureSize","frustumWidth","frustumHeight","dx","dy","max","GetEyePos"],"mappings":"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"}

package/dist/trinityCore/index.js

@@ -25,6 +25,8 @@ export { Tr2VariableStore } from './Tr2VariableStore.js';
 export { Tr2VisibilityEvent, Tr2VisibilityResults } from './Tr2VisibilityResults.js';
 export { TriDevice } from './TriDevice.js';
 export { TriFloat } from './TriFloat.js';
+export { FLOAT_MAX, PlaneDotCoord, PlaneDotNormal, TriFrustum } from './TriFrustum.js';
+export { TriFrustumOrtho } from './TriFrustumOrtho.js';
 export { SendEventToAudEmitter, TriObserverLocal } from './TriObserverLocal.js';
 export { TriProjection } from './TriProjection.js';
 export { TriRect } from './TriRect.js';

package/dist/trinityCore/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -24,10 +24,10 @@
   "publishConfig": {
     "access": "public"
   }, 
-  "version": "0.4.3",
+  "version": "0.5.0",
   "dependencies": {
     "@carbonenginejs/core-math": "^0.1.5",
-    "@carbonenginejs/core-types": "^0.12.0",
+    "@carbonenginejs/core-types": "^0.13.0",
     "@carbonenginejs/runtime-const": "^0.1.0"
   }, 
   "type": "module",