@realsee/five-webgpu 1.0.0-alpha.13 → 1.0.0-alpha.14

package/plugins/GaussianSplattingEntranceAnimationPlugin/Controller.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/const e=require("../../_virtual/_rolldown/runtime.js"),t=require("../BasePlugin/index.js");let n=require("tslib"),r=require("@realsee/five-webgpu"),i=require("three/webgpu");i=e.__toESM(i,1);var a=class{constructor(e,t,n,r,i){this.R=e,this.Q=t,this.A=n,this.B=r,this.C=i,this.cov=NaN,this.x=NaN}filter(e,t=0){if(isNaN(this.x))this.x=1/this.C*e,this.cov=1/this.C*this.Q*(1/this.C);else{let n=this.A*this.x+this.B*t,r=this.A*this.cov*this.A+this.R,i=r*this.C*(1/(this.C*r*this.C+this.Q));this.x=n+i*(e-this.C*n),this.cov=r-i*this.C*r}return this.x}},o=class extends t.BasePlugin.Controller{updateState(e,t){let n=this.state;this.state=Object.assign(Object.assign({},this.state),e),this.hooks.emit(`stateChange`,{state:this.state,prevState:n,userAction:t})}constructor(e,t){var n,r,i;super(e),this.boundingAABB=null,this.cancelAnimation=null,this.boundsSet=!1,this.keyframes=[],this.five=e,this.state={enabled:!0,visible:!0},this.duration=(n=t==null?void 0:t.duration)==null?5e3:n,this.curveHeight=(r=t==null?void 0:t.curveHeight)==null?1.5:r,this.pointDuration=(i=t==null?void 0:t.pointDuration)==null?3e3:i}load(){return(0,n.__awaiter)(this,void 0,void 0,function*(){})}enable(e){var t;if(this.state.enabled)return;let n=(t=e==null?void 0:e.userAction)==null?!0:t;this.updateState({enabled:!0},n)}disable(e){var t;if(this.state.enabled===!1)return;let n=(t=e==null?void 0:e.userAction)==null?!0:t;this.updateState({enabled:!1},n)}dispose(){this.disable(),this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null);try{let e=this.findRenderMesh();e&&(e.material.aggregationEnabled=!1,e.material.aggregationProgress=1)}catch(e){}}extractKeyframes(e){let t=[];if(!e.content.data)throw Error(`轨迹数据未加载`);let n=e.content.data.positionArray,r=n.length/3,o=.01,s=.1,c=new a(o,s,1,0,1),l=new a(o,s,1,0,1),u=new a(o,s,1,0,1),d=new Float32Array(r);for(let e=0;e<r;e++)if(e===0)d[e]=0;else{let t=new i.Vector3(n[(e-1)*3],n[(e-1)*3+1],n[(e-1)*3+2]);d[e]=new i.Vector3(n[e*3],n[e*3+1],n[e*3+2]).distanceTo(t)+d[e-1]}for(let a=0;a<r;a++){let o=new i.Vector3(0,0,0),s=0;for(let e=a-5;e<a+6;e++)e>=0&&e<r&&(o.add(new i.Vector3(n[e*3],n[e*3+1],n[e*3+2])),s++);o.divideScalar(s).applyMatrix4(e.transform);let f=c.filter(o.x),p=l.filter(o.y),m=u.filter(o.z);t.push({position:new i.Vector3(f,p,m),location:d[a]})}return t}computeAABB2D(e){let t=1/0,n=-1/0,r=1/0,a=-1/0;for(let i of e)i.position.x<t&&(t=i.position.x),i.position.x>n&&(n=i.position.x),i.position.z<r&&(r=i.position.z),i.position.z>a&&(a=i.position.z);return{min:new i.Vector2(t,r),max:new i.Vector2(n,a)}}findClosestKeyframeToRay(e,t){let n=1/0,r=t[0].position.clone(),a=new i.Vector3;for(let i of t){e.closestPointToPoint(i.position,a);let t=a.distanceTo(i.position);t<n&&(n=t,r=i.position.clone())}return r}isInitAnimationEnabled(){return this.five.modelScene.parameter.resolveValue(`enableGaussianSplattingInitAnimation`)===!0}findRenderMesh(){let e=null;if(this.five.scene.traverse(t=>{if(e)return;let n=t,r=n.material;r&&r.isPBMGaussianSplattingMaterial&&(e=n)}),!e)throw Error(`未找到 GaussianSplatting 渲染网格`);return e}loadTrajectoryDataIfNeeded(e){return(0,n.__awaiter)(this,void 0,void 0,function*(){var t,n,i,a,o,s,c,l;if((t=e.content)!=null&&t.data)return;if(((n=e.content)==null?void 0:n.loadState)===`LOADING`){yield new Promise(t=>{let n=r.AnimationFrameLoop.shared.add(()=>{var r;let i=(r=e.content)==null?void 0:r.loadState;(i===`READY`||i===`FAILED`||i===`UNLOADED`)&&(n(),t())})});return}let u=(i=this.five.model.viewLayers)==null?void 0:i[0],d=u==null?void 0:u.fetcher,f=u==null?void 0:u.search,p=(a=e.content)==null?void 0:a.uri;if(!d||!p)return;let m=f?p.includes(`?`)?`${p}&${f.replace(/^\?/,``)}`:`${p}${f.startsWith(`?`)?f:`?${f}`}`:p;e.content.loadState=`LOADING`;try{let t=yield(0,r.loadPly)(m,{type:`geometry`,customPropertyMapping:{time:{itemType:`uint32`,itemNames:[`time_milisec`]}},fetcher:d}),n=t.scene,i=n.getAttribute(`position`),a=n.getAttribute(`time`),u=(o=i==null?void 0:i.array)==null?new Float32Array:o,f=(s=a==null?void 0:a.array)==null?new Uint32Array:s;e.content.data={uri:m,byteLength:(c=t.byteLength)==null?0:c,memoryUsage:(l=t.memoryUsage)==null?0:l,positionArray:u,timeArray:f,object:null},e.content.loadState=`READY`}catch(t){console.warn(`[GaussianSplattingEntranceAnimationPlugin] trajectory ply 加载失败，将使用 3DGS AABB 回退`,t),e.content.data=void 0,e.content.loadState=`FAILED`}})}computeGSSceneBounds(){let e=new i.Box3,t=new i.Box3;return this.five.scene.traverse(n=>{let r=n;(r==null?void 0:r.boundingBox)instanceof i.Box3&&!r.boundingBox.isEmpty()&&(t.copy(r.boundingBox),r.matrixWorld&&t.applyMatrix4(r.matrixWorld),e.union(t))}),e.isEmpty()?null:e}getCameraCurve(){return(0,n.__awaiter)(this,void 0,void 0,function*(){var e,t,n,r,a,o,s,c,l,u;let d=(r=(n=(t=(e=this.five.model.viewLayers)==null?void 0:e[0])==null?void 0:t.trajectories)==null?void 0:n[0])==null?(c=(s=(o=(a=this.five.model.viewLayers)==null?void 0:a[0])==null?void 0:o.scene)==null?void 0:s.trajectories)==null?void 0:c[0]:r,f=null,p=null;if(d&&(yield this.loadTrajectoryDataIfNeeded(d),(l=d.content)!=null&&l.data&&((u=d.content.data.positionArray)==null?void 0:u.length)>=6&&(f=this.extractKeyframes(d),f.length>=2?p=this.computeAABB2D(f):f=null)),!f||!p){let e=this.computeGSSceneBounds();if(!e)throw Error(`未找到可用于计算入场曲线的 3DGS 边界或轨迹`);p={min:new i.Vector2(e.min.x,e.min.z),max:new i.Vector2(e.max.x,e.max.z)};let t=(p.min.x+p.max.x)/2,n=(p.min.y+p.max.y)/2,r=(e.min.y+e.max.y)/2,a=Math.max(p.max.x-p.min.x,p.max.y-p.min.y)*.5;f=[];let o=0,s=null;for(let e=0;e<16;e++){let c=e/16*Math.PI*2,l=new i.Vector3(t+Math.cos(c)*a,r,n+Math.sin(c)*a);s&&(o+=l.distanceTo(s)),f.push({position:l,location:o}),s=l}}this.keyframes=f,this.boundingAABB=p;let m=this.curveHeight,h=new i.Vector3((p.min.x+p.max.x)/2,m,(p.min.y+p.max.y)/2),g=(p.max.x-p.min.x)/2,_=(p.max.y-p.min.y)/2,v=Math.sqrt(g*g+_*_),y=e=>{let t=new i.Vector3().subVectors(e,h);return t.length()<.001&&t.set(1,0,0),h.clone().add(t.normalize().multiplyScalar(v))},b=new i.Vector3(f[0].position.x,m,f[0].position.z),x=y(b),S=new i.Vector3().subVectors(h,b).normalize(),C=new i.Ray(b,S),w=new i.Vector3(-S.z,0,S.x).normalize(),T=new i.Ray(h,w),E=this.findClosestKeyframeToRay(T,f),D=y(new i.Vector3(E.x,m,E.z)),O=this.findClosestKeyframeToRay(C,f),k=y(new i.Vector3(O.x,m,O.z));return new i.CatmullRomCurve3([x,D,k],!1,`centripetal`,.5)})}setBounding(e,t,n){let r=this.findRenderMesh();r.material.aggregationBoundsMin.copy(e),r.material.aggregationBoundsMax.copy(t),this.boundsSet=!0}setBounds(){if(!this.boundingAABB)throw Error(`请先调用 getCameraCurve 计算轨迹边界`);let e=this.boundingAABB,t=this.findRenderMesh(),n=new i.Vector3(e.min.x,0,e.min.y),r=new i.Vector3(e.max.x,3,e.max.y);t.material.aggregationBoundsMin.copy(n),t.material.aggregationBoundsMax.copy(r),this.boundsSet=!0}normalizedPointDuration(){let e=this.pointDuration;return e<=0?.01:Math.min(e<=1?e:e/this.duration,1)}resetToPointCloud(){return(0,n.__awaiter)(this,void 0,void 0,function*(){if(!this.isInitAnimationEnabled())return;this.boundingAABB||(yield this.getCameraCurve()),this.setBounds();let e=this.findRenderMesh().material;e.aggregationEnabled=!0,e.aggregationProgress=0,e.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0,this.five.modelSceneNeedsRender=!0})}startAggregation(){if(!this.isInitAnimationEnabled()){console.warn(`[GaussianSplattingEntranceAnimationPlugin] modelScene.enableGaussianSplattingInitAnimation 为 false，已跳过聚合动画`);return}if(!this.boundsSet)throw Error(`请先调用 setBounds 设置聚合边界`);let e=this.findRenderMesh().material;e.aggregationEnabled=!0,e.aggregationProgress=0,e.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0;let t=performance.now(),n=this.duration;this.cancelAnimation=r.AnimationFrameLoop.shared.add(()=>{let r=performance.now()-t,i=Math.min(r/n,1);e.aggregationProgress=i*i*(3-2*i),this.five.needsRender=!0,this.five.modelSceneNeedsRender=!0,i>=1&&(e.aggregationEnabled=!1,this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null))})}playEntrance(){return(0,n.__awaiter)(this,void 0,void 0,function*(){if(!this.isInitAnimationEnabled()){console.warn(`[GaussianSplattingEntranceAnimationPlugin] modelScene.enableGaussianSplattingInitAnimation 为 false，已跳过入场动画`);return}let e=yield this.getCameraCurve(),t=this.boundingAABB,n=new i.Vector3((t.min.x+t.max.x)/2,this.curveHeight,(t.min.y+t.max.y)/2),a=e.getPointAt(0),o=new r.Camera(90).copy(this.five.camera);o.position.copy(a),o.lookAt(n),o.computePose(0),this.five.setState(Object.assign({},o.pose)),this.setBounds();let s=this.findRenderMesh().material;s.aggregationEnabled=!0,s.aggregationProgress=0,s.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0;let c=this.duration,l=performance.now();return new Promise(t=>{this.cancelAnimation=r.AnimationFrameLoop.shared.add(()=>{let r=performance.now()-l,i=Math.min(r/c,1),a=i*i*(3-2*i);s.aggregationProgress=a,this.five.modelSceneNeedsRender=!0;let u=e.getPointAt(a);o.position.copy(u),o.lookAt(n),o.computePose(0),this.five.setState(Object.assign({},o.pose)),this.five.needsRender=!0,i>=1&&(s.aggregationEnabled=!1,s.aggregationProgress=1,this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null),t())})})})}};exports.Controller=o;
+*/const require_runtime=require("../../_virtual/_rolldown/runtime.js"),require_index=require("../BasePlugin/index.js");let tslib=require("tslib"),_realsee_five_webgpu=require("@realsee/five-webgpu"),three_webgpu=require("three/webgpu");three_webgpu=require_runtime.__toESM(three_webgpu,1);var KalmanFilter=class{constructor(R,Q,A,B,C){this.R=R,this.Q=Q,this.A=A,this.B=B,this.C=C,this.cov=NaN,this.x=NaN}filter(z,u=0){if(isNaN(this.x))this.x=1/this.C*z,this.cov=1/this.C*this.Q*(1/this.C);else{let predX=this.A*this.x+this.B*u,predCov=this.A*this.cov*this.A+this.R,K=predCov*this.C*(1/(this.C*predCov*this.C+this.Q));this.x=predX+K*(z-this.C*predX),this.cov=predCov-K*this.C*predCov}return this.x}},Controller=class extends require_index.BasePlugin.Controller{updateState(state,userAction){let prevState=this.state;this.state=Object.assign(Object.assign({},this.state),state),this.hooks.emit(`stateChange`,{state:this.state,prevState,userAction})}constructor(five,config){var _a,_b,_c;super(five),this.boundingAABB=null,this.cancelAnimation=null,this.boundsSet=!1,this.keyframes=[],this.five=five,this.state={enabled:!0,visible:!0},this.duration=(_a=config==null?void 0:config.duration)==null?5e3:_a,this.curveHeight=(_b=config==null?void 0:config.curveHeight)==null?1.5:_b,this.pointDuration=(_c=config==null?void 0:config.pointDuration)==null?3e3:_c}load(){return(0,tslib.__awaiter)(this,void 0,void 0,function*(){})}enable(options){var _a;if(this.state.enabled)return;let userAction=(_a=options==null?void 0:options.userAction)==null?!0:_a;this.updateState({enabled:!0},userAction)}disable(options){var _a;if(this.state.enabled===!1)return;let userAction=(_a=options==null?void 0:options.userAction)==null?!0:_a;this.updateState({enabled:!1},userAction)}dispose(){this.disable(),this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null);try{let renderMesh=this.findRenderMesh();renderMesh&&(renderMesh.material.aggregationEnabled=!1,renderMesh.material.aggregationProgress=1)}catch(_){}}extractKeyframes(trajectory){let keyframes=[];if(!trajectory.content.data)throw Error(`轨迹数据未加载`);let points=trajectory.content.data.positionArray,numPoints=points.length/3,R=.01,Q=.1,kfX=new KalmanFilter(R,Q,1,0,1),kfY=new KalmanFilter(R,Q,1,0,1),kfZ=new KalmanFilter(R,Q,1,0,1),lineDistances=new Float32Array(numPoints);for(let i=0;i<numPoints;i++)if(i===0)lineDistances[i]=0;else{let prev=new three_webgpu.Vector3(points[(i-1)*3],points[(i-1)*3+1],points[(i-1)*3+2]);lineDistances[i]=new three_webgpu.Vector3(points[i*3],points[i*3+1],points[i*3+2]).distanceTo(prev)+lineDistances[i-1]}for(let i=0;i<numPoints;i++){let smoothPosition=new three_webgpu.Vector3(0,0,0),count=0;for(let j=i-5;j<i+6;j++)j>=0&&j<numPoints&&(smoothPosition.add(new three_webgpu.Vector3(points[j*3],points[j*3+1],points[j*3+2])),count++);smoothPosition.divideScalar(count).applyMatrix4(trajectory.transform);let x=kfX.filter(smoothPosition.x),y=kfY.filter(smoothPosition.y),z=kfZ.filter(smoothPosition.z);keyframes.push({position:new three_webgpu.Vector3(x,y,z),location:lineDistances[i]})}return keyframes}computeAABB2D(keyframes){let minX=1/0,maxX=-1/0,minZ=1/0,maxZ=-1/0;for(let kf of keyframes)kf.position.x<minX&&(minX=kf.position.x),kf.position.x>maxX&&(maxX=kf.position.x),kf.position.z<minZ&&(minZ=kf.position.z),kf.position.z>maxZ&&(maxZ=kf.position.z);return{min:new three_webgpu.Vector2(minX,minZ),max:new three_webgpu.Vector2(maxX,maxZ)}}findClosestKeyframeToRay(ray,keyframes){let closestDist=1/0,closestPos=keyframes[0].position.clone(),tmpVec=new three_webgpu.Vector3;for(let kf of keyframes){ray.closestPointToPoint(kf.position,tmpVec);let dist=tmpVec.distanceTo(kf.position);dist<closestDist&&(closestDist=dist,closestPos=kf.position.clone())}return closestPos}isInitAnimationEnabled(){return this.five.modelScene.parameter.resolveValue(`enableGaussianSplattingInitAnimation`)===!0}findRenderMesh(){let found=null;if(this.five.scene.traverse(object=>{if(found)return;let mesh=object,material=mesh.material;material&&material.isPBMGaussianSplattingMaterial&&(found=mesh)}),!found)throw Error(`未找到 GaussianSplatting 渲染网格`);return found}loadTrajectoryDataIfNeeded(trajectory){return(0,tslib.__awaiter)(this,void 0,void 0,function*(){var _a,_b,_c,_d,_e,_f,_g,_h;if((_a=trajectory.content)!=null&&_a.data)return;if(((_b=trajectory.content)==null?void 0:_b.loadState)===`LOADING`){yield new Promise(resolve=>{let cancel=_realsee_five_webgpu.AnimationFrameLoop.shared.add(()=>{var _a;let s=(_a=trajectory.content)==null?void 0:_a.loadState;(s===`READY`||s===`FAILED`||s===`UNLOADED`)&&(cancel(),resolve())})});return}let viewLayer=(_c=this.five.model.viewLayers)==null?void 0:_c[0],fetcher=viewLayer==null?void 0:viewLayer.fetcher,search=viewLayer==null?void 0:viewLayer.search,uri=(_d=trajectory.content)==null?void 0:_d.uri;if(!fetcher||!uri)return;let url=search?uri.includes(`?`)?`${uri}&${search.replace(/^\?/,``)}`:`${uri}${search.startsWith(`?`)?search:`?${search}`}`:uri;trajectory.content.loadState=`LOADING`;try{let plyResult=yield(0,_realsee_five_webgpu.loadPly)(url,{type:`geometry`,customPropertyMapping:{time:{itemType:`uint32`,itemNames:[`time_milisec`]}},fetcher}),geometry=plyResult.scene,positionAttr=geometry.getAttribute(`position`),timeAttr=geometry.getAttribute(`time`),positionArray=(_e=positionAttr==null?void 0:positionAttr.array)==null?new Float32Array:_e,timeArray=(_f=timeAttr==null?void 0:timeAttr.array)==null?new Uint32Array:_f;trajectory.content.data={uri:url,byteLength:(_g=plyResult.byteLength)==null?0:_g,memoryUsage:(_h=plyResult.memoryUsage)==null?0:_h,positionArray,timeArray,object:null},trajectory.content.loadState=`READY`}catch(err){console.warn(`[GaussianSplattingEntranceAnimationPlugin] trajectory ply 加载失败，将使用 3DGS AABB 回退`,err),trajectory.content.data=void 0,trajectory.content.loadState=`FAILED`}})}computeGSSceneBounds(){let bounds=new three_webgpu.Box3,tmpBox=new three_webgpu.Box3;return this.five.scene.traverse(object=>{let anyObj=object;(anyObj==null?void 0:anyObj.boundingBox)instanceof three_webgpu.Box3&&!anyObj.boundingBox.isEmpty()&&(tmpBox.copy(anyObj.boundingBox),anyObj.matrixWorld&&tmpBox.applyMatrix4(anyObj.matrixWorld),bounds.union(tmpBox))}),bounds.isEmpty()?null:bounds}getCameraCurve(){return(0,tslib.__awaiter)(this,void 0,void 0,function*(){var _a,_b,_c,_d,_e,_f,_g,_h,_j,_k;let trajectory=(_d=(_c=(_b=(_a=this.five.model.viewLayers)==null?void 0:_a[0])==null?void 0:_b.trajectories)==null?void 0:_c[0])==null?(_h=(_g=(_f=(_e=this.five.model.viewLayers)==null?void 0:_e[0])==null?void 0:_f.scene)==null?void 0:_g.trajectories)==null?void 0:_h[0]:_d,keyframes=null,aabb=null;if(trajectory&&(yield this.loadTrajectoryDataIfNeeded(trajectory),(_j=trajectory.content)!=null&&_j.data&&((_k=trajectory.content.data.positionArray)==null?void 0:_k.length)>=6&&(keyframes=this.extractKeyframes(trajectory),keyframes.length>=2?aabb=this.computeAABB2D(keyframes):keyframes=null)),!keyframes||!aabb){let sceneBounds=this.computeGSSceneBounds();if(!sceneBounds)throw Error(`未找到可用于计算入场曲线的 3DGS 边界或轨迹`);aabb={min:new three_webgpu.Vector2(sceneBounds.min.x,sceneBounds.min.z),max:new three_webgpu.Vector2(sceneBounds.max.x,sceneBounds.max.z)};let cx=(aabb.min.x+aabb.max.x)/2,cz=(aabb.min.y+aabb.max.y)/2,y=(sceneBounds.min.y+sceneBounds.max.y)/2,r=Math.max(aabb.max.x-aabb.min.x,aabb.max.y-aabb.min.y)*.5;keyframes=[];let acc=0,prev=null;for(let i=0;i<16;i++){let t=i/16*Math.PI*2,p=new three_webgpu.Vector3(cx+Math.cos(t)*r,y,cz+Math.sin(t)*r);prev&&(acc+=p.distanceTo(prev)),keyframes.push({position:p,location:acc}),prev=p}}this.keyframes=keyframes,this.boundingAABB=aabb;let curveHeight=this.curveHeight,aabbCenter=new three_webgpu.Vector3((aabb.min.x+aabb.max.x)/2,curveHeight,(aabb.min.y+aabb.max.y)/2),halfW=(aabb.max.x-aabb.min.x)/2,halfH=(aabb.max.y-aabb.min.y)/2,boundingRadius=Math.sqrt(halfW*halfW+halfH*halfH),projectToSphere=pt=>{let dir=new three_webgpu.Vector3().subVectors(pt,aabbCenter);return dir.length()<.001&&dir.set(1,0,0),aabbCenter.clone().add(dir.normalize().multiplyScalar(boundingRadius))},startRaw=new three_webgpu.Vector3(keyframes[0].position.x,curveHeight,keyframes[0].position.z),startPoint=projectToSphere(startRaw),primaryDir=new three_webgpu.Vector3().subVectors(aabbCenter,startRaw).normalize(),primaryRay=new three_webgpu.Ray(startRaw,primaryDir),secondaryDir=new three_webgpu.Vector3(-primaryDir.z,0,primaryDir.x).normalize(),secondaryRay=new three_webgpu.Ray(aabbCenter,secondaryDir),p1Raw=this.findClosestKeyframeToRay(secondaryRay,keyframes),p1=projectToSphere(new three_webgpu.Vector3(p1Raw.x,curveHeight,p1Raw.z)),p2Raw=this.findClosestKeyframeToRay(primaryRay,keyframes),p2=projectToSphere(new three_webgpu.Vector3(p2Raw.x,curveHeight,p2Raw.z));return new three_webgpu.CatmullRomCurve3([startPoint,p1,p2],!1,`centripetal`,.5)})}setBounding(boundsMin,boundsMax,_center){let renderMesh=this.findRenderMesh();renderMesh.material.aggregationBoundsMin.copy(boundsMin),renderMesh.material.aggregationBoundsMax.copy(boundsMax),this.boundsSet=!0}setBounds(){if(!this.boundingAABB)throw Error(`请先调用 getCameraCurve 计算轨迹边界`);let aabb=this.boundingAABB,renderMesh=this.findRenderMesh(),boundsMin=new three_webgpu.Vector3(aabb.min.x,0,aabb.min.y),boundsMax=new three_webgpu.Vector3(aabb.max.x,3,aabb.max.y);renderMesh.material.aggregationBoundsMin.copy(boundsMin),renderMesh.material.aggregationBoundsMax.copy(boundsMax),this.boundsSet=!0}normalizedPointDuration(){let pd=this.pointDuration;return pd<=0?.01:Math.min(pd<=1?pd:pd/this.duration,1)}resetToPointCloud(){return(0,tslib.__awaiter)(this,void 0,void 0,function*(){if(!this.isInitAnimationEnabled())return;this.boundingAABB||(yield this.getCameraCurve()),this.setBounds();let material=this.findRenderMesh().material;material.aggregationEnabled=!0,material.aggregationProgress=0,material.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0,this.five.modelSceneNeedsRender=!0})}startAggregation(){if(!this.isInitAnimationEnabled()){console.warn(`[GaussianSplattingEntranceAnimationPlugin] modelScene.enableGaussianSplattingInitAnimation 为 false，已跳过聚合动画`);return}if(!this.boundsSet)throw Error(`请先调用 setBounds 设置聚合边界`);let material=this.findRenderMesh().material;material.aggregationEnabled=!0,material.aggregationProgress=0,material.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0;let startTime=performance.now(),duration=this.duration;this.cancelAnimation=_realsee_five_webgpu.AnimationFrameLoop.shared.add(()=>{let elapsed=performance.now()-startTime,progress=Math.min(elapsed/duration,1);material.aggregationProgress=progress*progress*(3-2*progress),this.five.needsRender=!0,this.five.modelSceneNeedsRender=!0,progress>=1&&(material.aggregationEnabled=!1,this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null))})}playEntrance(){return(0,tslib.__awaiter)(this,void 0,void 0,function*(){if(!this.isInitAnimationEnabled()){console.warn(`[GaussianSplattingEntranceAnimationPlugin] modelScene.enableGaussianSplattingInitAnimation 为 false，已跳过入场动画`);return}let curve=yield this.getCameraCurve(),aabb=this.boundingAABB,boundingCenter=new three_webgpu.Vector3((aabb.min.x+aabb.max.x)/2,this.curveHeight,(aabb.min.y+aabb.max.y)/2),startPoint=curve.getPointAt(0),visualCamera=new _realsee_five_webgpu.Camera(90).copy(this.five.camera);visualCamera.position.copy(startPoint),visualCamera.lookAt(boundingCenter),visualCamera.computePose(0),this.five.setState(Object.assign({},visualCamera.pose)),this.setBounds();let material=this.findRenderMesh().material;material.aggregationEnabled=!0,material.aggregationProgress=0,material.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0;let duration=this.duration,startTime=performance.now();return new Promise(resolve=>{this.cancelAnimation=_realsee_five_webgpu.AnimationFrameLoop.shared.add(()=>{let elapsed=performance.now()-startTime,t=Math.min(elapsed/duration,1),eased=t*t*(3-2*t);material.aggregationProgress=eased,this.five.modelSceneNeedsRender=!0;let point=curve.getPointAt(eased);visualCamera.position.copy(point),visualCamera.lookAt(boundingCenter),visualCamera.computePose(0),this.five.setState(Object.assign({},visualCamera.pose)),this.five.needsRender=!0,t>=1&&(material.aggregationEnabled=!1,material.aggregationProgress=1,this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null),resolve())})})})}};exports.Controller=Controller;

