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

package/umd/five-react.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/11/3
- * Version: 1.0.0-alpha.14
+ * Generated: 2026/11/4
+ * Version: 1.0.0-alpha.15
  * License:
  * Realsee SDK License Agreement
 

package/umd/five-sticker.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/11/3
- * Version: 1.0.0-alpha.14
+ * Generated: 2026/11/4
+ * Version: 1.0.0-alpha.15
  * License:
  * Realsee SDK License Agreement
 
@@ -378,4 +378,4 @@ fn fs(in: VSOut) -> @location(0) vec4f {
       }`)),t.attachShader(r,n(t.FRAGMENT_SHADER,`#version 300 es
       precision mediump float;
       in vec2 uv; uniform sampler2D tex; out vec4 color;
-      void main() { color = vec4(texture(tex, uv).rgb, 1.0); }`)),t.linkProgram(r),!t.getProgramParameter(r,t.LINK_STATUS))return null;let i=t.createTexture();return t.bindTexture(t.TEXTURE_2D,i),t.texParameteri(t.TEXTURE_2D,t.TEXTURE_MIN_FILTER,t.LINEAR),t.texParameteri(t.TEXTURE_2D,t.TEXTURE_MAG_FILTER,t.LINEAR),t.texParameteri(t.TEXTURE_2D,t.TEXTURE_WRAP_S,t.CLAMP_TO_EDGE),t.texParameteri(t.TEXTURE_2D,t.TEXTURE_WRAP_T,t.CLAMP_TO_EDGE),{canvas:e,gl:t,texture:i,program:r,pixels:new Uint8Array($*$*4)}}catch(e){return null}}function vr(e){var t;let{gl:n}=e;n.deleteTexture(e.texture),n.deleteProgram(e.program),(t=n.getExtension(`WEBGL_lose_context`))==null||t.loseContext()}var yr=64,br=16,xr=class{constructor(e){var t;this.debug={path:`pending`,candidate:``,locked:!1,probe:``,updateCalls:0,skipNotReady:0,blitCount:0,rvfcCount:0,fails:0,targetSize:``,lastError:``},this.mode=`unknown`,this.device=null,this.broken=!1,this.disposed=!1,this.locked=!1,this.blacklist=new Map,this.probing=!1,this.nextProbeAt=0,this.probeInterval=300,this.consecutiveFails=0,this.failingSince=0,this.frameTexture=null,this.frameReady=!1,this.heldFrame=null,this.canvas=null,this.canvasContext=null,this.gpuTexture=null,this.externalTexture=null,this.externalReady=!1,this.width=0,this.height=0,this.frameDirty=!0,this.lastVideoTime=-1,this.videoFrameCallbackId=null,this.glProbe=null,this.glProbeFailed=!1,this.gpuProbe=null,this.probeCanvas=null,this.forced=!1,this.onSourceChange=()=>{this.forced||(this.blacklist.clear(),this.locked=!1,this.debug.locked=!1,this.probeInterval=300,this.nextProbeAt=0,this.consecutiveFails=0,this.frameDirty=!0)},this.videoTexture=e,this.current=(t=er.find(hr))==null?`video`:t,this.debug.candidate=this.current,this.scheduleVideoFrameCallback();let n=this.video;typeof(n==null?void 0:n.addEventListener)==`function`&&n.addEventListener(`loadstart`,this.onSourceChange)}get video(){return this.videoTexture.image}scheduleVideoFrameCallback(){let e=this.video;this.disposed||typeof(e==null?void 0:e.requestVideoFrameCallback)!=`function`||(this.videoFrameCallbackId=e.requestVideoFrameCallback(()=>{this.videoFrameCallbackId=null,this.frameDirty=!0,this.debug.rvfcCount++,this.scheduleVideoFrameCallback()}))}get texture(){var e;if(this.broken||this.mode===`unknown`)return this.videoTexture;let t=this.mode===`webgpu`&&(this.current===`videoFrame`||this.current===`video`),n=this.externalReady?this.externalTexture:null,r=this.frameReady?this.frameTexture:null;return(e=t?n==null?r:n:r==null?n:r)==null?fr():e}update(e){if(this.debug.updateCalls++,this.disposed||this.broken||!this.resolveMode(e))return;let t=this.video;if(!(t instanceof HTMLVideoElement))return;if(t.readyState<2||t.videoWidth===0||t.videoHeight===0){this.debug.skipNotReady++;return}let n=performance.now();if(!this.locked&&!this.probing&&n>=this.nextProbeAt&&this.startProbe(),!(!this.frameDirty&&(this.debug.rvfcCount>0||t.currentTime===this.lastVideoTime)))try{this.produce(this.current,t),this.frameDirty=!1,this.lastVideoTime=t.currentTime,this.consecutiveFails=0,this.debug.blitCount++}catch(e){this.onProduceFailed(e)}}forceCandidate(e){if(e===null){this.forced=!1,this.onSourceChange();return}this.forced=!0,this.current=e,this.locked=!0,this.debug.candidate=e,this.debug.locked=!0,this.frameDirty=!0,this.releaseProbeResources()}resolveMode(e){if(this.mode!==`unknown`)return!0;let t=e==null?void 0:e.backend;if(!t)return!1;if(t.isWebGPUBackend===!0){if(!t.device)return!1;this.device=t.device,this.mode=`webgpu`}else this.mode=`webgl`;return this.debug.path=this.mode,this.ensureFrameTexture(),!0}ensureFrameTexture(){if(this.frameTexture)return;let e=this.videoTexture,t=new bn;t.colorSpace=C,t.generateMipmaps=!1,t.minFilter=e.minFilter,t.magFilter=e.magFilter,t.wrapS=e.wrapS,t.wrapT=e.wrapT,this.frameTexture=t}produce(e,t){let n=this.mode===`webgpu`;switch(e){case`videoFrame`:{let e=mr(t);if(n)try{this.blit(e,t)}finally{e.close()}else this.setFrame(e,e);break}case`video`:n?this.blit(t,t):this.setFrame(t,null);break;case`canvasFromVideoFrame`:{let e=mr(t);try{this.drawCanvas(e,t)}finally{e.close()}this.setFrame(this.canvas,null);break}case`canvasFromVideo`:this.drawCanvas(t,t),this.setFrame(this.canvas,null);break}}setFrame(e,t){this.frameTexture.setFrame(e);let n=this.heldFrame;this.heldFrame=t,n&&n!==t&&n.close(),this.frameReady=!0}drawCanvas(e,t){let n=Math.min(1,or/Math.max(t.videoWidth,t.videoHeight)),r=Math.max(1,Math.floor(t.videoWidth*n)),i=Math.max(1,Math.floor(t.videoHeight*n));if(!this.canvas&&(this.canvas=document.createElement(`canvas`),this.canvasContext=this.canvas.getContext(`2d`,{alpha:!1}),!this.canvasContext))throw Error(`canvas 2d 上下文不可用`);this.canvas.width!==r&&(this.canvas.width=r),this.canvas.height!==i&&(this.canvas.height=i),this.canvasContext.drawImage(e,0,0,r,i)}isBlacklisted(e){let t=this.blacklist.get(e);return t===void 0?!1:performance.now()>=t?(this.blacklist.delete(e),!1):!0}onProduceFailed(e){var t;let n=performance.now();if(this.consecutiveFails===0&&(this.failingSince=n),this.consecutiveFails++,this.debug.fails++,this.debug.lastError=String((t=e==null?void 0:e.message)==null?e:t),this.consecutiveFails<rr||n-this.failingSince<ir)return;console.warn(`[Five] 视频候选路径 ${this.current} 持续失败，暂时弃用`,e),this.blacklist.set(this.current,n+ar);let r=er.find(e=>hr(e)&&!this.isBlacklisted(e));this.consecutiveFails=0,r?(this.current=r,this.debug.candidate=r,this.locked=!1,this.debug.locked=!1,this.nextProbeAt=0,this.frameDirty=!0):(console.warn(`[Five] 视频所有候选路径均失败，回退为 VideoTexture 上传`),this.broken=!0,this.debug.path=`fallback`,this.releaseOutputs())}blit(e,t){this.ensureTarget(t.videoWidth,t.videoHeight);let n=this.device,{pipeline:r,bindGroupLayout:i,sampler:a}=ur(n),o=n.importExternalTexture({source:e}),s=n.createBindGroup({layout:i,entries:[{binding:0,resource:o},{binding:1,resource:a}]}),c=n.createCommandEncoder({label:`five.videoBlit`}),l=c.beginRenderPass({colorAttachments:[{view:this.gpuTexture.createView(),loadOp:`clear`,storeOp:`store`,clearValue:{r:0,g:0,b:0,a:1}}]});l.setPipeline(r),l.setBindGroup(0,s),l.draw(3),l.end(),n.queue.submit([c.finish()]),this.externalReady=!0,this.debug.targetSize=`${this.width}x${this.height}`}ensureTarget(e,t){let n=this.device,r=n.limits.maxTextureDimension2D,i=Math.min(1,r/Math.max(e,t)),a=Math.max(1,Math.floor(e*i)),o=Math.max(1,Math.floor(t*i));if(this.gpuTexture&&this.width===a&&this.height===o)return;let s=this.gpuTexture,l=n.createTexture({label:`five.videoBlit.target`,size:{width:a,height:o},format:sr,usage:GPUTextureUsage.TEXTURE_BINDING|GPUTextureUsage.RENDER_ATTACHMENT});if(this.gpuTexture=l,this.width=a,this.height=o,this.externalTexture)this.externalTexture.sourceTexture=l,this.externalTexture.image={width:a,height:o},this.externalTexture.dispose();else{let e=new Sn(l);e.colorSpace=C,e.flipY=!1,e.generateMipmaps=!1,e.minFilter=d,e.magFilter=d,e.wrapS=c,e.wrapT=c,e.image={width:a,height:o},this.externalTexture=e}s==null||s.destroy()}startProbe(){this.probing=!0,this.runProbe().catch(e=>{var t;this.debug.lastError=String((t=e==null?void 0:e.message)==null?e:t)}).finally(()=>{this.probing=!1,this.nextProbeAt=performance.now()+this.probeInterval,this.probeInterval=Math.min(this.probeInterval*1.5,5e3)})}runProbe(){return $n(this,void 0,void 0,function*(){let e=[],t=null;for(let n of er){let r=tr[n];if(this.disposed)return;if(this.isBlacklisted(n)||!hr(n)){e.push(`${r}:n/a`);continue}let i;try{i=yield this.probeCandidate(n)}catch(e){i=-1}if(e.push(`${r}:${i===null?`?`:i}`),i===null||i>=nr){t=n;break}}this.debug.probe=e.join(` `),t&&this.select(t)})}select(e){this.current=e,this.locked=!0,this.debug.candidate=e,this.debug.locked=!0,this.frameDirty=!0,this.releaseProbeResources()}probeCandidate(e){return $n(this,void 0,void 0,function*(){let t=this.video;if(!(t instanceof HTMLVideoElement)||t.readyState<2)return-1;switch(e){case`canvasFromVideoFrame`:return this.probe2d(t,!0);case`canvasFromVideo`:return this.probe2d(t,!1);default:return this.mode===`webgpu`?this.probeGPU(t,e===`videoFrame`):this.probeGL(t,e===`videoFrame`)}})}probe2d(e,t){if(!this.probeCanvas){let e=document.createElement(`canvas`);e.width=e.height=$;let t=e.getContext(`2d`,{willReadFrequently:!0});if(!t)return-1;this.probeCanvas=t}let n=t?mr(e):null;try{return this.probeCanvas.drawImage(n==null?e:n,0,0,$,$),gr(this.probeCanvas.getImageData(0,0,$,$).data)}finally{n==null||n.close()}}probeGL(e,t){!this.glProbe&&!this.glProbeFailed&&(this.glProbe=_r(),this.glProbeFailed=this.glProbe===null);let n=this.glProbe;if(!n)return null;let{gl:r}=n,i=t?mr(e):null;try{return r.getError(),r.viewport(0,0,$,$),r.bindTexture(r.TEXTURE_2D,n.texture),r.texImage2D(r.TEXTURE_2D,0,r.RGBA,r.RGBA,r.UNSIGNED_BYTE,i==null?e:i),r.getError()===r.NO_ERROR?(r.useProgram(n.program),r.drawArrays(r.TRIANGLES,0,3),r.readPixels(0,0,$,$,r.RGBA,r.UNSIGNED_BYTE,n.pixels),gr(n.pixels)):-1}finally{i==null||i.close()}}probeGPU(e,t){return $n(this,void 0,void 0,function*(){let n=this.device,{pipeline:r,bindGroupLayout:i,sampler:a}=ur(n);this.gpuProbe||(this.gpuProbe={texture:n.createTexture({label:`five.videoProbe.target`,size:{width:yr,height:br},format:sr,usage:GPUTextureUsage.RENDER_ATTACHMENT|GPUTextureUsage.COPY_SRC}),buffer:n.createBuffer({label:`five.videoProbe.readback`,size:yr*4*br,usage:GPUBufferUsage.COPY_DST|GPUBufferUsage.MAP_READ})});let o=this.gpuProbe;n.pushErrorScope(`validation`);let s=null,c=t?mr(e):null;try{let t=n.importExternalTexture({source:c==null?e:c}),s=n.createBindGroup({layout:i,entries:[{binding:0,resource:t},{binding:1,resource:a}]}),l=n.createCommandEncoder({label:`five.videoProbe`}),u=l.beginRenderPass({colorAttachments:[{view:o.texture.createView(),loadOp:`clear`,storeOp:`store`,clearValue:{r:0,g:0,b:0,a:1}}]});u.setPipeline(r),u.setBindGroup(0,s),u.draw(3),u.end(),l.copyTextureToBuffer({texture:o.texture},{buffer:o.buffer,bytesPerRow:yr*4},{width:yr,height:br}),n.queue.submit([l.finish()])}catch(e){s=e}finally{c==null||c.close()}let l=yield n.popErrorScope();if(s||l)return-1;yield o.buffer.mapAsync(GPUMapMode.READ);let u=gr(new Uint8Array(o.buffer.getMappedRange()));return o.buffer.unmap(),u})}releaseProbeResources(){this.glProbe&&(vr(this.glProbe),this.glProbe=null),this.glProbeFailed=!1,this.probeCanvas=null,this.gpuProbe&&(this.gpuProbe.texture.destroy(),this.gpuProbe.buffer.destroy(),this.gpuProbe=null)}releaseOutputs(){var e,t,n,r;(e=this.heldFrame)==null||e.close(),this.heldFrame=null,(t=this.frameTexture)==null||t.dispose(),this.frameTexture=null,this.frameReady=!1,(n=this.externalTexture)==null||n.dispose(),this.externalTexture=null,this.externalReady=!1,(r=this.gpuTexture)==null||r.destroy(),this.gpuTexture=null,this.width=this.height=0,this.canvas=null,this.canvasContext=null}dispose(){if(this.disposed)return;this.disposed=!0;let e=this.video;this.videoFrameCallbackId!==null&&typeof(e==null?void 0:e.cancelVideoFrameCallback)==`function`&&e.cancelVideoFrameCallback(this.videoFrameCallbackId),this.videoFrameCallbackId=null,typeof(e==null?void 0:e.removeEventListener)==`function`&&e.removeEventListener(`loadstart`,this.onSourceChange),this.releaseOutputs(),this.releaseProbeResources()}},Sr=new WeakMap;function Cr(e){let t=Sr.get(e);if(!t){let n=new xr(e);t=n,Sr.set(e,n);let r=()=>{e.removeEventListener(`dispose`,r),Sr.get(e)===n&&Sr.delete(e),n.dispose()};e.addEventListener(`dispose`,r)}return t}var wr=window,Tr=wr.requestAnimationFrame||wr.mozRequestAnimationFrame||wr.webkitRequestAnimationFrame||wr.msRequestAnimationFrame||(e=>setTimeout(e,16)),Er=typeof performance<`u`&&performance.timing!==void 0?performance.timing.navigationStart:Date.now(),Dr=typeof performance<`u`?(()=>Er+performance.now()):(()=>Date.now());function Or(e,t){e.naturalWidth>0&&Tr(()=>t());let n=()=>t();return e.addEventListener(`load`,n,!1),()=>e.removeEventListener(`load`,n,!1)}function kr(e,t){let n=Dr(),r=!1,i=()=>{r=!0,t(),Dr()-n<3e3?Tr(i):r=!1},a=()=>{n=Dr(),r===!1&&i()};return e.addEventListener(`timeupdate`,a,!1),()=>{e.removeEventListener(`timeupdate`,a,!1),r=!1}}function Ar(e,t){let n=e.dispose;e.dispose=()=>{t(),n.call(e)}}e.Sticker=class extends hn{static get version(){return`1.0.0-alpha.14`}constructor(e,t,n){let r=new nn;if(super(Qn,r),this._sourceTexture=null,this._needsRender=!1,this.scale.set(e,t,1),typeof n==`string`){r.transparent=/\.png$/.test(n);let e=new Image;e.src=n,e.crossOrigin=``,n=e}if(n instanceof HTMLImageElement){let e=r.map=new Oe;e.wrapS=c,e.wrapT=c,e.minFilter=d,e.colorSpace=C,Ar(e,Or(n,()=>{e.image=n,e.needsUpdate=!0,this._needsRender=!0}))}else if(n instanceof HTMLCanvasElement)r.map=new xn(n);else if(n instanceof HTMLVideoElement){let e=r.map=new yn(n);e.wrapS=c,e.wrapT=c,e.minFilter=d,e.colorSpace=C,Ar(e,kr(n,()=>{this._needsRender=!0}));let t=Cr(e);this.onBeforeRender=e=>{t.update(e);let n=t.texture;r.map!==n&&(r.map=n)}}this._sourceTexture=r.map}get needsRender(){return this._needsRender}set needsRender(e){this._needsRender=e,e===!0&&this._sourceTexture&&(this._sourceTexture.needsUpdate=!0)}setSize(e,t){this.scale.set(e,t,1),this._needsRender=!0}setTransparent(e){this.material.transparent=e,this._needsRender=!0}locationWithIntersection(e,t=.005){let{point:n,face:r}=e;this.position.copy(n),r&&(this.position.add(r.normal.clone().setLength(t)),this.lookAt(n.clone().add(r.normal))),this._needsRender=!0}dispose(){var e;(e=this._sourceTexture)==null||e.dispose(),this.material.dispose()}}});
+      void main() { color = vec4(texture(tex, uv).rgb, 1.0); }`)),t.linkProgram(r),!t.getProgramParameter(r,t.LINK_STATUS))return null;let i=t.createTexture();return t.bindTexture(t.TEXTURE_2D,i),t.texParameteri(t.TEXTURE_2D,t.TEXTURE_MIN_FILTER,t.LINEAR),t.texParameteri(t.TEXTURE_2D,t.TEXTURE_MAG_FILTER,t.LINEAR),t.texParameteri(t.TEXTURE_2D,t.TEXTURE_WRAP_S,t.CLAMP_TO_EDGE),t.texParameteri(t.TEXTURE_2D,t.TEXTURE_WRAP_T,t.CLAMP_TO_EDGE),{canvas:e,gl:t,texture:i,program:r,pixels:new Uint8Array($*$*4)}}catch(e){return null}}function vr(e){var t;let{gl:n}=e;n.deleteTexture(e.texture),n.deleteProgram(e.program),(t=n.getExtension(`WEBGL_lose_context`))==null||t.loseContext()}var yr=64,br=16,xr=class{constructor(e){var t;this.debug={path:`pending`,candidate:``,locked:!1,probe:``,updateCalls:0,skipNotReady:0,blitCount:0,rvfcCount:0,fails:0,targetSize:``,lastError:``},this.mode=`unknown`,this.device=null,this.broken=!1,this.disposed=!1,this.locked=!1,this.blacklist=new Map,this.probing=!1,this.nextProbeAt=0,this.probeInterval=300,this.consecutiveFails=0,this.failingSince=0,this.frameTexture=null,this.frameReady=!1,this.heldFrame=null,this.canvas=null,this.canvasContext=null,this.gpuTexture=null,this.externalTexture=null,this.externalReady=!1,this.width=0,this.height=0,this.frameDirty=!0,this.lastVideoTime=-1,this.videoFrameCallbackId=null,this.glProbe=null,this.glProbeFailed=!1,this.gpuProbe=null,this.probeCanvas=null,this.forced=!1,this.onSourceChange=()=>{this.forced||(this.blacklist.clear(),this.locked=!1,this.debug.locked=!1,this.probeInterval=300,this.nextProbeAt=0,this.consecutiveFails=0,this.frameDirty=!0)},this.videoTexture=e,this.current=(t=er.find(hr))==null?`video`:t,this.debug.candidate=this.current,this.scheduleVideoFrameCallback();let n=this.video;typeof(n==null?void 0:n.addEventListener)==`function`&&n.addEventListener(`loadstart`,this.onSourceChange)}get video(){return this.videoTexture.image}scheduleVideoFrameCallback(){let e=this.video;this.disposed||typeof(e==null?void 0:e.requestVideoFrameCallback)!=`function`||(this.videoFrameCallbackId=e.requestVideoFrameCallback(()=>{this.videoFrameCallbackId=null,this.frameDirty=!0,this.debug.rvfcCount++,this.scheduleVideoFrameCallback()}))}get texture(){var e;if(this.broken||this.mode===`unknown`)return this.videoTexture;let t=this.mode===`webgpu`&&(this.current===`videoFrame`||this.current===`video`),n=this.externalReady?this.externalTexture:null,r=this.frameReady?this.frameTexture:null;return(e=t?n==null?r:n:r==null?n:r)==null?fr():e}update(e){if(this.debug.updateCalls++,this.disposed||this.broken||!this.resolveMode(e))return;let t=this.video;if(!(t instanceof HTMLVideoElement))return;if(t.readyState<2||t.videoWidth===0||t.videoHeight===0){this.debug.skipNotReady++;return}let n=performance.now();if(!this.locked&&!this.probing&&n>=this.nextProbeAt&&this.startProbe(),!(!this.frameDirty&&(this.debug.rvfcCount>0||t.currentTime===this.lastVideoTime)))try{this.produce(this.current,t),this.frameDirty=!1,this.lastVideoTime=t.currentTime,this.consecutiveFails=0,this.debug.blitCount++}catch(e){this.onProduceFailed(e)}}forceCandidate(e){if(e===null){this.forced=!1,this.onSourceChange();return}this.forced=!0,this.current=e,this.locked=!0,this.debug.candidate=e,this.debug.locked=!0,this.frameDirty=!0,this.releaseProbeResources()}resolveMode(e){if(this.mode!==`unknown`)return!0;let t=e==null?void 0:e.backend;if(!t)return!1;if(t.isWebGPUBackend===!0){if(!t.device)return!1;this.device=t.device,this.mode=`webgpu`}else this.mode=`webgl`;return this.debug.path=this.mode,this.ensureFrameTexture(),!0}ensureFrameTexture(){if(this.frameTexture)return;let e=this.videoTexture,t=new bn;t.colorSpace=C,t.generateMipmaps=!1,t.minFilter=e.minFilter,t.magFilter=e.magFilter,t.wrapS=e.wrapS,t.wrapT=e.wrapT,this.frameTexture=t}produce(e,t){let n=this.mode===`webgpu`;switch(e){case`videoFrame`:{let e=mr(t);if(n)try{this.blit(e,t)}finally{e.close()}else this.setFrame(e,e);break}case`video`:n?this.blit(t,t):this.setFrame(t,null);break;case`canvasFromVideoFrame`:{let e=mr(t);try{this.drawCanvas(e,t)}finally{e.close()}this.setFrame(this.canvas,null);break}case`canvasFromVideo`:this.drawCanvas(t,t),this.setFrame(this.canvas,null);break}}setFrame(e,t){this.frameTexture.setFrame(e);let n=this.heldFrame;this.heldFrame=t,n&&n!==t&&n.close(),this.frameReady=!0}drawCanvas(e,t){let n=Math.min(1,or/Math.max(t.videoWidth,t.videoHeight)),r=Math.max(1,Math.floor(t.videoWidth*n)),i=Math.max(1,Math.floor(t.videoHeight*n));if(!this.canvas&&(this.canvas=document.createElement(`canvas`),this.canvasContext=this.canvas.getContext(`2d`,{alpha:!1}),!this.canvasContext))throw Error(`canvas 2d 上下文不可用`);this.canvas.width!==r&&(this.canvas.width=r),this.canvas.height!==i&&(this.canvas.height=i),this.canvasContext.drawImage(e,0,0,r,i)}isBlacklisted(e){let t=this.blacklist.get(e);return t===void 0?!1:performance.now()>=t?(this.blacklist.delete(e),!1):!0}onProduceFailed(e){var t;let n=performance.now();if(this.consecutiveFails===0&&(this.failingSince=n),this.consecutiveFails++,this.debug.fails++,this.debug.lastError=String((t=e==null?void 0:e.message)==null?e:t),this.consecutiveFails<rr||n-this.failingSince<ir)return;console.warn(`[Five] 视频候选路径 ${this.current} 持续失败，暂时弃用`,e),this.blacklist.set(this.current,n+ar);let r=er.find(e=>hr(e)&&!this.isBlacklisted(e));this.consecutiveFails=0,r?(this.current=r,this.debug.candidate=r,this.locked=!1,this.debug.locked=!1,this.nextProbeAt=0,this.frameDirty=!0):(console.warn(`[Five] 视频所有候选路径均失败，回退为 VideoTexture 上传`),this.broken=!0,this.debug.path=`fallback`,this.releaseOutputs())}blit(e,t){this.ensureTarget(t.videoWidth,t.videoHeight);let n=this.device,{pipeline:r,bindGroupLayout:i,sampler:a}=ur(n),o=n.importExternalTexture({source:e}),s=n.createBindGroup({layout:i,entries:[{binding:0,resource:o},{binding:1,resource:a}]}),c=n.createCommandEncoder({label:`five.videoBlit`}),l=c.beginRenderPass({colorAttachments:[{view:this.gpuTexture.createView(),loadOp:`clear`,storeOp:`store`,clearValue:{r:0,g:0,b:0,a:1}}]});l.setPipeline(r),l.setBindGroup(0,s),l.draw(3),l.end(),n.queue.submit([c.finish()]),this.externalReady=!0,this.debug.targetSize=`${this.width}x${this.height}`}ensureTarget(e,t){let n=this.device,r=n.limits.maxTextureDimension2D,i=Math.min(1,r/Math.max(e,t)),a=Math.max(1,Math.floor(e*i)),o=Math.max(1,Math.floor(t*i));if(this.gpuTexture&&this.width===a&&this.height===o)return;let s=this.gpuTexture,l=n.createTexture({label:`five.videoBlit.target`,size:{width:a,height:o},format:sr,usage:GPUTextureUsage.TEXTURE_BINDING|GPUTextureUsage.RENDER_ATTACHMENT});if(this.gpuTexture=l,this.width=a,this.height=o,this.externalTexture)this.externalTexture.sourceTexture=l,this.externalTexture.image={width:a,height:o},this.externalTexture.dispose();else{let e=new Sn(l);e.colorSpace=C,e.flipY=!1,e.generateMipmaps=!1,e.minFilter=d,e.magFilter=d,e.wrapS=c,e.wrapT=c,e.image={width:a,height:o},this.externalTexture=e}s==null||s.destroy()}startProbe(){this.probing=!0,this.runProbe().catch(e=>{var t;this.debug.lastError=String((t=e==null?void 0:e.message)==null?e:t)}).finally(()=>{this.probing=!1,this.nextProbeAt=performance.now()+this.probeInterval,this.probeInterval=Math.min(this.probeInterval*1.5,5e3)})}runProbe(){return $n(this,void 0,void 0,function*(){let e=[],t=null;for(let n of er){let r=tr[n];if(this.disposed)return;if(this.isBlacklisted(n)||!hr(n)){e.push(`${r}:n/a`);continue}let i;try{i=yield this.probeCandidate(n)}catch(e){i=-1}if(e.push(`${r}:${i===null?`?`:i}`),i===null||i>=nr){t=n;break}}this.debug.probe=e.join(` `),t&&this.select(t)})}select(e){this.current=e,this.locked=!0,this.debug.candidate=e,this.debug.locked=!0,this.frameDirty=!0,this.releaseProbeResources()}probeCandidate(e){return $n(this,void 0,void 0,function*(){let t=this.video;if(!(t instanceof HTMLVideoElement)||t.readyState<2)return-1;switch(e){case`canvasFromVideoFrame`:return this.probe2d(t,!0);case`canvasFromVideo`:return this.probe2d(t,!1);default:return this.mode===`webgpu`?this.probeGPU(t,e===`videoFrame`):this.probeGL(t,e===`videoFrame`)}})}probe2d(e,t){if(!this.probeCanvas){let e=document.createElement(`canvas`);e.width=e.height=$;let t=e.getContext(`2d`,{willReadFrequently:!0});if(!t)return-1;this.probeCanvas=t}let n=t?mr(e):null;try{return this.probeCanvas.drawImage(n==null?e:n,0,0,$,$),gr(this.probeCanvas.getImageData(0,0,$,$).data)}finally{n==null||n.close()}}probeGL(e,t){!this.glProbe&&!this.glProbeFailed&&(this.glProbe=_r(),this.glProbeFailed=this.glProbe===null);let n=this.glProbe;if(!n)return null;let{gl:r}=n,i=t?mr(e):null;try{return r.getError(),r.viewport(0,0,$,$),r.bindTexture(r.TEXTURE_2D,n.texture),r.texImage2D(r.TEXTURE_2D,0,r.RGBA,r.RGBA,r.UNSIGNED_BYTE,i==null?e:i),r.getError()===r.NO_ERROR?(r.useProgram(n.program),r.drawArrays(r.TRIANGLES,0,3),r.readPixels(0,0,$,$,r.RGBA,r.UNSIGNED_BYTE,n.pixels),gr(n.pixels)):-1}finally{i==null||i.close()}}probeGPU(e,t){return $n(this,void 0,void 0,function*(){let n=this.device,{pipeline:r,bindGroupLayout:i,sampler:a}=ur(n);this.gpuProbe||(this.gpuProbe={texture:n.createTexture({label:`five.videoProbe.target`,size:{width:yr,height:br},format:sr,usage:GPUTextureUsage.RENDER_ATTACHMENT|GPUTextureUsage.COPY_SRC}),buffer:n.createBuffer({label:`five.videoProbe.readback`,size:yr*4*br,usage:GPUBufferUsage.COPY_DST|GPUBufferUsage.MAP_READ})});let o=this.gpuProbe;n.pushErrorScope(`validation`);let s=null,c=t?mr(e):null;try{let t=n.importExternalTexture({source:c==null?e:c}),s=n.createBindGroup({layout:i,entries:[{binding:0,resource:t},{binding:1,resource:a}]}),l=n.createCommandEncoder({label:`five.videoProbe`}),u=l.beginRenderPass({colorAttachments:[{view:o.texture.createView(),loadOp:`clear`,storeOp:`store`,clearValue:{r:0,g:0,b:0,a:1}}]});u.setPipeline(r),u.setBindGroup(0,s),u.draw(3),u.end(),l.copyTextureToBuffer({texture:o.texture},{buffer:o.buffer,bytesPerRow:yr*4},{width:yr,height:br}),n.queue.submit([l.finish()])}catch(e){s=e}finally{c==null||c.close()}let l=yield n.popErrorScope();if(s||l)return-1;yield o.buffer.mapAsync(GPUMapMode.READ);let u=gr(new Uint8Array(o.buffer.getMappedRange()));return o.buffer.unmap(),u})}releaseProbeResources(){this.glProbe&&(vr(this.glProbe),this.glProbe=null),this.glProbeFailed=!1,this.probeCanvas=null,this.gpuProbe&&(this.gpuProbe.texture.destroy(),this.gpuProbe.buffer.destroy(),this.gpuProbe=null)}releaseOutputs(){var e,t,n,r;(e=this.heldFrame)==null||e.close(),this.heldFrame=null,(t=this.frameTexture)==null||t.dispose(),this.frameTexture=null,this.frameReady=!1,(n=this.externalTexture)==null||n.dispose(),this.externalTexture=null,this.externalReady=!1,(r=this.gpuTexture)==null||r.destroy(),this.gpuTexture=null,this.width=this.height=0,this.canvas=null,this.canvasContext=null}dispose(){if(this.disposed)return;this.disposed=!0;let e=this.video;this.videoFrameCallbackId!==null&&typeof(e==null?void 0:e.cancelVideoFrameCallback)==`function`&&e.cancelVideoFrameCallback(this.videoFrameCallbackId),this.videoFrameCallbackId=null,typeof(e==null?void 0:e.removeEventListener)==`function`&&e.removeEventListener(`loadstart`,this.onSourceChange),this.releaseOutputs(),this.releaseProbeResources()}},Sr=new WeakMap;function Cr(e){let t=Sr.get(e);if(!t){let n=new xr(e);t=n,Sr.set(e,n);let r=()=>{e.removeEventListener(`dispose`,r),Sr.get(e)===n&&Sr.delete(e),n.dispose()};e.addEventListener(`dispose`,r)}return t}var wr=window,Tr=wr.requestAnimationFrame||wr.mozRequestAnimationFrame||wr.webkitRequestAnimationFrame||wr.msRequestAnimationFrame||(e=>setTimeout(e,16)),Er=typeof performance<`u`&&performance.timing!==void 0?performance.timing.navigationStart:Date.now(),Dr=typeof performance<`u`?(()=>Er+performance.now()):(()=>Date.now());function Or(e,t){e.naturalWidth>0&&Tr(()=>t());let n=()=>t();return e.addEventListener(`load`,n,!1),()=>e.removeEventListener(`load`,n,!1)}function kr(e,t){let n=Dr(),r=!1,i=()=>{r=!0,t(),Dr()-n<3e3?Tr(i):r=!1},a=()=>{n=Dr(),r===!1&&i()};return e.addEventListener(`timeupdate`,a,!1),()=>{e.removeEventListener(`timeupdate`,a,!1),r=!1}}function Ar(e,t){let n=e.dispose;e.dispose=()=>{t(),n.call(e)}}e.Sticker=class extends hn{static get version(){return`1.0.0-alpha.15`}constructor(e,t,n){let r=new nn;if(super(Qn,r),this._sourceTexture=null,this._needsRender=!1,this.scale.set(e,t,1),typeof n==`string`){r.transparent=/\.png$/.test(n);let e=new Image;e.src=n,e.crossOrigin=``,n=e}if(n instanceof HTMLImageElement){let e=r.map=new Oe;e.wrapS=c,e.wrapT=c,e.minFilter=d,e.colorSpace=C,Ar(e,Or(n,()=>{e.image=n,e.needsUpdate=!0,this._needsRender=!0}))}else if(n instanceof HTMLCanvasElement)r.map=new xn(n);else if(n instanceof HTMLVideoElement){let e=r.map=new yn(n);e.wrapS=c,e.wrapT=c,e.minFilter=d,e.colorSpace=C,Ar(e,kr(n,()=>{this._needsRender=!0}));let t=Cr(e);this.onBeforeRender=e=>{t.update(e);let n=t.texture;r.map!==n&&(r.map=n)}}this._sourceTexture=r.map}get needsRender(){return this._needsRender}set needsRender(e){this._needsRender=e,e===!0&&this._sourceTexture&&(this._sourceTexture.needsUpdate=!0)}setSize(e,t){this.scale.set(e,t,1),this._needsRender=!0}setTransparent(e){this.material.transparent=e,this._needsRender=!0}locationWithIntersection(e,t=.005){let{point:n,face:r}=e;this.position.copy(n),r&&(this.position.add(r.normal.clone().setLength(t)),this.lookAt(n.clone().add(r.normal))),this._needsRender=!0}dispose(){var e;(e=this._sourceTexture)==null||e.dispose(),this.material.dispose()}}});

package/umd/five-vfx.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/11/3
- * Version: 1.0.0-alpha.14
+ * Generated: 2026/11/4
+ * Version: 1.0.0-alpha.15
  * License:
  * Realsee SDK License Agreement