@faicad/faijs 0.13.0

package/dist/mesh/knurl/displacement.js

@@ -0,0 +1,274 @@
+/**
+ * displacement.ts — 纹理位移核心，从 stlTexturizer/js/displacement.js 移植为 TS（简化版）。
+ *
+ * 对每个顶点：
+ *   1. 用与 GPU 预览 shader 相同的数学计算 UV（mapping.ts）
+ *   2. 双线性采样灰度 ImageData
+ *   3. 沿平滑法线位移：grey × amplitude
+ *
+ * 简化：去掉了 boundaryFalloff、blendNormalSmoothing、cubic zoneArea 等。
+ * 保留了核心水密性保证：同位置顶点使用相同平滑法线 + 相同位移值。
+ */
+import * as THREE from 'three';
+import { QuantizedPointMap } from './meshIndex.js';
+import { computeUV, getCubicBlendWeights } from './mapping.js';
+/**
+ * Displace every vertex of a non-indexed BufferGeometry. For each vertex the
+ * UV is computed with the same math as the GPU preview shader, the greyscale
+ * ImageData is sampled bilinearly, and the position is shifted along the
+ * smoothed normal by grey × amplitude.
+ *
+ * @param geometry - the non-indexed source geometry (position + normal attributes).
+ * @param imageData - RGBA pixel data of the height map.
+ * @param imgWidth - texture width in pixels.
+ * @param imgHeight - texture height in pixels.
+ * @param settings - displacement and mapping settings.
+ * @param bounds - overall mesh bounds used to normalize UV coordinates.
+ * @param onProgress - optional callback receiving progress in [0, 1].
+ * @returns a new BufferGeometry with displaced positions and face normals.
+ */
+export function applyDisplacement(geometry, imageData, imgWidth, imgHeight, settings, bounds, onProgress) {
+    const posAttr = geometry.attributes.position;
+    const nrmAttr = geometry.attributes.normal;
+    const count = posAttr.count;
+    const newPos = new Float32Array(count * 3);
+    const newNrm = new Float32Array(count * 3);
+    const tmpPos = new THREE.Vector3();
+    const tmpNrm = new THREE.Vector3();
+    const vA = new THREE.Vector3();
+    const vB = new THREE.Vector3();
+    const vC = new THREE.Vector3();
+    const edge1 = new THREE.Vector3();
+    const edge2 = new THREE.Vector3();
+    const faceNrm = new THREE.Vector3();
+    // 纹理纵横比校正
+    const tmax = Math.max(imgWidth, imgHeight, 1);
+    const aspectU = tmax / Math.max(imgWidth, 1);
+    const aspectV = tmax / Math.max(imgHeight, 1);
+    const settingsWithAspect = { ...settings, textureAspectU: aspectU, textureAspectV: aspectV };
+    // 10μm 顶点去重
+    const QUANT = 1e5;
+    // ── 顶点去重：position → numeric ID ──
+    const dedupMap = new QuantizedPointMap(QUANT, Math.min(count, 1 << 22));
+    let nextId = 0;
+    const vertexId = new Uint32Array(count);
+    for (let i = 0; i < count; i++) {
+        const x = posAttr.getX(i), y = posAttr.getY(i), z = posAttr.getZ(i);
+        const id = dedupMap.getOrSet(x, y, z, nextId);
+        if (dedupMap.inserted)
+            nextId++;
+        vertexId[i] = id;
+    }
+    const uniqueCount = nextId;
+    // ── Pass 1: 每个唯一顶点累加面积加权平滑法线 ──
+    const smoothNrmX = new Float64Array(uniqueCount);
+    const smoothNrmY = new Float64Array(uniqueCount);
+    const smoothNrmZ = new Float64Array(uniqueCount);
+    // 角度遮罩
+    const maskedFracMasked = new Float64Array(uniqueCount);
+    const maskedFracTotal = new Float64Array(uniqueCount);
+    // 面排除权重
+    const ewAttr = geometry.attributes.excludeWeight || null;
+    const userExcludedFaces = ewAttr ? new Uint8Array(count / 3) : null;
+    const excludedPos = ewAttr ? new Uint8Array(uniqueCount) : null;
+    for (let t = 0; t < count; t += 3) {
+        vA.fromBufferAttribute(posAttr, t);
+        vB.fromBufferAttribute(posAttr, t + 1);
+        vC.fromBufferAttribute(posAttr, t + 2);
+        edge1.subVectors(vB, vA);
+        edge2.subVectors(vC, vA);
+        faceNrm.crossVectors(edge1, edge2);
+        const faceArea = faceNrm.length();
+        const faceNzNorm = faceArea > 1e-12 ? faceNrm.z / faceArea : 0;
+        const faceAngle = Math.acos(Math.abs(faceNzNorm)) * (180 / Math.PI);
+        const angleMasked = faceNzNorm < 0
+            ? (settings.bottomAngleLimit ?? 0) > 0 &&
+                faceAngle <= (settings.bottomAngleLimit ?? 0)
+            : (settings.topAngleLimit ?? 0) > 0 &&
+                faceAngle <= (settings.topAngleLimit ?? 0);
+        const userExcluded = ewAttr
+            ? (ewAttr.getX(t) + ewAttr.getX(t + 1) + ewAttr.getX(t + 2)) / 3 > 0.99
+            : false;
+        const faceMasked = angleMasked;
+        if (userExcluded && userExcludedFaces)
+            userExcludedFaces[t / 3] = 1;
+        for (let v = 0; v < 3; v++) {
+            const vid = vertexId[t + v];
+            if (userExcluded && excludedPos)
+                excludedPos[vid] = 1;
+            tmpNrm.fromBufferAttribute(nrmAttr, t + v);
+            smoothNrmX[vid] += tmpNrm.x * faceArea;
+            smoothNrmY[vid] += tmpNrm.y * faceArea;
+            smoothNrmZ[vid] += tmpNrm.z * faceArea;
+            if (faceMasked)
+                maskedFracMasked[vid] += faceArea;
+            maskedFracTotal[vid] += faceArea;
+        }
+    }
+    // 归一化平滑法线
+    for (let id = 0; id < uniqueCount; id++) {
+        const len = Math.sqrt(smoothNrmX[id] * smoothNrmX[id] +
+            smoothNrmY[id] * smoothNrmY[id] +
+            smoothNrmZ[id] * smoothNrmZ[id]);
+        const inv = len > 0 ? 1 / len : 1;
+        smoothNrmX[id] *= inv;
+        smoothNrmY[id] *= inv;
+        smoothNrmZ[id] *= inv;
+    }
+    // ── Pass 2: 每个唯一顶点采样纹理一次 ──
+    const dispCacheVal = new Float64Array(uniqueCount);
+    const dispCacheSet = new Uint8Array(uniqueCount);
+    for (let i = 0; i < count; i++) {
+        const vid = vertexId[i];
+        if (dispCacheSet[vid])
+            continue;
+        dispCacheSet[vid] = 1;
+        tmpPos.fromBufferAttribute(posAttr, i);
+        // Cubic 模式特殊处理
+        if (settings.mappingMode === 6) {
+            const md = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6);
+            const rotRad = (settings.rotation ?? 0) * Math.PI / 180;
+            const cubicBlend = settings.mappingBlend ?? 0;
+            const cubicBandWidth = settings.seamBandWidth ?? 0.35;
+            const sn = {
+                x: smoothNrmX[vid],
+                y: smoothNrmY[vid],
+                z: smoothNrmZ[vid],
+            };
+            const w = getCubicBlendWeights(sn, cubicBlend, cubicBandWidth);
+            if (w.x + w.y + w.z > 0) {
+                let grey = 0;
+                if (w.x > 0) {
+                    let rawU = (tmpPos.y - bounds.min.y) / md;
+                    if (smoothNrmX[vid] < 0)
+                        rawU = -rawU;
+                    const uv = _cubicUV(rawU, (tmpPos.z - bounds.min.z) / md, settings, rotRad, aspectU, aspectV);
+                    grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.x;
+                }
+                if (w.y > 0) {
+                    let rawU = (tmpPos.x - bounds.min.x) / md;
+                    if (smoothNrmY[vid] > 0)
+                        rawU = -rawU;
+                    const uv = _cubicUV(rawU, (tmpPos.z - bounds.min.z) / md, settings, rotRad, aspectU, aspectV);
+                    grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.y;
+                }
+                if (w.z > 0) {
+                    let rawU = (tmpPos.x - bounds.min.x) / md;
+                    if (smoothNrmZ[vid] < 0)
+                        rawU = -rawU;
+                    const uv = _cubicUV(rawU, (tmpPos.y - bounds.min.y) / md, settings, rotRad, aspectU, aspectV);
+                    grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.z;
+                }
+                dispCacheVal[vid] = grey;
+                continue;
+            }
+        }
+        // 其他模式：用平滑法线计算 UV
+        tmpNrm.set(smoothNrmX[vid], smoothNrmY[vid], smoothNrmZ[vid]);
+        const uvResult = computeUV(tmpPos, tmpNrm, settings.mappingMode, settingsWithAspect, bounds);
+        let grey;
+        if (uvResult.triplanar && uvResult.samples) {
+            grey = 0;
+            for (const s of uvResult.samples) {
+                grey += sampleBilinear(imageData.data, imgWidth, imgHeight, s.u, s.v) * s.w;
+            }
+        }
+        else {
+            grey = sampleBilinear(imageData.data, imgWidth, imgHeight, uvResult.u, uvResult.v);
+        }
+        dispCacheVal[vid] = grey;
+    }
+    // ── Pass 3: 每个顶点副本沿平滑法线位移 ──
+    const REPORT_EVERY = 5000;
+    for (let i = 0; i < count; i++) {
+        tmpPos.fromBufferAttribute(posAttr, i);
+        tmpNrm.fromBufferAttribute(nrmAttr, i);
+        const vid = vertexId[i];
+        const grey = dispCacheVal[vid];
+        const isFaceExcluded = userExcludedFaces && userExcludedFaces[Math.floor(i / 3)];
+        const isSealedBoundary = !isFaceExcluded && excludedPos && excludedPos[vid] === 1;
+        const mfTotal = maskedFracTotal[vid];
+        const maskedFrac = mfTotal > 0 ? maskedFracMasked[vid] / mfTotal : 0;
+        const centeredGrey = settings.symmetricDisplacement ? grey - 0.5 : grey;
+        const disp = isFaceExcluded || isSealedBoundary
+            ? 0
+            : (1 - maskedFrac) * centeredGrey * settings.amplitude;
+        const newX = tmpPos.x + smoothNrmX[vid] * disp;
+        const newY = tmpPos.y + smoothNrmY[vid] * disp;
+        let newZ = tmpPos.z + smoothNrmZ[vid] * disp;
+        // 防止边界顶点穿过遮罩表面
+        if (maskedFrac > 0) {
+            if ((settings.bottomAngleLimit ?? 0) > 0 && newZ < tmpPos.z)
+                newZ = tmpPos.z;
+            if ((settings.topAngleLimit ?? 0) > 0 && newZ > tmpPos.z)
+                newZ = tmpPos.z;
+        }
+        newPos[i * 3] = newX;
+        newPos[i * 3 + 1] = newY;
+        newPos[i * 3 + 2] = newZ;
+        newNrm[i * 3] = tmpNrm.x;
+        newNrm[i * 3 + 1] = tmpNrm.y;
+        newNrm[i * 3 + 2] = tmpNrm.z;
+        if (onProgress && i % REPORT_EVERY === 0)
+            onProgress(i / count);
+    }
+    // 从位移后位置计算精确的面法线
+    const eA = new THREE.Vector3();
+    const eB = new THREE.Vector3();
+    const fn = new THREE.Vector3();
+    for (let t = 0; t < count; t += 3) {
+        const ax = newPos[t * 3], ay = newPos[t * 3 + 1], az = newPos[t * 3 + 2];
+        const bx = newPos[t * 3 + 3], by = newPos[t * 3 + 4], bz = newPos[t * 3 + 5];
+        const cx = newPos[t * 3 + 6], cy = newPos[t * 3 + 7], cz = newPos[t * 3 + 8];
+        eA.set(bx - ax, by - ay, bz - az);
+        eB.set(cx - ax, cy - ay, cz - az);
+        fn.crossVectors(eA, eB).normalize();
+        for (let v = 0; v < 3; v++) {
+            newNrm[(t + v) * 3] = fn.x;
+            newNrm[(t + v) * 3 + 1] = fn.y;
+            newNrm[(t + v) * 3 + 2] = fn.z;
+        }
+    }
+    const out = new THREE.BufferGeometry();
+    out.setAttribute('position', new THREE.BufferAttribute(newPos, 3));
+    out.setAttribute('normal', new THREE.BufferAttribute(newNrm, 3));
+    return out;
+}
+// ── 双线性采样 ──
+function sampleBilinear(data, w, h, u, v) {
+    u = ((u % 1) + 1) % 1;
+    v = ((v % 1) + 1) % 1;
+    v = 1 - v;
+    const fx = u * w - 0.5;
+    const fy = v * h - 0.5;
+    let x0 = Math.floor(fx);
+    let y0 = Math.floor(fy);
+    const tx = fx - x0;
+    const ty = fy - y0;
+    const x1 = (x0 + 1 + w) % w;
+    const y1 = (y0 + 1 + h) % h;
+    x0 = ((x0 % w) + w) % w;
+    y0 = ((y0 % h) + h) % h;
+    const v00 = data[(y0 * w + x0) * 4] / 255;
+    const v10 = data[(y0 * w + x1) * 4] / 255;
+    const v01 = data[(y1 * w + x0) * 4] / 255;
+    const v11 = data[(y1 * w + x1) * 4] / 255;
+    return (v00 * (1 - tx) * (1 - ty) +
+        v10 * tx * (1 - ty) +
+        v01 * (1 - tx) * ty +
+        v11 * tx * ty);
+}
+function _cubicUV(rawU, rawV, settings, rotRad, aspectU, aspectV) {
+    let u = (rawU * aspectU) / settings.scaleU + settings.offsetU;
+    let v = (rawV * aspectV) / settings.scaleV + settings.offsetV;
+    if (rotRad !== 0) {
+        const c = Math.cos(rotRad), s = Math.sin(rotRad);
+        u -= 0.5;
+        v -= 0.5;
+        const ru = c * u - s * v, rv = s * u + c * v;
+        u = ru + 0.5;
+        v = rv + 0.5;
+    }
+    return { u: u - Math.floor(u), v: v - Math.floor(v) };
+}
+//# sourceMappingURL=displacement.js.map