package/plugins/GaussianSplattingEntranceAnimationPlugin/Controller.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/import{BasePlugin as e}from"../BasePlugin/index.mjs";import{__awaiter as t}from"tslib";import{AnimationFrameLoop as n,Camera as r,loadPly as i}from"@realsee/five-webgpu";import*as a from"three/webgpu";var o=class{constructor(e,t,n,r,i){this.R=e,this.Q=t,this.A=n,this.B=r,this.C=i,this.cov=NaN,this.x=NaN}filter(e,t=0){if(isNaN(this.x))this.x=1/this.C*e,this.cov=1/this.C*this.Q*(1/this.C);else{let n=this.A*this.x+this.B*t,r=this.A*this.cov*this.A+this.R,i=r*this.C*(1/(this.C*r*this.C+this.Q));this.x=n+i*(e-this.C*n),this.cov=r-i*this.C*r}return this.x}},s=class extends e.Controller{updateState(e,t){let n=this.state;this.state=Object.assign(Object.assign({},this.state),e),this.hooks.emit(`stateChange`,{state:this.state,prevState:n,userAction:t})}constructor(e,t){var n,r,i;super(e),this.boundingAABB=null,this.cancelAnimation=null,this.boundsSet=!1,this.keyframes=[],this.five=e,this.state={enabled:!0,visible:!0},this.duration=(n=t==null?void 0:t.duration)==null?5e3:n,this.curveHeight=(r=t==null?void 0:t.curveHeight)==null?1.5:r,this.pointDuration=(i=t==null?void 0:t.pointDuration)==null?3e3:i}load(){return t(this,void 0,void 0,function*(){})}enable(e){var t;if(this.state.enabled)return;let n=(t=e==null?void 0:e.userAction)==null?!0:t;this.updateState({enabled:!0},n)}disable(e){var t;if(this.state.enabled===!1)return;let n=(t=e==null?void 0:e.userAction)==null?!0:t;this.updateState({enabled:!1},n)}dispose(){this.disable(),this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null);try{let e=this.findRenderMesh();e&&(e.material.aggregationEnabled=!1,e.material.aggregationProgress=1)}catch(e){}}extractKeyframes(e){let t=[];if(!e.content.data)throw Error(`轨迹数据未加载`);let n=e.content.data.positionArray,r=n.length/3,i=.01,s=.1,c=new o(i,s,1,0,1),l=new o(i,s,1,0,1),u=new o(i,s,1,0,1),d=new Float32Array(r);for(let e=0;e<r;e++)if(e===0)d[e]=0;else{let t=new a.Vector3(n[(e-1)*3],n[(e-1)*3+1],n[(e-1)*3+2]);d[e]=new a.Vector3(n[e*3],n[e*3+1],n[e*3+2]).distanceTo(t)+d[e-1]}for(let i=0;i<r;i++){let o=new a.Vector3(0,0,0),s=0;for(let e=i-5;e<i+6;e++)e>=0&&e<r&&(o.add(new a.Vector3(n[e*3],n[e*3+1],n[e*3+2])),s++);o.divideScalar(s).applyMatrix4(e.transform);let f=c.filter(o.x),p=l.filter(o.y),m=u.filter(o.z);t.push({position:new a.Vector3(f,p,m),location:d[i]})}return t}computeAABB2D(e){let t=1/0,n=-1/0,r=1/0,i=-1/0;for(let a of e)a.position.x<t&&(t=a.position.x),a.position.x>n&&(n=a.position.x),a.position.z<r&&(r=a.position.z),a.position.z>i&&(i=a.position.z);return{min:new a.Vector2(t,r),max:new a.Vector2(n,i)}}findClosestKeyframeToRay(e,t){let n=1/0,r=t[0].position.clone(),i=new a.Vector3;for(let a of t){e.closestPointToPoint(a.position,i);let t=i.distanceTo(a.position);t<n&&(n=t,r=a.position.clone())}return r}isInitAnimationEnabled(){return this.five.modelScene.parameter.resolveValue(`enableGaussianSplattingInitAnimation`)===!0}findRenderMesh(){let e=null;if(this.five.scene.traverse(t=>{if(e)return;let n=t,r=n.material;r&&r.isPBMGaussianSplattingMaterial&&(e=n)}),!e)throw Error(`未找到 GaussianSplatting 渲染网格`);return e}loadTrajectoryDataIfNeeded(e){return t(this,void 0,void 0,function*(){var t,r,a,o,s,c,l,u;if((t=e.content)!=null&&t.data)return;if(((r=e.content)==null?void 0:r.loadState)===`LOADING`){yield new Promise(t=>{let r=n.shared.add(()=>{var n;let i=(n=e.content)==null?void 0:n.loadState;(i===`READY`||i===`FAILED`||i===`UNLOADED`)&&(r(),t())})});return}let d=(a=this.five.model.viewLayers)==null?void 0:a[0],f=d==null?void 0:d.fetcher,p=d==null?void 0:d.search,m=(o=e.content)==null?void 0:o.uri;if(!f||!m)return;let h=p?m.includes(`?`)?`${m}&${p.replace(/^\?/,``)}`:`${m}${p.startsWith(`?`)?p:`?${p}`}`:m;e.content.loadState=`LOADING`;try{let t=yield i(h,{type:`geometry`,customPropertyMapping:{time:{itemType:`uint32`,itemNames:[`time_milisec`]}},fetcher:f}),n=t.scene,r=n.getAttribute(`position`),a=n.getAttribute(`time`),o=(s=r==null?void 0:r.array)==null?new Float32Array:s,d=(c=a==null?void 0:a.array)==null?new Uint32Array:c;e.content.data={uri:h,byteLength:(l=t.byteLength)==null?0:l,memoryUsage:(u=t.memoryUsage)==null?0:u,positionArray:o,timeArray:d,object:null},e.content.loadState=`READY`}catch(t){console.warn(`[GaussianSplattingEntranceAnimationPlugin] trajectory ply 加载失败，将使用 3DGS AABB 回退`,t),e.content.data=void 0,e.content.loadState=`FAILED`}})}computeGSSceneBounds(){let e=new a.Box3,t=new a.Box3;return this.five.scene.traverse(n=>{let r=n;(r==null?void 0:r.boundingBox)instanceof a.Box3&&!r.boundingBox.isEmpty()&&(t.copy(r.boundingBox),r.matrixWorld&&t.applyMatrix4(r.matrixWorld),e.union(t))}),e.isEmpty()?null:e}getCameraCurve(){return t(this,void 0,void 0,function*(){var e,t,n,r,i,o,s,c,l,u;let d=(r=(n=(t=(e=this.five.model.viewLayers)==null?void 0:e[0])==null?void 0:t.trajectories)==null?void 0:n[0])==null?(c=(s=(o=(i=this.five.model.viewLayers)==null?void 0:i[0])==null?void 0:o.scene)==null?void 0:s.trajectories)==null?void 0:c[0]:r,f=null,p=null;if(d&&(yield this.loadTrajectoryDataIfNeeded(d),(l=d.content)!=null&&l.data&&((u=d.content.data.positionArray)==null?void 0:u.length)>=6&&(f=this.extractKeyframes(d),f.length>=2?p=this.computeAABB2D(f):f=null)),!f||!p){let e=this.computeGSSceneBounds();if(!e)throw Error(`未找到可用于计算入场曲线的 3DGS 边界或轨迹`);p={min:new a.Vector2(e.min.x,e.min.z),max:new a.Vector2(e.max.x,e.max.z)};let t=(p.min.x+p.max.x)/2,n=(p.min.y+p.max.y)/2,r=(e.min.y+e.max.y)/2,i=Math.max(p.max.x-p.min.x,p.max.y-p.min.y)*.5;f=[];let o=0,s=null;for(let e=0;e<16;e++){let c=e/16*Math.PI*2,l=new a.Vector3(t+Math.cos(c)*i,r,n+Math.sin(c)*i);s&&(o+=l.distanceTo(s)),f.push({position:l,location:o}),s=l}}this.keyframes=f,this.boundingAABB=p;let m=this.curveHeight,h=new a.Vector3((p.min.x+p.max.x)/2,m,(p.min.y+p.max.y)/2),g=(p.max.x-p.min.x)/2,_=(p.max.y-p.min.y)/2,v=Math.sqrt(g*g+_*_),y=e=>{let t=new a.Vector3().subVectors(e,h);return t.length()<.001&&t.set(1,0,0),h.clone().add(t.normalize().multiplyScalar(v))},b=new a.Vector3(f[0].position.x,m,f[0].position.z),x=y(b),S=new a.Vector3().subVectors(h,b).normalize(),C=new a.Ray(b,S),w=new a.Vector3(-S.z,0,S.x).normalize(),T=new a.Ray(h,w),E=this.findClosestKeyframeToRay(T,f),D=y(new a.Vector3(E.x,m,E.z)),O=this.findClosestKeyframeToRay(C,f),k=y(new a.Vector3(O.x,m,O.z));return new a.CatmullRomCurve3([x,D,k],!1,`centripetal`,.5)})}setBounding(e,t,n){let r=this.findRenderMesh();r.material.aggregationBoundsMin.copy(e),r.material.aggregationBoundsMax.copy(t),this.boundsSet=!0}setBounds(){if(!this.boundingAABB)throw Error(`请先调用 getCameraCurve 计算轨迹边界`);let e=this.boundingAABB,t=this.findRenderMesh(),n=new a.Vector3(e.min.x,0,e.min.y),r=new a.Vector3(e.max.x,3,e.max.y);t.material.aggregationBoundsMin.copy(n),t.material.aggregationBoundsMax.copy(r),this.boundsSet=!0}normalizedPointDuration(){let e=this.pointDuration;return e<=0?.01:Math.min(e<=1?e:e/this.duration,1)}resetToPointCloud(){return t(this,void 0,void 0,function*(){if(!this.isInitAnimationEnabled())return;this.boundingAABB||(yield this.getCameraCurve()),this.setBounds();let e=this.findRenderMesh().material;e.aggregationEnabled=!0,e.aggregationProgress=0,e.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0,this.five.modelSceneNeedsRender=!0})}startAggregation(){if(!this.isInitAnimationEnabled()){console.warn(`[GaussianSplattingEntranceAnimationPlugin] modelScene.enableGaussianSplattingInitAnimation 为 false，已跳过聚合动画`);return}if(!this.boundsSet)throw Error(`请先调用 setBounds 设置聚合边界`);let e=this.findRenderMesh().material;e.aggregationEnabled=!0,e.aggregationProgress=0,e.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0;let t=performance.now(),r=this.duration;this.cancelAnimation=n.shared.add(()=>{let n=performance.now()-t,i=Math.min(n/r,1);e.aggregationProgress=i*i*(3-2*i),this.five.needsRender=!0,this.five.modelSceneNeedsRender=!0,i>=1&&(e.aggregationEnabled=!1,this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null))})}playEntrance(){return t(this,void 0,void 0,function*(){if(!this.isInitAnimationEnabled()){console.warn(`[GaussianSplattingEntranceAnimationPlugin] modelScene.enableGaussianSplattingInitAnimation 为 false，已跳过入场动画`);return}let e=yield this.getCameraCurve(),t=this.boundingAABB,i=new a.Vector3((t.min.x+t.max.x)/2,this.curveHeight,(t.min.y+t.max.y)/2),o=e.getPointAt(0),s=new r(90).copy(this.five.camera);s.position.copy(o),s.lookAt(i),s.computePose(0),this.five.setState(Object.assign({},s.pose)),this.setBounds();let c=this.findRenderMesh().material;c.aggregationEnabled=!0,c.aggregationProgress=0,c.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0;let l=this.duration,u=performance.now();return new Promise(t=>{this.cancelAnimation=n.shared.add(()=>{let n=performance.now()-u,r=Math.min(n/l,1),a=r*r*(3-2*r);c.aggregationProgress=a,this.five.modelSceneNeedsRender=!0;let o=e.getPointAt(a);s.position.copy(o),s.lookAt(i),s.computePose(0),this.five.setState(Object.assign({},s.pose)),this.five.needsRender=!0,r>=1&&(c.aggregationEnabled=!1,c.aggregationProgress=1,this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null),t())})})})}};export{s as Controller};
+*/import{BasePlugin}from"../BasePlugin/index.mjs";import{__awaiter}from"tslib";import{AnimationFrameLoop,Camera,loadPly}from"@realsee/five-webgpu";import*as THREE from"three/webgpu";var KalmanFilter=class{constructor(R,Q,A,B,C){this.R=R,this.Q=Q,this.A=A,this.B=B,this.C=C,this.cov=NaN,this.x=NaN}filter(z,u=0){if(isNaN(this.x))this.x=1/this.C*z,this.cov=1/this.C*this.Q*(1/this.C);else{let predX=this.A*this.x+this.B*u,predCov=this.A*this.cov*this.A+this.R,K=predCov*this.C*(1/(this.C*predCov*this.C+this.Q));this.x=predX+K*(z-this.C*predX),this.cov=predCov-K*this.C*predCov}return this.x}},Controller=class extends BasePlugin.Controller{updateState(state,userAction){let prevState=this.state;this.state=Object.assign(Object.assign({},this.state),state),this.hooks.emit(`stateChange`,{state:this.state,prevState,userAction})}constructor(five,config){var _a,_b,_c;super(five),this.boundingAABB=null,this.cancelAnimation=null,this.boundsSet=!1,this.keyframes=[],this.five=five,this.state={enabled:!0,visible:!0},this.duration=(_a=config==null?void 0:config.duration)==null?5e3:_a,this.curveHeight=(_b=config==null?void 0:config.curveHeight)==null?1.5:_b,this.pointDuration=(_c=config==null?void 0:config.pointDuration)==null?3e3:_c}load(){return __awaiter(this,void 0,void 0,function*(){})}enable(options){var _a;if(this.state.enabled)return;let userAction=(_a=options==null?void 0:options.userAction)==null?!0:_a;this.updateState({enabled:!0},userAction)}disable(options){var _a;if(this.state.enabled===!1)return;let userAction=(_a=options==null?void 0:options.userAction)==null?!0:_a;this.updateState({enabled:!1},userAction)}dispose(){this.disable(),this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null);try{let renderMesh=this.findRenderMesh();renderMesh&&(renderMesh.material.aggregationEnabled=!1,renderMesh.material.aggregationProgress=1)}catch(_){}}extractKeyframes(trajectory){let keyframes=[];if(!trajectory.content.data)throw Error(`轨迹数据未加载`);let points=trajectory.content.data.positionArray,numPoints=points.length/3,R=.01,Q=.1,kfX=new KalmanFilter(R,Q,1,0,1),kfY=new KalmanFilter(R,Q,1,0,1),kfZ=new KalmanFilter(R,Q,1,0,1),lineDistances=new Float32Array(numPoints);for(let i=0;i<numPoints;i++)if(i===0)lineDistances[i]=0;else{let prev=new THREE.Vector3(points[(i-1)*3],points[(i-1)*3+1],points[(i-1)*3+2]);lineDistances[i]=new THREE.Vector3(points[i*3],points[i*3+1],points[i*3+2]).distanceTo(prev)+lineDistances[i-1]}for(let i=0;i<numPoints;i++){let smoothPosition=new THREE.Vector3(0,0,0),count=0;for(let j=i-5;j<i+6;j++)j>=0&&j<numPoints&&(smoothPosition.add(new THREE.Vector3(points[j*3],points[j*3+1],points[j*3+2])),count++);smoothPosition.divideScalar(count).applyMatrix4(trajectory.transform);let x=kfX.filter(smoothPosition.x),y=kfY.filter(smoothPosition.y),z=kfZ.filter(smoothPosition.z);keyframes.push({position:new THREE.Vector3(x,y,z),location:lineDistances[i]})}return keyframes}computeAABB2D(keyframes){let minX=1/0,maxX=-1/0,minZ=1/0,maxZ=-1/0;for(let kf of keyframes)kf.position.x<minX&&(minX=kf.position.x),kf.position.x>maxX&&(maxX=kf.position.x),kf.position.z<minZ&&(minZ=kf.position.z),kf.position.z>maxZ&&(maxZ=kf.position.z);return{min:new THREE.Vector2(minX,minZ),max:new THREE.Vector2(maxX,maxZ)}}findClosestKeyframeToRay(ray,keyframes){let closestDist=1/0,closestPos=keyframes[0].position.clone(),tmpVec=new THREE.Vector3;for(let kf of keyframes){ray.closestPointToPoint(kf.position,tmpVec);let dist=tmpVec.distanceTo(kf.position);dist<closestDist&&(closestDist=dist,closestPos=kf.position.clone())}return closestPos}isInitAnimationEnabled(){return this.five.modelScene.parameter.resolveValue(`enableGaussianSplattingInitAnimation`)===!0}findRenderMesh(){let found=null;if(this.five.scene.traverse(object=>{if(found)return;let mesh=object,material=mesh.material;material&&material.isPBMGaussianSplattingMaterial&&(found=mesh)}),!found)throw Error(`未找到 GaussianSplatting 渲染网格`);return found}loadTrajectoryDataIfNeeded(trajectory){return __awaiter(this,void 0,void 0,function*(){var _a,_b,_c,_d,_e,_f,_g,_h;if((_a=trajectory.content)!=null&&_a.data)return;if(((_b=trajectory.content)==null?void 0:_b.loadState)===`LOADING`){yield new Promise(resolve=>{let cancel=AnimationFrameLoop.shared.add(()=>{var _a;let s=(_a=trajectory.content)==null?void 0:_a.loadState;(s===`READY`||s===`FAILED`||s===`UNLOADED`)&&(cancel(),resolve())})});return}let viewLayer=(_c=this.five.model.viewLayers)==null?void 0:_c[0],fetcher=viewLayer==null?void 0:viewLayer.fetcher,search=viewLayer==null?void 0:viewLayer.search,uri=(_d=trajectory.content)==null?void 0:_d.uri;if(!fetcher||!uri)return;let url=search?uri.includes(`?`)?`${uri}&${search.replace(/^\?/,``)}`:`${uri}${search.startsWith(`?`)?search:`?${search}`}`:uri;trajectory.content.loadState=`LOADING`;try{let plyResult=yield loadPly(url,{type:`geometry`,customPropertyMapping:{time:{itemType:`uint32`,itemNames:[`time_milisec`]}},fetcher}),geometry=plyResult.scene,positionAttr=geometry.getAttribute(`position`),timeAttr=geometry.getAttribute(`time`),positionArray=(_e=positionAttr==null?void 0:positionAttr.array)==null?new Float32Array:_e,timeArray=(_f=timeAttr==null?void 0:timeAttr.array)==null?new Uint32Array:_f;trajectory.content.data={uri:url,byteLength:(_g=plyResult.byteLength)==null?0:_g,memoryUsage:(_h=plyResult.memoryUsage)==null?0:_h,positionArray,timeArray,object:null},trajectory.content.loadState=`READY`}catch(err){console.warn(`[GaussianSplattingEntranceAnimationPlugin] trajectory ply 加载失败，将使用 3DGS AABB 回退`,err),trajectory.content.data=void 0,trajectory.content.loadState=`FAILED`}})}computeGSSceneBounds(){let bounds=new THREE.Box3,tmpBox=new THREE.Box3;return this.five.scene.traverse(object=>{let anyObj=object;(anyObj==null?void 0:anyObj.boundingBox)instanceof THREE.Box3&&!anyObj.boundingBox.isEmpty()&&(tmpBox.copy(anyObj.boundingBox),anyObj.matrixWorld&&tmpBox.applyMatrix4(anyObj.matrixWorld),bounds.union(tmpBox))}),bounds.isEmpty()?null:bounds}getCameraCurve(){return __awaiter(this,void 0,void 0,function*(){var _a,_b,_c,_d,_e,_f,_g,_h,_j,_k;let trajectory=(_d=(_c=(_b=(_a=this.five.model.viewLayers)==null?void 0:_a[0])==null?void 0:_b.trajectories)==null?void 0:_c[0])==null?(_h=(_g=(_f=(_e=this.five.model.viewLayers)==null?void 0:_e[0])==null?void 0:_f.scene)==null?void 0:_g.trajectories)==null?void 0:_h[0]:_d,keyframes=null,aabb=null;if(trajectory&&(yield this.loadTrajectoryDataIfNeeded(trajectory),(_j=trajectory.content)!=null&&_j.data&&((_k=trajectory.content.data.positionArray)==null?void 0:_k.length)>=6&&(keyframes=this.extractKeyframes(trajectory),keyframes.length>=2?aabb=this.computeAABB2D(keyframes):keyframes=null)),!keyframes||!aabb){let sceneBounds=this.computeGSSceneBounds();if(!sceneBounds)throw Error(`未找到可用于计算入场曲线的 3DGS 边界或轨迹`);aabb={min:new THREE.Vector2(sceneBounds.min.x,sceneBounds.min.z),max:new THREE.Vector2(sceneBounds.max.x,sceneBounds.max.z)};let cx=(aabb.min.x+aabb.max.x)/2,cz=(aabb.min.y+aabb.max.y)/2,y=(sceneBounds.min.y+sceneBounds.max.y)/2,r=Math.max(aabb.max.x-aabb.min.x,aabb.max.y-aabb.min.y)*.5;keyframes=[];let acc=0,prev=null;for(let i=0;i<16;i++){let t=i/16*Math.PI*2,p=new THREE.Vector3(cx+Math.cos(t)*r,y,cz+Math.sin(t)*r);prev&&(acc+=p.distanceTo(prev)),keyframes.push({position:p,location:acc}),prev=p}}this.keyframes=keyframes,this.boundingAABB=aabb;let curveHeight=this.curveHeight,aabbCenter=new THREE.Vector3((aabb.min.x+aabb.max.x)/2,curveHeight,(aabb.min.y+aabb.max.y)/2),halfW=(aabb.max.x-aabb.min.x)/2,halfH=(aabb.max.y-aabb.min.y)/2,boundingRadius=Math.sqrt(halfW*halfW+halfH*halfH),projectToSphere=pt=>{let dir=new THREE.Vector3().subVectors(pt,aabbCenter);return dir.length()<.001&&dir.set(1,0,0),aabbCenter.clone().add(dir.normalize().multiplyScalar(boundingRadius))},startRaw=new THREE.Vector3(keyframes[0].position.x,curveHeight,keyframes[0].position.z),startPoint=projectToSphere(startRaw),primaryDir=new THREE.Vector3().subVectors(aabbCenter,startRaw).normalize(),primaryRay=new THREE.Ray(startRaw,primaryDir),secondaryDir=new THREE.Vector3(-primaryDir.z,0,primaryDir.x).normalize(),secondaryRay=new THREE.Ray(aabbCenter,secondaryDir),p1Raw=this.findClosestKeyframeToRay(secondaryRay,keyframes),p1=projectToSphere(new THREE.Vector3(p1Raw.x,curveHeight,p1Raw.z)),p2Raw=this.findClosestKeyframeToRay(primaryRay,keyframes),p2=projectToSphere(new THREE.Vector3(p2Raw.x,curveHeight,p2Raw.z));return new THREE.CatmullRomCurve3([startPoint,p1,p2],!1,`centripetal`,.5)})}setBounding(boundsMin,boundsMax,_center){let renderMesh=this.findRenderMesh();renderMesh.material.aggregationBoundsMin.copy(boundsMin),renderMesh.material.aggregationBoundsMax.copy(boundsMax),this.boundsSet=!0}setBounds(){if(!this.boundingAABB)throw Error(`请先调用 getCameraCurve 计算轨迹边界`);let aabb=this.boundingAABB,renderMesh=this.findRenderMesh(),boundsMin=new THREE.Vector3(aabb.min.x,0,aabb.min.y),boundsMax=new THREE.Vector3(aabb.max.x,3,aabb.max.y);renderMesh.material.aggregationBoundsMin.copy(boundsMin),renderMesh.material.aggregationBoundsMax.copy(boundsMax),this.boundsSet=!0}normalizedPointDuration(){let pd=this.pointDuration;return pd<=0?.01:Math.min(pd<=1?pd:pd/this.duration,1)}resetToPointCloud(){return __awaiter(this,void 0,void 0,function*(){if(!this.isInitAnimationEnabled())return;this.boundingAABB||(yield this.getCameraCurve()),this.setBounds();let material=this.findRenderMesh().material;material.aggregationEnabled=!0,material.aggregationProgress=0,material.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0,this.five.modelSceneNeedsRender=!0})}startAggregation(){if(!this.isInitAnimationEnabled()){console.warn(`[GaussianSplattingEntranceAnimationPlugin] modelScene.enableGaussianSplattingInitAnimation 为 false，已跳过聚合动画`);return}if(!this.boundsSet)throw Error(`请先调用 setBounds 设置聚合边界`);let material=this.findRenderMesh().material;material.aggregationEnabled=!0,material.aggregationProgress=0,material.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0;let startTime=performance.now(),duration=this.duration;this.cancelAnimation=AnimationFrameLoop.shared.add(()=>{let elapsed=performance.now()-startTime,progress=Math.min(elapsed/duration,1);material.aggregationProgress=progress*progress*(3-2*progress),this.five.needsRender=!0,this.five.modelSceneNeedsRender=!0,progress>=1&&(material.aggregationEnabled=!1,this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null))})}playEntrance(){return __awaiter(this,void 0,void 0,function*(){if(!this.isInitAnimationEnabled()){console.warn(`[GaussianSplattingEntranceAnimationPlugin] modelScene.enableGaussianSplattingInitAnimation 为 false，已跳过入场动画`);return}let curve=yield this.getCameraCurve(),aabb=this.boundingAABB,boundingCenter=new THREE.Vector3((aabb.min.x+aabb.max.x)/2,this.curveHeight,(aabb.min.y+aabb.max.y)/2),startPoint=curve.getPointAt(0),visualCamera=new Camera(90).copy(this.five.camera);visualCamera.position.copy(startPoint),visualCamera.lookAt(boundingCenter),visualCamera.computePose(0),this.five.setState(Object.assign({},visualCamera.pose)),this.setBounds();let material=this.findRenderMesh().material;material.aggregationEnabled=!0,material.aggregationProgress=0,material.aggregationPointDuration=this.normalizedPointDuration(),this.five.needsRender=!0;let duration=this.duration,startTime=performance.now();return new Promise(resolve=>{this.cancelAnimation=AnimationFrameLoop.shared.add(()=>{let elapsed=performance.now()-startTime,t=Math.min(elapsed/duration,1),eased=t*t*(3-2*t);material.aggregationProgress=eased,this.five.modelSceneNeedsRender=!0;let point=curve.getPointAt(eased);visualCamera.position.copy(point),visualCamera.lookAt(boundingCenter),visualCamera.computePose(0),this.five.setState(Object.assign({},visualCamera.pose)),this.five.needsRender=!0,t>=1&&(material.aggregationEnabled=!1,material.aggregationProgress=1,this.cancelAnimation&&(this.cancelAnimation(),this.cancelAnimation=null),resolve())})})})}};export{Controller};

