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

package/plugins/thirdParty/domevents.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/plugins/utils/absoluteUrl.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/plugins/utils/absoluteUrl.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/plugins/utils/calculatePath.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/plugins/utils/calculatePath.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/plugins/utils/clamp.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/plugins/utils/clamp.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/plugins/utils/uuid.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/plugins/utils/uuid.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/react/index.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/react/index.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 

package/sticker/index.d.ts

@@ -18,6 +18,13 @@ interface IntersectionLike {
 declare class Sticker extends THREE.Mesh<THREE.BufferGeometry, THREE.MeshBasicMaterial> {
     static get version(): string;
     private _needsRender;
+    /**
+     * 资源对应的原始纹理。
+     * @description
+     * 视频资源在 WebGPU 下 `material.map` 会被换成 GPU 中转纹理，`needsUpdate` 与 `dispose`
+     * 必须作用在原始纹理上（中转纹理不能 needsUpdate，否则 three 会重复初始化）。
+     */
+    private _sourceTexture;
     /**
      * 贴纸
      * @description

package/sticker/index.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,38 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require("three/webgpu");c=s(c,1);var l=new Float32Array([-.5,-.5,0,.5,-.5,0,-.5,.5,0,.5,.5,0]),u=new Float32Array([0,0,1,0,0,1,1,1]),d=new Uint8Array([0,1,2,1,3,2]),f=new c.BufferGeometry;f.setAttribute(`position`,new c.BufferAttribute(l,3)),f.setAttribute(`uv`,new c.BufferAttribute(u,2)),f.setIndex(new c.BufferAttribute(d,1));var p=window,m=p.requestAnimationFrame||p.mozRequestAnimationFrame||p.webkitRequestAnimationFrame||p.msRequestAnimationFrame||(e=>setTimeout(e,16)),h=typeof performance<`u`&&performance.timing!==void 0?performance.timing.navigationStart:Date.now(),g=typeof performance<`u`?(()=>h+performance.now()):(()=>Date.now());function _(e,t){e.naturalWidth>0&&m(()=>t());let n=()=>t();return e.addEventListener(`load`,n,!1),()=>e.removeEventListener(`load`,n,!1)}function v(e,t){let n=g(),r=!1,i=()=>{r=!0,t(),g()-n<3e3?m(i):r=!1},a=()=>{n=g(),r===!1&&i()};return e.addEventListener(`timeupdate`,a,!1),()=>{e.removeEventListener(`timeupdate`,a,!1),r=!1}}function y(e,t){let n=e.dispose;e.dispose=()=>{t(),n.call(e)}}var b=class extends c.Mesh{static get version(){return`1.0.0-alpha.12`}constructor(e,t,n){let r=new c.MeshBasicMaterial;if(super(f,r),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 c.Texture;e.wrapS=c.ClampToEdgeWrapping,e.wrapT=c.ClampToEdgeWrapping,e.minFilter=c.LinearFilter,e.colorSpace=c.SRGBColorSpace,y(e,_(n,()=>{e.image=n,e.needsUpdate=!0,this._needsRender=!0}))}else if(n instanceof HTMLCanvasElement)r.map=new c.CanvasTexture(n);else if(n instanceof HTMLVideoElement){let e=r.map=new c.VideoTexture(n);e.wrapS=c.ClampToEdgeWrapping,e.wrapT=c.ClampToEdgeWrapping,e.minFilter=c.LinearFilter,e.colorSpace=c.SRGBColorSpace,y(e,v(n,()=>{this._needsRender=!0}))}}get needsRender(){return this._needsRender}set needsRender(e){this._needsRender=e,e===!0&&this.material.map&&(this.material.map.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.material.map)==null||e.dispose(),this.material.dispose()}};exports.Sticker=b;
+*/Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require("three/webgpu");c=s(c,1);var l=new Float32Array([-.5,-.5,0,.5,-.5,0,-.5,.5,0,.5,.5,0]),u=new Float32Array([0,0,1,0,0,1,1,1]),d=new Uint8Array([0,1,2,1,3,2]),f=new c.BufferGeometry;f.setAttribute(`position`,new c.BufferAttribute(l,3)),f.setAttribute(`uv`,new c.BufferAttribute(u,2)),f.setIndex(new c.BufferAttribute(d,1));var p=`rgba8unorm-srgb`,m=`
+struct VSOut {
+  @builtin(position) position: vec4f,
+  @location(0) uv: vec2f,
+};
+
+@vertex
+fn vs(@builtin(vertex_index) index: u32) -> VSOut {
+  // 全屏三角形：p ∈ {(0,0), (2,0), (0,2)}
+  let p = vec2f(f32((index << 1u) & 2u), f32(index & 2u));
+  var out: VSOut;
+  out.position = vec4f(p * 2.0 - 1.0, 0.0, 1.0);
+  // NDC y = +1 对应纹理第 0 行。three 的约定是 uv.v = 0 为图像底部、且存放在第 0 行，
+  // 而 external texture 的 uv (0,0) 是视频左上角，所以第 0 行要采视频的 v = 1，即 uv = p。
+  out.uv = p;
+  return out;
+}
+
+@group(0) @binding(0) var source: texture_external;
+@group(0) @binding(1) var sourceSampler: sampler;
+
+fn srgbToLinear(c: vec3f) -> vec3f {
+  let low = c / 12.92;
+  let high = pow((c + 0.055) / 1.055, vec3f(2.4));
+  return select(high, low, c <= vec3f(0.04045));
+}
+
+@fragment
+fn fs(in: VSOut) -> @location(0) vec4f {
+  // external texture 采样结果是 sRGB 编码值；目标是 -srgb 格式，写入时会再编码一次，
+  // 所以这里先解码为线性。
+  let color = textureSampleBaseClampToEdge(source, sourceSampler, in.uv);
+  return vec4f(srgbToLinear(color.rgb), 1.0);
+}
+`,h=new WeakMap;function g(e){let t=h.get(e);if(!t){let n=e.createShaderModule({label:`five.videoBlit`,code:m});t={pipeline:e.createRenderPipeline({label:`five.videoBlit`,layout:`auto`,vertex:{module:n,entryPoint:`vs`},fragment:{module:n,entryPoint:`fs`,targets:[{format:p}]},primitive:{topology:`triangle-list`}}),sampler:e.createSampler({magFilter:`linear`,minFilter:`linear`})},h.set(e,t)}return t}var _=null;function v(){return _||(_=new c.DataTexture(new Uint8Array([0,0,0,255]),1,1,c.RGBAFormat),_.colorSpace=c.SRGBColorSpace,_.magFilter=c.LinearFilter,_.minFilter=c.LinearFilter,_.needsUpdate=!0),_}var y=class{constructor(e){this.device=null,this.useBlit=null,this.broken=!1,this.gpuTexture=null,this.externalTexture=null,this.width=0,this.height=0,this.frameDirty=!0,this.lastVideoTime=-1,this.videoFrameCallbackId=null,this.disposed=!1,this.videoTexture=e,this.scheduleVideoFrameCallback()}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.scheduleVideoFrameCallback()}))}get texture(){var e;return this.broken||this.useBlit!==!0?this.videoTexture:(e=this.externalTexture)==null?v():e}update(e){if(this.disposed||this.broken)return;if(this.useBlit===null){let t=e==null?void 0:e.backend;if(!t)return;if(t.isWebGPUBackend!==!0){this.useBlit=!1;return}if(!t.device)return;this.device=t.device,this.useBlit=!0}if(!this.useBlit||!this.device)return;let t=this.video;if(t instanceof HTMLVideoElement&&!(t.readyState<2||t.videoWidth===0||t.videoHeight===0)&&!(this.externalTexture&&!this.frameDirty&&t.currentTime===this.lastVideoTime))try{this.ensureTarget(t.videoWidth,t.videoHeight),this.blit(t),this.frameDirty=!1,this.lastVideoTime=t.currentTime}catch(e){console.warn(`[Five] 视频纹理 GPU 中转失败，回退为 VideoTexture 上传`,e),this.broken=!0,this.releaseTarget()}}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:p,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 c.ExternalTexture(l);e.colorSpace=c.SRGBColorSpace,e.flipY=!1,e.generateMipmaps=!1,e.minFilter=c.LinearFilter,e.magFilter=c.LinearFilter,e.wrapS=c.ClampToEdgeWrapping,e.wrapT=c.ClampToEdgeWrapping,e.image={width:a,height:o},this.externalTexture=e}s==null||s.destroy()}blit(e){let t=this.device,{pipeline:n,sampler:r}=g(t),i=t.importExternalTexture({source:e}),a=t.createBindGroup({layout:n.getBindGroupLayout(0),entries:[{binding:0,resource:i},{binding:1,resource:r}]}),o=t.createCommandEncoder({label:`five.videoBlit`}),s=o.beginRenderPass({colorAttachments:[{view:this.gpuTexture.createView(),loadOp:`clear`,storeOp:`store`,clearValue:{r:0,g:0,b:0,a:1}}]});s.setPipeline(n),s.setBindGroup(0,a),s.draw(3),s.end(),t.queue.submit([o.finish()])}releaseTarget(){var e,t;(e=this.externalTexture)==null||e.dispose(),this.externalTexture=null,(t=this.gpuTexture)==null||t.destroy(),this.gpuTexture=null,this.width=this.height=0}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,this.releaseTarget()}},b=new WeakMap;function x(e){let t=b.get(e);if(!t){let n=new y(e);t=n,b.set(e,n);let r=()=>{e.removeEventListener(`dispose`,r),b.get(e)===n&&b.delete(e),n.dispose()};e.addEventListener(`dispose`,r)}return t}var S=window,C=S.requestAnimationFrame||S.mozRequestAnimationFrame||S.webkitRequestAnimationFrame||S.msRequestAnimationFrame||(e=>setTimeout(e,16)),w=typeof performance<`u`&&performance.timing!==void 0?performance.timing.navigationStart:Date.now(),T=typeof performance<`u`?(()=>w+performance.now()):(()=>Date.now());function E(e,t){e.naturalWidth>0&&C(()=>t());let n=()=>t();return e.addEventListener(`load`,n,!1),()=>e.removeEventListener(`load`,n,!1)}function D(e,t){let n=T(),r=!1,i=()=>{r=!0,t(),T()-n<3e3?C(i):r=!1},a=()=>{n=T(),r===!1&&i()};return e.addEventListener(`timeupdate`,a,!1),()=>{e.removeEventListener(`timeupdate`,a,!1),r=!1}}function O(e,t){let n=e.dispose;e.dispose=()=>{t(),n.call(e)}}var k=class extends c.Mesh{static get version(){return`1.0.0-alpha.13`}constructor(e,t,n){let r=new c.MeshBasicMaterial;if(super(f,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 c.Texture;e.wrapS=c.ClampToEdgeWrapping,e.wrapT=c.ClampToEdgeWrapping,e.minFilter=c.LinearFilter,e.colorSpace=c.SRGBColorSpace,O(e,E(n,()=>{e.image=n,e.needsUpdate=!0,this._needsRender=!0}))}else if(n instanceof HTMLCanvasElement)r.map=new c.CanvasTexture(n);else if(n instanceof HTMLVideoElement){let e=r.map=new c.VideoTexture(n);e.wrapS=c.ClampToEdgeWrapping,e.wrapT=c.ClampToEdgeWrapping,e.minFilter=c.LinearFilter,e.colorSpace=c.SRGBColorSpace,O(e,D(n,()=>{this._needsRender=!0}));let t=x(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()}};exports.Sticker=k;

package/sticker/index.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/10/30
+ * Version: 1.0.0-alpha.13
  * License:
  * Realsee SDK License Agreement
 
@@ -369,58 +369,215 @@ var t = new Float32Array([
 ]), i = new e.BufferGeometry();
 i.setAttribute("position", new e.BufferAttribute(t, 3)), i.setAttribute("uv", new e.BufferAttribute(n, 2)), i.setIndex(new e.BufferAttribute(r, 1));
 //#endregion
+//#region build/five/texture/videoTextureBridge.js
+var a = "rgba8unorm-srgb", o = "\nstruct VSOut {\n  @builtin(position) position: vec4f,\n  @location(0) uv: vec2f,\n};\n\n@vertex\nfn vs(@builtin(vertex_index) index: u32) -> VSOut {\n  // 全屏三角形：p ∈ {(0,0), (2,0), (0,2)}\n  let p = vec2f(f32((index << 1u) & 2u), f32(index & 2u));\n  var out: VSOut;\n  out.position = vec4f(p * 2.0 - 1.0, 0.0, 1.0);\n  // NDC y = +1 对应纹理第 0 行。three 的约定是 uv.v = 0 为图像底部、且存放在第 0 行，\n  // 而 external texture 的 uv (0,0) 是视频左上角，所以第 0 行要采视频的 v = 1，即 uv = p。\n  out.uv = p;\n  return out;\n}\n\n@group(0) @binding(0) var source: texture_external;\n@group(0) @binding(1) var sourceSampler: sampler;\n\nfn srgbToLinear(c: vec3f) -> vec3f {\n  let low = c / 12.92;\n  let high = pow((c + 0.055) / 1.055, vec3f(2.4));\n  return select(high, low, c <= vec3f(0.04045));\n}\n\n@fragment\nfn fs(in: VSOut) -> @location(0) vec4f {\n  // external texture 采样结果是 sRGB 编码值；目标是 -srgb 格式，写入时会再编码一次，\n  // 所以这里先解码为线性。\n  let color = textureSampleBaseClampToEdge(source, sourceSampler, in.uv);\n  return vec4f(srgbToLinear(color.rgb), 1.0);\n}\n", s = /* @__PURE__ */ new WeakMap();
+function c(e) {
+	let t = s.get(e);
+	if (!t) {
+		let n = e.createShaderModule({
+			label: "five.videoBlit",
+			code: o
+		});
+		t = {
+			pipeline: e.createRenderPipeline({
+				label: "five.videoBlit",
+				layout: "auto",
+				vertex: {
+					module: n,
+					entryPoint: "vs"
+				},
+				fragment: {
+					module: n,
+					entryPoint: "fs",
+					targets: [{ format: a }]
+				},
+				primitive: { topology: "triangle-list" }
+			}),
+			sampler: e.createSampler({
+				magFilter: "linear",
+				minFilter: "linear"
+			})
+		}, s.set(e, t);
+	}
+	return t;
+}
+var l = null;
+function u() {
+	return l || (l = new e.DataTexture(new Uint8Array([
+		0,
+		0,
+		0,
+		255
+	]), 1, 1, e.RGBAFormat), l.colorSpace = e.SRGBColorSpace, l.magFilter = e.LinearFilter, l.minFilter = e.LinearFilter, l.needsUpdate = !0), l;
+}
+var d = class {
+	constructor(e) {
+		this.device = null, this.useBlit = null, this.broken = !1, this.gpuTexture = null, this.externalTexture = null, this.width = 0, this.height = 0, this.frameDirty = !0, this.lastVideoTime = -1, this.videoFrameCallbackId = null, this.disposed = !1, this.videoTexture = e, this.scheduleVideoFrameCallback();
+	}
+	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.scheduleVideoFrameCallback();
+		}));
+	}
+	get texture() {
+		var e;
+		return this.broken || this.useBlit !== !0 ? this.videoTexture : (e = this.externalTexture) == null ? u() : e;
+	}
+	update(e) {
+		if (this.disposed || this.broken) return;
+		if (this.useBlit === null) {
+			let t = e == null ? void 0 : e.backend;
+			if (!t) return;
+			if (t.isWebGPUBackend !== !0) {
+				this.useBlit = !1;
+				return;
+			}
+			if (!t.device) return;
+			this.device = t.device, this.useBlit = !0;
+		}
+		if (!this.useBlit || !this.device) return;
+		let t = this.video;
+		if (t instanceof HTMLVideoElement && !(t.readyState < 2 || t.videoWidth === 0 || t.videoHeight === 0) && !(this.externalTexture && !this.frameDirty && t.currentTime === this.lastVideoTime)) try {
+			this.ensureTarget(t.videoWidth, t.videoHeight), this.blit(t), this.frameDirty = !1, this.lastVideoTime = t.currentTime;
+		} catch (e) {
+			console.warn("[Five] 视频纹理 GPU 中转失败，回退为 VideoTexture 上传", e), this.broken = !0, this.releaseTarget();
+		}
+	}
+	ensureTarget(t, n) {
+		let r = this.device, i = r.limits.maxTextureDimension2D, o = Math.min(1, i / Math.max(t, n)), s = Math.max(1, Math.floor(t * o)), c = Math.max(1, Math.floor(n * o));
+		if (this.gpuTexture && this.width === s && this.height === c) return;
+		let l = this.gpuTexture, u = r.createTexture({
+			label: "five.videoBlit.target",
+			size: {
+				width: s,
+				height: c
+			},
+			format: a,
+			usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT
+		});
+		if (this.gpuTexture = u, this.width = s, this.height = c, this.externalTexture) this.externalTexture.sourceTexture = u, this.externalTexture.image = {
+			width: s,
+			height: c
+		}, this.externalTexture.dispose();
+		else {
+			let t = new e.ExternalTexture(u);
+			t.colorSpace = e.SRGBColorSpace, t.flipY = !1, t.generateMipmaps = !1, t.minFilter = e.LinearFilter, t.magFilter = e.LinearFilter, t.wrapS = e.ClampToEdgeWrapping, t.wrapT = e.ClampToEdgeWrapping, t.image = {
+				width: s,
+				height: c
+			}, this.externalTexture = t;
+		}
+		l == null || l.destroy();
+	}
+	blit(e) {
+		let t = this.device, { pipeline: n, sampler: r } = c(t), i = t.importExternalTexture({ source: e }), a = t.createBindGroup({
+			layout: n.getBindGroupLayout(0),
+			entries: [{
+				binding: 0,
+				resource: i
+			}, {
+				binding: 1,
+				resource: r
+			}]
+		}), o = t.createCommandEncoder({ label: "five.videoBlit" }), s = o.beginRenderPass({ colorAttachments: [{
+			view: this.gpuTexture.createView(),
+			loadOp: "clear",
+			storeOp: "store",
+			clearValue: {
+				r: 0,
+				g: 0,
+				b: 0,
+				a: 1
+			}
+		}] });
+		s.setPipeline(n), s.setBindGroup(0, a), s.draw(3), s.end(), t.queue.submit([o.finish()]);
+	}
+	releaseTarget() {
+		var e, t;
+		(e = this.externalTexture) == null || e.dispose(), this.externalTexture = null, (t = this.gpuTexture) == null || t.destroy(), this.gpuTexture = null, this.width = this.height = 0;
+	}
+	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, this.releaseTarget();
+	}
+}, f = /* @__PURE__ */ new WeakMap();
+function p(e) {
+	let t = f.get(e);
+	if (!t) {
+		let n = new d(e);
+		t = n, f.set(e, n);
+		let r = () => {
+			e.removeEventListener("dispose", r), f.get(e) === n && f.delete(e), n.dispose();
+		};
+		e.addEventListener("dispose", r);
+	}
+	return t;
+}
+//#endregion
 //#region build/sticker/index.js
