@eva/plugin-renderer-mesh 2.0.1-beta.9 → 2.0.2-beta.0

package/dist/EVA.plugin.renderer.mesh.js

@@ -3,7 +3,6 @@ globalThis.EVA.plugin = globalThis.EVA.plugin || {};
 globalThis.EVA.plugin.renderer = globalThis.EVA.plugin.renderer || {};
 var _EVA_IIFE_mesh = function (exports, eva_js, pluginRenderer, pixi_js) {
   'use strict';
-
   class PerspectiveMesh extends eva_js.Component {
     constructor() {
       super(...arguments);

package/dist/EVA.plugin.renderer.mesh.min.js

@@ -1 +1 @@
-globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{},globalThis.EVA.plugin.renderer=globalThis.EVA.plugin.renderer||{};var _EVA_IIFE_mesh=function(e,r,s,t){"use strict";class n extends r.Component{constructor(){super(...arguments),this.verticesX=10,this.verticesY=10,this._forceUpdate=0}init(e){e&&e.resource&&(this.resource=e.resource),e&&e.verticesX&&(this.verticesX=e.verticesX),e&&e.verticesY&&(this.verticesY=e.verticesY)}setCorners(e,r,s,t,n,i,o,c){const a=this.corners||{};a.x0=e,a.y0=r,a.x1=s,a.y1=t,a.x2=n,a.y2=i,a.x3=o,a.y3=c,this.corners=a,this._forceUpdate+=1}}function i(e,r,s,t){return new(s||(s=Promise))((function(n,i){function o(e){try{a(t.next(e))}catch(e){i(e)}}function c(e){try{a(t.throw(e))}catch(e){i(e)}}function a(e){var r;e.done?n(e.value):(r=e.value,r instanceof s?r:new s((function(e){e(r)}))).then(o,c)}a((t=t.apply(e,r||[])).next())}))}n.componentName="PerspectiveMesh";let o=class extends s.Renderer{constructor(){super(...arguments),this.name="MeshSystem",this.meshes={}}init(){this.renderSystem=this.game.getSystem(s.RendererSystem),this.renderSystem.rendererManager.register(this)}componentChanged(e){var s,n;return i(this,void 0,void 0,(function*(){if("PerspectiveMesh"===e.componentName){const i=e.gameObject.id,o=e.component;if(e.type===r.OBSERVER_TYPE.ADD){const n=new t.PerspectiveMesh({texture:new t.Texture,verticesX:o.verticesX,verticesY:o.verticesY});this.meshes[e.gameObject.id]=n,this.containerManager.getContainer(e.gameObject.id).addChildAt(n,0);const c=this.increaseAsyncId(i),a=yield r.resource.getResource(o.resource),h=null===(s=a.data)||void 0===s?void 0:s.image;if(!this.validateAsyncId(i,c))return;if(!h)return void console.error(`GameObject:${e.gameObject.name}'s Mesh resource load error`);n.texture=h,o.corners?this.meshes[e.gameObject.id].setCorners(o.corners.x0,o.corners.y0,o.corners.x1,o.corners.y1,o.corners.x2,o.corners.y2,o.corners.x3,o.corners.y3):n.setCorners(0,0,h.width,0,h.width,h.height,0,h.height)}else if(e.type===r.OBSERVER_TYPE.CHANGE){const s=this.increaseAsyncId(i),t=yield r.resource.getResource(o.resource),c=null===(n=t.data)||void 0===n?void 0:n.image;if(!this.validateAsyncId(i,s))return;if(!c)return void console.error(`GameObject:${e.gameObject.name}'s Mesh resource load error`);this.meshes[e.gameObject.id].texture=c,o.corners&&this.meshes[e.gameObject.id].setCorners(o.corners.x0,o.corners.y0,o.corners.x1,o.corners.y1,o.corners.x2,o.corners.y2,o.corners.x3,o.corners.y3)}else if(e.type===r.OBSERVER_TYPE.REMOVE){this.increaseAsyncId(i);const r=this.meshes[e.gameObject.id];this.containerManager.getContainer(e.gameObject.id).removeChild(r),r.destroy(),delete this.meshes[e.gameObject.id]}}}))}destroy(){var e,r;for(const s in this.meshes){const t=this.meshes[s];null===(r=null===(e=this.containerManager)||void 0===e?void 0:e.getContainer(parseInt(s)))||void 0===r||r.removeChild(t),t.destroy(),delete this.meshes[s]}}};o.systemName="MeshSystem",o=function(e,r,s,t){var n,i=arguments.length,o=i<3?r:null===t?t=Object.getOwnPropertyDescriptor(r,s):t;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,r,s,t);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(o=(i<3?n(o):i>3?n(r,s,o):n(r,s))||o);return i>3&&o&&Object.defineProperty(r,s,o),o}([r.decorators.componentObserver({PerspectiveMesh:["resource","_forceUpdate"]})],o);var c=o;return e.MeshSystem=c,e.PerspectiveMesh=n,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer,PIXI);globalThis.EVA.plugin.renderer.mesh=globalThis.EVA.plugin.renderer.mesh||_EVA_IIFE_mesh;
+globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{},globalThis.EVA.plugin.renderer=globalThis.EVA.plugin.renderer||{};var _EVA_IIFE_mesh=function(e,r,s,t){"use strict";class n extends r.Component{constructor(){super(...arguments),this.verticesX=10,this.verticesY=10,this._forceUpdate=0}init(e){e&&e.resource&&(this.resource=e.resource),e&&e.verticesX&&(this.verticesX=e.verticesX),e&&e.verticesY&&(this.verticesY=e.verticesY)}setCorners(e,r,s,t,n,i,o,c){const a=this.corners||{};a.x0=e,a.y0=r,a.x1=s,a.y1=t,a.x2=n,a.y2=i,a.x3=o,a.y3=c,this.corners=a,this._forceUpdate+=1}}function i(e,r,s,t){return new(s||(s=Promise))(function(n,i){function o(e){try{a(t.next(e))}catch(e){i(e)}}function c(e){try{a(t.throw(e))}catch(e){i(e)}}function a(e){var r;e.done?n(e.value):(r=e.value,r instanceof s?r:new s(function(e){e(r)})).then(o,c)}a((t=t.apply(e,r||[])).next())})}n.componentName="PerspectiveMesh";let o=class extends s.Renderer{constructor(){super(...arguments),this.name="MeshSystem",this.meshes={}}init(){this.renderSystem=this.game.getSystem(s.RendererSystem),this.renderSystem.rendererManager.register(this)}componentChanged(e){var s,n;return i(this,void 0,void 0,function*(){if("PerspectiveMesh"===e.componentName){const i=e.gameObject.id,o=e.component;if(e.type===r.OBSERVER_TYPE.ADD){const n=new t.PerspectiveMesh({texture:new t.Texture,verticesX:o.verticesX,verticesY:o.verticesY});this.meshes[e.gameObject.id]=n,this.containerManager.getContainer(e.gameObject.id).addChildAt(n,0);const c=this.increaseAsyncId(i),a=yield r.resource.getResource(o.resource),h=null===(s=a.data)||void 0===s?void 0:s.image;if(!this.validateAsyncId(i,c))return;if(!h)return void console.error(`GameObject:${e.gameObject.name}'s Mesh resource load error`);n.texture=h,o.corners?this.meshes[e.gameObject.id].setCorners(o.corners.x0,o.corners.y0,o.corners.x1,o.corners.y1,o.corners.x2,o.corners.y2,o.corners.x3,o.corners.y3):n.setCorners(0,0,h.width,0,h.width,h.height,0,h.height)}else if(e.type===r.OBSERVER_TYPE.CHANGE){const s=this.increaseAsyncId(i),t=yield r.resource.getResource(o.resource),c=null===(n=t.data)||void 0===n?void 0:n.image;if(!this.validateAsyncId(i,s))return;if(!c)return void console.error(`GameObject:${e.gameObject.name}'s Mesh resource load error`);this.meshes[e.gameObject.id].texture=c,o.corners&&this.meshes[e.gameObject.id].setCorners(o.corners.x0,o.corners.y0,o.corners.x1,o.corners.y1,o.corners.x2,o.corners.y2,o.corners.x3,o.corners.y3)}else if(e.type===r.OBSERVER_TYPE.REMOVE){this.increaseAsyncId(i);const r=this.meshes[e.gameObject.id];this.containerManager.getContainer(e.gameObject.id).removeChild(r),r.destroy(),delete this.meshes[e.gameObject.id]}}})}destroy(){var e,r;for(const s in this.meshes){const t=this.meshes[s];null===(r=null===(e=this.containerManager)||void 0===e?void 0:e.getContainer(parseInt(s)))||void 0===r||r.removeChild(t),t.destroy(),delete this.meshes[s]}}};o.systemName="MeshSystem",o=function(e,r,s,t){var n,i=arguments.length,o=i<3?r:null===t?t=Object.getOwnPropertyDescriptor(r,s):t;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,r,s,t);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(o=(i<3?n(o):i>3?n(r,s,o):n(r,s))||o);return i>3&&o&&Object.defineProperty(r,s,o),o}([r.decorators.componentObserver({PerspectiveMesh:["resource","_forceUpdate"]})],o);var c=o;return e.MeshSystem=c,e.PerspectiveMesh=n,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer,PIXI);globalThis.EVA.plugin.renderer.mesh=globalThis.EVA.plugin.renderer.mesh||_EVA_IIFE_mesh;

package/dist/plugin-renderer-mesh.cjs.js

@@ -6,13 +6,69 @@ var eva_js = require('@eva/eva.js');
 var pluginRenderer = require('@eva/plugin-renderer');
 var pixi_js = require('pixi.js');
 
+/**
+ * 透视网格组件
+ *
+ * PerspectiveMesh 组件用于创建具有透视变形效果的图片。
+ * 通过将图片分割成网格并调整四个角的位置，可以实现 3D 透视、梯形变换等效果，
+ * 适用于翻书效果、卡片翻转、3D 地面贴图等场景。
+ *
+ * 工作原理：
+ * - 将图片分割成 M×N 的网格
+ * - 通过调整四个角的位置实现透视变换
+ * - 网格越密集，变形效果越平滑
+ *
+ * @example
+ * ```typescript
+ * // 创建透视变形的图片
+ * const card = new GameObject('card');
+ * const mesh = new PerspectiveMesh({
+ *   resource: 'cardImage',
+ *   verticesX: 10, // 横向网格数
+ *   verticesY: 10  // 纵向网格数
+ * });
+ * card.addComponent(mesh);
+ *
+ * // 设置四个角的位置实现透视效果
+ * // 参数：左上(x0,y0), 右上(x1,y1), 右下(x2,y2), 左下(x3,y3)
+ * mesh.setCorners(
+ *   50, 0,    // 左上角
+ *   350, 0,   // 右上角
+ *   400, 300, // 右下角
+ *   0, 300    // 左下角
+ * );
+ *
+ * // 创建翻书效果
+ * let angle = 0;
+ * setInterval(() => {
+ *   angle += 0.1;
+ *   const offset = Math.sin(angle) * 50;
+ *   mesh.setCorners(
+ *     offset, 0,
+ *     400 - offset, 0,
+ *     400, 300,
+ *     0, 300
+ *   );
+ * }, 16);
+ * ```
+ */
 class PerspectiveMesh extends eva_js.Component {
     constructor() {
         super(...arguments);
+        /** 横向顶点数量（网格密度） */
         this.verticesX = 10;
+        /** 纵向顶点数量（网格密度） */
         this.verticesY = 10;
+        /** 强制更新标志 */
         this._forceUpdate = 0;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 纹理资源名称
+     * @param obj.verticesX - 横向网格密度
+     * @param obj.verticesY - 纵向网格密度
+     */
     init(obj) {
         if (obj && obj.resource) {
             this.resource = obj.resource;
@@ -24,6 +80,20 @@ class PerspectiveMesh extends eva_js.Component {
             this.verticesY = obj.verticesY;
         }
     }
+    /**
+     * 设置四个角的位置
+     *
+     * 通过改变四个角的坐标来实现透视变换效果。
+     *
+     * @param x0 - 左上角 X 坐标
+     * @param y0 - 左上角 Y 坐标
+     * @param x1 - 右上角 X 坐标
+     * @param y1 - 右上角 Y 坐标
+     * @param x2 - 右下角 X 坐标
+     * @param y2 - 右下角 Y 坐标
+     * @param x3 - 左下角 X 坐标
+     * @param y3 - 左下角 Y 坐标
+     */
     setCorners(x0, y0, x1, y1, x2, y2, x3, y3) {
         const corners = this.corners || {};
         corners.x0 = x0;
@@ -38,21 +108,22 @@ class PerspectiveMesh extends eva_js.Component {
         this._forceUpdate += 1;
     }
 }
+/** 组件名称 */
 PerspectiveMesh.componentName = 'PerspectiveMesh';
 
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
 
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABLITY OR NON-INFRINGEMENT.
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
 
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
 
 function __decorate(decorators, target, key, desc) {
@@ -63,13 +134,19 @@ function __decorate(decorators, target, key, desc) {
 }
 
 function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
         function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
         function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
-}
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
 
 let MeshSystem = class MeshSystem extends pluginRenderer.Renderer {
     constructor() {

package/dist/plugin-renderer-mesh.cjs.prod.js

@@ -1,16 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),r=require("@eva/plugin-renderer"),t=require("pixi.js");class s extends e.Component{constructor(){super(...arguments),this.verticesX=10,this.verticesY=10,this._forceUpdate=0}init(e){e&&e.resource&&(this.resource=e.resource),e&&e.verticesX&&(this.verticesX=e.verticesX),e&&e.verticesY&&(this.verticesY=e.verticesY)}setCorners(e,r,t,s,n,i,o,c){const a=this.corners||{};a.x0=e,a.y0=r,a.x1=t,a.y1=s,a.x2=n,a.y2=i,a.x3=o,a.y3=c,this.corners=a,this._forceUpdate+=1}}s.componentName="PerspectiveMesh";let n=class extends r.Renderer{constructor(){super(...arguments),this.name="MeshSystem",this.meshes={}}init(){this.renderSystem=this.game.getSystem(r.RendererSystem),this.renderSystem.rendererManager.register(this)}componentChanged(r){var s,n,i,o,c,a;return i=this,o=void 0,a=function*(){if("PerspectiveMesh"===r.componentName){const i=r.gameObject.id,o=r.component;if(r.type===e.OBSERVER_TYPE.ADD){const n=new t.PerspectiveMesh({texture:new t.Texture,verticesX:o.verticesX,verticesY:o.verticesY});this.meshes[r.gameObject.id]=n,this.containerManager.getContainer(r.gameObject.id).addChildAt(n,0);const c=this.increaseAsyncId(i),a=yield e.resource.getResource(o.resource),h=null===(s=a.data)||void 0===s?void 0:s.image;if(!this.validateAsyncId(i,c))return;if(!h)return void console.error(`GameObject:${r.gameObject.name}'s Mesh resource load error`);n.texture=h,o.corners?this.meshes[r.gameObject.id].setCorners(o.corners.x0,o.corners.y0,o.corners.x1,o.corners.y1,o.corners.x2,o.corners.y2,o.corners.x3,o.corners.y3):n.setCorners(0,0,h.width,0,h.width,h.height,0,h.height)}else if(r.type===e.OBSERVER_TYPE.CHANGE){const t=this.increaseAsyncId(i),s=yield e.resource.getResource(o.resource),c=null===(n=s.data)||void 0===n?void 0:n.image;if(!this.validateAsyncId(i,t))return;if(!c)return void console.error(`GameObject:${r.gameObject.name}'s Mesh resource load error`);this.meshes[r.gameObject.id].texture=c,o.corners&&this.meshes[r.gameObject.id].setCorners(o.corners.x0,o.corners.y0,o.corners.x1,o.corners.y1,o.corners.x2,o.corners.y2,o.corners.x3,o.corners.y3)}else if(r.type===e.OBSERVER_TYPE.REMOVE){this.increaseAsyncId(i);const e=this.meshes[r.gameObject.id];this.containerManager.getContainer(r.gameObject.id).removeChild(e),e.destroy(),delete this.meshes[r.gameObject.id]}}},new((c=void 0)||(c=Promise))((function(e,r){function t(e){try{n(a.next(e))}catch(e){r(e)}}function s(e){try{n(a.throw(e))}catch(e){r(e)}}function n(r){r.done?e(r.value):new c((function(e){e(r.value)})).then(t,s)}n((a=a.apply(i,o||[])).next())}))}destroy(){var e,r;for(const t in this.meshes){const s=this.meshes[t];null===(r=null===(e=this.containerManager)||void 0===e?void 0:e.getContainer(parseInt(t)))||void 0===r||r.removeChild(s),s.destroy(),delete this.meshes[t]}}};n.systemName="MeshSystem",n=
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
-
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABLITY OR NON-INFRINGEMENT.
-
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
-***************************************************************************** */
-function(e,r,t,s){var n,i=arguments.length,o=i<3?r:null===s?s=Object.getOwnPropertyDescriptor(r,t):s;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,r,t,s);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(o=(i<3?n(o):i>3?n(r,t,o):n(r,t))||o);return i>3&&o&&Object.defineProperty(r,t,o),o}([e.decorators.componentObserver({PerspectiveMesh:["resource","_forceUpdate"]})],n);var i=n;exports.MeshSystem=i,exports.PerspectiveMesh=s;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),r=require("@eva/plugin-renderer"),t=require("pixi.js");class s extends e.Component{constructor(){super(...arguments),this.verticesX=10,this.verticesY=10,this._forceUpdate=0}init(e){e&&e.resource&&(this.resource=e.resource),e&&e.verticesX&&(this.verticesX=e.verticesX),e&&e.verticesY&&(this.verticesY=e.verticesY)}setCorners(e,r,t,s,n,i,o,c){const a=this.corners||{};a.x0=e,a.y0=r,a.x1=t,a.y1=s,a.x2=n,a.y2=i,a.x3=o,a.y3=c,this.corners=a,this._forceUpdate+=1}}function n(e,r,t,s){return new(t||(t=Promise))(function(n,i){function o(e){try{a(s.next(e))}catch(e){i(e)}}function c(e){try{a(s.throw(e))}catch(e){i(e)}}function a(e){var r;e.done?n(e.value):(r=e.value,r instanceof t?r:new t(function(e){e(r)})).then(o,c)}a((s=s.apply(e,r||[])).next())})}s.componentName="PerspectiveMesh","function"==typeof SuppressedError&&SuppressedError;let i=class extends r.Renderer{constructor(){super(...arguments),this.name="MeshSystem",this.meshes={}}init(){this.renderSystem=this.game.getSystem(r.RendererSystem),this.renderSystem.rendererManager.register(this)}componentChanged(r){var s,i;return n(this,void 0,void 0,function*(){if("PerspectiveMesh"===r.componentName){const n=r.gameObject.id,o=r.component;if(r.type===e.OBSERVER_TYPE.ADD){const i=new t.PerspectiveMesh({texture:new t.Texture,verticesX:o.verticesX,verticesY:o.verticesY});this.meshes[r.gameObject.id]=i,this.containerManager.getContainer(r.gameObject.id).addChildAt(i,0);const c=this.increaseAsyncId(n),a=yield e.resource.getResource(o.resource),h=null===(s=a.data)||void 0===s?void 0:s.image;if(!this.validateAsyncId(n,c))return;if(!h)return void console.error(`GameObject:${r.gameObject.name}'s Mesh resource load error`);i.texture=h,o.corners?this.meshes[r.gameObject.id].setCorners(o.corners.x0,o.corners.y0,o.corners.x1,o.corners.y1,o.corners.x2,o.corners.y2,o.corners.x3,o.corners.y3):i.setCorners(0,0,h.width,0,h.width,h.height,0,h.height)}else if(r.type===e.OBSERVER_TYPE.CHANGE){const t=this.increaseAsyncId(n),s=yield e.resource.getResource(o.resource),c=null===(i=s.data)||void 0===i?void 0:i.image;if(!this.validateAsyncId(n,t))return;if(!c)return void console.error(`GameObject:${r.gameObject.name}'s Mesh resource load error`);this.meshes[r.gameObject.id].texture=c,o.corners&&this.meshes[r.gameObject.id].setCorners(o.corners.x0,o.corners.y0,o.corners.x1,o.corners.y1,o.corners.x2,o.corners.y2,o.corners.x3,o.corners.y3)}else if(r.type===e.OBSERVER_TYPE.REMOVE){this.increaseAsyncId(n);const e=this.meshes[r.gameObject.id];this.containerManager.getContainer(r.gameObject.id).removeChild(e),e.destroy(),delete this.meshes[r.gameObject.id]}}})}destroy(){var e,r;for(const t in this.meshes){const s=this.meshes[t];null===(r=null===(e=this.containerManager)||void 0===e?void 0:e.getContainer(parseInt(t)))||void 0===r||r.removeChild(s),s.destroy(),delete this.meshes[t]}}};i.systemName="MeshSystem",i=function(e,r,t,s){var n,i=arguments.length,o=i<3?r:null===s?s=Object.getOwnPropertyDescriptor(r,t):s;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)o=Reflect.decorate(e,r,t,s);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(o=(i<3?n(o):i>3?n(r,t,o):n(r,t))||o);return i>3&&o&&Object.defineProperty(r,t,o),o}([e.decorators.componentObserver({PerspectiveMesh:["resource","_forceUpdate"]})],i);var o=i;exports.MeshSystem=o,exports.PerspectiveMesh=s;

package/dist/plugin-renderer-mesh.d.ts

@@ -24,14 +24,87 @@ export declare class MeshSystem extends Renderer {
     destroy(): void;
 }
 
+/**
+ * 透视网格组件
+ *
+ * PerspectiveMesh 组件用于创建具有透视变形效果的图片。
+ * 通过将图片分割成网格并调整四个角的位置，可以实现 3D 透视、梯形变换等效果，
+ * 适用于翻书效果、卡片翻转、3D 地面贴图等场景。
+ *
+ * 工作原理：
+ * - 将图片分割成 M×N 的网格
+ * - 通过调整四个角的位置实现透视变换
+ * - 网格越密集，变形效果越平滑
+ *
+ * @example
+ * ```typescript
+ * // 创建透视变形的图片
+ * const card = new GameObject('card');
+ * const mesh = new PerspectiveMesh({
+ *   resource: 'cardImage',
+ *   verticesX: 10, // 横向网格数
+ *   verticesY: 10  // 纵向网格数
+ * });
+ * card.addComponent(mesh);
+ *
+ * // 设置四个角的位置实现透视效果
+ * // 参数：左上(x0,y0), 右上(x1,y1), 右下(x2,y2), 左下(x3,y3)
+ * mesh.setCorners(
+ *   50, 0,    // 左上角
+ *   350, 0,   // 右上角
+ *   400, 300, // 右下角
+ *   0, 300    // 左下角
+ * );
+ *
+ * // 创建翻书效果
+ * let angle = 0;
+ * setInterval(() => {
+ *   angle += 0.1;
+ *   const offset = Math.sin(angle) * 50;
+ *   mesh.setCorners(
+ *     offset, 0,
+ *     400 - offset, 0,
+ *     400, 300,
+ *     0, 300
+ *   );
+ * }, 16);
+ * ```
+ */
 export declare class PerspectiveMesh extends Component<PerspectiveMeshParams> {
+    /** 组件名称 */
     static componentName: string;
+    /** 纹理资源名称 */
     resource: string;
+    /** 横向顶点数量（网格密度） */
     verticesX: number;
+    /** 纵向顶点数量（网格密度） */
     verticesY: number;
+    /** 四个角的坐标位置 */
     corners: Corners;
+    /** 强制更新标志 */
     _forceUpdate: number;
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 纹理资源名称
+     * @param obj.verticesX - 横向网格密度
+     * @param obj.verticesY - 纵向网格密度
+     */
     init(obj?: PerspectiveMeshParams): void;
+    /**
+     * 设置四个角的位置
+     *
+     * 通过改变四个角的坐标来实现透视变换效果。
+     *
+     * @param x0 - 左上角 X 坐标
+     * @param y0 - 左上角 Y 坐标
+     * @param x1 - 右上角 X 坐标
+     * @param y1 - 右上角 Y 坐标
+     * @param x2 - 右下角 X 坐标
+     * @param y2 - 右下角 Y 坐标
+     * @param x3 - 左下角 X 坐标
+     * @param y3 - 左下角 Y 坐标
+     */
     setCorners(x0: number, y0: number, x1: number, y1: number, x2: number, y2: number, x3: number, y3: number): void;
 }
 

package/dist/plugin-renderer-mesh.esm.js

@@ -2,13 +2,69 @@ import { Component, decorators, OBSERVER_TYPE, resource } from '@eva/eva.js';
 import { Renderer, RendererSystem } from '@eva/plugin-renderer';
 import { PerspectiveMesh as PerspectiveMesh$1, Texture } from 'pixi.js';
 
+/**
+ * 透视网格组件
+ *
+ * PerspectiveMesh 组件用于创建具有透视变形效果的图片。
+ * 通过将图片分割成网格并调整四个角的位置，可以实现 3D 透视、梯形变换等效果，
+ * 适用于翻书效果、卡片翻转、3D 地面贴图等场景。
+ *
+ * 工作原理：
+ * - 将图片分割成 M×N 的网格
+ * - 通过调整四个角的位置实现透视变换
+ * - 网格越密集，变形效果越平滑
+ *
+ * @example
+ * ```typescript
+ * // 创建透视变形的图片
+ * const card = new GameObject('card');
+ * const mesh = new PerspectiveMesh({
+ *   resource: 'cardImage',
+ *   verticesX: 10, // 横向网格数
+ *   verticesY: 10  // 纵向网格数
+ * });
+ * card.addComponent(mesh);
+ *
+ * // 设置四个角的位置实现透视效果
+ * // 参数：左上(x0,y0), 右上(x1,y1), 右下(x2,y2), 左下(x3,y3)
+ * mesh.setCorners(
+ *   50, 0,    // 左上角
+ *   350, 0,   // 右上角
+ *   400, 300, // 右下角
+ *   0, 300    // 左下角
+ * );
+ *
+ * // 创建翻书效果
+ * let angle = 0;
+ * setInterval(() => {
+ *   angle += 0.1;
+ *   const offset = Math.sin(angle) * 50;
+ *   mesh.setCorners(
+ *     offset, 0,
+ *     400 - offset, 0,
+ *     400, 300,
+ *     0, 300
+ *   );
+ * }, 16);
+ * ```
+ */
 class PerspectiveMesh extends Component {
     constructor() {
         super(...arguments);
+        /** 横向顶点数量（网格密度） */
         this.verticesX = 10;
+        /** 纵向顶点数量（网格密度） */
         this.verticesY = 10;
+        /** 强制更新标志 */
         this._forceUpdate = 0;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 纹理资源名称
+     * @param obj.verticesX - 横向网格密度
+     * @param obj.verticesY - 纵向网格密度
+     */
     init(obj) {
         if (obj && obj.resource) {
             this.resource = obj.resource;
@@ -20,6 +76,20 @@ class PerspectiveMesh extends Component {
             this.verticesY = obj.verticesY;
         }
     }
+    /**
+     * 设置四个角的位置
+     *
+     * 通过改变四个角的坐标来实现透视变换效果。
+     *
+     * @param x0 - 左上角 X 坐标
+     * @param y0 - 左上角 Y 坐标
+     * @param x1 - 右上角 X 坐标
+     * @param y1 - 右上角 Y 坐标
+     * @param x2 - 右下角 X 坐标
+     * @param y2 - 右下角 Y 坐标
+     * @param x3 - 左下角 X 坐标
+     * @param y3 - 左下角 Y 坐标
+     */
     setCorners(x0, y0, x1, y1, x2, y2, x3, y3) {
         const corners = this.corners || {};
         corners.x0 = x0;
@@ -34,21 +104,22 @@ class PerspectiveMesh extends Component {
         this._forceUpdate += 1;
     }
 }
+/** 组件名称 */
 PerspectiveMesh.componentName = 'PerspectiveMesh';
 
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
 
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABLITY OR NON-INFRINGEMENT.
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
 
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
 
 function __decorate(decorators, target, key, desc) {
@@ -59,13 +130,19 @@ function __decorate(decorators, target, key, desc) {
 }
 
 function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
         function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
         function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
-}
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
 
 let MeshSystem = class MeshSystem extends Renderer {
     constructor() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eva/plugin-renderer-mesh",
-  "version": "2.0.1-beta.9",
+  "version": "2.0.2-beta.0",
   "description": "@eva/plugin-renderer-mesh",
   "main": "index.js",
   "module": "dist/plugin-renderer-mesh.esm.js",
@@ -19,8 +19,8 @@
   "homepage": "https://eva.js.org",
   "dependencies": {
     "@eva/inspector-decorator": "^0.0.5",
-    "@eva/plugin-renderer": "2.0.1-beta.9",
-    "@eva/eva.js": "2.0.1-beta.9",
-    "pixi.js": "^8.8.1"
+    "@eva/plugin-renderer": "2.0.2-beta.0",
+    "@eva/eva.js": "2.0.2-beta.0",
+    "pixi.js": "^8.17.0"
   }
 }