package/dist/mesh/knurl/displacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displacement.js","sourceRoot":"","sources":["../../../src/mesh/knurl/displacement.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * displacement.ts — 纹理位移核心，从 stlTexturizer/js/displacement.js 移植为 TS（简化版）。\n *\n * 对每个顶点：\n *   1. 用与 GPU 预览 shader 相同的数学计算 UV（mapping.ts）\n *   2. 双线性采样灰度 ImageData\n *   3. 沿平滑法线位移：grey × amplitude\n *\n * 简化：去掉了 boundaryFalloff、blendNormalSmoothing、cubic zoneArea 等。\n * 保留了核心水密性保证：同位置顶点使用相同平滑法线 + 相同位移值。\n */\n\nimport * as THREE from 'three'\nimport { QuantizedPointMap } from './meshIndex'\nimport { computeUV, getCubicBlendWeights, type MappingSettings } from './mapping'\n\n/**\n * Displacement settings: the mapping settings plus the amplitude, optional\n * symmetric displacement, and angle-based face-masking limits.\n */\nexport interface DisplacementSettings extends MappingSettings {\n  mappingMode: number\n  amplitude: number\n  symmetricDisplacement?: boolean\n  bottomAngleLimit?: number\n  topAngleLimit?: number\n}\n\ninterface Bounds {\n  min: THREE.Vector3\n  max: THREE.Vector3\n  center: THREE.Vector3\n  size: THREE.Vector3\n}\n\ninterface ImageDataLike {\n  data: Uint8ClampedArray | Uint8Array\n  width: number\n  height: number\n}\n\n/**\n * Displace every vertex of a non-indexed BufferGeometry. For each vertex the\n * UV is computed with the same math as the GPU preview shader, the greyscale\n * ImageData is sampled bilinearly, and the position is shifted along the\n * smoothed normal by grey × amplitude.\n *\n * @param geometry - the non-indexed source geometry (position + normal attributes).\n * @param imageData - RGBA pixel data of the height map.\n * @param imgWidth - texture width in pixels.\n * @param imgHeight - texture height in pixels.\n * @param settings - displacement and mapping settings.\n * @param bounds - overall mesh bounds used to normalize UV coordinates.\n * @param onProgress - optional callback receiving progress in [0, 1].\n * @returns a new BufferGeometry with displaced positions and face normals.\n */\nexport function applyDisplacement(\n  geometry: THREE.BufferGeometry,\n  imageData: ImageDataLike,\n  imgWidth: number,\n  imgHeight: number,\n  settings: DisplacementSettings,\n  bounds: Bounds,\n  onProgress?: (p: number) => void,\n): THREE.BufferGeometry {\n  const posAttr = geometry.attributes.position\n  const nrmAttr = geometry.attributes.normal\n  const count = posAttr.count\n\n  const newPos = new Float32Array(count * 3)\n  const newNrm = new Float32Array(count * 3)\n\n  const tmpPos = new THREE.Vector3()\n  const tmpNrm = new THREE.Vector3()\n  const vA = new THREE.Vector3()\n  const vB = new THREE.Vector3()\n  const vC = new THREE.Vector3()\n  const edge1 = new THREE.Vector3()\n  const edge2 = new THREE.Vector3()\n  const faceNrm = new THREE.Vector3()\n\n  // 纹理纵横比校正\n  const tmax = Math.max(imgWidth, imgHeight, 1)\n  const aspectU = tmax / Math.max(imgWidth, 1)\n  const aspectV = tmax / Math.max(imgHeight, 1)\n  const settingsWithAspect = { ...settings, textureAspectU: aspectU, textureAspectV: aspectV }\n\n  // 10μm 顶点去重\n  const QUANT = 1e5\n\n  // ── 顶点去重：position → numeric ID ──\n  const dedupMap = new QuantizedPointMap(QUANT, Math.min(count, 1 << 22))\n  let nextId = 0\n  const vertexId = new Uint32Array(count)\n  for (let i = 0; i < count; i++) {\n    const x = posAttr.getX(i),\n      y = posAttr.getY(i),\n      z = posAttr.getZ(i)\n    const id = dedupMap.getOrSet(x, y, z, nextId)\n    if (dedupMap.inserted) nextId++\n    vertexId[i] = id\n  }\n  const uniqueCount = nextId\n\n  // ── Pass 1: 每个唯一顶点累加面积加权平滑法线 ──\n  const smoothNrmX = new Float64Array(uniqueCount)\n  const smoothNrmY = new Float64Array(uniqueCount)\n  const smoothNrmZ = new Float64Array(uniqueCount)\n\n  // 角度遮罩\n  const maskedFracMasked = new Float64Array(uniqueCount)\n  const maskedFracTotal = new Float64Array(uniqueCount)\n\n  // 面排除权重\n  const ewAttr = geometry.attributes.excludeWeight || null\n  const userExcludedFaces = ewAttr ? new Uint8Array(count / 3) : null\n  const excludedPos = ewAttr ? new Uint8Array(uniqueCount) : null\n\n  for (let t = 0; t < count; t += 3) {\n    vA.fromBufferAttribute(posAttr, t)\n    vB.fromBufferAttribute(posAttr, t + 1)\n    vC.fromBufferAttribute(posAttr, t + 2)\n    edge1.subVectors(vB, vA)\n    edge2.subVectors(vC, vA)\n    faceNrm.crossVectors(edge1, edge2)\n\n    const faceArea = faceNrm.length()\n    const faceNzNorm = faceArea > 1e-12 ? faceNrm.z / faceArea : 0\n    const faceAngle = Math.acos(Math.abs(faceNzNorm)) * (180 / Math.PI)\n    const angleMasked =\n      faceNzNorm < 0\n        ? (settings.bottomAngleLimit ?? 0) > 0 &&\n          faceAngle <= (settings.bottomAngleLimit ?? 0)\n        : (settings.topAngleLimit ?? 0) > 0 &&\n          faceAngle <= (settings.topAngleLimit ?? 0)\n\n    const userExcluded = ewAttr\n      ? (ewAttr.getX(t) + ewAttr.getX(t + 1) + ewAttr.getX(t + 2)) / 3 > 0.99\n      : false\n    const faceMasked = angleMasked\n    if (userExcluded && userExcludedFaces) userExcludedFaces[t / 3] = 1\n\n    for (let v = 0; v < 3; v++) {\n      const vid = vertexId[t + v]\n      if (userExcluded && excludedPos) excludedPos[vid] = 1\n      tmpNrm.fromBufferAttribute(nrmAttr, t + v)\n      smoothNrmX[vid] += tmpNrm.x * faceArea\n      smoothNrmY[vid] += tmpNrm.y * faceArea\n      smoothNrmZ[vid] += tmpNrm.z * faceArea\n      if (faceMasked) maskedFracMasked[vid] += faceArea\n      maskedFracTotal[vid] += faceArea\n    }\n  }\n\n  // 归一化平滑法线\n  for (let id = 0; id < uniqueCount; id++) {\n    const len = Math.sqrt(\n      smoothNrmX[id] * smoothNrmX[id] +\n        smoothNrmY[id] * smoothNrmY[id] +\n        smoothNrmZ[id] * smoothNrmZ[id],\n    )\n    const inv = len > 0 ? 1 / len : 1\n    smoothNrmX[id] *= inv\n    smoothNrmY[id] *= inv\n    smoothNrmZ[id] *= inv\n  }\n\n  // ── Pass 2: 每个唯一顶点采样纹理一次 ──\n  const dispCacheVal = new Float64Array(uniqueCount)\n  const dispCacheSet = new Uint8Array(uniqueCount)\n\n  for (let i = 0; i < count; i++) {\n    const vid = vertexId[i]\n    if (dispCacheSet[vid]) continue\n    dispCacheSet[vid] = 1\n\n    tmpPos.fromBufferAttribute(posAttr, i)\n\n    // Cubic 模式特殊处理\n    if (settings.mappingMode === 6) {\n      const md = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6)\n      const rotRad = (settings.rotation ?? 0) * Math.PI / 180\n      const cubicBlend = settings.mappingBlend ?? 0\n      const cubicBandWidth = settings.seamBandWidth ?? 0.35\n\n      const sn = {\n        x: smoothNrmX[vid],\n        y: smoothNrmY[vid],\n        z: smoothNrmZ[vid],\n      }\n      const w = getCubicBlendWeights(sn, cubicBlend, cubicBandWidth)\n\n      if (w.x + w.y + w.z > 0) {\n        let grey = 0\n        if (w.x > 0) {\n          let rawU = (tmpPos.y - bounds.min.y) / md\n          if (smoothNrmX[vid] < 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.z - bounds.min.z) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.x\n        }\n        if (w.y > 0) {\n          let rawU = (tmpPos.x - bounds.min.x) / md\n          if (smoothNrmY[vid] > 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.z - bounds.min.z) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.y\n        }\n        if (w.z > 0) {\n          let rawU = (tmpPos.x - bounds.min.x) / md\n          if (smoothNrmZ[vid] < 0) rawU = -rawU\n          const uv = _cubicUV(rawU, (tmpPos.y - bounds.min.y) / md, settings, rotRad, aspectU, aspectV)\n          grey += sampleBilinear(imageData.data, imgWidth, imgHeight, uv.u, uv.v) * w.z\n        }\n        dispCacheVal[vid] = grey\n        continue\n      }\n    }\n\n    // 其他模式：用平滑法线计算 UV\n    tmpNrm.set(smoothNrmX[vid], smoothNrmY[vid], smoothNrmZ[vid])\n\n    const uvResult = computeUV(tmpPos, tmpNrm, settings.mappingMode, settingsWithAspect, bounds)\n    let grey: number\n    if (uvResult.triplanar && uvResult.samples) {\n      grey = 0\n      for (const s of uvResult.samples) {\n        grey += sampleBilinear(imageData.data, imgWidth, imgHeight, s.u, s.v) * s.w\n      }\n    } else {\n      grey = sampleBilinear(imageData.data, imgWidth, imgHeight, uvResult.u, uvResult.v)\n    }\n    dispCacheVal[vid] = grey\n  }\n\n  // ── Pass 3: 每个顶点副本沿平滑法线位移 ──\n  const REPORT_EVERY = 5000\n\n  for (let i = 0; i < count; i++) {\n    tmpPos.fromBufferAttribute(posAttr, i)\n    tmpNrm.fromBufferAttribute(nrmAttr, i)\n\n    const vid = vertexId[i]\n    const grey = dispCacheVal[vid]\n\n    const isFaceExcluded = userExcludedFaces && userExcludedFaces[Math.floor(i / 3)]\n    const isSealedBoundary = !isFaceExcluded && excludedPos && excludedPos[vid] === 1\n    const mfTotal = maskedFracTotal[vid]\n    const maskedFrac = mfTotal > 0 ? maskedFracMasked[vid] / mfTotal : 0\n    const centeredGrey = settings.symmetricDisplacement ? grey - 0.5 : grey\n    const disp =\n      isFaceExcluded || isSealedBoundary\n        ? 0\n        : (1 - maskedFrac) * centeredGrey * settings.amplitude\n\n    const newX = tmpPos.x + smoothNrmX[vid] * disp\n    const newY = tmpPos.y + smoothNrmY[vid] * disp\n    let newZ = tmpPos.z + smoothNrmZ[vid] * disp\n\n    // 防止边界顶点穿过遮罩表面\n    if (maskedFrac > 0) {\n      if ((settings.bottomAngleLimit ?? 0) > 0 && newZ < tmpPos.z) newZ = tmpPos.z\n      if ((settings.topAngleLimit ?? 0) > 0 && newZ > tmpPos.z) newZ = tmpPos.z\n    }\n\n    newPos[i * 3] = newX\n    newPos[i * 3 + 1] = newY\n    newPos[i * 3 + 2] = newZ\n\n    newNrm[i * 3] = tmpNrm.x\n    newNrm[i * 3 + 1] = tmpNrm.y\n    newNrm[i * 3 + 2] = tmpNrm.z\n\n    if (onProgress && i % REPORT_EVERY === 0) onProgress(i / count)\n  }\n\n  // 从位移后位置计算精确的面法线\n  const eA = new THREE.Vector3()\n  const eB = new THREE.Vector3()\n  const fn = new THREE.Vector3()\n  for (let t = 0; t < count; t += 3) {\n    const ax = newPos[t * 3],\n      ay = newPos[t * 3 + 1],\n      az = newPos[t * 3 + 2]\n    const bx = newPos[t * 3 + 3],\n      by = newPos[t * 3 + 4],\n      bz = newPos[t * 3 + 5]\n    const cx = newPos[t * 3 + 6],\n      cy = newPos[t * 3 + 7],\n      cz = newPos[t * 3 + 8]\n    eA.set(bx - ax, by - ay, bz - az)\n    eB.set(cx - ax, cy - ay, cz - az)\n    fn.crossVectors(eA, eB).normalize()\n    for (let v = 0; v < 3; v++) {\n      newNrm[(t + v) * 3] = fn.x\n      newNrm[(t + v) * 3 + 1] = fn.y\n      newNrm[(t + v) * 3 + 2] = fn.z\n    }\n  }\n\n  const out = new THREE.BufferGeometry()\n  out.setAttribute('position', new THREE.BufferAttribute(newPos, 3))\n  out.setAttribute('normal', new THREE.BufferAttribute(newNrm, 3))\n  return out\n}\n\n// ── 双线性采样 ──\n\nfunction sampleBilinear(\n  data: Uint8ClampedArray | Uint8Array,\n  w: number,\n  h: number,\n  u: number,\n  v: number,\n): number {\n  u = ((u % 1) + 1) % 1\n  v = ((v % 1) + 1) % 1\n  v = 1 - v\n\n  const fx = u * w - 0.5\n  const fy = v * h - 0.5\n  let x0 = Math.floor(fx)\n  let y0 = Math.floor(fy)\n  const tx = fx - x0\n  const ty = fy - y0\n  const x1 = (x0 + 1 + w) % w\n  const y1 = (y0 + 1 + h) % h\n  x0 = ((x0 % w) + w) % w\n  y0 = ((y0 % h) + h) % h\n\n  const v00 = data[(y0 * w + x0) * 4] / 255\n  const v10 = data[(y0 * w + x1) * 4] / 255\n  const v01 = data[(y1 * w + x0) * 4] / 255\n  const v11 = data[(y1 * w + x1) * 4] / 255\n\n  return (\n    v00 * (1 - tx) * (1 - ty) +\n    v10 * tx * (1 - ty) +\n    v01 * (1 - tx) * ty +\n    v11 * tx * ty\n  )\n}\n\nfunction _cubicUV(\n  rawU: number,\n  rawV: number,\n  settings: DisplacementSettings,\n  rotRad: number,\n  aspectU: number,\n  aspectV: number,\n): { u: number; v: number } {\n  let u = (rawU * aspectU) / settings.scaleU + settings.offsetU\n  let v = (rawV * aspectV) / settings.scaleV + settings.offsetV\n  if (rotRad !== 0) {\n    const c = Math.cos(rotRad),\n      s = Math.sin(rotRad)\n    u -= 0.5\n    v -= 0.5\n    const ru = c * u - s * v,\n      rv = s * u + c * v\n    u = ru + 0.5\n    v = rv + 0.5\n  }\n  return { u: u - Math.floor(u), v: v - Math.floor(v) }\n}\n"]}

package/dist/mesh/knurl/mapping.d.ts

@@ -0,0 +1,104 @@
+/**
+ * mapping.ts — CPU 侧 UV 投影，从 stlTexturizer/js/mapping.js 移植为 TS。
+ *
+ * 所有函数接受 {x,y,z} 格式的 position/normal 和 bounds 对象。
+ */
+/** Planar projection mode projecting onto the XY plane (normal ≈ Z axis). */
+export declare const MODE_PLANAR_XY = 0;
+/** Planar projection mode projecting onto the XZ plane (normal ≈ Y axis). */
+export declare const MODE_PLANAR_XZ = 1;
+/** Planar projection mode projecting onto the YZ plane (normal ≈ X axis). */
+export declare const MODE_PLANAR_YZ = 2;
+/** Cylindrical projection mode around the vertical axis. */
+export declare const MODE_CYLINDRICAL = 3;
+/** Spherical projection mode around the bounds center. */
+export declare const MODE_SPHERICAL = 4;
+/** Triplanar projection mode blending the three axial planar projections. */
+export declare const MODE_TRIPLANAR = 5;
+/** Cubic projection mode with one dominant axis and seam blending. */
+export declare const MODE_CUBIC = 6;
+interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+interface Bounds {
+    min: Vec3;
+    max: Vec3;
+    center: Vec3;
+    size: Vec3;
+}
+/**
+ * UV mapping settings: per-axis scale and offset, rotation, the optional
+ * texture aspect ratio, seam blend and band width, plus the optional cylinder
+ * parameters used by the cylindrical mode.
+ */
+export interface MappingSettings {
+    scaleU: number;
+    scaleV: number;
+    offsetU: number;
+    offsetV: number;
+    rotation?: number;
+    textureAspectU?: number;
+    textureAspectV?: number;
+    mappingBlend?: number;
+    seamBandWidth?: number;
+    capAngle?: number;
+    cylinderCenterX?: number;
+    cylinderCenterY?: number;
+    cylinderRadius?: number;
+}
+/**
+ * A single UV sample paired with a blend weight, used when a projection
+ * returns several weighted planes (triplanar or seam blending).
+ */
+export interface UVSample {
+    u: number;
+    v: number;
+    w: number;
+}
+/**
+ * Result of a UV projection: either a single transformed UV pair, or a flag
+ * plus a list of weighted samples for multi-plane projections.
+ */
+export interface UVResult {
+    u: number;
+    v: number;
+    triplanar?: boolean;
+    samples?: UVSample[];
+}
+/**
+ * Pick the dominant axis of a normal for cubic projection.
+ *
+ * @param normal - the vertex normal (unit length not required).
+ * @returns the axis with the largest absolute component, preferring x then y.
+ */
+export declare function getDominantCubicAxis(normal: Vec3): 'x' | 'y' | 'z';
+/**
+ * Compute per-axis blend weights for cubic projection, softening the seams
+ * between the dominant axis and the secondary axes.
+ *
+ * @param normal - the vertex normal.
+ * @param blend - blend amount in [0, 1]; 0 keeps a single dominant axis.
+ * @param seamBandWidth - width of the seam-blend band.
+ * @returns the x/y/z blend weights, summing to 1.
+ */
+export declare function getCubicBlendWeights(normal: Vec3, blend: number, seamBandWidth?: number): {
+    x: number;
+    y: number;
+    z: number;
+};
+/**
+ * Compute the normalized tiling UV coordinates [0, 1) for a vertex under the
+ * requested projection mode.
+ *
+ * @param pos - the vertex position.
+ * @param normal - the vertex normal.
+ * @param mode - projection mode constant (planar, cylindrical, spherical, triplanar, or cubic).
+ * @param settings - mapping settings for scale, offset, and rotation.
+ * @param bounds - the mesh bounds used to normalize coordinates.
+ * @returns the UV result (a single pair or weighted samples).
+ */
+export declare function computeUV(pos: Vec3, normal: Vec3, mode: number, settings: MappingSettings, bounds: Bounds): UVResult;
+export {};
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mesh/knurl/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/mapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,cAAc,IAAI,CAAA;AAC/B,6EAA6E;AAC7E,eAAO,MAAM,cAAc,IAAI,CAAA;AAC/B,6EAA6E;AAC7E,eAAO,MAAM,cAAc,IAAI,CAAA;AAC/B,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,IAAI,CAAA;AACjC,0DAA0D;AAC1D,eAAO,MAAM,cAAc,IAAI,CAAA;AAC/B,6EAA6E;AAC7E,eAAO,MAAM,cAAc,IAAI,CAAA;AAC/B,sEAAsE;AACtE,eAAO,MAAM,UAAU,IAAI,CAAA;AAK3B,UAAU,IAAI;IACZ,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,UAAU,MAAM;IACd,GAAG,EAAE,IAAI,CAAA;IACT,GAAG,EAAE,IAAI,CAAA;IACT,MAAM,EAAE,IAAI,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAA;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAOlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,MAAa,GAC3B;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAqDrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,IAAI,EACT,MAAM,EAAE,IAAI,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,GACb,QAAQ,CAsMV"}