package/plugins/GaussianSplattingEntranceAnimationPlugin/index.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/const e=require("./Controller.js");var t=(t,n)=>new e.Controller(t,n);exports.GaussianSplattingEntranceAnimationPlugin=t;
+*/const require_Controller=require("./Controller.js");var GaussianSplattingEntranceAnimationPlugin=(five,config)=>new require_Controller.Controller(five,config);exports.GaussianSplattingEntranceAnimationPlugin=GaussianSplattingEntranceAnimationPlugin;

package/plugins/GaussianSplattingEntranceAnimationPlugin/index.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/import{Controller as e}from"./Controller.mjs";var t=(t,n)=>new e(t,n);export{t as GaussianSplattingEntranceAnimationPlugin};
+*/import{Controller}from"./Controller.mjs";var GaussianSplattingEntranceAnimationPlugin=(five,config)=>new Controller(five,config);export{GaussianSplattingEntranceAnimationPlugin};

package/plugins/Object3DHelperPlugin/Controller.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/const e=require("../../_virtual/_rolldown/runtime.js"),t=require("../BasePlugin/index.js"),n=require("./Helper/MoveHelper.js"),r=require("./Helper/RotateHelper.js"),i=require("./Helper/BoundingBoxHelper.js"),a=require("./Controllers/MoveController.js"),o=require("./FiveControllerWrapper.js"),s=require("./Controllers/RotateController.js"),c=require("./Controllers/BoundingBoxController.js"),l=require("../thirdParty/domevents.js");let u=require("tslib"),d=require("@realsee/five-webgpu"),f=require("three/webgpu");f=e.__toESM(f,1);var p=`Object3DHelperPlugin`,m=p,h=()=>{console.error(`${m} is disposed`)},g=()=>{console.warn(`${m} is disabled`)},_=()=>{console.error(`${m} is disabled`)},v=class{constructor(e){this.controllers={},this.state={visible:!0,enabled:!0,disposed:!1},this.hooks=new d.Subscribe,e&&this.addControllers(e),this.setState(this.state)}show(e){this.setState({visible:!0},e)}hide(e){this.setState({visible:!1},e)}enable(e){this.setState({enabled:!0},e)}disable(e){this.setState({enabled:!1},e)}dispose(){this.setState({disposed:!0})}setState(e,t){if(this.state.disposed||!this.state.enabled&&e.enabled!==!0&&e.disposed!==!0)return;let n=Object.assign({},this.state);this.state=Object.assign(Object.assign({},this.state),e),e.disposed!==void 0&&e.disposed!==n.disposed&&e.disposed&&this.handleDispose(),e.visible!==void 0&&this.handleVisible(e.visible),e.enabled!==void 0&&this.handleEnable(e.enabled),this.hooks.emit(`stateChange`,{state:this.state,prevState:n})}addControllers(e){this.controllers=Object.assign(Object.assign({},this.controllers),e),this.setState(this.state)}initialHelperMatrix(){this.everyControllerDo(e=>{e.initialHelperPosition(),e.initialHelperQuaternion()})}handleEnable(e,t=!0){e?(this.everyControllerDo(e=>e.enable()),this.hooks.emit(`enable`,{userAction:t})):(this.everyControllerDo(e=>e.disable()),this.hooks.emit(`disable`,{userAction:t}))}handleVisible(e,t=!0){e?(this.everyControllerDo(e=>e.show()),this.state.enabled&&this.hooks.emit(`show`,{userAction:t})):(this.everyControllerDo(e=>e.hide()),this.state.enabled&&this.hooks.emit(`hide`,{userAction:t}))}handleDispose(){Object.values(this.controllers).forEach(e=>{e==null||e.dispose()})}everyControllerDo(e){Object.values(this.controllers).forEach(t=>{t&&e(t)})}},y=class extends t.BasePlugin.Controller{constructor(e){super(e),this.name=p,this.state={visible:!0,enabled:!0,disposed:!1},this.objectHelperMap=new Map,this.five=e}show(e){return(0,u.__awaiter)(this,void 0,void 0,function*(){this.setState({visible:!0},e)})}hide(e){return(0,u.__awaiter)(this,void 0,void 0,function*(){this.setState({visible:!1},e)})}enable(e){this.setState({enabled:!0},e)}disable(e){this.setState({enabled:!1},e)}dispose(){this.setState({disposed:!0})}load(e){return(0,u.__awaiter)(this,void 0,void 0,function*(){})}setState(e,t){var n;if(this.state.disposed)return h();if(!this.state.enabled&&e.enabled!==!0&&e.disposed!==!0)return _();let r=Object.assign({},this.state);this.state=Object.assign(Object.assign({},this.state),e),e.disposed!==void 0&&e.disposed!==r.disposed&&e.disposed&&this.handleDispose(),e.visible!==void 0&&e.visible!==r.visible&&this.handleVisible(e.visible),e.enabled!==void 0&&e.enabled!==r.enabled&&this.handleEnable(e.enabled),this.hooks.emit(`stateChange`,{state:this.state,prevState:r,userAction:(n=t==null?void 0:t.userAction)==null?!0:n})}getObject3DHelper(e){return this.objectHelperMap.get(e)}addObject3DHelper(e,t={}){var u,p;if(!e){console.error(`Object3D is undefined`);return}if(this.objectHelperMap.has(e)){console.warn(`Object3DHelperPlugin: object3D ${e.name} already has helper`);return}let m=new v,h=[],g=(u=this.five.getElement())==null?void 0:u.parentElement;this.five.camera;let _=Object.assign(Object.assign({},{moveHelper:!0,rotateHelper:!0,boundingBoxHelper:!1,moveHelperTips:!1,positionFrom:`objectPosition`}),t),{moveHelper:y,rotateHelper:b,boundingBoxHelper:x}=_,S=new f.Group;_.helperOffset&&S.position.copy(_.helperOffset),this.five.scene.add(S);let C=m.hooks,w=new d.Subscribe,T=new l.default(this.five.camera,this.five.getElement()),E=e=>{if(e)return typeof e==`boolean`?e:e.enable},D={};if(E(y)){let t=Object.assign(Object.assign({},this.getConfig(_.moveHelper)),_),r=new n.MoveHelper(e,Object.assign({container:g==null?void 0:g,moveTipsEnable:(p=_.moveHelperTips)==null?!1:p},t)),i=new o.ControllerWrapper(this.five,T,a.MoveController,e,r,t,C,w,S);D.moveController=i.helperController,h.push(()=>i.dispose())}if(E(b)){let t=Object.assign(Object.assign({},this.getConfig(_.rotateHelper)),_),n=new r.RotateHelper(e,Object.assign({container:g==null?void 0:g},t)),i=new o.ControllerWrapper(this.five,T,s.RotateController,e,n,t,C,w,S);D.rotateController=i.helperController,h.push(()=>i.dispose())}if(E(x)){let t=new i.BoundingBoxHelper(e),n=new o.ControllerWrapper(this.five,T,c.BoundingBoxController,e,t,void 0,C,w,S);D.boundingBoxController=n.helperController,h.push(()=>n.dispose())}return Object.values(D).forEach(e=>{e&&typeof e.updateOtherControllers==`function`&&e.updateOtherControllers(D)}),m.addControllers(D),this.objectHelperMap.set(e,{helper:m,disposers:h,helperGroup:S}),m.controllers}removeObject3DHelper(e){if(!this.objectHelperMap.has(e))return;let{helper:t,disposers:n,helperGroup:r}=this.objectHelperMap.get(e);this.objectHelperMap.delete(e),t.dispose(),n==null||n.forEach(e=>e==null?void 0:e()),r.parent&&r.parent.remove(r)}handleEnable(e,t=!0){e?(this.everyHelperDo(e=>e.enable()),this.hooks.emit(`enable`,{userAction:t})):(this.everyHelperDo(e=>e.disable()),this.hooks.emit(`disable`,{userAction:t})),this.state.enabled=e}handleVisible(e,t=!0){e?(this.everyHelperDo(e=>e.show()),this.actionIfStateIsEnabled(()=>this.hooks.emit(`show`,{userAction:t}))):(this.everyHelperDo(e=>e.hide()),this.actionIfStateIsEnabled(()=>this.hooks.emit(`hide`,{userAction:t}))),this.state.visible=e}handleDispose(){this.objectHelperMap.forEach(({helper:e,disposers:t,helperGroup:n})=>{e.dispose(),t==null||t.forEach(e=>e==null?void 0:e()),n.parent&&n.parent.remove(n)}),this.objectHelperMap.clear()}everyHelperDo(e){this.objectHelperMap.forEach(({helper:t,disposers:n})=>{t&&e(t,n)})}actionIfStateIsEnabled(e,t){if(this.state.enabled)return e();t!=null&&t.warnLog&&g()}getConfig(e){if(e&&typeof e!=`boolean`&&e.enable)return e}};exports.Controller=y,exports.Object3DHelper=v,exports.PLUGIN=m;
+*/const require_runtime=require("../../_virtual/_rolldown/runtime.js"),require_index=require("../BasePlugin/index.js"),require_MoveHelper=require("./Helper/MoveHelper.js"),require_RotateHelper=require("./Helper/RotateHelper.js"),require_BoundingBoxHelper=require("./Helper/BoundingBoxHelper.js"),require_MoveController=require("./Controllers/MoveController.js"),require_FiveControllerWrapper=require("./FiveControllerWrapper.js"),require_RotateController=require("./Controllers/RotateController.js"),require_BoundingBoxController=require("./Controllers/BoundingBoxController.js"),require_domevents=require("../thirdParty/domevents.js");let tslib=require("tslib"),_realsee_five_webgpu=require("@realsee/five-webgpu"),three_webgpu=require("three/webgpu");three_webgpu=require_runtime.__toESM(three_webgpu,1);var PLUGIN_NAME=`Object3DHelperPlugin`,PLUGIN=PLUGIN_NAME,disposedErrorLog=()=>{console.error(`${PLUGIN} is disposed`)},disableWarnLog=()=>{console.warn(`${PLUGIN} is disabled`)},disableErrorLog=()=>{console.error(`${PLUGIN} is disabled`)},Object3DHelper=class{constructor(controllers){this.controllers={},this.state={visible:!0,enabled:!0,disposed:!1},this.hooks=new _realsee_five_webgpu.Subscribe,controllers&&this.addControllers(controllers),this.setState(this.state)}show(options){this.setState({visible:!0},options)}hide(options){this.setState({visible:!1},options)}enable(options){this.setState({enabled:!0},options)}disable(options){this.setState({enabled:!1},options)}dispose(){this.setState({disposed:!0})}setState(state,_options){if(this.state.disposed||!this.state.enabled&&state.enabled!==!0&&state.disposed!==!0)return;let prevState=Object.assign({},this.state);this.state=Object.assign(Object.assign({},this.state),state),state.disposed!==void 0&&state.disposed!==prevState.disposed&&state.disposed&&this.handleDispose(),state.visible!==void 0&&this.handleVisible(state.visible),state.enabled!==void 0&&this.handleEnable(state.enabled),this.hooks.emit(`stateChange`,{state:this.state,prevState})}addControllers(controllers){this.controllers=Object.assign(Object.assign({},this.controllers),controllers),this.setState(this.state)}initialHelperMatrix(){this.everyControllerDo(controller=>{controller.initialHelperPosition(),controller.initialHelperQuaternion()})}handleEnable(enabled,userAction=!0){enabled?(this.everyControllerDo(c=>c.enable()),this.hooks.emit(`enable`,{userAction})):(this.everyControllerDo(c=>c.disable()),this.hooks.emit(`disable`,{userAction}))}handleVisible(visible,userAction=!0){visible?(this.everyControllerDo(c=>c.show()),this.state.enabled&&this.hooks.emit(`show`,{userAction})):(this.everyControllerDo(c=>c.hide()),this.state.enabled&&this.hooks.emit(`hide`,{userAction}))}handleDispose(){Object.values(this.controllers).forEach(controller=>{controller==null||controller.dispose()})}everyControllerDo(func){Object.values(this.controllers).forEach(controller=>{controller&&func(controller)})}},Controller=class extends require_index.BasePlugin.Controller{constructor(five){super(five),this.name=PLUGIN_NAME,this.state={visible:!0,enabled:!0,disposed:!1},this.objectHelperMap=new Map,this.five=five}show(options){return(0,tslib.__awaiter)(this,void 0,void 0,function*(){this.setState({visible:!0},options)})}hide(options){return(0,tslib.__awaiter)(this,void 0,void 0,function*(){this.setState({visible:!1},options)})}enable(options){this.setState({enabled:!0},options)}disable(options){this.setState({enabled:!1},options)}dispose(){this.setState({disposed:!0})}load(_data){return(0,tslib.__awaiter)(this,void 0,void 0,function*(){})}setState(state,options){var _a;if(this.state.disposed)return disposedErrorLog();if(!this.state.enabled&&state.enabled!==!0&&state.disposed!==!0)return disableErrorLog();let prevState=Object.assign({},this.state);this.state=Object.assign(Object.assign({},this.state),state),state.disposed!==void 0&&state.disposed!==prevState.disposed&&state.disposed&&this.handleDispose(),state.visible!==void 0&&state.visible!==prevState.visible&&this.handleVisible(state.visible),state.enabled!==void 0&&state.enabled!==prevState.enabled&&this.handleEnable(state.enabled),this.hooks.emit(`stateChange`,{state:this.state,prevState,userAction:(_a=options==null?void 0:options.userAction)==null?!0:_a})}getObject3DHelper(object3D){return this.objectHelperMap.get(object3D)}addObject3DHelper(object3D,paramsConfig={}){var _a,_b;if(!object3D){console.error(`Object3D is undefined`);return}if(this.objectHelperMap.has(object3D)){console.warn(`Object3DHelperPlugin: object3D ${object3D.name} already has helper`);return}let helper=new Object3DHelper,disposers=[],container=(_a=this.five.getElement())==null?void 0:_a.parentElement;this.five.camera;let config=Object.assign(Object.assign({},{moveHelper:!0,rotateHelper:!0,boundingBoxHelper:!1,moveHelperTips:!1,positionFrom:`objectPosition`}),paramsConfig),{moveHelper,rotateHelper,boundingBoxHelper}=config,helperGroup=new three_webgpu.Group;config.helperOffset&&helperGroup.position.copy(config.helperOffset),this.five.scene.add(helperGroup);let hooks=helper.hooks,internalHooks=new _realsee_five_webgpu.Subscribe,donEvents=new require_domevents.default(this.five.camera,this.five.getElement()),helperEnable=helper=>{if(helper)return typeof helper==`boolean`?helper:helper.enable},controllers={};if(helperEnable(moveHelper)){let c=Object.assign(Object.assign({},this.getConfig(config.moveHelper)),config),moveHelperObj=new require_MoveHelper.MoveHelper(object3D,Object.assign({container:container==null?void 0:container,moveTipsEnable:(_b=config.moveHelperTips)==null?!1:_b},c)),controllerWrapper=new require_FiveControllerWrapper.ControllerWrapper(this.five,donEvents,require_MoveController.MoveController,object3D,moveHelperObj,c,hooks,internalHooks,helperGroup);controllers.moveController=controllerWrapper.helperController,disposers.push(()=>controllerWrapper.dispose())}if(helperEnable(rotateHelper)){let c=Object.assign(Object.assign({},this.getConfig(config.rotateHelper)),config),rotateHelperObj=new require_RotateHelper.RotateHelper(object3D,Object.assign({container:container==null?void 0:container},c)),controllerWrapper=new require_FiveControllerWrapper.ControllerWrapper(this.five,donEvents,require_RotateController.RotateController,object3D,rotateHelperObj,c,hooks,internalHooks,helperGroup);controllers.rotateController=controllerWrapper.helperController,disposers.push(()=>controllerWrapper.dispose())}if(helperEnable(boundingBoxHelper)){let boundingBoxHelperObj=new require_BoundingBoxHelper.BoundingBoxHelper(object3D),controllerWrapper=new require_FiveControllerWrapper.ControllerWrapper(this.five,donEvents,require_BoundingBoxController.BoundingBoxController,object3D,boundingBoxHelperObj,void 0,hooks,internalHooks,helperGroup);controllers.boundingBoxController=controllerWrapper.helperController,disposers.push(()=>controllerWrapper.dispose())}return Object.values(controllers).forEach(controller=>{controller&&typeof controller.updateOtherControllers==`function`&&controller.updateOtherControllers(controllers)}),helper.addControllers(controllers),this.objectHelperMap.set(object3D,{helper,disposers,helperGroup}),helper.controllers}removeObject3DHelper(object3D){if(!this.objectHelperMap.has(object3D))return;let{helper,disposers,helperGroup}=this.objectHelperMap.get(object3D);this.objectHelperMap.delete(object3D),helper.dispose(),disposers==null||disposers.forEach(d=>d==null?void 0:d()),helperGroup.parent&&helperGroup.parent.remove(helperGroup)}handleEnable(enabled,userAction=!0){enabled?(this.everyHelperDo(helper=>helper.enable()),this.hooks.emit(`enable`,{userAction})):(this.everyHelperDo(helper=>helper.disable()),this.hooks.emit(`disable`,{userAction})),this.state.enabled=enabled}handleVisible(visible,userAction=!0){visible?(this.everyHelperDo(helper=>helper.show()),this.actionIfStateIsEnabled(()=>this.hooks.emit(`show`,{userAction}))):(this.everyHelperDo(helper=>helper.hide()),this.actionIfStateIsEnabled(()=>this.hooks.emit(`hide`,{userAction}))),this.state.visible=visible}handleDispose(){this.objectHelperMap.forEach(({helper,disposers,helperGroup})=>{helper.dispose(),disposers==null||disposers.forEach(d=>d==null?void 0:d()),helperGroup.parent&&helperGroup.parent.remove(helperGroup)}),this.objectHelperMap.clear()}everyHelperDo(func){this.objectHelperMap.forEach(({helper,disposers})=>{helper&&func(helper,disposers)})}actionIfStateIsEnabled(func,options){if(this.state.enabled)return func();options!=null&&options.warnLog&&disableWarnLog()}getConfig(config){if(config&&typeof config!=`boolean`&&config.enable)return config}};exports.Controller=Controller,exports.Object3DHelper=Object3DHelper,exports.PLUGIN=PLUGIN;

