npm - @fps-games/vfx - Versions diffs - 0.1.1 → 0.3.3 - Mend

@fps-games/vfx 0.1.1 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (250) hide show

package/docs/weapon-trail-visualization.html DELETED Viewed

@@ -1,241 +0,0 @@
-<!doctype html>
-<html lang="zh">
-<head>
-<meta charset="utf-8" />
-<meta name="viewport" content="width=device-width, initial-scale=1" />
-<title>武器拖尾 weapon-trail · 贴图 / 颜色 / 形状 可视化</title>
-<style>
-  :root { --bg:#0a0e17; --panel:#121826; --ink:#cfe1ff; --dim:#7e93b8; --line:#22304d; --accent:#6cc0ff; }
-  * { box-sizing:border-box; }
-  body { margin:0; background:var(--bg); color:var(--ink); font:14px/1.6 -apple-system,system-ui,"PingFang SC",sans-serif; }
-  h1 { font-size:18px; margin:0 0 4px; }
-  h2 { font-size:14px; color:var(--accent); margin:0 0 8px; letter-spacing:.5px; }
-  .sub { color:var(--dim); font-size:12px; margin-bottom:18px; }
-  .wrap { max-width:1080px; margin:0 auto; padding:22px 18px 60px; }
-  .grid { display:grid; grid-template-columns:1fr 1fr; gap:16px; }
-  .card { background:var(--panel); border:1px solid var(--line); border-radius:12px; padding:14px 16px; }
-  .full { grid-column:1 / -1; }
-  canvas { display:block; width:100%; border-radius:8px; background:
-     conic-gradient(#1a2233 0 25%, #141a28 0 50%, #1a2233 0 75%, #141a28 0) 0 0 / 16px 16px; }
-  .row { display:flex; align-items:center; gap:10px; margin:7px 0; }
-  .row label { flex:0 0 120px; color:var(--dim); font-size:12px; }
-  .row input[type=range] { flex:1; }
-  .row .val { flex:0 0 48px; text-align:right; color:var(--accent); font-variant-numeric:tabular-nums; }
-  .row input[type=color] { width:40px; height:24px; border:1px solid var(--line); border-radius:5px; background:#0c1322; padding:0; }
-  code { background:#0c1322; border:1px solid var(--line); border-radius:4px; padding:1px 5px; color:#9fd0ff; font-size:12px; }
-  .legend { font-size:12px; color:var(--dim); margin-top:8px; }
-  .legend b { color:var(--ink); }
-  .pipe { font-size:12.5px; line-height:1.9; }
-  .pipe .step { color:var(--ink); } .pipe .op { color:var(--accent); }
-  .tag { display:inline-block; font-size:11px; padding:1px 6px; border:1px solid var(--line); border-radius:999px; color:var(--dim); margin-left:6px; }
-  .axis { font-size:11px; color:var(--dim); }
-</style>
-</head>
-<body>
-<div class="wrap">
-  <h1>武器拖尾 <code>weapon-trail</code> — 贴图 / 颜色 / 形状</h1>
-  <div class="sub">贴图 <b>trail_wedge.png</b> 254×77 RGBA · 下面用 canvas 实时复刻片元着色器,拖滑块即时看每个参数的影响。背景棋盘格 = 透明区。</div>
-  <div class="grid">
-    <!-- 1. 原始贴图 -->
-    <div class="card">
-      <h2>① 原始贴图 trail_wedge.png</h2>
-      <canvas id="texCanvas" height="120"></canvas>
-      <div class="legend">
-        左 = 拖尾<b>头部</b>(u≈0),右 = <b>尾端</b>(u≈1);上下 = 拖尾<b>宽度</b>方向(v 0→1)。<br>
-        这是一个<b>楔形 + alpha 渐变</b>:RGB 蓝白,alpha 决定可见形状(头宽尾窄/边缘羽化)。
-      </div>
-    </div>
-    <!-- 2. alpha 通道 -->
-    <div class="card">
-      <h2>② 贴图通道拆解</h2>
-      <canvas id="chanCanvas" height="120"></canvas>
-      <div class="legend">上 = <b>RGB</b>(颜色)· 下 = <b>Alpha</b>(白=不透明,黑=透明)。拖尾的「形状」几乎全在 alpha 里。</div>
-    </div>
-    <!-- 3. 颜色管线 -->
-    <div class="card full">
-      <h2>③ 片元颜色管线(逐步)</h2>
-      <div class="pipe">
-        <span class="step">base = texture(uv)</span> <span class="op">→</span>
-        <span class="step">color = base.rgb × <b style="color:#6cc0ff">uTint</b></span> <span class="op">→</span>
-        <span class="step">饱和度 mix(灰, color, <b style="color:#6cc0ff">uSaturation</b>)</span> <span class="op">→</span>
-        <span class="step">对比度 (color−0.5)×<b style="color:#6cc0ff">uContrast</b>+0.5</span> <span class="op">→</span>
-        <span class="step">alpha = base.a<sup><b style="color:#6cc0ff">uAlphaPower</b></sup> × 顶点α(尾部淡出) × <b style="color:#6cc0ff">uAlphaScale</b></span>
-        <span class="tag">ALPHA_COMBINE</span>
-      </div>
-      <canvas id="stripCanvas" height="120" style="margin-top:10px"></canvas>
-      <div class="legend">↑ <b>展开的 ribbon</b>:贴图经上面整条管线 + <b>尾部 alpha 衰减</b>(<code>1 − u^淡出曲线 × 淡出强度</code>,沿长度从头到尾越来越透)后的最终样子。</div>
-    </div>
-    <!-- 4. 拖尾形状 -->
-    <div class="card full">
-      <h2>④ 拖尾形状(几何)</h2>
-      <canvas id="arcCanvas" height="300"></canvas>
-      <div class="legend">
-        每个采样点出 <b>2 个顶点</b> = 中心点 ± (宽度/2) × <b>宽度轴</b>,连成三角带 = ribbon。<br>
-        采样点是 emitter 绕圈路径按<b>弧长均匀重采样</b>到固定段数的结果;<b>水平面</b>朝向时宽度轴=径向(平躺),<b>竖直</b>时=上方向(立着)。
-        <span class="axis">— 虚线 = 采样中心线(emitter 轨迹弧段),短线 = 各点宽度轴。</span>
-      </div>
-    </div>
-  </div>
-  <!-- 控制 -->
-  <div class="card full" style="margin-top:16px">
-    <h2>参数(对应 weapon-trail debugParams)</h2>
-    <div class="grid" style="gap:4px 28px">
-      <div>
-        <div class="row"><label>颜色 uTint</label><input type="color" id="tint" value="#ffffff"><span class="val" id="tintv">#fff</span></div>
-        <div class="row"><label>透明度 opacity</label><input type="range" id="opacity" min="0" max="3" step="0.01" value="1.35"><span class="val" id="opacityv"></span></div>
-        <div class="row"><label>饱和度 saturation</label><input type="range" id="saturation" min="0" max="3" step="0.01" value="1.45"><span class="val" id="saturationv"></span></div>
-        <div class="row"><label>对比度 contrast</label><input type="range" id="contrast" min="0" max="3" step="0.01" value="1.32"><span class="val" id="contrastv"></span></div>
-        <div class="row"><label>alphaPower</label><input type="range" id="alphaPower" min="0.1" max="3" step="0.01" value="0.82"><span class="val" id="alphaPowerv"></span></div>
-      </div>
-      <div>
-        <div class="row"><label>尾部淡出强度</label><input type="range" id="fadeStrength" min="0" max="1" step="0.01" value="0.58"><span class="val" id="fadeStrengthv"></span></div>
-        <div class="row"><label>尾部淡出曲线</label><input type="range" id="fadeExp" min="0.2" max="4" step="0.05" value="1.35"><span class="val" id="fadeExpv"></span></div>
-        <div class="row"><label>拖尾宽度 width</label><input type="range" id="width" min="0.1" max="4" step="0.01" value="1.2"><span class="val" id="widthv"></span></div>
-        <div class="row"><label>拖尾弧度</label><input type="range" id="arcSpan" min="20" max="300" step="5" value="150"><span class="val" id="arcSpanv"></span></div>
-        <div class="row"><label>朝向</label>
-          <select id="orient" style="flex:1;background:#0c1322;color:var(--ink);border:1px solid var(--line);border-radius:5px;padding:3px 6px;">
-            <option value="horizontal">水平面</option><option value="vertical">竖直</option>
-          </select><span class="val"></span></div>
-      </div>
-    </div>
-  </div>
-</div>
-<script>
-const TEX_DATA_URI = "data:image/png;base64,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";
-const P = {};
-const ids = ['opacity','saturation','contrast','alphaPower','fadeStrength','fadeExp','width','arcSpan'];
-function readParams(){
-  for (const id of ids){ P[id]=parseFloat(document.getElementById(id).value); document.getElementById(id+'v').textContent = P[id]; }
-  const t = document.getElementById('tint').value;
-  P.tint = [parseInt(t.substr(1,2),16)/255, parseInt(t.substr(3,2),16)/255, parseInt(t.substr(5,2),16)/255];
-  document.getElementById('tintv').textContent = t;
-  P.orient = document.getElementById('orient').value;
-}
-// 读贴图像素
-const img = new Image();
-let texW=0, texH=0, texData=null;
-function sampleTex(u, v){ // u,v in 0..1 → {r,g,b,a} 0..1 (nearest)
-  const x = Math.min(texW-1, Math.max(0, Math.floor(u*texW)));
-  const y = Math.min(texH-1, Math.max(0, Math.floor(v*texH)));
-  const i = (y*texW + x)*4;
-  return [texData[i]/255, texData[i+1]/255, texData[i+2]/255, texData[i+3]/255];
-}
-// 复刻片元:base + tint + sat + contrast + alpha(含尾部衰减 vertexAlpha(u))
-function shade(u, v){
-  const b = sampleTex(u*0.97+0.015, v);
-  let c = [b[0]*P.tint[0], b[1]*P.tint[1], b[2]*P.tint[2]];
-  const lum = c[0]*0.299 + c[1]*0.587 + c[2]*0.114;
-  c = c.map(x => lum + (x-lum)*P.saturation);
-  c = c.map(x => (x-0.5)*P.contrast + 0.5);
-  c = c.map(x => Math.min(1, Math.max(0, x)));
-  const vertexAlpha = Math.max(0, 1 - Math.pow(u, P.fadeExp) * P.fadeStrength);
-  let a = Math.pow(Math.min(1,Math.max(0,b[3])), P.alphaPower) * vertexAlpha * P.opacity;
-  a = Math.min(1, Math.max(0, a));
-  return [c[0]*255, c[1]*255, c[2]*255, a];
-}
-function fitCanvas(cv){ const w = cv.clientWidth; cv.width = w; return cv.getContext('2d'); }
-function drawTex(){ // 原始贴图(直接画 img,棋盘格背景透出 alpha)
-  const cv = document.getElementById('texCanvas'); const ctx = fitCanvas(cv);
-  ctx.clearRect(0,0,cv.width,cv.height);
-  ctx.imageSmoothingEnabled = false;
-  ctx.drawImage(img, 0, 0, cv.width, cv.height);
-}
-function drawChannels(){
-  const cv = document.getElementById('chanCanvas'); const ctx = fitCanvas(cv);
-  ctx.clearRect(0,0,cv.width,cv.height);
-  const h = cv.height/2, w = cv.width;
-  const out = ctx.createImageData(w, cv.height);
-  for (let y=0;y<cv.height;y++) for (let x=0;x<w;x++){
-    const u=x/w, top = y<h;
-    const v = top ? y/h : (y-h)/h;
-    const b = sampleTex(u, v); const o=(y*w+x)*4;
-    if (top){ out.data[o]=b[0]*255; out.data[o+1]=b[1]*255; out.data[o+2]=b[2]*255; out.data[o+3]=255; }
-    else { const g=b[3]*255; out.data[o]=g; out.data[o+1]=g; out.data[o+2]=g; out.data[o+3]=255; }
-  }
-  ctx.putImageData(out,0,0);
-  ctx.fillStyle='#0008'; ctx.fillRect(0,h-9,42,18); ctx.fillStyle='#cfe1ff'; ctx.font='11px monospace';
-  ctx.fillText('RGB', 6, h-12); ctx.fillText('Alpha', 6, cv.height-6);
-}
-function drawStrip(){ // 展开 ribbon:整条管线后的最终像素
-  const cv = document.getElementById('stripCanvas'); const ctx = fitCanvas(cv);
-  ctx.clearRect(0,0,cv.width,cv.height);
-  const w=cv.width, h=cv.height;
-  const out = ctx.createImageData(w,h);
-  for (let y=0;y<h;y++) for (let x=0;x<w;x++){
-    const u=x/w, v=y/h; const s=shade(u,v); const o=(y*w+x)*4;
-    // 在棋盘格上做 alpha 合成
-    const checker = (((x>>4)+(y>>4))&1) ? [26,34,51] : [20,26,40];
-    out.data[o]   = s[0]*s[3] + checker[0]*(1-s[3]);
-    out.data[o+1] = s[1]*s[3] + checker[1]*(1-s[3]);
-    out.data[o+2] = s[2]*s[3] + checker[2]*(1-s[3]);
-    out.data[o+3] = 255;
-  }
-  ctx.putImageData(out,0,0);
-  ctx.fillStyle='#cfe1ff'; ctx.font='11px monospace';
-  ctx.fillText('头 u=0', 4, 14); ctx.textAlign='right'; ctx.fillText('尾 u=1', w-4, 14); ctx.textAlign='left';
-}
-function drawArc(){ // 弯成弧的实际形状 + 几何标注
-  const cv = document.getElementById('arcCanvas'); const ctx = fitCanvas(cv);
-  const w=cv.width, h=cv.height; ctx.clearRect(0,0,w,h);
-  const cx=w*0.5, cy=h*0.62, R=Math.min(w*0.32, h*0.7);
-  const span = P.arcSpan * Math.PI/180;
-  const a0 = -span/2 - Math.PI/2;       // 起始角
-  const SEG=140, VW=18;                  // u 段数 / v 行数
-  const halfW = (P.width*0.5) * (R*0.34);// 屏幕上的半宽(可视化缩放)
-  // 逐格 quad 画 ribbon
-  for (let i=0;i<SEG;i++){
-    const u0=i/SEG, u1=(i+1)/SEG;
-    const ang0=a0+span*u0, ang1=a0+span*u1;
-    for (let j=0;j<VW;j++){
-      const v0=j/VW, v1=(j+1)/VW, vm=(v0+v1)/2, um=(u0+u1)/2;
-      const s=shade(um,vm); if (s[3]<0.02) continue;
-      // 中心线点
-      const p0x=cx+Math.cos(ang0)*R, p0y=cy+Math.sin(ang0)*R*0.55; // *0.55 模拟俯视压扁(水平面)
-      const p1x=cx+Math.cos(ang1)*R, p1y=cy+Math.sin(ang1)*R*0.55;
-      // 宽度方向:水平=径向(在压扁平面里),竖直=屏幕上下
-      let wx0,wy0,wx1,wy1;
-      if (P.orient==='vertical'){ wx0=0; wy0=-1; wx1=0; wy1=-1; }
-      else { wx0=Math.cos(ang0); wy0=Math.sin(ang0)*0.55; const l0=Math.hypot(wx0,wy0); wx0/=l0; wy0/=l0; wx1=Math.cos(ang1); wy1=Math.sin(ang1)*0.55; const l1=Math.hypot(wx1,wy1); wx1/=l1; wy1/=l1; }
-      const oy = P.orient==='vertical' ? halfW : halfW; // 屏幕半宽
-      const A=[p0x+wx0*oy*(0.5-v0)*2, p0y+wy0*oy*(0.5-v0)*2];
-      const B=[p0x+wx0*oy*(0.5-v1)*2, p0y+wy0*oy*(0.5-v1)*2];
-      const C=[p1x+wx1*oy*(0.5-v1)*2, p1y+wy1*oy*(0.5-v1)*2];
-      const D=[p1x+wx1*oy*(0.5-v0)*2, p1y+wy1*oy*(0.5-v0)*2];
-      ctx.fillStyle=`rgba(${s[0]|0},${s[1]|0},${s[2]|0},${s[3]})`;
-      ctx.beginPath(); ctx.moveTo(A[0],A[1]); ctx.lineTo(B[0],B[1]); ctx.lineTo(C[0],C[1]); ctx.lineTo(D[0],D[1]); ctx.closePath(); ctx.fill();
-    }
-  }
-  // 标注:中心线 + 几个宽度轴
-  ctx.setLineDash([4,4]); ctx.strokeStyle='#6cc0ff88'; ctx.beginPath();
-  for (let i=0;i<=SEG;i++){ const ang=a0+span*(i/SEG); const x=cx+Math.cos(ang)*R, y=cy+Math.sin(ang)*R*0.55; i?ctx.lineTo(x,y):ctx.moveTo(x,y); }
-  ctx.stroke(); ctx.setLineDash([]);
-  ctx.strokeStyle='#ffd36c'; ctx.lineWidth=1.5;
-  for (let k=0;k<=6;k++){ const u=k/6; const ang=a0+span*u; const px=cx+Math.cos(ang)*R, py=cy+Math.sin(ang)*R*0.55;
-    let wx,wy; if(P.orient==='vertical'){wx=0;wy=-1;} else {wx=Math.cos(ang); wy=Math.sin(ang)*0.55; const l=Math.hypot(wx,wy); wx/=l; wy/=l;}
-    const hw=(P.width*0.5)*(R*0.34); ctx.beginPath(); ctx.moveTo(px-wx*hw,py-wy*hw); ctx.lineTo(px+wx*hw,py+wy*hw); ctx.stroke(); }
-  ctx.fillStyle='#cfe1ff'; ctx.font='12px monospace'; ctx.fillText('头(u=0)', cx+Math.cos(a0)*R-10, cy+Math.sin(a0)*R*0.55-8);
-  ctx.fillText('尾(u=1)', cx+Math.cos(a0+span)*R-10, cy+Math.sin(a0+span)*R*0.55+16);
-}
-function redraw(){ readParams(); drawTex(); drawChannels(); drawStrip(); drawArc(); }
-img.onload = () => {
-  const off = document.createElement('canvas'); off.width=img.width; off.height=img.height;
-  const octx = off.getContext('2d'); octx.drawImage(img,0,0);
-  texW=img.width; texH=img.height; texData=octx.getImageData(0,0,texW,texH).data;
-  redraw();
-};
-img.src = TEX_DATA_URI;
-document.querySelectorAll('input,select').forEach(el => el.addEventListener('input', redraw));
-window.addEventListener('resize', redraw);
-</script>
-</body>
-</html>

package/packages/EffectPackageService.ts DELETED Viewed

@@ -1,240 +0,0 @@
-import { Vector3 } from '@babylonjs/core/Maths/math.vector';
-import type { Scene } from '@babylonjs/core/scene';
-import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
-import { VFX_DEFAULT_GENERATION_PARAMS, VFX_GENERATION_PARAM_KEYS } from './generation';
-import type { VfxRegistry } from './registry';
-import type {
-  VfxColorValue,
-  VfxDebugAnchor,
-  VfxEffectHandle,
-  VfxEffectPackage,
-  VfxParamValue,
-  VfxParamValues,
-  VfxSpawnParamKeys,
-  VfxSpawnTransform,
-} from './types';
-export interface EffectPackageServiceOptions {
-  /** 注入的注册表(由项目侧 glob + buildRegistry 构建);库不直接引用项目注册表 */
-  registry: VfxRegistry;
-  getDebugAnchorPosition?: (anchor: VfxDebugAnchor) => Vector3 | null;
-}
-const DEFAULT_SPAWN_PARAM_KEYS: Required<Pick<VfxSpawnParamKeys, 'offsetX' | 'offsetY' | 'offsetZ'>> = {
-  offsetX: VFX_GENERATION_PARAM_KEYS.offsetX,
-  offsetY: VFX_GENERATION_PARAM_KEYS.offsetY,
-  offsetZ: VFX_GENERATION_PARAM_KEYS.offsetZ,
-};
-export class EffectPackageService {
-  private readonly scene: Scene;
-  private readonly registry: VfxRegistry;
-  private readonly getDebugAnchorPosition?: (anchor: VfxDebugAnchor) => Vector3 | null;
-  private readonly activeHandles = new Set<VfxEffectHandle>();
-  private readonly savedParams: Record<string, Partial<VfxParamValues>>;
-  constructor(scene: Scene, options: EffectPackageServiceOptions) {
-    this.scene = scene;
-    this.registry = options.registry;
-    this.getDebugAnchorPosition = options.getDebugAnchorPosition;
-    this.savedParams = cloneOverrideMap(options.registry.savedParams);
-  }
-  getEffectPackages(): VfxEffectPackage[] {
-    return this.registry.getEffectPackages();
-  }
-  getEffectPackage(effectId: string): VfxEffectPackage | undefined {
-    return this.registry.getEffectPackage(effectId);
-  }
-  getMergedParams(effectId: string, explicitParams?: Partial<VfxParamValues>): VfxParamValues | null {
-    const effectPackage = this.getEffectPackage(effectId);
-    if (!effectPackage) return null;
-    return mergeVfxParams(
-      VFX_DEFAULT_GENERATION_PARAMS,
-      effectPackage.defaultParams,
-      effectPackage.savedParams,
-      this.savedParams[effectId],
-      explicitParams,
-    );
-  }
-  getDebugOverride(effectId: string): Partial<VfxParamValues> {
-    return cloneParams(this.savedParams[effectId]);
-  }
-  setDebugOverride(effectId: string, params: Partial<VfxParamValues>): void {
-    this.savedParams[effectId] = cloneParams(params);
-    const effectPackage = this.getEffectPackage(effectId);
-    if (effectPackage) effectPackage.savedParams = cloneParams(params);
-  }
-  playEffectPackage(
-    effectId: string,
-    explicitParams?: Partial<VfxParamValues>,
-    spawnTransform?: VfxSpawnTransform | Vector3,
-  ): VfxEffectHandle | null {
-    const effectPackage = this.getEffectPackage(effectId);
-    if (!effectPackage) {
-      console.warn(`[EffectPackageService] Unknown VFX effect package: ${effectId}`);
-      return null;
-    }
-    const params = this.getMergedParams(effectId, explicitParams);
-    if (!params) return null;
-    const spawn = this.resolveSpawnTransform(effectPackage, params, spawnTransform);
-    const runtimeParams = stripSpawnParams(params, effectPackage.spawnParams);
-    const root = new TransformNode(`vfx_package_${effectId}`, this.scene);
-    root.position.copyFrom(spawn.position);
-    root.rotation.y = spawn.rotationY;
-    let handle: VfxEffectHandle;
-    try {
-      handle = effectPackage.create({
-        scene: this.scene,
-        root,
-        position: spawn.position.clone(),
-        rotationY: spawn.rotationY,
-        renderingGroupId: spawn.renderingGroupId,
-        params: runtimeParams,
-      });
-    } catch (error) {
-      // 错误兜底:单个坏包不得崩掉整个场景(plan §7)
-      console.warn(`[EffectPackageService] effect "${effectId}" create() failed; skipped.`, error);
-      try { root.dispose(); } catch { /* ignore */ }
-      return null;
-    }
-    this.activeHandles.add(handle);
-    const originalDispose = handle.dispose.bind(handle);
-    handle.dispose = () => {
-      this.activeHandles.delete(handle);
-      originalDispose();
-    };
-    return handle;
-  }
-  dispose(): void {
-    for (const handle of this.activeHandles) {
-      handle.dispose();
-    }
-    this.activeHandles.clear();
-  }
-  private resolveDebugPosition(effectPackage: VfxEffectPackage): Vector3 {
-    const anchor = effectPackage.debugAnchor ?? 'playerRight';
-    const anchorPosition = this.getDebugAnchorPosition?.(anchor);
-    if (anchorPosition) return anchorPosition.clone();
-    const cameraTarget = (this.scene.activeCamera as any)?.target as Vector3 | undefined;
-    if (cameraTarget?.clone) return cameraTarget.clone().addInPlace(new Vector3(1.2, 0, 0));
-    return new Vector3(0, 0, 0);
-  }
-  private resolveSpawnTransform(
-    effectPackage: VfxEffectPackage,
-    params: VfxParamValues,
-    spawnTransform?: VfxSpawnTransform | Vector3,
-  ): Required<Pick<VfxSpawnTransform, 'position' | 'rotationY'>> & Pick<VfxSpawnTransform, 'renderingGroupId'> {
-    const normalized = normalizeSpawnTransform(spawnTransform);
-    const basePosition = normalized.position?.clone() ?? this.resolveDebugPosition(effectPackage);
-    const rotationY = readFiniteNumber(normalized.rotationY, 0);
-    const renderingGroupId = readOptionalFiniteNumber(normalized.renderingGroupId);
-    const offset = readSpawnOffset(params, effectPackage.spawnParams);
-    if (offset.lengthSquared() <= 0.0000001) {
-      return { position: basePosition, rotationY, renderingGroupId };
-    }
-    const cos = Math.cos(rotationY);
-    const sin = Math.sin(rotationY);
-    return {
-      position: basePosition.addInPlace(new Vector3(
-        offset.x * cos - offset.z * sin,
-        offset.y,
-        offset.x * sin + offset.z * cos,
-      )),
-      rotationY,
-      renderingGroupId,
-    };
-  }
-}
-function normalizeSpawnTransform(spawnTransform?: VfxSpawnTransform | Vector3): VfxSpawnTransform {
-  if (!spawnTransform) return {};
-  if (spawnTransform instanceof Vector3) return { position: spawnTransform };
-  return spawnTransform;
-}
-function readSpawnOffset(params: VfxParamValues, spawnParams?: VfxSpawnParamKeys): Vector3 {
-  const keys = resolveSpawnParamKeys(spawnParams);
-  return new Vector3(
-    readParamNumber(params[keys.offsetX ?? ''], 0),
-    readParamNumber(params[keys.offsetY ?? ''], 0),
-    readParamNumber(params[keys.offsetZ ?? ''], 0),
-  );
-}
-function stripSpawnParams(params: VfxParamValues, spawnParams?: VfxSpawnParamKeys): VfxParamValues {
-  const result = cloneParams(params) as VfxParamValues;
-  const keys = resolveSpawnParamKeys(spawnParams);
-  for (const key of [keys.offsetX, keys.offsetY, keys.offsetZ]) {
-    if (key) delete result[key];
-  }
-  return result;
-}
-function resolveSpawnParamKeys(spawnParams?: VfxSpawnParamKeys): VfxSpawnParamKeys {
-  return spawnParams ?? DEFAULT_SPAWN_PARAM_KEYS;
-}
-function readParamNumber(value: VfxParamValue | undefined, fallback: number): number {
-  return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
-}
-function readFiniteNumber(value: unknown, fallback: number): number {
-  return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
-}
-function readOptionalFiniteNumber(value: unknown): number | undefined {
-  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
-}
-function mergeVfxParams(
-  ...sources: Array<Partial<VfxParamValues> | undefined>
-): VfxParamValues {
-  const result: Partial<VfxParamValues> = {};
-  for (const source of sources) {
-    Object.assign(result, cloneParams(source));
-  }
-  return result as VfxParamValues;
-}
-function cloneParams(value: Partial<VfxParamValues> | undefined): Partial<VfxParamValues> {
-  if (!value) return {};
-  const result: Partial<VfxParamValues> = {};
-  for (const [key, item] of Object.entries(value)) {
-    if (item === undefined) continue;
-    result[key] = cloneParamValue(item);
-  }
-  return result;
-}
-function cloneOverrideMap(value: Record<string, Partial<VfxParamValues>>): Record<string, Partial<VfxParamValues>> {
-  const result: Record<string, Partial<VfxParamValues>> = {};
-  for (const [effectId, params] of Object.entries(value)) {
-    result[effectId] = cloneParams(params);
-  }
-  return result;
-}
-function cloneParamValue(value: VfxParamValue): VfxParamValue {
-  if (isColorValue(value)) return { ...value };
-  return value;
-}
-function isColorValue(value: unknown): value is VfxColorValue {
-  return !!value
-    && typeof value === 'object'
-    && !Array.isArray(value)
-    && typeof (value as VfxColorValue).r === 'number'
-    && typeof (value as VfxColorValue).g === 'number'
-    && typeof (value as VfxColorValue).b === 'number';
-}

package/packages/SceneVfxService.ts DELETED Viewed

@@ -1,96 +0,0 @@
-/**
- * SceneVfxService —— 特效播放门面(库纯净版)
- *
- * 只委托 EffectPackageService:播放 / 预热 / 销毁。注册表经 options.registry 注入。
- * 注:旧版的 `initFromConfig`/`createParticleSystem`(读 scene.json + UIImages 的常驻场景粒子路径)
- * 属项目耦合,已从库剥离(契约 §17)。场景常驻粒子应建模为普通特效包,由项目在 init 时触发。
- */
-import { Scene } from '@babylonjs/core/scene';
-import { Vector3 } from '@babylonjs/core/Maths/math.vector';
-import type { VfxRegistry } from './registry';
-import type {
-  VfxDebugAnchor,
-  VfxEffectHandle,
-  VfxEffectPackage,
-  VfxParamValues,
-  VfxSpawnTransform,
-} from './types';
-import { EffectPackageService } from './EffectPackageService';
-export interface SceneVfxWarmupEntry {
-  effectId: string;
-  params?: Partial<VfxParamValues>;
-  spawnTransform?: VfxSpawnTransform | Vector3;
-}
-export interface SceneVfxServiceOptions {
-  /** 注入的注册表(项目侧 glob + buildRegistry 构建) */
-  registry: VfxRegistry;
-  getDebugAnchorPosition?: (anchor: VfxDebugAnchor) => Vector3 | null;
-}
-export class SceneVfxService {
-  private effectPackageService: EffectPackageService;
-  constructor(scene: Scene, options: SceneVfxServiceOptions) {
-    this.effectPackageService = new EffectPackageService(scene, {
-      registry: options.registry,
-      getDebugAnchorPosition: options.getDebugAnchorPosition,
-    });
-  }
-  getEffectPackageService(): EffectPackageService {
-    return this.effectPackageService;
-  }
-  getEffectPackages(): VfxEffectPackage[] {
-    return this.effectPackageService.getEffectPackages();
-  }
-  getMergedParams(effectId: string, explicitParams?: Partial<VfxParamValues>): VfxParamValues | null {
-    return this.effectPackageService.getMergedParams(effectId, explicitParams);
-  }
-  playEffectPackage(
-    effectId: string,
-    params: Partial<VfxParamValues> = {},
-    spawnTransform?: VfxSpawnTransform | Vector3,
-  ): VfxEffectHandle | null {
-    return this.effectPackageService.playEffectPackage(effectId, params, spawnTransform);
-  }
-  async warmupEffectPackages(entries: SceneVfxWarmupEntry[]): Promise<void> {
-    await Promise.all(entries.map((entry) => this.warmupEffectPackage(entry)));
-  }
-  private async warmupEffectPackage(entry: SceneVfxWarmupEntry): Promise<void> {
-    let handle: VfxEffectHandle | null = null;
-    try {
-      handle = this.playEffectPackage(entry.effectId, entry.params ?? {}, entry.spawnTransform);
-      if (!handle) return;
-      await handle.ready;
-      await this.waitForAnimationFrames(2);
-    } catch (error) {
-      console.warn(`[SceneVfxService] Failed to warm up effect package "${entry.effectId}".`, error);
-    } finally {
-      handle?.dispose();
-    }
-  }
-  private async waitForAnimationFrames(frameCount: number): Promise<void> {
-    for (let i = 0; i < frameCount; i += 1) {
-      await new Promise<void>((resolve) => {
-        if (typeof requestAnimationFrame === 'function') {
-          requestAnimationFrame(() => resolve());
-          return;
-        }
-        window.setTimeout(resolve, 0);
-      });
-    }
-  }
-  dispose(): void {
-    this.effectPackageService.dispose();
-  }
-}