-var a = window, o = a.requestAnimationFrame || a.mozRequestAnimationFrame || a.webkitRequestAnimationFrame || a.msRequestAnimationFrame || ((e) => setTimeout(e, 16)), s = typeof performance < "u" && performance.timing !== void 0 ? performance.timing.navigationStart : Date.now(), c = typeof performance < "u" ? (() => s + performance.now()) : (() => Date.now());
-function l(e, t) {
-	e.naturalWidth > 0 && o(() => t());
+var m = window, h = m.requestAnimationFrame || m.mozRequestAnimationFrame || m.webkitRequestAnimationFrame || m.msRequestAnimationFrame || ((e) => setTimeout(e, 16)), g = typeof performance < "u" && performance.timing !== void 0 ? performance.timing.navigationStart : Date.now(), _ = typeof performance < "u" ? (() => g + performance.now()) : (() => Date.now());
+function v(e, t) {
+	e.naturalWidth > 0 && h(() => t());
 	let n = () => t();
 	return e.addEventListener("load", n, !1), () => e.removeEventListener("load", n, !1);
 }
-function u(e, t) {
-	let n = c(), r = !1, i = () => {
-		r = !0, t(), c() - n < 3e3 ? o(i) : r = !1;
+function y(e, t) {
+	let n = _(), r = !1, i = () => {
+		r = !0, t(), _() - n < 3e3 ? h(i) : r = !1;
 	}, a = () => {
-		n = c(), r === !1 && i();
+		n = _(), r === !1 && i();
 	};
 	return e.addEventListener("timeupdate", a, !1), () => {
 		e.removeEventListener("timeupdate", a, !1), r = !1;
 	};
 }
-function d(e, t) {
+function b(e, t) {
 	let n = e.dispose;
 	e.dispose = () => {
 		t(), n.call(e);
 	};
 }
-var f = class extends e.Mesh {
+var x = class extends e.Mesh {
 	static get version() {
-		return "1.0.0-alpha.12";
+		return "1.0.0-alpha.13";
 	}
 	constructor(t, n, r) {
 		let a = new e.MeshBasicMaterial();
-		if (super(i, a), this._needsRender = !1, this.scale.set(t, n, 1), typeof r == "string") {
+		if (super(i, a), this._sourceTexture = null, this._needsRender = !1, this.scale.set(t, n, 1), typeof r == "string") {
 			a.transparent = /\.png$/.test(r);
 			let e = new Image();
 			e.src = r, e.crossOrigin = "", r = e;
 		}
 		if (r instanceof HTMLImageElement) {
 			let t = a.map = new e.Texture();
-			t.wrapS = e.ClampToEdgeWrapping, t.wrapT = e.ClampToEdgeWrapping, t.minFilter = e.LinearFilter, t.colorSpace = e.SRGBColorSpace, d(t, l(r, () => {
+			t.wrapS = e.ClampToEdgeWrapping, t.wrapT = e.ClampToEdgeWrapping, t.minFilter = e.LinearFilter, t.colorSpace = e.SRGBColorSpace, b(t, v(r, () => {
 				t.image = r, t.needsUpdate = !0, this._needsRender = !0;
 			}));
 		} else if (r instanceof HTMLCanvasElement) a.map = new e.CanvasTexture(r);
 		else if (r instanceof HTMLVideoElement) {
 			let t = a.map = new e.VideoTexture(r);
-			t.wrapS = e.ClampToEdgeWrapping, t.wrapT = e.ClampToEdgeWrapping, t.minFilter = e.LinearFilter, t.colorSpace = e.SRGBColorSpace, d(t, u(r, () => {
+			t.wrapS = e.ClampToEdgeWrapping, t.wrapT = e.ClampToEdgeWrapping, t.minFilter = e.LinearFilter, t.colorSpace = e.SRGBColorSpace, b(t, y(r, () => {
 				this._needsRender = !0;
 			}));
+			let n = p(t);
+			this.onBeforeRender = (e) => {
+				n.update(e);
+				let t = n.texture;
+				a.map !== t && (a.map = t);
+			};
 		}
+		this._sourceTexture = a.map;
 	}
 	get needsRender() {
 		return this._needsRender;
 	}
 	set needsRender(e) {
-		this._needsRender = e, e === !0 && this.material.map && (this.material.map.needsUpdate = !0);
+		this._needsRender = e, e === !0 && this._sourceTexture && (this._sourceTexture.needsUpdate = !0);
 	}
 	setSize(e, t) {
 		this.scale.set(e, t, 1), this._needsRender = !0;
@@ -434,8 +591,8 @@ var f = class extends e.Mesh {
 	}
 	dispose() {
 		var e;
-		(e = this.material.map) == null || e.dispose(), this.material.dispose();
+		(e = this._sourceTexture) == null || e.dispose(), this.material.dispose();
 	}
 };
 //#endregion
-export { f as Sticker };
+export { x as Sticker };