package/plugins/Object3DHelperPlugin/Controller.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/import{BasePlugin as e}from"../BasePlugin/index.mjs";import{MoveHelper as t}from"./Helper/MoveHelper.mjs";import{RotateHelper as n}from"./Helper/RotateHelper.mjs";import{BoundingBoxHelper as r}from"./Helper/BoundingBoxHelper.mjs";import{MoveController as i}from"./Controllers/MoveController.mjs";import{ControllerWrapper as a}from"./FiveControllerWrapper.mjs";import{RotateController as o}from"./Controllers/RotateController.mjs";import{BoundingBoxController as s}from"./Controllers/BoundingBoxController.mjs";import c from"../thirdParty/domevents.mjs";import{__awaiter as l}from"tslib";import{Subscribe as u}from"@realsee/five-webgpu";import*as d from"three/webgpu";var f=`Object3DHelperPlugin`,p=f,m=()=>{console.error(`${p} is disposed`)},h=()=>{console.warn(`${p} is disabled`)},g=()=>{console.error(`${p} is disabled`)},_=class{constructor(e){this.controllers={},this.state={visible:!0,enabled:!0,disposed:!1},this.hooks=new u,e&&this.addControllers(e),this.setState(this.state)}show(e){this.setState({visible:!0},e)}hide(e){this.setState({visible:!1},e)}enable(e){this.setState({enabled:!0},e)}disable(e){this.setState({enabled:!1},e)}dispose(){this.setState({disposed:!0})}setState(e,t){if(this.state.disposed||!this.state.enabled&&e.enabled!==!0&&e.disposed!==!0)return;let n=Object.assign({},this.state);this.state=Object.assign(Object.assign({},this.state),e),e.disposed!==void 0&&e.disposed!==n.disposed&&e.disposed&&this.handleDispose(),e.visible!==void 0&&this.handleVisible(e.visible),e.enabled!==void 0&&this.handleEnable(e.enabled),this.hooks.emit(`stateChange`,{state:this.state,prevState:n})}addControllers(e){this.controllers=Object.assign(Object.assign({},this.controllers),e),this.setState(this.state)}initialHelperMatrix(){this.everyControllerDo(e=>{e.initialHelperPosition(),e.initialHelperQuaternion()})}handleEnable(e,t=!0){e?(this.everyControllerDo(e=>e.enable()),this.hooks.emit(`enable`,{userAction:t})):(this.everyControllerDo(e=>e.disable()),this.hooks.emit(`disable`,{userAction:t}))}handleVisible(e,t=!0){e?(this.everyControllerDo(e=>e.show()),this.state.enabled&&this.hooks.emit(`show`,{userAction:t})):(this.everyControllerDo(e=>e.hide()),this.state.enabled&&this.hooks.emit(`hide`,{userAction:t}))}handleDispose(){Object.values(this.controllers).forEach(e=>{e==null||e.dispose()})}everyControllerDo(e){Object.values(this.controllers).forEach(t=>{t&&e(t)})}},v=class extends e.Controller{constructor(e){super(e),this.name=f,this.state={visible:!0,enabled:!0,disposed:!1},this.objectHelperMap=new Map,this.five=e}show(e){return l(this,void 0,void 0,function*(){this.setState({visible:!0},e)})}hide(e){return l(this,void 0,void 0,function*(){this.setState({visible:!1},e)})}enable(e){this.setState({enabled:!0},e)}disable(e){this.setState({enabled:!1},e)}dispose(){this.setState({disposed:!0})}load(e){return l(this,void 0,void 0,function*(){})}setState(e,t){var n;if(this.state.disposed)return m();if(!this.state.enabled&&e.enabled!==!0&&e.disposed!==!0)return g();let r=Object.assign({},this.state);this.state=Object.assign(Object.assign({},this.state),e),e.disposed!==void 0&&e.disposed!==r.disposed&&e.disposed&&this.handleDispose(),e.visible!==void 0&&e.visible!==r.visible&&this.handleVisible(e.visible),e.enabled!==void 0&&e.enabled!==r.enabled&&this.handleEnable(e.enabled),this.hooks.emit(`stateChange`,{state:this.state,prevState:r,userAction:(n=t==null?void 0:t.userAction)==null?!0:n})}getObject3DHelper(e){return this.objectHelperMap.get(e)}addObject3DHelper(e,l={}){var f,p;if(!e){console.error(`Object3D is undefined`);return}if(this.objectHelperMap.has(e)){console.warn(`Object3DHelperPlugin: object3D ${e.name} already has helper`);return}let m=new _,h=[],g=(f=this.five.getElement())==null?void 0:f.parentElement;this.five.camera;let v=Object.assign(Object.assign({},{moveHelper:!0,rotateHelper:!0,boundingBoxHelper:!1,moveHelperTips:!1,positionFrom:`objectPosition`}),l),{moveHelper:y,rotateHelper:b,boundingBoxHelper:x}=v,S=new d.Group;v.helperOffset&&S.position.copy(v.helperOffset),this.five.scene.add(S);let C=m.hooks,w=new u,T=new c(this.five.camera,this.five.getElement()),E=e=>{if(e)return typeof e==`boolean`?e:e.enable},D={};if(E(y)){let n=Object.assign(Object.assign({},this.getConfig(v.moveHelper)),v),r=new t(e,Object.assign({container:g==null?void 0:g,moveTipsEnable:(p=v.moveHelperTips)==null?!1:p},n)),o=new a(this.five,T,i,e,r,n,C,w,S);D.moveController=o.helperController,h.push(()=>o.dispose())}if(E(b)){let t=Object.assign(Object.assign({},this.getConfig(v.rotateHelper)),v),r=new n(e,Object.assign({container:g==null?void 0:g},t)),i=new a(this.five,T,o,e,r,t,C,w,S);D.rotateController=i.helperController,h.push(()=>i.dispose())}if(E(x)){let t=new r(e),n=new a(this.five,T,s,e,t,void 0,C,w,S);D.boundingBoxController=n.helperController,h.push(()=>n.dispose())}return Object.values(D).forEach(e=>{e&&typeof e.updateOtherControllers==`function`&&e.updateOtherControllers(D)}),m.addControllers(D),this.objectHelperMap.set(e,{helper:m,disposers:h,helperGroup:S}),m.controllers}removeObject3DHelper(e){if(!this.objectHelperMap.has(e))return;let{helper:t,disposers:n,helperGroup:r}=this.objectHelperMap.get(e);this.objectHelperMap.delete(e),t.dispose(),n==null||n.forEach(e=>e==null?void 0:e()),r.parent&&r.parent.remove(r)}handleEnable(e,t=!0){e?(this.everyHelperDo(e=>e.enable()),this.hooks.emit(`enable`,{userAction:t})):(this.everyHelperDo(e=>e.disable()),this.hooks.emit(`disable`,{userAction:t})),this.state.enabled=e}handleVisible(e,t=!0){e?(this.everyHelperDo(e=>e.show()),this.actionIfStateIsEnabled(()=>this.hooks.emit(`show`,{userAction:t}))):(this.everyHelperDo(e=>e.hide()),this.actionIfStateIsEnabled(()=>this.hooks.emit(`hide`,{userAction:t}))),this.state.visible=e}handleDispose(){this.objectHelperMap.forEach(({helper:e,disposers:t,helperGroup:n})=>{e.dispose(),t==null||t.forEach(e=>e==null?void 0:e()),n.parent&&n.parent.remove(n)}),this.objectHelperMap.clear()}everyHelperDo(e){this.objectHelperMap.forEach(({helper:t,disposers:n})=>{t&&e(t,n)})}actionIfStateIsEnabled(e,t){if(this.state.enabled)return e();t!=null&&t.warnLog&&h()}getConfig(e){if(e&&typeof e!=`boolean`&&e.enable)return e}};export{v as Controller,_ as Object3DHelper,p as PLUGIN};
+*/import{BasePlugin}from"../BasePlugin/index.mjs";import{MoveHelper}from"./Helper/MoveHelper.mjs";import{RotateHelper}from"./Helper/RotateHelper.mjs";import{BoundingBoxHelper}from"./Helper/BoundingBoxHelper.mjs";import{MoveController}from"./Controllers/MoveController.mjs";import{ControllerWrapper}from"./FiveControllerWrapper.mjs";import{RotateController}from"./Controllers/RotateController.mjs";import{BoundingBoxController}from"./Controllers/BoundingBoxController.mjs";import DomEvents from"../thirdParty/domevents.mjs";import{__awaiter}from"tslib";import{Subscribe}from"@realsee/five-webgpu";import*as THREE from"three/webgpu";var PLUGIN_NAME=`Object3DHelperPlugin`,PLUGIN=PLUGIN_NAME,disposedErrorLog=()=>{console.error(`${PLUGIN} is disposed`)},disableWarnLog=()=>{console.warn(`${PLUGIN} is disabled`)},disableErrorLog=()=>{console.error(`${PLUGIN} is disabled`)},Object3DHelper=class{constructor(controllers){this.controllers={},this.state={visible:!0,enabled:!0,disposed:!1},this.hooks=new Subscribe,controllers&&this.addControllers(controllers),this.setState(this.state)}show(options){this.setState({visible:!0},options)}hide(options){this.setState({visible:!1},options)}enable(options){this.setState({enabled:!0},options)}disable(options){this.setState({enabled:!1},options)}dispose(){this.setState({disposed:!0})}setState(state,_options){if(this.state.disposed||!this.state.enabled&&state.enabled!==!0&&state.disposed!==!0)return;let prevState=Object.assign({},this.state);this.state=Object.assign(Object.assign({},this.state),state),state.disposed!==void 0&&state.disposed!==prevState.disposed&&state.disposed&&this.handleDispose(),state.visible!==void 0&&this.handleVisible(state.visible),state.enabled!==void 0&&this.handleEnable(state.enabled),this.hooks.emit(`stateChange`,{state:this.state,prevState})}addControllers(controllers){this.controllers=Object.assign(Object.assign({},this.controllers),controllers),this.setState(this.state)}initialHelperMatrix(){this.everyControllerDo(controller=>{controller.initialHelperPosition(),controller.initialHelperQuaternion()})}handleEnable(enabled,userAction=!0){enabled?(this.everyControllerDo(c=>c.enable()),this.hooks.emit(`enable`,{userAction})):(this.everyControllerDo(c=>c.disable()),this.hooks.emit(`disable`,{userAction}))}handleVisible(visible,userAction=!0){visible?(this.everyControllerDo(c=>c.show()),this.state.enabled&&this.hooks.emit(`show`,{userAction})):(this.everyControllerDo(c=>c.hide()),this.state.enabled&&this.hooks.emit(`hide`,{userAction}))}handleDispose(){Object.values(this.controllers).forEach(controller=>{controller==null||controller.dispose()})}everyControllerDo(func){Object.values(this.controllers).forEach(controller=>{controller&&func(controller)})}},Controller=class extends BasePlugin.Controller{constructor(five){super(five),this.name=PLUGIN_NAME,this.state={visible:!0,enabled:!0,disposed:!1},this.objectHelperMap=new Map,this.five=five}show(options){return __awaiter(this,void 0,void 0,function*(){this.setState({visible:!0},options)})}hide(options){return __awaiter(this,void 0,void 0,function*(){this.setState({visible:!1},options)})}enable(options){this.setState({enabled:!0},options)}disable(options){this.setState({enabled:!1},options)}dispose(){this.setState({disposed:!0})}load(_data){return __awaiter(this,void 0,void 0,function*(){})}setState(state,options){var _a;if(this.state.disposed)return disposedErrorLog();if(!this.state.enabled&&state.enabled!==!0&&state.disposed!==!0)return disableErrorLog();let prevState=Object.assign({},this.state);this.state=Object.assign(Object.assign({},this.state),state),state.disposed!==void 0&&state.disposed!==prevState.disposed&&state.disposed&&this.handleDispose(),state.visible!==void 0&&state.visible!==prevState.visible&&this.handleVisible(state.visible),state.enabled!==void 0&&state.enabled!==prevState.enabled&&this.handleEnable(state.enabled),this.hooks.emit(`stateChange`,{state:this.state,prevState,userAction:(_a=options==null?void 0:options.userAction)==null?!0:_a})}getObject3DHelper(object3D){return this.objectHelperMap.get(object3D)}addObject3DHelper(object3D,paramsConfig={}){var _a,_b;if(!object3D){console.error(`Object3D is undefined`);return}if(this.objectHelperMap.has(object3D)){console.warn(`Object3DHelperPlugin: object3D ${object3D.name} already has helper`);return}let helper=new Object3DHelper,disposers=[],container=(_a=this.five.getElement())==null?void 0:_a.parentElement;this.five.camera;let config=Object.assign(Object.assign({},{moveHelper:!0,rotateHelper:!0,boundingBoxHelper:!1,moveHelperTips:!1,positionFrom:`objectPosition`}),paramsConfig),{moveHelper,rotateHelper,boundingBoxHelper}=config,helperGroup=new THREE.Group;config.helperOffset&&helperGroup.position.copy(config.helperOffset),this.five.scene.add(helperGroup);let hooks=helper.hooks,internalHooks=new Subscribe,donEvents=new DomEvents(this.five.camera,this.five.getElement()),helperEnable=helper=>{if(helper)return typeof helper==`boolean`?helper:helper.enable},controllers={};if(helperEnable(moveHelper)){let c=Object.assign(Object.assign({},this.getConfig(config.moveHelper)),config),moveHelperObj=new MoveHelper(object3D,Object.assign({container:container==null?void 0:container,moveTipsEnable:(_b=config.moveHelperTips)==null?!1:_b},c)),controllerWrapper=new ControllerWrapper(this.five,donEvents,MoveController,object3D,moveHelperObj,c,hooks,internalHooks,helperGroup);controllers.moveController=controllerWrapper.helperController,disposers.push(()=>controllerWrapper.dispose())}if(helperEnable(rotateHelper)){let c=Object.assign(Object.assign({},this.getConfig(config.rotateHelper)),config),rotateHelperObj=new RotateHelper(object3D,Object.assign({container:container==null?void 0:container},c)),controllerWrapper=new ControllerWrapper(this.five,donEvents,RotateController,object3D,rotateHelperObj,c,hooks,internalHooks,helperGroup);controllers.rotateController=controllerWrapper.helperController,disposers.push(()=>controllerWrapper.dispose())}if(helperEnable(boundingBoxHelper)){let boundingBoxHelperObj=new BoundingBoxHelper(object3D),controllerWrapper=new ControllerWrapper(this.five,donEvents,BoundingBoxController,object3D,boundingBoxHelperObj,void 0,hooks,internalHooks,helperGroup);controllers.boundingBoxController=controllerWrapper.helperController,disposers.push(()=>controllerWrapper.dispose())}return Object.values(controllers).forEach(controller=>{controller&&typeof controller.updateOtherControllers==`function`&&controller.updateOtherControllers(controllers)}),helper.addControllers(controllers),this.objectHelperMap.set(object3D,{helper,disposers,helperGroup}),helper.controllers}removeObject3DHelper(object3D){if(!this.objectHelperMap.has(object3D))return;let{helper,disposers,helperGroup}=this.objectHelperMap.get(object3D);this.objectHelperMap.delete(object3D),helper.dispose(),disposers==null||disposers.forEach(d=>d==null?void 0:d()),helperGroup.parent&&helperGroup.parent.remove(helperGroup)}handleEnable(enabled,userAction=!0){enabled?(this.everyHelperDo(helper=>helper.enable()),this.hooks.emit(`enable`,{userAction})):(this.everyHelperDo(helper=>helper.disable()),this.hooks.emit(`disable`,{userAction})),this.state.enabled=enabled}handleVisible(visible,userAction=!0){visible?(this.everyHelperDo(helper=>helper.show()),this.actionIfStateIsEnabled(()=>this.hooks.emit(`show`,{userAction}))):(this.everyHelperDo(helper=>helper.hide()),this.actionIfStateIsEnabled(()=>this.hooks.emit(`hide`,{userAction}))),this.state.visible=visible}handleDispose(){this.objectHelperMap.forEach(({helper,disposers,helperGroup})=>{helper.dispose(),disposers==null||disposers.forEach(d=>d==null?void 0:d()),helperGroup.parent&&helperGroup.parent.remove(helperGroup)}),this.objectHelperMap.clear()}everyHelperDo(func){this.objectHelperMap.forEach(({helper,disposers})=>{helper&&func(helper,disposers)})}actionIfStateIsEnabled(func,options){if(this.state.enabled)return func();options!=null&&options.warnLog&&disableWarnLog()}getConfig(config){if(config&&typeof config!=`boolean`&&config.enable)return config}};export{Controller,Object3DHelper,PLUGIN};

