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

package/dist/EVA.plugin.renderer.tilingSprite.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_tilingSprite=function(e,t,i,r){"use strict";function n(e,t,i,r){var n,o=arguments.length,s=o<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,i):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,i,r);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(s=(o<3?n(s):o>3?n(t,i,s):n(t,i))||s);return o>3&&s&&Object.defineProperty(t,i,s),s}function o(e,t,i,r){return new(i||(i=Promise))((function(n,o){function s(e){try{l(r.next(e))}catch(e){o(e)}}function c(e){try{l(r.throw(e))}catch(e){o(e)}}function l(e){var t;e.done?n(e.value):(t=e.value,t instanceof i?t:new i((function(e){e(t)}))).then(s,c)}l((r=r.apply(e,t||[])).next())}))}function s(e,t){return e.constructor.IDEProps||(e.constructor.IDEProps={}),e.constructor.IDEProps[t]||(e.constructor.IDEProps[t]={}),e.constructor.IDEProps[t]}function c(e){return function(t,i){var r=s(t,i);r.key=i,r.type=e}}function l(e){return function(t,i){s(t,i).step=e}}class a extends t.Component{constructor(){super(...arguments),this.resource="",this.tileScale={x:1,y:1},this.tilePosition={x:0,y:0}}init(e){e&&(this.resource=e.resource,this.tileScale=e.tileScale,this.tilePosition=e.tilePosition)}}a.componentName="TilingSprite",n([c("string")],a.prototype,"resource",void 0),n([c("vector2"),l(.1)],a.prototype,"tileScale",void 0),n([c("vector2"),l(1)],a.prototype,"tilePosition",void 0);let p=class extends i.Renderer{constructor(){super(...arguments),this.name="TilingSprite",this.imgs={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size,r=this.imgs[e.id];r&&(r.tilingSprite.width=t,r.tilingSprite.height=i)}componentChanged(e){return o(this,void 0,void 0,(function*(){const i=e.gameObject.id;if("TilingSprite"===e.componentName){const n=e.component;if(e.type===t.OBSERVER_TYPE.ADD){const o=new r.TilingSprite(null);this.imgs[e.gameObject.id]=o,this.containerManager.getContainer(e.gameObject.id).addChildAt(o.tilingSprite,0),this.setProp(e.gameObject.id,n);const s=this.increaseAsyncId(i),{data:c}=yield t.resource.getResource(n.resource);if(!this.validateAsyncId(i,s))return;if(!c)return void console.error(`GameObject:${e.gameObject.name}'s TilingSprite resource load error`);o.image=c.image}else if(e.type===t.OBSERVER_TYPE.CHANGE)if("resource"===e.prop.prop[0]){const r=this.increaseAsyncId(i),{data:o}=yield t.resource.getResource(n.resource);if(!this.validateAsyncId(i,r))return;if(!o)return void console.error(`GameObject:${e.gameObject.name}'s TilingSprite resource load error`);this.imgs[e.gameObject.id].image=o.image}else this.setProp(e.gameObject.id,n);else if(e.type===t.OBSERVER_TYPE.REMOVE){this.increaseAsyncId(i);const t=this.imgs[e.gameObject.id];this.containerManager.getContainer(e.gameObject.id).removeChild(t.tilingSprite),t.tilingSprite.destroy({children:!0}),delete this.imgs[e.gameObject.id]}}}))}setProp(e,t){this.imgs[e].tilingSprite.tilePosition=t.tilePosition,this.imgs[e].tilingSprite.tileScale=t.tileScale}};p=n([t.decorators.componentObserver({TilingSprite:[{prop:["resource"],deep:!1},{prop:["tileScale"],deep:!0},{prop:["tilePosition"],deep:!0}]})],p);var g=p;return e.TilingSprite=a,e.TilingSpriteSystem=g,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer,EVA.rendererAdapter);globalThis.EVA.plugin.renderer.tilingSprite=globalThis.EVA.plugin.renderer.tilingSprite||_EVA_IIFE_tilingSprite;
+globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{},globalThis.EVA.plugin.renderer=globalThis.EVA.plugin.renderer||{};var _EVA_IIFE_tilingSprite=function(e,t,i,r){"use strict";function n(e,t,i,r){var n,o=arguments.length,s=o<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,i):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,i,r);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(s=(o<3?n(s):o>3?n(t,i,s):n(t,i))||s);return o>3&&s&&Object.defineProperty(t,i,s),s}function o(e,t,i,r){return new(i||(i=Promise))(function(n,o){function s(e){try{l(r.next(e))}catch(e){o(e)}}function c(e){try{l(r.throw(e))}catch(e){o(e)}}function l(e){var t;e.done?n(e.value):(t=e.value,t instanceof i?t:new i(function(e){e(t)})).then(s,c)}l((r=r.apply(e,t||[])).next())})}function s(e,t){return e.constructor.IDEProps||(e.constructor.IDEProps={}),e.constructor.IDEProps[t]||(e.constructor.IDEProps[t]={}),e.constructor.IDEProps[t]}function c(e){return function(t,i){var r=s(t,i);r.key=i,r.type=e}}function l(e){return function(t,i){s(t,i).step=e}}class a extends t.Component{constructor(){super(...arguments),this.resource="",this.tileScale={x:1,y:1},this.tilePosition={x:0,y:0}}init(e){e&&(this.resource=e.resource,this.tileScale=e.tileScale,this.tilePosition=e.tilePosition)}}a.componentName="TilingSprite",n([c("string")],a.prototype,"resource",void 0),n([c("vector2"),l(.1)],a.prototype,"tileScale",void 0),n([c("vector2"),l(1)],a.prototype,"tilePosition",void 0);let p=class extends i.Renderer{constructor(){super(...arguments),this.name="TilingSprite",this.imgs={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size,r=this.imgs[e.id];r&&(r.tilingSprite.width=t,r.tilingSprite.height=i)}componentChanged(e){return o(this,void 0,void 0,function*(){const i=e.gameObject.id;if("TilingSprite"===e.componentName){const n=e.component;if(e.type===t.OBSERVER_TYPE.ADD){const o=new r.TilingSprite(null);this.imgs[e.gameObject.id]=o,this.containerManager.getContainer(e.gameObject.id).addChildAt(o.tilingSprite,0),this.setProp(e.gameObject.id,n);const s=this.increaseAsyncId(i),{data:c}=yield t.resource.getResource(n.resource);if(!this.validateAsyncId(i,s))return;if(!c)return void console.error(`GameObject:${e.gameObject.name}'s TilingSprite resource load error`);o.image=c.image}else if(e.type===t.OBSERVER_TYPE.CHANGE)if("resource"===e.prop.prop[0]){const r=this.increaseAsyncId(i),{data:o}=yield t.resource.getResource(n.resource);if(!this.validateAsyncId(i,r))return;if(!o)return void console.error(`GameObject:${e.gameObject.name}'s TilingSprite resource load error`);this.imgs[e.gameObject.id].image=o.image}else this.setProp(e.gameObject.id,n);else if(e.type===t.OBSERVER_TYPE.REMOVE){this.increaseAsyncId(i);const t=this.imgs[e.gameObject.id];this.containerManager.getContainer(e.gameObject.id).removeChild(t.tilingSprite),t.tilingSprite.destroy({children:!0}),delete this.imgs[e.gameObject.id]}}})}setProp(e,t){this.imgs[e].tilingSprite.tilePosition=t.tilePosition,this.imgs[e].tilingSprite.tileScale=t.tileScale}};p=n([t.decorators.componentObserver({TilingSprite:[{prop:["resource"],deep:!1},{prop:["tileScale"],deep:!0},{prop:["tilePosition"],deep:!0}]})],p);var g=p;return e.TilingSprite=a,e.TilingSpriteSystem=g,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer,EVA.rendererAdapter);globalThis.EVA.plugin.renderer.tilingSprite=globalThis.EVA.plugin.renderer.tilingSprite||_EVA_IIFE_tilingSprite;