package/plugins/Object3DHelperPlugin/Controllers/BaseController.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/const e=require("../../../_virtual/_rolldown/runtime.js"),t=require("../../../five/utils/isNil.js"),n=require("../utils/cameraHooks.js");let r=require("@realsee/five-webgpu"),i=require("three/webgpu");i=e.__toESM(i,1);function a(e){return arguments.length===0?[]:Array.isArray(e)?e:[e]}var o=class{updateOtherControllers(e){this.otherControllers=e}getIsDragging(){return this.isDragging}constructor(e,t){var a,o,s;this.preventTapDefaultEvent=!1,this.disposers=[],this.isDragging=!1,this.enabled=!1,this.name=`BaseController`,this.onWantsTapGesture=e=>{if(this.getIntersectObject(e))return!1},this.updateHelperScale=()=>{`update`in this.helperObject3D&&typeof this.helperObject3D.update==`function`&&this.helperObject3D.update(this.camera),this.helperObject3D.setScaleByCamera(this.camera)},this.getBox=()=>(this.boundingBox||(this.boundingBox=new i.Box3().expandByObject(this.originObject3D)),this.boundingBox),this.hooks=(a=e.sharedHooks)==null?new r.Subscribe:a,this.internalHooks=(o=e.sharedInternalHooks)==null?new r.Subscribe:o,this.camera=e.camera,this.model=e.model,this.originObject3D=e.originObject3D,this.helperObject3D=e.helperObject3D,this.container=e.container,this.scene=e.scene,this.domEvents=e.domEvents,this.onRender=(s=e.onRender)==null?(()=>{}):s,this.config=t==null?{}:t,this.otherControllers=e.otherControllers,this.initialHelperPosition(),this.initialHelperQuaternion(),this.updateHelperScale(),this.cameraHooks=n.cameraHooks(this.camera),this.enable();let c=this.onSetOriginObjectScale.bind(this),l=this.onSetOriginObjectRotate.bind(this),u=this.onSetOriginObjectPosition.bind(this),d=this.onApplyOriginObjectScale.bind(this),f=this.onApplyOriginObjectRotate.bind(this),p=this.onApplyOriginObjectPosition.bind(this),m=this.initialHelperPosition.bind(this);this.cameraHooks.on(`cameraUpdate`,this.updateHelperScale),this.internalHooks.on(`initialHelperPosition`,m),this.internalHooks.on(`setObjectScale`,c),this.internalHooks.on(`setObjectRotate`,l),this.internalHooks.on(`setObjectPosition`,u),this.internalHooks.on(`applyObjectPosition`,p),this.internalHooks.on(`applyObjectRotate`,f),this.internalHooks.on(`applyObjectScale`,d),this.hooks.on(`moveEnd`,this.updateHelperScale),this.internalHooks.on(`setObjectPosition`,this.updateHelperScale),this.internalHooks.on(`initialHelperPosition`,this.updateHelperScale),this.disposers.push(()=>{this.cameraHooks.off(`cameraUpdate`,this.updateHelperScale),this.internalHooks.off(`initialHelperPosition`,m),this.internalHooks.off(`setObjectScale`,c),this.internalHooks.off(`setObjectRotate`,l),this.internalHooks.off(`setObjectPosition`,u),this.internalHooks.off(`applyObjectPosition`,p),this.internalHooks.off(`applyObjectRotate`,f),this.internalHooks.off(`applyObjectScale`,d),this.hooks.off(`moveEnd`,this.updateHelperScale),this.internalHooks.off(`setObjectPosition`,this.updateHelperScale),this.internalHooks.off(`initialHelperPosition`,this.updateHelperScale)})}initialHelperPosition(){this.helperObject3D.initialPosition(this.calculateOffset(this.config.offset))}initialHelperQuaternion(){this.helperObject3D.initQuaternion(this.config)}enable(){this.enabled||(this.enabled=!0,this.scene.add(this.helperObject3D),this.helperObject3D.enable(),this.render())}disable(){this.enabled&&(this.enabled=!1,this.helperObject3D.disable(),this.render())}show(){this.helperObject3D.show(),this.render()}hide(){this.helperObject3D.hide(),this.render()}dispose(){var e;(e=this.disposers)==null||e.forEach(e=>e==null?void 0:e()),this.helperObject3D.dispose(),this.render()}applyHelperMatrix4(e){this.helperObject3D.applyMatrix4(e)}applyHelperQuaternion(e,t){this.helperObject3D.applyHelperQuaternion(e,t)}applyHelperScaleMatrix4(e,t){this.helperObject3D.applyHelperScaleMatrix4(e,t)}onWantsGesture(e,t,n){if(this.isDragging)return!1}onIntersectionOnModelUpdate(e){}onApplyOriginObjectScale(e){this.applyHelperScaleMatrix4(e.matrix,e.origin)}onApplyOriginObjectRotate(e){let t=e.origin;if(t){let n=new i.Vector3().subVectors(this.helperObject3D.position,t).applyQuaternion(e.quaternion).add(t);this.helperObject3D.position.copy(n)}}onApplyOriginObjectPosition(e){this.applyHelperMatrix4(e.matrix)}onSetOriginObjectScale(e){this.helperObject3D.scale.copy(e),this.updateOffsetByScale(e)}onSetOriginObjectRotate(e,t){}onSetOriginObjectPosition(e){this.helperObject3D.position.copy(e.clone().add(this.calculateOffset(this.config.offset)))}render(){this.onRender()}updateOffsetByScale(e){if(this.boundingBox&&this.config.offset){let t=this.originObject3D.position,n=new i.Vector3().subVectors(this.boundingBox.max,t).multiply(e).add(t),r=new i.Vector3().subVectors(this.boundingBox.min,t).multiply(e).add(t),a=this.calculateOffset(this.config.offset,{min:r,max:n});this.helperObject3D.initialPosition(a)}}hoverListener(e,n=16777215,r=1){let o=a(e).filter(e=>!t.isNil(e)),s=[];for(let e of o)if(e.material||e instanceof i.Group){let t=e instanceof i.Group?e.children.filter(e=>e instanceof i.Mesh):[e];t.forEach(e=>{var t,n,r,i;let a=e.material;Array.isArray(a)?(e.__originalColor__=(t=e.__originalColor__)==null?a.map(e=>e.color.clone()):t,e.__originalOpacity__=(n=e.__originalOpacity__)==null?a.map(e=>e.opacity):n):(e.__originalColor__=(r=e.__originalColor__)==null?a.color.clone():r,e.__originalOpacity__=(i=e.__originalOpacity__)==null?a.opacity:i)});let a=()=>{t.forEach(e=>{if(e.name===`ScaleHelperTransparentGroup`){if(e.children[0]){let t=e.children[0].material;t.color.set(n),t.opacity=r}}else{let t=e.material;Array.isArray(t)?t.forEach(e=>{e.color.set(n),e.opacity=r}):(t.color.set(n),t.opacity=r)}}),this.render()},o=()=>{t.forEach(e=>{if(e.name===`ScaleHelperTransparentGroup`){if(e.children[0]){let t=e.children[0].material;t.color.set(16776960),t.opacity=1}}else{let t=e.material;if(Array.isArray(t)){let n=e.__originalColor__,r=e.__originalOpacity__;t.forEach((e,t)=>{n&&n[t]&&e.color.copy(n[t]),r&&r[t]!==void 0&&(e.opacity=r[t])})}else t.color.copy(e.__originalColor__),t.opacity=e.__originalOpacity__}}),this.render()},c=e=>{this.isDragging||a()},l=e=>{this.isDragging||o()};for(let e of t)this.domEvents.addEventListener(e,`mouseover`,c),this.domEvents.addEventListener(e,`mouseout`,l),this.hooks.on(`moveStart`,a),this.hooks.on(`moveEnd`,o),this.hooks.on(`rotateEnd`,o),this.hooks.on(`scaleEnd`,o),s.push(()=>{this.domEvents.removeEventListener(e,`mouseover`,c),this.domEvents.removeEventListener(e,`mouseout`,l),this.hooks.off(`moveStart`,a),this.hooks.off(`moveEnd`,o),this.hooks.off(`rotateEnd`,o),this.hooks.off(`scaleEnd`,o)})}return()=>s.forEach(e=>e==null?void 0:e())}getIntersectObject(e){let t=this.camera.position,n=this.helperObject3D;if(!n)return;let r=this.helperObject3D.raycasterIntersectObject(e)[0];if(!r)return;let i=r;if(i.object=n,this.model.intersectRaycaster){let n=this.model.intersectRaycaster(e)[0];if(n&&n.point.distanceTo(t)<i.point.distanceTo(t))return}return i.object}calculateOffset(e,t){let n=new i.Vector3(0,0,0);if(!e)return n;let r=()=>t||this.getBox();if(typeof e.x==`number`)n.setX(e.x);else if(typeof e.x==`object`){let t=r();n.setX((t.max.x-t.min.x)*e.x.percents)}if(typeof e.y==`number`)n.setY(e.y);else if(typeof e.y==`object`){let t=r();n.setY((t.max.y-t.min.y)*e.y.percents)}if(typeof e.z==`number`)n.setZ(e.z);else if(typeof e.z==`object`){let t=r();n.setZ((t.max.z-t.min.z)*e.z.percents)}return n}};exports.BaseController=o;
+*/const require_runtime=require("../../../_virtual/_rolldown/runtime.js"),require_isNil=require("../../../five/utils/isNil.js"),require_cameraHooks=require("../utils/cameraHooks.js");let _realsee_five_webgpu=require("@realsee/five-webgpu"),three_webgpu=require("three/webgpu");three_webgpu=require_runtime.__toESM(three_webgpu,1);function toArray(value){return arguments.length===0?[]:Array.isArray(value)?value:[value]}var BaseController=class{updateOtherControllers(otherControllers){this.otherControllers=otherControllers}getIsDragging(){return this.isDragging}constructor(params,config){var _a,_b,_c;this.preventTapDefaultEvent=!1,this.disposers=[],this.isDragging=!1,this.enabled=!1,this.name=`BaseController`,this.onWantsTapGesture=raycaster=>{if(this.getIntersectObject(raycaster))return!1},this.updateHelperScale=()=>{`update`in this.helperObject3D&&typeof this.helperObject3D.update==`function`&&this.helperObject3D.update(this.camera),this.helperObject3D.setScaleByCamera(this.camera)},this.getBox=()=>(this.boundingBox||(this.boundingBox=new three_webgpu.Box3().expandByObject(this.originObject3D)),this.boundingBox),this.hooks=(_a=params.sharedHooks)==null?new _realsee_five_webgpu.Subscribe:_a,this.internalHooks=(_b=params.sharedInternalHooks)==null?new _realsee_five_webgpu.Subscribe:_b,this.camera=params.camera,this.model=params.model,this.originObject3D=params.originObject3D,this.helperObject3D=params.helperObject3D,this.container=params.container,this.scene=params.scene,this.domEvents=params.domEvents,this.onRender=(_c=params.onRender)==null?(()=>{}):_c,this.config=config==null?{}:config,this.otherControllers=params.otherControllers,this.initialHelperPosition(),this.initialHelperQuaternion(),this.updateHelperScale(),this.cameraHooks=require_cameraHooks.cameraHooks(this.camera),this.enable();let handleSetObjectScale=this.onSetOriginObjectScale.bind(this),handleSetObjectRotate=this.onSetOriginObjectRotate.bind(this),handleSetObjectPosition=this.onSetOriginObjectPosition.bind(this),handleApplyObjectScale=this.onApplyOriginObjectScale.bind(this),handleApplyObjectRotate=this.onApplyOriginObjectRotate.bind(this),handleApplyObjectPosition=this.onApplyOriginObjectPosition.bind(this),initialHelperPosition=this.initialHelperPosition.bind(this);this.cameraHooks.on(`cameraUpdate`,this.updateHelperScale),this.internalHooks.on(`initialHelperPosition`,initialHelperPosition),this.internalHooks.on(`setObjectScale`,handleSetObjectScale),this.internalHooks.on(`setObjectRotate`,handleSetObjectRotate),this.internalHooks.on(`setObjectPosition`,handleSetObjectPosition),this.internalHooks.on(`applyObjectPosition`,handleApplyObjectPosition),this.internalHooks.on(`applyObjectRotate`,handleApplyObjectRotate),this.internalHooks.on(`applyObjectScale`,handleApplyObjectScale),this.hooks.on(`moveEnd`,this.updateHelperScale),this.internalHooks.on(`setObjectPosition`,this.updateHelperScale),this.internalHooks.on(`initialHelperPosition`,this.updateHelperScale),this.disposers.push(()=>{this.cameraHooks.off(`cameraUpdate`,this.updateHelperScale),this.internalHooks.off(`initialHelperPosition`,initialHelperPosition),this.internalHooks.off(`setObjectScale`,handleSetObjectScale),this.internalHooks.off(`setObjectRotate`,handleSetObjectRotate),this.internalHooks.off(`setObjectPosition`,handleSetObjectPosition),this.internalHooks.off(`applyObjectPosition`,handleApplyObjectPosition),this.internalHooks.off(`applyObjectRotate`,handleApplyObjectRotate),this.internalHooks.off(`applyObjectScale`,handleApplyObjectScale),this.hooks.off(`moveEnd`,this.updateHelperScale),this.internalHooks.off(`setObjectPosition`,this.updateHelperScale),this.internalHooks.off(`initialHelperPosition`,this.updateHelperScale)})}initialHelperPosition(){this.helperObject3D.initialPosition(this.calculateOffset(this.config.offset))}initialHelperQuaternion(){this.helperObject3D.initQuaternion(this.config)}enable(){this.enabled||(this.enabled=!0,this.scene.add(this.helperObject3D),this.helperObject3D.enable(),this.render())}disable(){this.enabled&&(this.enabled=!1,this.helperObject3D.disable(),this.render())}show(){this.helperObject3D.show(),this.render()}hide(){this.helperObject3D.hide(),this.render()}dispose(){var _a;(_a=this.disposers)==null||_a.forEach(d=>d==null?void 0:d()),this.helperObject3D.dispose(),this.render()}applyHelperMatrix4(matrix){this.helperObject3D.applyMatrix4(matrix)}applyHelperQuaternion(quaternion,origin){this.helperObject3D.applyHelperQuaternion(quaternion,origin)}applyHelperScaleMatrix4(matrix,origin){this.helperObject3D.applyHelperScaleMatrix4(matrix,origin)}onWantsGesture(type,pointers,final){if(this.isDragging)return!1}onIntersectionOnModelUpdate(intersection){}onApplyOriginObjectScale(params){this.applyHelperScaleMatrix4(params.matrix,params.origin)}onApplyOriginObjectRotate(params){let origin=params.origin;if(origin){let v=new three_webgpu.Vector3().subVectors(this.helperObject3D.position,origin).applyQuaternion(params.quaternion).add(origin);this.helperObject3D.position.copy(v)}}onApplyOriginObjectPosition(params){this.applyHelperMatrix4(params.matrix)}onSetOriginObjectScale(scale){this.helperObject3D.scale.copy(scale),this.updateOffsetByScale(scale)}onSetOriginObjectRotate(_quaternion,_origin){}onSetOriginObjectPosition(position){this.helperObject3D.position.copy(position.clone().add(this.calculateOffset(this.config.offset)))}render(){this.onRender()}updateOffsetByScale(scale){if(this.boundingBox&&this.config.offset){let origin=this.originObject3D.position,max=new three_webgpu.Vector3().subVectors(this.boundingBox.max,origin).multiply(scale).add(origin),min=new three_webgpu.Vector3().subVectors(this.boundingBox.min,origin).multiply(scale).add(origin),offset=this.calculateOffset(this.config.offset,{min,max});this.helperObject3D.initialPosition(offset)}}hoverListener(object3D,hoverColor=16777215,hoverOpacity=1){let objects=toArray(object3D).filter(object=>!require_isNil.isNil(object)),disposers=[];for(let object of objects)if(object.material||object instanceof three_webgpu.Group){let meshes=object instanceof three_webgpu.Group?object.children.filter(child=>child instanceof three_webgpu.Mesh):[object];meshes.forEach(mesh=>{var _a,_b,_c,_d;let mat=mesh.material;Array.isArray(mat)?(mesh.__originalColor__=(_a=mesh.__originalColor__)==null?mat.map(m=>m.color.clone()):_a,mesh.__originalOpacity__=(_b=mesh.__originalOpacity__)==null?mat.map(m=>m.opacity):_b):(mesh.__originalColor__=(_c=mesh.__originalColor__)==null?mat.color.clone():_c,mesh.__originalOpacity__=(_d=mesh.__originalOpacity__)==null?mat.opacity:_d)});let setHoverColor=()=>{meshes.forEach(mesh=>{if(mesh.name===`ScaleHelperTransparentGroup`){if(mesh.children[0]){let childMat=mesh.children[0].material;childMat.color.set(hoverColor),childMat.opacity=hoverOpacity}}else{let mat=mesh.material;Array.isArray(mat)?mat.forEach(m=>{m.color.set(hoverColor),m.opacity=hoverOpacity}):(mat.color.set(hoverColor),mat.opacity=hoverOpacity)}}),this.render()},resetColor=()=>{meshes.forEach(mesh=>{if(mesh.name===`ScaleHelperTransparentGroup`){if(mesh.children[0]){let childMat=mesh.children[0].material;childMat.color.set(16776960),childMat.opacity=1}}else{let mat=mesh.material;if(Array.isArray(mat)){let originalColors=mesh.__originalColor__,originalOpacities=mesh.__originalOpacity__;mat.forEach((m,index)=>{originalColors&&originalColors[index]&&m.color.copy(originalColors[index]),originalOpacities&&originalOpacities[index]!==void 0&&(m.opacity=originalOpacities[index])})}else mat.color.copy(mesh.__originalColor__),mat.opacity=mesh.__originalOpacity__}}),this.render()},handleMouseover=_e=>{this.isDragging||setHoverColor()},handleMouseout=_e=>{this.isDragging||resetColor()};for(let mesh of meshes)this.domEvents.addEventListener(mesh,`mouseover`,handleMouseover),this.domEvents.addEventListener(mesh,`mouseout`,handleMouseout),this.hooks.on(`moveStart`,setHoverColor),this.hooks.on(`moveEnd`,resetColor),this.hooks.on(`rotateEnd`,resetColor),this.hooks.on(`scaleEnd`,resetColor),disposers.push(()=>{this.domEvents.removeEventListener(mesh,`mouseover`,handleMouseover),this.domEvents.removeEventListener(mesh,`mouseout`,handleMouseout),this.hooks.off(`moveStart`,setHoverColor),this.hooks.off(`moveEnd`,resetColor),this.hooks.off(`rotateEnd`,resetColor),this.hooks.off(`scaleEnd`,resetColor)})}return()=>disposers.forEach(disposer=>disposer==null?void 0:disposer())}getIntersectObject(raycaster){let cameraPosition=this.camera.position,object=this.helperObject3D;if(!object)return;let intersection=this.helperObject3D.raycasterIntersectObject(raycaster)[0];if(!intersection)return;let objectIntersection=intersection;if(objectIntersection.object=object,this.model.intersectRaycaster){let modelIntersection=this.model.intersectRaycaster(raycaster)[0];if(modelIntersection&&modelIntersection.point.distanceTo(cameraPosition)<objectIntersection.point.distanceTo(cameraPosition))return}return objectIntersection.object}calculateOffset(offset,box3){let result=new three_webgpu.Vector3(0,0,0);if(!offset)return result;let getBox=()=>box3||this.getBox();if(typeof offset.x==`number`)result.setX(offset.x);else if(typeof offset.x==`object`){let box=getBox();result.setX((box.max.x-box.min.x)*offset.x.percents)}if(typeof offset.y==`number`)result.setY(offset.y);else if(typeof offset.y==`object`){let box=getBox();result.setY((box.max.y-box.min.y)*offset.y.percents)}if(typeof offset.z==`number`)result.setZ(offset.z);else if(typeof offset.z==`object`){let box=getBox();result.setZ((box.max.z-box.min.z)*offset.z.percents)}return result}};exports.BaseController=BaseController;

package/plugins/Object3DHelperPlugin/Controllers/BaseController.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/import{isNil as e}from"../../../five/utils/isNil.mjs";import{cameraHooks as t}from"../utils/cameraHooks.mjs";import{Subscribe as n}from"@realsee/five-webgpu";import*as r from"three/webgpu";function i(e){return arguments.length===0?[]:Array.isArray(e)?e:[e]}var a=class{updateOtherControllers(e){this.otherControllers=e}getIsDragging(){return this.isDragging}constructor(e,i){var a,o,s;this.preventTapDefaultEvent=!1,this.disposers=[],this.isDragging=!1,this.enabled=!1,this.name=`BaseController`,this.onWantsTapGesture=e=>{if(this.getIntersectObject(e))return!1},this.updateHelperScale=()=>{`update`in this.helperObject3D&&typeof this.helperObject3D.update==`function`&&this.helperObject3D.update(this.camera),this.helperObject3D.setScaleByCamera(this.camera)},this.getBox=()=>(this.boundingBox||(this.boundingBox=new r.Box3().expandByObject(this.originObject3D)),this.boundingBox),this.hooks=(a=e.sharedHooks)==null?new n:a,this.internalHooks=(o=e.sharedInternalHooks)==null?new n:o,this.camera=e.camera,this.model=e.model,this.originObject3D=e.originObject3D,this.helperObject3D=e.helperObject3D,this.container=e.container,this.scene=e.scene,this.domEvents=e.domEvents,this.onRender=(s=e.onRender)==null?(()=>{}):s,this.config=i==null?{}:i,this.otherControllers=e.otherControllers,this.initialHelperPosition(),this.initialHelperQuaternion(),this.updateHelperScale(),this.cameraHooks=t(this.camera),this.enable();let c=this.onSetOriginObjectScale.bind(this),l=this.onSetOriginObjectRotate.bind(this),u=this.onSetOriginObjectPosition.bind(this),d=this.onApplyOriginObjectScale.bind(this),f=this.onApplyOriginObjectRotate.bind(this),p=this.onApplyOriginObjectPosition.bind(this),m=this.initialHelperPosition.bind(this);this.cameraHooks.on(`cameraUpdate`,this.updateHelperScale),this.internalHooks.on(`initialHelperPosition`,m),this.internalHooks.on(`setObjectScale`,c),this.internalHooks.on(`setObjectRotate`,l),this.internalHooks.on(`setObjectPosition`,u),this.internalHooks.on(`applyObjectPosition`,p),this.internalHooks.on(`applyObjectRotate`,f),this.internalHooks.on(`applyObjectScale`,d),this.hooks.on(`moveEnd`,this.updateHelperScale),this.internalHooks.on(`setObjectPosition`,this.updateHelperScale),this.internalHooks.on(`initialHelperPosition`,this.updateHelperScale),this.disposers.push(()=>{this.cameraHooks.off(`cameraUpdate`,this.updateHelperScale),this.internalHooks.off(`initialHelperPosition`,m),this.internalHooks.off(`setObjectScale`,c),this.internalHooks.off(`setObjectRotate`,l),this.internalHooks.off(`setObjectPosition`,u),this.internalHooks.off(`applyObjectPosition`,p),this.internalHooks.off(`applyObjectRotate`,f),this.internalHooks.off(`applyObjectScale`,d),this.hooks.off(`moveEnd`,this.updateHelperScale),this.internalHooks.off(`setObjectPosition`,this.updateHelperScale),this.internalHooks.off(`initialHelperPosition`,this.updateHelperScale)})}initialHelperPosition(){this.helperObject3D.initialPosition(this.calculateOffset(this.config.offset))}initialHelperQuaternion(){this.helperObject3D.initQuaternion(this.config)}enable(){this.enabled||(this.enabled=!0,this.scene.add(this.helperObject3D),this.helperObject3D.enable(),this.render())}disable(){this.enabled&&(this.enabled=!1,this.helperObject3D.disable(),this.render())}show(){this.helperObject3D.show(),this.render()}hide(){this.helperObject3D.hide(),this.render()}dispose(){var e;(e=this.disposers)==null||e.forEach(e=>e==null?void 0:e()),this.helperObject3D.dispose(),this.render()}applyHelperMatrix4(e){this.helperObject3D.applyMatrix4(e)}applyHelperQuaternion(e,t){this.helperObject3D.applyHelperQuaternion(e,t)}applyHelperScaleMatrix4(e,t){this.helperObject3D.applyHelperScaleMatrix4(e,t)}onWantsGesture(e,t,n){if(this.isDragging)return!1}onIntersectionOnModelUpdate(e){}onApplyOriginObjectScale(e){this.applyHelperScaleMatrix4(e.matrix,e.origin)}onApplyOriginObjectRotate(e){let t=e.origin;if(t){let n=new r.Vector3().subVectors(this.helperObject3D.position,t).applyQuaternion(e.quaternion).add(t);this.helperObject3D.position.copy(n)}}onApplyOriginObjectPosition(e){this.applyHelperMatrix4(e.matrix)}onSetOriginObjectScale(e){this.helperObject3D.scale.copy(e),this.updateOffsetByScale(e)}onSetOriginObjectRotate(e,t){}onSetOriginObjectPosition(e){this.helperObject3D.position.copy(e.clone().add(this.calculateOffset(this.config.offset)))}render(){this.onRender()}updateOffsetByScale(e){if(this.boundingBox&&this.config.offset){let t=this.originObject3D.position,n=new r.Vector3().subVectors(this.boundingBox.max,t).multiply(e).add(t),i=new r.Vector3().subVectors(this.boundingBox.min,t).multiply(e).add(t),a=this.calculateOffset(this.config.offset,{min:i,max:n});this.helperObject3D.initialPosition(a)}}hoverListener(t,n=16777215,a=1){let o=i(t).filter(t=>!e(t)),s=[];for(let e of o)if(e.material||e instanceof r.Group){let t=e instanceof r.Group?e.children.filter(e=>e instanceof r.Mesh):[e];t.forEach(e=>{var t,n,r,i;let a=e.material;Array.isArray(a)?(e.__originalColor__=(t=e.__originalColor__)==null?a.map(e=>e.color.clone()):t,e.__originalOpacity__=(n=e.__originalOpacity__)==null?a.map(e=>e.opacity):n):(e.__originalColor__=(r=e.__originalColor__)==null?a.color.clone():r,e.__originalOpacity__=(i=e.__originalOpacity__)==null?a.opacity:i)});let i=()=>{t.forEach(e=>{if(e.name===`ScaleHelperTransparentGroup`){if(e.children[0]){let t=e.children[0].material;t.color.set(n),t.opacity=a}}else{let t=e.material;Array.isArray(t)?t.forEach(e=>{e.color.set(n),e.opacity=a}):(t.color.set(n),t.opacity=a)}}),this.render()},o=()=>{t.forEach(e=>{if(e.name===`ScaleHelperTransparentGroup`){if(e.children[0]){let t=e.children[0].material;t.color.set(16776960),t.opacity=1}}else{let t=e.material;if(Array.isArray(t)){let n=e.__originalColor__,r=e.__originalOpacity__;t.forEach((e,t)=>{n&&n[t]&&e.color.copy(n[t]),r&&r[t]!==void 0&&(e.opacity=r[t])})}else t.color.copy(e.__originalColor__),t.opacity=e.__originalOpacity__}}),this.render()},c=e=>{this.isDragging||i()},l=e=>{this.isDragging||o()};for(let e of t)this.domEvents.addEventListener(e,`mouseover`,c),this.domEvents.addEventListener(e,`mouseout`,l),this.hooks.on(`moveStart`,i),this.hooks.on(`moveEnd`,o),this.hooks.on(`rotateEnd`,o),this.hooks.on(`scaleEnd`,o),s.push(()=>{this.domEvents.removeEventListener(e,`mouseover`,c),this.domEvents.removeEventListener(e,`mouseout`,l),this.hooks.off(`moveStart`,i),this.hooks.off(`moveEnd`,o),this.hooks.off(`rotateEnd`,o),this.hooks.off(`scaleEnd`,o)})}return()=>s.forEach(e=>e==null?void 0:e())}getIntersectObject(e){let t=this.camera.position,n=this.helperObject3D;if(!n)return;let r=this.helperObject3D.raycasterIntersectObject(e)[0];if(!r)return;let i=r;if(i.object=n,this.model.intersectRaycaster){let n=this.model.intersectRaycaster(e)[0];if(n&&n.point.distanceTo(t)<i.point.distanceTo(t))return}return i.object}calculateOffset(e,t){let n=new r.Vector3(0,0,0);if(!e)return n;let i=()=>t||this.getBox();if(typeof e.x==`number`)n.setX(e.x);else if(typeof e.x==`object`){let t=i();n.setX((t.max.x-t.min.x)*e.x.percents)}if(typeof e.y==`number`)n.setY(e.y);else if(typeof e.y==`object`){let t=i();n.setY((t.max.y-t.min.y)*e.y.percents)}if(typeof e.z==`number`)n.setZ(e.z);else if(typeof e.z==`object`){let t=i();n.setZ((t.max.z-t.min.z)*e.z.percents)}return n}};export{a as BaseController};
+*/import{isNil}from"../../../five/utils/isNil.mjs";import{cameraHooks}from"../utils/cameraHooks.mjs";import{Subscribe}from"@realsee/five-webgpu";import*as THREE from"three/webgpu";function toArray(value){return arguments.length===0?[]:Array.isArray(value)?value:[value]}var BaseController=class{updateOtherControllers(otherControllers){this.otherControllers=otherControllers}getIsDragging(){return this.isDragging}constructor(params,config){var _a,_b,_c;this.preventTapDefaultEvent=!1,this.disposers=[],this.isDragging=!1,this.enabled=!1,this.name=`BaseController`,this.onWantsTapGesture=raycaster=>{if(this.getIntersectObject(raycaster))return!1},this.updateHelperScale=()=>{`update`in this.helperObject3D&&typeof this.helperObject3D.update==`function`&&this.helperObject3D.update(this.camera),this.helperObject3D.setScaleByCamera(this.camera)},this.getBox=()=>(this.boundingBox||(this.boundingBox=new THREE.Box3().expandByObject(this.originObject3D)),this.boundingBox),this.hooks=(_a=params.sharedHooks)==null?new Subscribe:_a,this.internalHooks=(_b=params.sharedInternalHooks)==null?new Subscribe:_b,this.camera=params.camera,this.model=params.model,this.originObject3D=params.originObject3D,this.helperObject3D=params.helperObject3D,this.container=params.container,this.scene=params.scene,this.domEvents=params.domEvents,this.onRender=(_c=params.onRender)==null?(()=>{}):_c,this.config=config==null?{}:config,this.otherControllers=params.otherControllers,this.initialHelperPosition(),this.initialHelperQuaternion(),this.updateHelperScale(),this.cameraHooks=cameraHooks(this.camera),this.enable();let handleSetObjectScale=this.onSetOriginObjectScale.bind(this),handleSetObjectRotate=this.onSetOriginObjectRotate.bind(this),handleSetObjectPosition=this.onSetOriginObjectPosition.bind(this),handleApplyObjectScale=this.onApplyOriginObjectScale.bind(this),handleApplyObjectRotate=this.onApplyOriginObjectRotate.bind(this),handleApplyObjectPosition=this.onApplyOriginObjectPosition.bind(this),initialHelperPosition=this.initialHelperPosition.bind(this);this.cameraHooks.on(`cameraUpdate`,this.updateHelperScale),this.internalHooks.on(`initialHelperPosition`,initialHelperPosition),this.internalHooks.on(`setObjectScale`,handleSetObjectScale),this.internalHooks.on(`setObjectRotate`,handleSetObjectRotate),this.internalHooks.on(`setObjectPosition`,handleSetObjectPosition),this.internalHooks.on(`applyObjectPosition`,handleApplyObjectPosition),this.internalHooks.on(`applyObjectRotate`,handleApplyObjectRotate),this.internalHooks.on(`applyObjectScale`,handleApplyObjectScale),this.hooks.on(`moveEnd`,this.updateHelperScale),this.internalHooks.on(`setObjectPosition`,this.updateHelperScale),this.internalHooks.on(`initialHelperPosition`,this.updateHelperScale),this.disposers.push(()=>{this.cameraHooks.off(`cameraUpdate`,this.updateHelperScale),this.internalHooks.off(`initialHelperPosition`,initialHelperPosition),this.internalHooks.off(`setObjectScale`,handleSetObjectScale),this.internalHooks.off(`setObjectRotate`,handleSetObjectRotate),this.internalHooks.off(`setObjectPosition`,handleSetObjectPosition),this.internalHooks.off(`applyObjectPosition`,handleApplyObjectPosition),this.internalHooks.off(`applyObjectRotate`,handleApplyObjectRotate),this.internalHooks.off(`applyObjectScale`,handleApplyObjectScale),this.hooks.off(`moveEnd`,this.updateHelperScale),this.internalHooks.off(`setObjectPosition`,this.updateHelperScale),this.internalHooks.off(`initialHelperPosition`,this.updateHelperScale)})}initialHelperPosition(){this.helperObject3D.initialPosition(this.calculateOffset(this.config.offset))}initialHelperQuaternion(){this.helperObject3D.initQuaternion(this.config)}enable(){this.enabled||(this.enabled=!0,this.scene.add(this.helperObject3D),this.helperObject3D.enable(),this.render())}disable(){this.enabled&&(this.enabled=!1,this.helperObject3D.disable(),this.render())}show(){this.helperObject3D.show(),this.render()}hide(){this.helperObject3D.hide(),this.render()}dispose(){var _a;(_a=this.disposers)==null||_a.forEach(d=>d==null?void 0:d()),this.helperObject3D.dispose(),this.render()}applyHelperMatrix4(matrix){this.helperObject3D.applyMatrix4(matrix)}applyHelperQuaternion(quaternion,origin){this.helperObject3D.applyHelperQuaternion(quaternion,origin)}applyHelperScaleMatrix4(matrix,origin){this.helperObject3D.applyHelperScaleMatrix4(matrix,origin)}onWantsGesture(type,pointers,final){if(this.isDragging)return!1}onIntersectionOnModelUpdate(intersection){}onApplyOriginObjectScale(params){this.applyHelperScaleMatrix4(params.matrix,params.origin)}onApplyOriginObjectRotate(params){let origin=params.origin;if(origin){let v=new THREE.Vector3().subVectors(this.helperObject3D.position,origin).applyQuaternion(params.quaternion).add(origin);this.helperObject3D.position.copy(v)}}onApplyOriginObjectPosition(params){this.applyHelperMatrix4(params.matrix)}onSetOriginObjectScale(scale){this.helperObject3D.scale.copy(scale),this.updateOffsetByScale(scale)}onSetOriginObjectRotate(_quaternion,_origin){}onSetOriginObjectPosition(position){this.helperObject3D.position.copy(position.clone().add(this.calculateOffset(this.config.offset)))}render(){this.onRender()}updateOffsetByScale(scale){if(this.boundingBox&&this.config.offset){let origin=this.originObject3D.position,max=new THREE.Vector3().subVectors(this.boundingBox.max,origin).multiply(scale).add(origin),min=new THREE.Vector3().subVectors(this.boundingBox.min,origin).multiply(scale).add(origin),offset=this.calculateOffset(this.config.offset,{min,max});this.helperObject3D.initialPosition(offset)}}hoverListener(object3D,hoverColor=16777215,hoverOpacity=1){let objects=toArray(object3D).filter(object=>!isNil(object)),disposers=[];for(let object of objects)if(object.material||object instanceof THREE.Group){let meshes=object instanceof THREE.Group?object.children.filter(child=>child instanceof THREE.Mesh):[object];meshes.forEach(mesh=>{var _a,_b,_c,_d;let mat=mesh.material;Array.isArray(mat)?(mesh.__originalColor__=(_a=mesh.__originalColor__)==null?mat.map(m=>m.color.clone()):_a,mesh.__originalOpacity__=(_b=mesh.__originalOpacity__)==null?mat.map(m=>m.opacity):_b):(mesh.__originalColor__=(_c=mesh.__originalColor__)==null?mat.color.clone():_c,mesh.__originalOpacity__=(_d=mesh.__originalOpacity__)==null?mat.opacity:_d)});let setHoverColor=()=>{meshes.forEach(mesh=>{if(mesh.name===`ScaleHelperTransparentGroup`){if(mesh.children[0]){let childMat=mesh.children[0].material;childMat.color.set(hoverColor),childMat.opacity=hoverOpacity}}else{let mat=mesh.material;Array.isArray(mat)?mat.forEach(m=>{m.color.set(hoverColor),m.opacity=hoverOpacity}):(mat.color.set(hoverColor),mat.opacity=hoverOpacity)}}),this.render()},resetColor=()=>{meshes.forEach(mesh=>{if(mesh.name===`ScaleHelperTransparentGroup`){if(mesh.children[0]){let childMat=mesh.children[0].material;childMat.color.set(16776960),childMat.opacity=1}}else{let mat=mesh.material;if(Array.isArray(mat)){let originalColors=mesh.__originalColor__,originalOpacities=mesh.__originalOpacity__;mat.forEach((m,index)=>{originalColors&&originalColors[index]&&m.color.copy(originalColors[index]),originalOpacities&&originalOpacities[index]!==void 0&&(m.opacity=originalOpacities[index])})}else mat.color.copy(mesh.__originalColor__),mat.opacity=mesh.__originalOpacity__}}),this.render()},handleMouseover=_e=>{this.isDragging||setHoverColor()},handleMouseout=_e=>{this.isDragging||resetColor()};for(let mesh of meshes)this.domEvents.addEventListener(mesh,`mouseover`,handleMouseover),this.domEvents.addEventListener(mesh,`mouseout`,handleMouseout),this.hooks.on(`moveStart`,setHoverColor),this.hooks.on(`moveEnd`,resetColor),this.hooks.on(`rotateEnd`,resetColor),this.hooks.on(`scaleEnd`,resetColor),disposers.push(()=>{this.domEvents.removeEventListener(mesh,`mouseover`,handleMouseover),this.domEvents.removeEventListener(mesh,`mouseout`,handleMouseout),this.hooks.off(`moveStart`,setHoverColor),this.hooks.off(`moveEnd`,resetColor),this.hooks.off(`rotateEnd`,resetColor),this.hooks.off(`scaleEnd`,resetColor)})}return()=>disposers.forEach(disposer=>disposer==null?void 0:disposer())}getIntersectObject(raycaster){let cameraPosition=this.camera.position,object=this.helperObject3D;if(!object)return;let intersection=this.helperObject3D.raycasterIntersectObject(raycaster)[0];if(!intersection)return;let objectIntersection=intersection;if(objectIntersection.object=object,this.model.intersectRaycaster){let modelIntersection=this.model.intersectRaycaster(raycaster)[0];if(modelIntersection&&modelIntersection.point.distanceTo(cameraPosition)<objectIntersection.point.distanceTo(cameraPosition))return}return objectIntersection.object}calculateOffset(offset,box3){let result=new THREE.Vector3(0,0,0);if(!offset)return result;let getBox=()=>box3||this.getBox();if(typeof offset.x==`number`)result.setX(offset.x);else if(typeof offset.x==`object`){let box=getBox();result.setX((box.max.x-box.min.x)*offset.x.percents)}if(typeof offset.y==`number`)result.setY(offset.y);else if(typeof offset.y==`object`){let box=getBox();result.setY((box.max.y-box.min.y)*offset.y.percents)}if(typeof offset.z==`number`)result.setZ(offset.z);else if(typeof offset.z==`object`){let box=getBox();result.setZ((box.max.z-box.min.z)*offset.z.percents)}return result}};export{BaseController};