package/dist/plugin-renderer-tiling-sprite.cjs.js

@@ -7,19 +7,19 @@ var inspectorDecorator = require('@eva/inspector-decorator');
 var pluginRenderer = require('@eva/plugin-renderer');
 var rendererAdapter = require('@eva/renderer-adapter');
 
-/*! *****************************************************************************
-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) {
@@ -30,27 +30,83 @@ 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;
+};
 
+/**
+ * 平铺精灵组件
+ *
+ * TilingSprite 组件用于创建可平铺重复的纹理，支持无限滚动效果。
+ * 纹理会在指定区域内重复平铺，并可以设置平铺的缩放和偏移，
+ * 适用于背景滚动、地面贴图、水面波纹等需要重复纹理的场景。
+ *
+ * 主要功能：
+ * - 纹理平铺重复
+ * - 支持平铺缩放
+ * - 支持平铺偏移（实现滚动效果）
+ * - 性能优化（只渲染可见区域）
+ *
+ * @example
+ * ```typescript
+ * // 创建滚动背景
+ * const background = new GameObject('background');
+ * background.addComponent(new TilingSprite({
+ *   resource: 'bgTile', // 平铺纹理资源
+ *   tileScale: { x: 1, y: 1 }, // 平铺缩放
+ *   tilePosition: { x: 0, y: 0 } // 平铺偏移
+ * }));
+ * background.transform.size = { width: 800, height: 600 };
+ *
+ * // 实现无限滚动
+ * const tilingSprite = background.getComponent('TilingSprite');
+ * let offset = 0;
+ * setInterval(() => {
+ *   offset += 1;
+ *   tilingSprite.tilePosition = { x: offset, y: 0 };
+ * }, 16);
+ *
+ * // 创建水面效果
+ * const water = new GameObject('water');
+ * water.addComponent(new TilingSprite({
+ *   resource: 'waterTile',
+ *   tileScale: { x: 2, y: 2 } // 放大 2 倍平铺
+ * }));
+ * ```
+ */
 class TilingSprite$2 extends eva_js.Component {
     constructor() {
         super(...arguments);
+        /** 平铺纹理资源名称 */
         this.resource = '';
+        /** 平铺缩放比例 */
         this.tileScale = {
             x: 1,
             y: 1,
         };
+        /** 平铺位置偏移（用于实现滚动效果） */
         this.tilePosition = {
             x: 0,
             y: 0,
         };
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 纹理资源名称
+     * @param obj.tileScale - 平铺缩放
+     * @param obj.tilePosition - 平铺偏移
+     */
     init(obj) {
         if (obj) {
             this.resource = obj.resource;
@@ -59,6 +115,7 @@ class TilingSprite$2 extends eva_js.Component {
         }
     }
 }
+/** 组件名称 */
 TilingSprite$2.componentName = 'TilingSprite';
 __decorate([
     inspectorDecorator.type('string')

package/dist/plugin-renderer-tiling-sprite.cjs.prod.js

@@ -1,16 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/inspector-decorator"),i=require("@eva/plugin-renderer"),r=require("@eva/renderer-adapter");
-/*! *****************************************************************************
-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 n(e,t,i,r){var n,o=arguments.length,s=o<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,i):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,i,r);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(s=(o<3?n(s):o>3?n(t,i,s):n(t,i))||s);return o>3&&s&&Object.defineProperty(t,i,s),s}class o extends e.Component{constructor(){super(...arguments),this.resource="",this.tileScale={x:1,y:1},this.tilePosition={x:0,y:0}}init(e){e&&(this.resource=e.resource,this.tileScale=e.tileScale,this.tilePosition=e.tilePosition)}}o.componentName="TilingSprite",n([t.type("string")],o.prototype,"resource",void 0),n([t.type("vector2"),t.step(.1)],o.prototype,"tileScale",void 0),n([t.type("vector2"),t.step(1)],o.prototype,"tilePosition",void 0);let s=class extends i.Renderer{constructor(){super(...arguments),this.name="TilingSprite",this.imgs={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size,r=this.imgs[e.id];r&&(r.tilingSprite.width=t,r.tilingSprite.height=i)}componentChanged(t){return i=this,n=void 0,s=function*(){const i=t.gameObject.id;if("TilingSprite"===t.componentName){const n=t.component;if(t.type===e.OBSERVER_TYPE.ADD){const o=new r.TilingSprite(null);this.imgs[t.gameObject.id]=o,this.containerManager.getContainer(t.gameObject.id).addChildAt(o.tilingSprite,0),this.setProp(t.gameObject.id,n);const s=this.increaseAsyncId(i),{data:c}=yield e.resource.getResource(n.resource);if(!this.validateAsyncId(i,s))return;if(!c)return void console.error(`GameObject:${t.gameObject.name}'s TilingSprite resource load error`);o.image=c.image}else if(t.type===e.OBSERVER_TYPE.CHANGE)if("resource"===t.prop.prop[0]){const r=this.increaseAsyncId(i),{data:o}=yield e.resource.getResource(n.resource);if(!this.validateAsyncId(i,r))return;if(!o)return void console.error(`GameObject:${t.gameObject.name}'s TilingSprite resource load error`);this.imgs[t.gameObject.id].image=o.image}else this.setProp(t.gameObject.id,n);else if(t.type===e.OBSERVER_TYPE.REMOVE){this.increaseAsyncId(i);const e=this.imgs[t.gameObject.id];this.containerManager.getContainer(t.gameObject.id).removeChild(e.tilingSprite),e.tilingSprite.destroy({children:!0}),delete this.imgs[t.gameObject.id]}}},new((o=void 0)||(o=Promise))((function(e,t){function r(e){try{a(s.next(e))}catch(e){t(e)}}function c(e){try{a(s.throw(e))}catch(e){t(e)}}function a(t){t.done?e(t.value):new o((function(e){e(t.value)})).then(r,c)}a((s=s.apply(i,n||[])).next())}));var i,n,o,s}setProp(e,t){this.imgs[e].tilingSprite.tilePosition=t.tilePosition,this.imgs[e].tilingSprite.tileScale=t.tileScale}};s=n([e.decorators.componentObserver({TilingSprite:[{prop:["resource"],deep:!1},{prop:["tileScale"],deep:!0},{prop:["tilePosition"],deep:!0}]})],s);var c=s;exports.TilingSprite=o,exports.TilingSpriteSystem=c;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/inspector-decorator"),i=require("@eva/plugin-renderer"),r=require("@eva/renderer-adapter");function n(e,t,i,r){var n,o=arguments.length,s=o<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,i):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,i,r);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(s=(o<3?n(s):o>3?n(t,i,s):n(t,i))||s);return o>3&&s&&Object.defineProperty(t,i,s),s}function o(e,t,i,r){return new(i||(i=Promise))(function(n,o){function s(e){try{a(r.next(e))}catch(e){o(e)}}function c(e){try{a(r.throw(e))}catch(e){o(e)}}function a(e){var t;e.done?n(e.value):(t=e.value,t instanceof i?t:new i(function(e){e(t)})).then(s,c)}a((r=r.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;class s extends e.Component{constructor(){super(...arguments),this.resource="",this.tileScale={x:1,y:1},this.tilePosition={x:0,y:0}}init(e){e&&(this.resource=e.resource,this.tileScale=e.tileScale,this.tilePosition=e.tilePosition)}}s.componentName="TilingSprite",n([t.type("string")],s.prototype,"resource",void 0),n([t.type("vector2"),t.step(.1)],s.prototype,"tileScale",void 0),n([t.type("vector2"),t.step(1)],s.prototype,"tilePosition",void 0);let c=class extends i.Renderer{constructor(){super(...arguments),this.name="TilingSprite",this.imgs={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size,r=this.imgs[e.id];r&&(r.tilingSprite.width=t,r.tilingSprite.height=i)}componentChanged(t){return o(this,void 0,void 0,function*(){const i=t.gameObject.id;if("TilingSprite"===t.componentName){const n=t.component;if(t.type===e.OBSERVER_TYPE.ADD){const o=new r.TilingSprite(null);this.imgs[t.gameObject.id]=o,this.containerManager.getContainer(t.gameObject.id).addChildAt(o.tilingSprite,0),this.setProp(t.gameObject.id,n);const s=this.increaseAsyncId(i),{data:c}=yield e.resource.getResource(n.resource);if(!this.validateAsyncId(i,s))return;if(!c)return void console.error(`GameObject:${t.gameObject.name}'s TilingSprite resource load error`);o.image=c.image}else if(t.type===e.OBSERVER_TYPE.CHANGE)if("resource"===t.prop.prop[0]){const r=this.increaseAsyncId(i),{data:o}=yield e.resource.getResource(n.resource);if(!this.validateAsyncId(i,r))return;if(!o)return void console.error(`GameObject:${t.gameObject.name}'s TilingSprite resource load error`);this.imgs[t.gameObject.id].image=o.image}else this.setProp(t.gameObject.id,n);else if(t.type===e.OBSERVER_TYPE.REMOVE){this.increaseAsyncId(i);const e=this.imgs[t.gameObject.id];this.containerManager.getContainer(t.gameObject.id).removeChild(e.tilingSprite),e.tilingSprite.destroy({children:!0}),delete this.imgs[t.gameObject.id]}}})}setProp(e,t){this.imgs[e].tilingSprite.tilePosition=t.tilePosition,this.imgs[e].tilingSprite.tileScale=t.tileScale}};c=n([e.decorators.componentObserver({TilingSprite:[{prop:["resource"],deep:!1},{prop:["tileScale"],deep:!0},{prop:["tilePosition"],deep:!0}]})],c);var a=c;exports.TilingSprite=s,exports.TilingSpriteSystem=a;

package/dist/plugin-renderer-tiling-sprite.d.ts

@@ -7,11 +7,62 @@ import { RendererManager } from '@eva/plugin-renderer';
 import { RendererSystem } from '@eva/plugin-renderer';
 import { TilingSprite as TilingSprite_2 } from '@eva/renderer-adapter';
 
+/**
+ * 平铺精灵组件
+ *
+ * TilingSprite 组件用于创建可平铺重复的纹理，支持无限滚动效果。
+ * 纹理会在指定区域内重复平铺，并可以设置平铺的缩放和偏移，
+ * 适用于背景滚动、地面贴图、水面波纹等需要重复纹理的场景。
+ *
+ * 主要功能：
+ * - 纹理平铺重复
+ * - 支持平铺缩放
+ * - 支持平铺偏移（实现滚动效果）
+ * - 性能优化（只渲染可见区域）
+ *
+ * @example
+ * ```typescript
+ * // 创建滚动背景
+ * const background = new GameObject('background');
+ * background.addComponent(new TilingSprite({
+ *   resource: 'bgTile', // 平铺纹理资源
+ *   tileScale: { x: 1, y: 1 }, // 平铺缩放
+ *   tilePosition: { x: 0, y: 0 } // 平铺偏移
+ * }));
+ * background.transform.size = { width: 800, height: 600 };
+ *
+ * // 实现无限滚动
+ * const tilingSprite = background.getComponent('TilingSprite');
+ * let offset = 0;
+ * setInterval(() => {
+ *   offset += 1;
+ *   tilingSprite.tilePosition = { x: offset, y: 0 };
+ * }, 16);
+ *
+ * // 创建水面效果
+ * const water = new GameObject('water');
+ * water.addComponent(new TilingSprite({
+ *   resource: 'waterTile',
+ *   tileScale: { x: 2, y: 2 } // 放大 2 倍平铺
+ * }));
+ * ```
+ */
 export declare class TilingSprite extends Component<TilingSpriteParams> {
+    /** 组件名称 */
     static componentName: string;
+    /** 平铺纹理资源名称 */
     resource: string;
+    /** 平铺缩放比例 */
     tileScale: TilingSpriteParams['tileScale'];
+    /** 平铺位置偏移（用于实现滚动效果） */
     tilePosition: TilingSpriteParams['tilePosition'];
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 纹理资源名称
+     * @param obj.tileScale - 平铺缩放
+     * @param obj.tilePosition - 平铺偏移
+     */
     init(obj?: TilingSpriteParams): void;
 }
 

package/dist/plugin-renderer-tiling-sprite.esm.js

@@ -3,19 +3,19 @@ import { type, step } from '@eva/inspector-decorator';
 import { Renderer, RendererSystem } from '@eva/plugin-renderer';
 import { TilingSprite as TilingSprite$3 } from '@eva/renderer-adapter';
 
-/*! *****************************************************************************
-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) {
@@ -26,27 +26,83 @@ 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;
+};
 
+/**
+ * 平铺精灵组件
+ *
+ * TilingSprite 组件用于创建可平铺重复的纹理，支持无限滚动效果。
+ * 纹理会在指定区域内重复平铺，并可以设置平铺的缩放和偏移，
+ * 适用于背景滚动、地面贴图、水面波纹等需要重复纹理的场景。
+ *
+ * 主要功能：
+ * - 纹理平铺重复
+ * - 支持平铺缩放
+ * - 支持平铺偏移（实现滚动效果）
+ * - 性能优化（只渲染可见区域）
+ *
+ * @example
+ * ```typescript
+ * // 创建滚动背景
+ * const background = new GameObject('background');
+ * background.addComponent(new TilingSprite({
+ *   resource: 'bgTile', // 平铺纹理资源
+ *   tileScale: { x: 1, y: 1 }, // 平铺缩放
+ *   tilePosition: { x: 0, y: 0 } // 平铺偏移
+ * }));
+ * background.transform.size = { width: 800, height: 600 };
+ *
+ * // 实现无限滚动
+ * const tilingSprite = background.getComponent('TilingSprite');
+ * let offset = 0;
+ * setInterval(() => {
+ *   offset += 1;
+ *   tilingSprite.tilePosition = { x: offset, y: 0 };
+ * }, 16);
+ *
+ * // 创建水面效果
+ * const water = new GameObject('water');
+ * water.addComponent(new TilingSprite({
+ *   resource: 'waterTile',
+ *   tileScale: { x: 2, y: 2 } // 放大 2 倍平铺
+ * }));
+ * ```
+ */
 class TilingSprite$2 extends Component {
     constructor() {
         super(...arguments);
+        /** 平铺纹理资源名称 */
         this.resource = '';
+        /** 平铺缩放比例 */
         this.tileScale = {
             x: 1,
             y: 1,
         };
+        /** 平铺位置偏移（用于实现滚动效果） */
         this.tilePosition = {
             x: 0,
             y: 0,
         };
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 纹理资源名称
+     * @param obj.tileScale - 平铺缩放
+     * @param obj.tilePosition - 平铺偏移
+     */
     init(obj) {
         if (obj) {
             this.resource = obj.resource;
@@ -55,6 +111,7 @@ class TilingSprite$2 extends Component {
         }
     }
 }
+/** 组件名称 */
 TilingSprite$2.componentName = 'TilingSprite';
 __decorate([
     type('string')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eva/plugin-renderer-tiling-sprite",
-  "version": "2.0.1-beta.9",
+  "version": "2.0.2-beta.0",
   "description": "@eva/plugin-renderer-tiling-sprite",
   "main": "index.js",
   "module": "dist/plugin-renderer-tiling-sprite.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/renderer-adapter": "2.0.1-beta.9",
-    "@eva/eva.js": "2.0.1-beta.9"
+    "@eva/plugin-renderer": "2.0.2-beta.0",
+    "@eva/renderer-adapter": "2.0.2-beta.0",
+    "@eva/eva.js": "2.0.2-beta.0"
   }
 }