package/plugins/Object3DHelperPlugin/Controllers/BoundingBoxController.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/const e=require("./BaseController.js");var t=class extends e.BaseController{constructor(...e){super(...e),this.name=`BoundingBoxController`;let t=()=>{this.syncWithObject(),this.render()};this.hooks.on(`moveEnd`,t),this.hooks.on(`rotateEnd`,t),this.hooks.on(`scaleEnd`,t),this.disposers.push(()=>{this.hooks.off(`moveEnd`,t),this.hooks.off(`rotateEnd`,t),this.hooks.off(`scaleEnd`,t)})}onApplyOriginObjectRotate(e){this.helperObject3D.applyHelperQuaternion(e.quaternion,e.origin)}onSetOriginObjectRotate(e,t){this.helperObject3D.setHelperQuaternion(e,t)}syncWithObject(){this.helperObject3D.position.copy(this.originObject3D.position),this.helperObject3D.quaternion.copy(this.originObject3D.quaternion),this.helperObject3D.scale.copy(this.originObject3D.scale);let e=this.helperObject3D;e.update&&e.update()}};exports.BoundingBoxController=t;
+*/const require_BaseController=require("./BaseController.js");var BoundingBoxController=class extends require_BaseController.BaseController{constructor(...params){super(...params),this.name=`BoundingBoxController`;let syncAndUpdate=()=>{this.syncWithObject(),this.render()};this.hooks.on(`moveEnd`,syncAndUpdate),this.hooks.on(`rotateEnd`,syncAndUpdate),this.hooks.on(`scaleEnd`,syncAndUpdate),this.disposers.push(()=>{this.hooks.off(`moveEnd`,syncAndUpdate),this.hooks.off(`rotateEnd`,syncAndUpdate),this.hooks.off(`scaleEnd`,syncAndUpdate)})}onApplyOriginObjectRotate(params){this.helperObject3D.applyHelperQuaternion(params.quaternion,params.origin)}onSetOriginObjectRotate(quaternion,origin){this.helperObject3D.setHelperQuaternion(quaternion,origin)}syncWithObject(){this.helperObject3D.position.copy(this.originObject3D.position),this.helperObject3D.quaternion.copy(this.originObject3D.quaternion),this.helperObject3D.scale.copy(this.originObject3D.scale);let helper=this.helperObject3D;helper.update&&helper.update()}};exports.BoundingBoxController=BoundingBoxController;

package/plugins/Object3DHelperPlugin/Controllers/BoundingBoxController.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/import{BaseController as e}from"./BaseController.mjs";var t=class extends e{constructor(...e){super(...e),this.name=`BoundingBoxController`;let t=()=>{this.syncWithObject(),this.render()};this.hooks.on(`moveEnd`,t),this.hooks.on(`rotateEnd`,t),this.hooks.on(`scaleEnd`,t),this.disposers.push(()=>{this.hooks.off(`moveEnd`,t),this.hooks.off(`rotateEnd`,t),this.hooks.off(`scaleEnd`,t)})}onApplyOriginObjectRotate(e){this.helperObject3D.applyHelperQuaternion(e.quaternion,e.origin)}onSetOriginObjectRotate(e,t){this.helperObject3D.setHelperQuaternion(e,t)}syncWithObject(){this.helperObject3D.position.copy(this.originObject3D.position),this.helperObject3D.quaternion.copy(this.originObject3D.quaternion),this.helperObject3D.scale.copy(this.originObject3D.scale);let e=this.helperObject3D;e.update&&e.update()}};export{t as BoundingBoxController};
+*/import{BaseController}from"./BaseController.mjs";var BoundingBoxController=class extends BaseController{constructor(...params){super(...params),this.name=`BoundingBoxController`;let syncAndUpdate=()=>{this.syncWithObject(),this.render()};this.hooks.on(`moveEnd`,syncAndUpdate),this.hooks.on(`rotateEnd`,syncAndUpdate),this.hooks.on(`scaleEnd`,syncAndUpdate),this.disposers.push(()=>{this.hooks.off(`moveEnd`,syncAndUpdate),this.hooks.off(`rotateEnd`,syncAndUpdate),this.hooks.off(`scaleEnd`,syncAndUpdate)})}onApplyOriginObjectRotate(params){this.helperObject3D.applyHelperQuaternion(params.quaternion,params.origin)}onSetOriginObjectRotate(quaternion,origin){this.helperObject3D.setHelperQuaternion(quaternion,origin)}syncWithObject(){this.helperObject3D.position.copy(this.originObject3D.position),this.helperObject3D.quaternion.copy(this.originObject3D.quaternion),this.helperObject3D.scale.copy(this.originObject3D.scale);let helper=this.helperObject3D;helper.update&&helper.update()}};export{BoundingBoxController};

package/plugins/Object3DHelperPlugin/Controllers/MoveController.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/30
- * Version: 1.0.0-alpha.13
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/const e=require("../../../_virtual/_rolldown/runtime.js"),t=require("../constant.js"),n=require("../utils/CenterHandle.js"),r=require("./BaseController.js"),i=require("../utils/solidGuide.js"),a=require("../utils/getMouseRaycaster.js");let o=require("three/webgpu");o=e.__toESM(o,1);function s(e){let{raycaster:t,line:n,clampToLine:r=!0}=e,i=new o.Plane().setFromNormalAndCoplanarPoint(t.ray.direction.clone().normalize(),new o.Vector3),a=i.projectPoint(n.start,new o.Vector3),s=i.projectPoint(n.end,new o.Vector3),c=new o.Line3(a,s),l=c.closestPointToPoint(t.ray.origin,r,new o.Vector3),u=l.distanceTo(s),d=l.distanceTo(a),f=c.distance();if(u>d&&u>f){let e=-l.distanceTo(a)/f,t=n.start.clone().sub(n.end).normalize();return n.start.clone().sub(t.clone().multiplyScalar(e*n.distance()))}else{let e=l.distanceTo(a)/f;return new o.Vector3().lerpVectors(n.start,n.end,e)}}var c=class extends r.BaseController{get moveByMouseEnable(){return this._moveByMouse.enabled}constructor(...e){var r,s,c,l,u;super(...e),this.name=`MoveController`,this.solidGuide=new i.SolidGuideLine(this.camera,this.container,(s=(r=this.config)==null?void 0:r.solidGuide)==null?{}:s),this._moveByMouse={enabled:!1},this.dragStart=e=>{if(this.moveByMouseEnable||this.isDragging)return;let n=e==null?void 0:e.intersect;if(!n)return this.dragEnd();let r=(n==null?void 0:n.object).direction;if(!r)return this.dragEnd();let i=new o.Vector3(1,0,0),a=new o.Vector3(0,1,0),s=new o.Vector3(0,0,1),c=(()=>{switch(r){case`x`:return i;case`y`:return a;case`z`:return s;case`xy`:case`xz`:case`yz`:case`plane`:return}})(),l=n.point.clone();if(r===`xy`||r===`xz`||r===`yz`){let e=(()=>{switch(r){case`xy`:return s;case`xz`:return a;case`yz`:return i}})(),t=new o.Plane().setFromNormalAndCoplanarPoint(e,l),n=l.clone();this.startInfo={draggingDirection:r,startVectorProject:n,line:new o.Line3(n.clone(),n.clone()),plane:t}}else if(r===`plane`){let e=this.camera.position.clone(),t=l.clone(),n=t.clone().sub(e).normalize(),i=new o.Plane().setFromNormalAndCoplanarPoint(n,t),a=t.clone();this.startInfo={draggingDirection:r,startVectorProject:a,line:new o.Line3(a.clone(),a.clone()),plane:i}}else{if(!c)return this.dragEnd();let e=new o.Line3(l.clone().sub(c.normalize()),l.clone().add(c.normalize()));this.startInfo={draggingDirection:r,startVectorProject:l,line:e};try{let e=c.clone().normalize(),n=this.helperObject3D.getWorldPosition(new o.Vector3),r=this.solidGuide.createSolidLine(n,e,{color:16777215,renderOrder:t.RENDER_ORDER.DRAG_GUIDE_LINE});this.scene.add(r),this.dragGuideLine=r}catch(e){}}let u=(()=>{switch(r){case`plane`:return[];case`xy`:return[`x`,`y`,`xy`];case`xz`:return[`x`,`z`,`xz`];case`yz`:return[`y`,`z`,`yz`];default:return[r]}})();this.helperObject3D.showDraggingHelper(u),this.hooks.emit(`moveStart`,r),this.isDragging=!0,this.setTipsText(this.originObject3D.position),this.setTipsPosition(l)},this.dragging=e=>{if(!this.isDragging||!this.startInfo)return;let t=`touches`in e?e.touches[0].clientX:e.x,n=`touches`in e?e.touches[0].clientY:e.y,r=a.getMouseRaycaster(this.camera,{x:t,y:n},this.container);return r?(this.move(r),!1):this.dragEnd()},this.dragEnd=()=>{if(this.isDragging){if(this.startInfo=void 0,this.isDragging=!1,this.dragGuideLine){this.scene.remove(this.dragGuideLine),this.dragGuideLine.geometry.dispose();let e=this.dragGuideLine.material;Array.isArray(e)?e.forEach(e=>e.dispose()):e.dispose(),this.dragGuideLine=void 0}this.helperObject3D.show(),this.hooks.emit(`moveEnd`)}};let d=this.helperObject3D;if(this.hoverListener([d.xArrow,d.yArrow,d.zArrow,(c=d.xyPlane)==null?void 0:c.handle,(l=d.xzPlane)==null?void 0:l.handle,(u=d.yzPlane)==null?void 0:u.handle]),d.centerHandle&&d.centerHandle instanceof n.CenterHandle){let e=d.centerHandle,t=e.cube;this.domEvents.addEventListener(t,`mouseover`,()=>{this.isDragging||(Array.isArray(t.material)&&t.material.forEach(e=>{e.color.set(16777215)}),this.render())}),this.domEvents.addEventListener(t,`mouseout`,()=>{this.isDragging||(e.update(this.camera),this.render())})}let f=this.show.bind(this),p=this.hide.bind(this),m=()=>{this.helperObject3D.update(this.camera),this.isDragging&&this.updateDragGuideLineScale(),this.render()};m(),this.domEvents.addEventListener(this.helperObject3D,`mousedown`,this.dragStart),document.addEventListener(`mousemove`,this.dragging),document.addEventListener(`mouseup`,this.dragEnd),this.domEvents.addEventListener(this.helperObject3D,`touchstart`,this.dragStart),document.addEventListener(`touchmove`,this.dragging),document.addEventListener(`touchend`,this.dragEnd),this.hooks.on(`rotateStart`,p),this.hooks.on(`rotateEnd`,f),this.hooks.on(`scaleStart`,p),this.hooks.on(`scaleEnd`,f),this.hooks.on(`moveByMouseEnable`,p),this.hooks.on(`moveByMouseDisable`,f),this.hooks.on(`updateOtherHelpers`,e=>{this.helperObject3D.update(e.camera),this.render()}),this.cameraHooks.on(`cameraUpdate`,m),this.disposers.push(()=>{this.domEvents.removeEventListener(this.helperObject3D,`mousedown`,this.dragStart),document.removeEventListener(`mousemove`,this.dragging),document.removeEventListener(`mouseup`,this.dragEnd),this.domEvents.removeEventListener(this.helperObject3D,`touchstart`,this.dragStart),document.removeEventListener(`touchmove`,this.dragging),document.removeEventListener(`touchend`,this.dragEnd),this.hooks.off(`rotateStart`,p),this.hooks.off(`rotateEnd`,f),this.hooks.off(`scaleStart`,p),this.hooks.off(`scaleEnd`,f),this.hooks.off(`moveByMouseEnable`,p),this.hooks.off(`moveByMouseDisable`,f),this.hooks.off(`updateOtherHelpers`),this.cameraHooks.off(`cameraUpdate`,m)}),this.moveByMouseEnable&&this.moveByMouse()}dispose(){var e;super.dispose(),(e=this.disposers)==null||e.forEach(e=>e==null?void 0:e())}moveByMouse(e){this._moveByMouse={enabled:!0,useFaceNormal:e==null?void 0:e.useFaceNormal},this.preventTapDefaultEvent=!0;let t=this.handleMouseDown.bind(this),n=this.handleMouseUp.bind(this);this.hooks.emit(`moveByMouseEnable`),setTimeout(()=>{this.container.addEventListener(`mousedown`,t),this.container.addEventListener(`mouseup`,n)}),this.mousedownEventListenerDisposer=()=>{this.container.removeEventListener(`mousedown`,t),this.container.removeEventListener(`mouseup`,n)}}disableMoveByMouse(){var e;this._moveByMouse={enabled:!1},this.preventTapDefaultEvent=!1,this.hooks.emit(`moveByMouseDisable`),(e=this.mousedownEventListenerDisposer)==null||e.call(this)}onIntersectionOnModelUpdate(e){var t,n,r;if(!this.moveByMouseEnable)return;let{point:i,face:a}=e;if(!this.hooks.emit(`wantToMove`,i)){if(this.originObject3D.position.copy(i),(this._moveByMouse.useFaceNormal===!0||typeof this._moveByMouse.useFaceNormal==`object`&&this._moveByMouse.useFaceNormal.enable!==!1)&&a!=null&&a.normal){let e=typeof this._moveByMouse.useFaceNormal==`object`&&this._moveByMouse.useFaceNormal.alignmentVector?this._moveByMouse.useFaceNormal.alignmentVector:{x:0,y:1,z:0},i=new o.Vector3((t=e.x)==null?0:t,(n=e.y)==null?0:n,(r=e.z)==null?0:r),s=typeof this._moveByMouse.useFaceNormal==`object`&&this._moveByMouse.useFaceNormal.fixedFaceNormal?this._moveByMouse.useFaceNormal.fixedFaceNormal(a.normal):a.normal;this.originObject3D.quaternion.setFromUnitVectors(i,s),this.internalHooks.emit(`setObjectRotate`,this.originObject3D.quaternion.clone(),new o.Vector3)}this.internalHooks.emit(`setObjectPosition`,i),this.hooks.emit(`move`,i)}}handleMouseDown(e){let{x:t,y:n}=e;this.mouseInfo={x:t,y:n,mouseDownTimestamp:Date.now()}}handleMouseUp(e){if(!this.mouseInfo)return;let{x:t,y:n}=e;this.mouseInfo.x===t&&this.mouseInfo.y===n&&Date.now()-this.mouseInfo.mouseDownTimestamp<500&&(this.disableMoveByMouse(),this.mouseInfo=void 0)}updateDragGuideLineScale(){if(!this.dragGuideLine||!this.startInfo)return;let{line:e}=this.startInfo,t=e.end.clone().sub(e.start).normalize();if(t.lengthSq()<1e-6)return;let n=this.helperObject3D.getWorldPosition(new o.Vector3);this.solidGuide.updateSolidLine(this.dragGuideLine,n,t)}move(e){if(!this.startInfo)return this.dragEnd();let{line:t,startVectorProject:n}=this.startInfo,r=this.originObject3D,i=this.startInfo.draggingDirection===`plane`||this.startInfo.draggingDirection===`xy`||this.startInfo.draggingDirection===`xz`||this.startInfo.draggingDirection===`yz`,a;if(i){let t=this.startInfo.plane;if(!t)return;let n=new o.Vector3,r=t.normal.dot(e.ray.direction);if(Math.abs(r)<1e-6)return;let i=-(t.normal.dot(e.ray.origin)+t.constant)/r;if(i<0)return;n.copy(e.ray.origin.clone().add(e.ray.direction.clone().multiplyScalar(i))),a=n}else a=s({raycaster:e,line:t,clampToLine:!1});let c=r.position.clone(),l=a.clone().sub(n),u=new o.Matrix4;u.setPosition(l);let d=r.position.clone().applyMatrix4(u);if(this.hooks.emit(`wantToMove`,d))return;let f=d.clone();this.hooks.emit(`moveBefore`,f);let p=new o.Matrix4;p.setPosition(f.clone().sub(c)),r.position.copy(f),this.setTipsText(f),this.setTipsPosition(f),n.copy(a),this.internalHooks.emit(`applyObjectPosition`,{matrix:p}),this.hooks.emit(`move`,f)}setTipsText(e){var t;let n=(t=this.helperObject3D.moveTips)==null?void 0:t.element;if(!n||!this.startInfo)return;let r=this.startInfo.draggingDirection,i=e=>e.toFixed(3);switch(r){case`x`:n.innerText=`x: ${i(e.x)}`;break;case`y`:n.innerText=`y: ${i(e.y)}`;break;case`z`:n.innerText=`z: ${i(e.z)}`;break;case`xy`:n.innerText=`x: ${i(e.x)}  y: ${i(e.y)}`;break;case`xz`:n.innerText=`x: ${i(e.x)}  z: ${i(e.z)}`;break;case`yz`:n.innerText=`y: ${i(e.y)}  z: ${i(e.z)}`;break;case`plane`:n.innerText=`x: ${i(e.x)}  y: ${i(e.y)}  z: ${i(e.z)}`;break}}setTipsPosition(e){let t=this.helperObject3D.moveTips;if(!t)return;let{x:n,y:r,z:i}=this.helperObject3D.getWorldPosition(new o.Vector3).clone().project(this.camera);if(i>1){t.hide();return}let a=this.container.getBoundingClientRect(),s=(n+1)/2*a.width,c=(-r+1)/2*a.height;t.setLeftTop(s+`px`,c+`px`)}};exports.MoveController=c,exports.rayOnLine=s;
+*/const require_runtime=require("../../../_virtual/_rolldown/runtime.js"),require_constant=require("../constant.js"),require_CenterHandle=require("../utils/CenterHandle.js"),require_BaseController=require("./BaseController.js"),require_solidGuide=require("../utils/solidGuide.js"),require_getMouseRaycaster=require("../utils/getMouseRaycaster.js");let three_webgpu=require("three/webgpu");three_webgpu=require_runtime.__toESM(three_webgpu,1);function rayOnLine(params){let{raycaster,line,clampToLine=!0}=params,cameraPlane=new three_webgpu.Plane().setFromNormalAndCoplanarPoint(raycaster.ray.direction.clone().normalize(),new three_webgpu.Vector3),lineStartPointOnPlane=cameraPlane.projectPoint(line.start,new three_webgpu.Vector3),lineEndPointOnPlane=cameraPlane.projectPoint(line.end,new three_webgpu.Vector3),lineOnPlane=new three_webgpu.Line3(lineStartPointOnPlane,lineEndPointOnPlane),intersectionPointOnLineOnPlane=lineOnPlane.closestPointToPoint(raycaster.ray.origin,clampToLine,new three_webgpu.Vector3),pointToEndDistance=intersectionPointOnLineOnPlane.distanceTo(lineEndPointOnPlane),pointToStartDistance=intersectionPointOnLineOnPlane.distanceTo(lineStartPointOnPlane),lineOnPlaneDistance=lineOnPlane.distance();if(pointToEndDistance>pointToStartDistance&&pointToEndDistance>lineOnPlaneDistance){let distanceScale=-intersectionPointOnLineOnPlane.distanceTo(lineStartPointOnPlane)/lineOnPlaneDistance,lineVector=line.start.clone().sub(line.end).normalize();return line.start.clone().sub(lineVector.clone().multiplyScalar(distanceScale*line.distance()))}else{let distanceScale=intersectionPointOnLineOnPlane.distanceTo(lineStartPointOnPlane)/lineOnPlaneDistance;return new three_webgpu.Vector3().lerpVectors(line.start,line.end,distanceScale)}}var MoveController=class extends require_BaseController.BaseController{get moveByMouseEnable(){return this._moveByMouse.enabled}constructor(...params){var _a,_b,_c,_d,_e;super(...params),this.name=`MoveController`,this.solidGuide=new require_solidGuide.SolidGuideLine(this.camera,this.container,(_b=(_a=this.config)==null?void 0:_a.solidGuide)==null?{}:_b),this._moveByMouse={enabled:!1},this.dragStart=params=>{if(this.moveByMouseEnable||this.isDragging)return;let intersect=params==null?void 0:params.intersect;if(!intersect)return this.dragEnd();let draggingDirection=(intersect==null?void 0:intersect.object).direction;if(!draggingDirection)return this.dragEnd();let directionX=new three_webgpu.Vector3(1,0,0),directionY=new three_webgpu.Vector3(0,1,0),directionZ=new three_webgpu.Vector3(0,0,1),directionVector=(()=>{switch(draggingDirection){case`x`:return directionX;case`y`:return directionY;case`z`:return directionZ;case`xy`:case`xz`:case`yz`:case`plane`:return}})(),startIntersect=intersect.point.clone();if(draggingDirection===`xy`||draggingDirection===`xz`||draggingDirection===`yz`){let planeNormal=(()=>{switch(draggingDirection){case`xy`:return directionZ;case`xz`:return directionY;case`yz`:return directionX}})(),plane=new three_webgpu.Plane().setFromNormalAndCoplanarPoint(planeNormal,startIntersect),startProject=startIntersect.clone();this.startInfo={draggingDirection,startVectorProject:startProject,line:new three_webgpu.Line3(startProject.clone(),startProject.clone()),plane}}else if(draggingDirection===`plane`){let cameraPosition=this.camera.position.clone(),clickPoint=startIntersect.clone(),viewDirection=clickPoint.clone().sub(cameraPosition).normalize(),plane=new three_webgpu.Plane().setFromNormalAndCoplanarPoint(viewDirection,clickPoint),startProject=clickPoint.clone();this.startInfo={draggingDirection,startVectorProject:startProject,line:new three_webgpu.Line3(startProject.clone(),startProject.clone()),plane}}else{if(!directionVector)return this.dragEnd();let line=new three_webgpu.Line3(startIntersect.clone().sub(directionVector.normalize()),startIntersect.clone().add(directionVector.normalize()));this.startInfo={draggingDirection,startVectorProject:startIntersect,line};try{let dirNormalized=directionVector.clone().normalize(),center=this.helperObject3D.getWorldPosition(new three_webgpu.Vector3),line=this.solidGuide.createSolidLine(center,dirNormalized,{color:16777215,renderOrder:require_constant.RENDER_ORDER.DRAG_GUIDE_LINE});this.scene.add(line),this.dragGuideLine=line}catch(_a){}}let directionsToShow=(()=>{switch(draggingDirection){case`plane`:return[];case`xy`:return[`x`,`y`,`xy`];case`xz`:return[`x`,`z`,`xz`];case`yz`:return[`y`,`z`,`yz`];default:return[draggingDirection]}})();this.helperObject3D.showDraggingHelper(directionsToShow),this.hooks.emit(`moveStart`,draggingDirection),this.isDragging=!0,this.setTipsText(this.originObject3D.position),this.setTipsPosition(startIntersect)},this.dragging=point=>{if(!this.isDragging||!this.startInfo)return;let x=`touches`in point?point.touches[0].clientX:point.x,y=`touches`in point?point.touches[0].clientY:point.y,ray=require_getMouseRaycaster.getMouseRaycaster(this.camera,{x,y},this.container);return ray?(this.move(ray),!1):this.dragEnd()},this.dragEnd=()=>{if(this.isDragging){if(this.startInfo=void 0,this.isDragging=!1,this.dragGuideLine){this.scene.remove(this.dragGuideLine),this.dragGuideLine.geometry.dispose();let material=this.dragGuideLine.material;Array.isArray(material)?material.forEach(m=>m.dispose()):material.dispose(),this.dragGuideLine=void 0}this.helperObject3D.show(),this.hooks.emit(`moveEnd`)}};let helper=this.helperObject3D;if(this.hoverListener([helper.xArrow,helper.yArrow,helper.zArrow,(_c=helper.xyPlane)==null?void 0:_c.handle,(_d=helper.xzPlane)==null?void 0:_d.handle,(_e=helper.yzPlane)==null?void 0:_e.handle]),helper.centerHandle&&helper.centerHandle instanceof require_CenterHandle.CenterHandle){let centerHandle=helper.centerHandle,centerHandleMesh=centerHandle.cube;this.domEvents.addEventListener(centerHandleMesh,`mouseover`,()=>{this.isDragging||(Array.isArray(centerHandleMesh.material)&&centerHandleMesh.material.forEach(mat=>{mat.color.set(16777215)}),this.render())}),this.domEvents.addEventListener(centerHandleMesh,`mouseout`,()=>{this.isDragging||(centerHandle.update(this.camera),this.render())})}let show=this.show.bind(this),hide=this.hide.bind(this),updateHelperByCamera=()=>{this.helperObject3D.update(this.camera),this.isDragging&&this.updateDragGuideLineScale(),this.render()};updateHelperByCamera(),this.domEvents.addEventListener(this.helperObject3D,`mousedown`,this.dragStart),document.addEventListener(`mousemove`,this.dragging),document.addEventListener(`mouseup`,this.dragEnd),this.domEvents.addEventListener(this.helperObject3D,`touchstart`,this.dragStart),document.addEventListener(`touchmove`,this.dragging),document.addEventListener(`touchend`,this.dragEnd),this.hooks.on(`rotateStart`,hide),this.hooks.on(`rotateEnd`,show),this.hooks.on(`scaleStart`,hide),this.hooks.on(`scaleEnd`,show),this.hooks.on(`moveByMouseEnable`,hide),this.hooks.on(`moveByMouseDisable`,show),this.hooks.on(`updateOtherHelpers`,params=>{this.helperObject3D.update(params.camera),this.render()}),this.cameraHooks.on(`cameraUpdate`,updateHelperByCamera),this.disposers.push(()=>{this.domEvents.removeEventListener(this.helperObject3D,`mousedown`,this.dragStart),document.removeEventListener(`mousemove`,this.dragging),document.removeEventListener(`mouseup`,this.dragEnd),this.domEvents.removeEventListener(this.helperObject3D,`touchstart`,this.dragStart),document.removeEventListener(`touchmove`,this.dragging),document.removeEventListener(`touchend`,this.dragEnd),this.hooks.off(`rotateStart`,hide),this.hooks.off(`rotateEnd`,show),this.hooks.off(`scaleStart`,hide),this.hooks.off(`scaleEnd`,show),this.hooks.off(`moveByMouseEnable`,hide),this.hooks.off(`moveByMouseDisable`,show),this.hooks.off(`updateOtherHelpers`),this.cameraHooks.off(`cameraUpdate`,updateHelperByCamera)}),this.moveByMouseEnable&&this.moveByMouse()}dispose(){var _a;super.dispose(),(_a=this.disposers)==null||_a.forEach(d=>d==null?void 0:d())}moveByMouse(params){this._moveByMouse={enabled:!0,useFaceNormal:params==null?void 0:params.useFaceNormal},this.preventTapDefaultEvent=!0;let mousedownListener=this.handleMouseDown.bind(this),mouseupListener=this.handleMouseUp.bind(this);this.hooks.emit(`moveByMouseEnable`),setTimeout(()=>{this.container.addEventListener(`mousedown`,mousedownListener),this.container.addEventListener(`mouseup`,mouseupListener)}),this.mousedownEventListenerDisposer=()=>{this.container.removeEventListener(`mousedown`,mousedownListener),this.container.removeEventListener(`mouseup`,mouseupListener)}}disableMoveByMouse(){var _a;this._moveByMouse={enabled:!1},this.preventTapDefaultEvent=!1,this.hooks.emit(`moveByMouseDisable`),(_a=this.mousedownEventListenerDisposer)==null||_a.call(this)}onIntersectionOnModelUpdate(intersection){var _a,_b,_c;if(!this.moveByMouseEnable)return;let{point,face}=intersection;if(!this.hooks.emit(`wantToMove`,point)){if(this.originObject3D.position.copy(point),(this._moveByMouse.useFaceNormal===!0||typeof this._moveByMouse.useFaceNormal==`object`&&this._moveByMouse.useFaceNormal.enable!==!1)&&face!=null&&face.normal){let alignment=typeof this._moveByMouse.useFaceNormal==`object`&&this._moveByMouse.useFaceNormal.alignmentVector?this._moveByMouse.useFaceNormal.alignmentVector:{x:0,y:1,z:0},alignmentVector3=new three_webgpu.Vector3((_a=alignment.x)==null?0:_a,(_b=alignment.y)==null?0:_b,(_c=alignment.z)==null?0:_c),faceNormal=typeof this._moveByMouse.useFaceNormal==`object`&&this._moveByMouse.useFaceNormal.fixedFaceNormal?this._moveByMouse.useFaceNormal.fixedFaceNormal(face.normal):face.normal;this.originObject3D.quaternion.setFromUnitVectors(alignmentVector3,faceNormal),this.internalHooks.emit(`setObjectRotate`,this.originObject3D.quaternion.clone(),new three_webgpu.Vector3)}this.internalHooks.emit(`setObjectPosition`,point),this.hooks.emit(`move`,point)}}handleMouseDown(event){let{x,y}=event;this.mouseInfo={x,y,mouseDownTimestamp:Date.now()}}handleMouseUp(event){if(!this.mouseInfo)return;let{x,y}=event;this.mouseInfo.x===x&&this.mouseInfo.y===y&&Date.now()-this.mouseInfo.mouseDownTimestamp<500&&(this.disableMoveByMouse(),this.mouseInfo=void 0)}updateDragGuideLineScale(){if(!this.dragGuideLine||!this.startInfo)return;let{line}=this.startInfo,dirNormalized=line.end.clone().sub(line.start).normalize();if(dirNormalized.lengthSq()<1e-6)return;let center=this.helperObject3D.getWorldPosition(new three_webgpu.Vector3);this.solidGuide.updateSolidLine(this.dragGuideLine,center,dirNormalized)}move(raycaster){if(!this.startInfo)return this.dragEnd();let{line,startVectorProject}=this.startInfo,object=this.originObject3D,isPlane=this.startInfo.draggingDirection===`plane`||this.startInfo.draggingDirection===`xy`||this.startInfo.draggingDirection===`xz`||this.startInfo.draggingDirection===`yz`,currentVectorProject;if(isPlane){let plane=this.startInfo.plane;if(!plane)return;let projected=new three_webgpu.Vector3,denom=plane.normal.dot(raycaster.ray.direction);if(Math.abs(denom)<1e-6)return;let t=-(plane.normal.dot(raycaster.ray.origin)+plane.constant)/denom;if(t<0)return;projected.copy(raycaster.ray.origin.clone().add(raycaster.ray.direction.clone().multiplyScalar(t))),currentVectorProject=projected}else currentVectorProject=rayOnLine({raycaster,line,clampToLine:!1});let beforePosition=object.position.clone(),offsetVector=currentVectorProject.clone().sub(startVectorProject),transform=new three_webgpu.Matrix4;transform.setPosition(offsetVector);let newPosition=object.position.clone().applyMatrix4(transform);if(this.hooks.emit(`wantToMove`,newPosition))return;let finalPosition=newPosition.clone();this.hooks.emit(`moveBefore`,finalPosition);let finalTransform=new three_webgpu.Matrix4;finalTransform.setPosition(finalPosition.clone().sub(beforePosition)),object.position.copy(finalPosition),this.setTipsText(finalPosition),this.setTipsPosition(finalPosition),startVectorProject.copy(currentVectorProject),this.internalHooks.emit(`applyObjectPosition`,{matrix:finalTransform}),this.hooks.emit(`move`,finalPosition)}setTipsText(position){var _a;let element=(_a=this.helperObject3D.moveTips)==null?void 0:_a.element;if(!element||!this.startInfo)return;let dir=this.startInfo.draggingDirection,fmt=n=>n.toFixed(3);switch(dir){case`x`:element.innerText=`x: ${fmt(position.x)}`;break;case`y`:element.innerText=`y: ${fmt(position.y)}`;break;case`z`:element.innerText=`z: ${fmt(position.z)}`;break;case`xy`:element.innerText=`x: ${fmt(position.x)}  y: ${fmt(position.y)}`;break;case`xz`:element.innerText=`x: ${fmt(position.x)}  z: ${fmt(position.z)}`;break;case`yz`:element.innerText=`y: ${fmt(position.y)}  z: ${fmt(position.z)}`;break;case`plane`:element.innerText=`x: ${fmt(position.x)}  y: ${fmt(position.y)}  z: ${fmt(position.z)}`;break}}setTipsPosition(position){let moveTips=this.helperObject3D.moveTips;if(!moveTips)return;let{x,y,z}=this.helperObject3D.getWorldPosition(new three_webgpu.Vector3).clone().project(this.camera);if(z>1){moveTips.hide();return}let rect=this.container.getBoundingClientRect(),px=(x+1)/2*rect.width,py=(-y+1)/2*rect.height;moveTips.setLeftTop(px+`px`,py+`px`)}};exports.MoveController=MoveController,exports.rayOnLine=rayOnLine;