@eva/plugin-renderer-tiling-sprite 2.1.0-beta.3 → 2.1.0-beta.4

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

@@ -0,0 +1,271 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+globalThis.EVA = globalThis.EVA || {};
+globalThis.EVA.plugin = globalThis.EVA.plugin || {};
+globalThis.EVA.plugin.renderer = globalThis.EVA.plugin.renderer || {};
+var _EVA_IIFE_tilingSprite = function (exports, eva_js, pluginRenderer, rendererAdapter) {
+  'use strict';
+  function __decorate(decorators, target, key, desc) {
+    var c = arguments.length,
+      r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc,
+      d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+  }
+  function __metadata(metadataKey, metadataValue) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue);
+  }
+  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) : 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;
+  };
+  function __rest(s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0) t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function") for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+      if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i])) t[p[i]] = s[p[i]];
+    }
+    return t;
+  }
+  typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+  };
+  class SymbolKeysNotSupportedError extends Error {
+    constructor() {
+      super('Symbol keys are not supported yet!');
+      Object.setPrototypeOf(this, new.target.prototype);
+    }
+  }
+  const IDE_PROPERTY_METADATA = 'IDE_PROPERTY_METADATA';
+  function transformBasicType(type) {
+    if (type === String) {
+      return 'string';
+    }
+    if (type === Number) {
+      return 'number';
+    }
+    if (type === Boolean) {
+      return 'boolean';
+    }
+    return 'unknown';
+  }
+  function defineLegacyIDEProp(target, propertyKey, patch) {
+    const constructor = target.constructor;
+    const current = constructor.IDEProps || {};
+    current[propertyKey] = _extends(_extends({
+      key: propertyKey
+    }, current[propertyKey]), patch);
+    constructor.IDEProps = current;
+  }
+  function defineTypes(target, key, options, returnTypeFunction) {
+    let type = Reflect.getMetadata('design:type', target, key);
+    let isArray = type === Array;
+    const str = transformBasicType(type);
+    if (str !== 'unknown') {
+      type = str;
+    }
+    if (returnTypeFunction) {
+      const returnType = returnTypeFunction();
+      if (Array.isArray(returnType)) {
+        isArray = true;
+        type = returnType[0];
+      } else {
+        type = returnType;
+      }
+    }
+    const properties = Reflect.getMetadata(IDE_PROPERTY_METADATA, target.constructor) || {};
+    const current = properties[key] || {};
+    const property = _extends(_extends(_extends({}, current), {
+      type,
+      isArray: isArray
+    }), options);
+    properties[key] = property;
+    Reflect.defineMetadata(IDE_PROPERTY_METADATA, properties, target.constructor);
+    const legacyProperty = __rest(property, ["isArray"]);
+    defineLegacyIDEProp(target, key, legacyProperty);
+  }
+  function type(type) {
+    return Field({
+      type
+    });
+  }
+  function step(step) {
+    return Field({
+      step
+    });
+  }
+  function getTypeDecoratorParams(returnTypeFuncOrOptions, maybeOptions) {
+    if (typeof returnTypeFuncOrOptions === 'function') {
+      return {
+        returnTypeFunc: returnTypeFuncOrOptions,
+        options: maybeOptions || {}
+      };
+    }
+    return {
+      options: returnTypeFuncOrOptions || {}
+    };
+  }
+  function Field(returnTypeFunction, maybeOptions) {
+    return (target, propertyKey) => {
+      if (typeof propertyKey === 'symbol') {
+        throw new SymbolKeysNotSupportedError();
+      }
+      const {
+        options,
+        returnTypeFunc
+      } = getTypeDecoratorParams(returnTypeFunction, maybeOptions);
+      defineTypes(target, propertyKey, options, returnTypeFunc);
+    };
+  }
+  var ExecuteMode;
+  (function (ExecuteMode) {
+    ExecuteMode[ExecuteMode["Edit"] = 2] = "Edit";
+    ExecuteMode[ExecuteMode["Game"] = 4] = "Game";
+    ExecuteMode[ExecuteMode["All"] = 6] = "All";
+  })(ExecuteMode || (ExecuteMode = {}));
+  class TilingSprite$2 extends eva_js.Component {
+    constructor() {
+      super(...arguments);
+      this.resource = '';
+      this.tileScale = {
+        x: 1,
+        y: 1
+      };
+      this.tilePosition = {
+        x: 0,
+        y: 0
+      };
+    }
+    init(obj) {
+      if (obj) {
+        this.resource = obj.resource;
+        this.tileScale = obj.tileScale;
+        this.tilePosition = obj.tilePosition;
+      }
+    }
+  }
+  TilingSprite$2.componentName = 'TilingSprite';
+  __decorate([type('string'), __metadata("design:type", String)], TilingSprite$2.prototype, "resource", void 0);
+  __decorate([type('vector2'), step(0.1), __metadata("design:type", Object)], TilingSprite$2.prototype, "tileScale", void 0);
+  __decorate([type('vector2'), step(1), __metadata("design:type", Object)], TilingSprite$2.prototype, "tilePosition", void 0);
+  let TilingSprite = class TilingSprite extends pluginRenderer.Renderer {
+    constructor() {
+      super(...arguments);
+      this.name = 'TilingSprite';
+      this.imgs = {};
+    }
+    init() {
+      this.renderSystem = this.game.getSystem(pluginRenderer.RendererSystem);
+      this.renderSystem.rendererManager.register(this);
+    }
+    rendererUpdate(gameObject) {
+      const {
+        width,
+        height
+      } = gameObject.transform.size;
+      const img = this.imgs[gameObject.id];
+      if (img) {
+        img.tilingSprite.width = width;
+        img.tilingSprite.height = height;
+      }
+    }
+    componentChanged(changed) {
+      return __awaiter(this, void 0, void 0, function* () {
+        const gameObjectId = changed.gameObject.id;
+        if (changed.componentName === 'TilingSprite') {
+          const component = changed.component;
+          if (changed.type === eva_js.OBSERVER_TYPE.ADD) {
+            const sprite = new rendererAdapter.TilingSprite(null);
+            this.imgs[changed.gameObject.id] = sprite;
+            this.containerManager.getContainer(changed.gameObject.id).addChildAt(sprite.tilingSprite, 0);
+            this.setProp(changed.gameObject.id, component);
+            const asyncId = this.increaseAsyncId(gameObjectId);
+            const {
+              data
+            } = yield eva_js.resource.getResource(component.resource);
+            if (!this.validateAsyncId(gameObjectId, asyncId)) return;
+            if (!data) {
+              console.error(`GameObject:${changed.gameObject.name}'s TilingSprite resource load error`);
+              return;
+            }
+            sprite.image = data.image;
+          } else if (changed.type === eva_js.OBSERVER_TYPE.CHANGE) {
+            if (changed.prop.prop[0] === 'resource') {
+              const asyncId = this.increaseAsyncId(gameObjectId);
+              const {
+                data
+              } = yield eva_js.resource.getResource(component.resource);
+              if (!this.validateAsyncId(gameObjectId, asyncId)) return;
+              if (!data) {
+                console.error(`GameObject:${changed.gameObject.name}'s TilingSprite resource load error`);
+                return;
+              }
+              this.imgs[changed.gameObject.id].image = data.image;
+            } else {
+              this.setProp(changed.gameObject.id, component);
+            }
+          } else if (changed.type === eva_js.OBSERVER_TYPE.REMOVE) {
+            this.increaseAsyncId(gameObjectId);
+            const sprite = this.imgs[changed.gameObject.id];
+            this.containerManager.getContainer(changed.gameObject.id).removeChild(sprite.tilingSprite);
+            sprite.tilingSprite.destroy({
+              children: true
+            });
+            delete this.imgs[changed.gameObject.id];
+          }
+        }
+      });
+    }
+    setProp(id, component) {
+      this.imgs[id].tilingSprite.tilePosition = component.tilePosition;
+      this.imgs[id].tilingSprite.tileScale = component.tileScale;
+    }
+  };
+  TilingSprite = __decorate([eva_js.decorators.componentObserver({
+    TilingSprite: [{
+      prop: ['resource'],
+      deep: false
+    }, {
+      prop: ['tileScale'],
+      deep: true
+    }, {
+      prop: ['tilePosition'],
+      deep: true
+    }]
+  })], TilingSprite);
+  var TilingSprite$1 = TilingSprite;
+  exports.TilingSprite = TilingSprite$2;
+  exports.TilingSpriteSystem = TilingSprite$1;
+  Object.defineProperty(exports, '__esModule', {
+    value: true
+  });
+  return exports;
+}({}, EVA, EVA.plugin.renderer, EVA.rendererAdapter);
+globalThis.EVA.plugin.renderer.tilingSprite = globalThis.EVA.plugin.renderer.tilingSprite || _EVA_IIFE_tilingSprite;

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

@@ -0,0 +1 @@
+function _extends(){return _extends=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var i in r)({}).hasOwnProperty.call(r,i)&&(e[i]=r[i])}return e},_extends.apply(null,arguments)}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,r,i){"use strict";function n(e,t,r,i){var n,o=arguments.length,s=o<3?t:null===i?i=Object.getOwnPropertyDescriptor(t,r):i;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,i);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(s=(o<3?n(s):o>3?n(t,r,s):n(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s}function o(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)}function s(e,t,r,i){return new(r||(r=Promise))(function(n,o){function s(e){try{l(i.next(e))}catch(e){o(e)}}function c(e){try{l(i.throw(e))}catch(e){o(e)}}function l(e){var t;e.done?n(e.value):(t=e.value,t instanceof r?t:new r(function(e){e(t)})).then(s,c)}l((i=i.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError,"function"==typeof SuppressedError&&SuppressedError;class c extends Error{constructor(){super("Symbol keys are not supported yet!"),Object.setPrototypeOf(this,new.target.prototype)}}const l="IDE_PROPERTY_METADATA";function a(e,t,r,i){let n=Reflect.getMetadata("design:type",e,t),o=n===Array;const s=function(e){return e===String?"string":e===Number?"number":e===Boolean?"boolean":"unknown"}(n);if("unknown"!==s&&(n=s),i){const e=i();Array.isArray(e)?(o=!0,n=e[0]):n=e}const c=Reflect.getMetadata(l,e.constructor)||{},a=_extends(_extends(_extends({},c[t]||{}),{type:n,isArray:o}),r);c[t]=a,Reflect.defineMetadata(l,c,e.constructor);!function(e,t,r){const i=e.constructor,n=i.IDEProps||{};n[t]=_extends(_extends({key:t},n[t]),r),i.IDEProps=n}(e,t,function(e,t){var r={};for(var i in e)Object.prototype.hasOwnProperty.call(e,i)&&t.indexOf(i)<0&&(r[i]=e[i]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var n=0;for(i=Object.getOwnPropertySymbols(e);n<i.length;n++)t.indexOf(i[n])<0&&Object.prototype.propertyIsEnumerable.call(e,i[n])&&(r[i[n]]=e[i[n]])}return r}(a,["isArray"]))}function p(e){return d({type:e})}function u(e){return d({step:e})}function d(e,t){return(r,i)=>{if("symbol"==typeof i)throw new c;const{options:n,returnTypeFunc:o}=function(e,t){return"function"==typeof e?{returnTypeFunc:e,options:t||{}}:{options:e||{}}}(e,t);a(r,i,n,o)}}var g;!function(e){e[e.Edit=2]="Edit",e[e.Game=4]="Game",e[e.All=6]="All"}(g||(g={}));class f 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)}}f.componentName="TilingSprite",n([p("string"),o("design:type",String)],f.prototype,"resource",void 0),n([p("vector2"),u(.1),o("design:type",Object)],f.prototype,"tileScale",void 0),n([p("vector2"),u(1),o("design:type",Object)],f.prototype,"tilePosition",void 0);let y=class extends r.Renderer{constructor(){super(...arguments),this.name="TilingSprite",this.imgs={}}init(){this.renderSystem=this.game.getSystem(r.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:r}=e.transform.size,i=this.imgs[e.id];i&&(i.tilingSprite.width=t,i.tilingSprite.height=r)}componentChanged(e){return s(this,void 0,void 0,function*(){const r=e.gameObject.id;if("TilingSprite"===e.componentName){const n=e.component;if(e.type===t.OBSERVER_TYPE.ADD){const o=new i.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(r),{data:c}=yield t.resource.getResource(n.resource);if(!this.validateAsyncId(r,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 i=this.increaseAsyncId(r),{data:o}=yield t.resource.getResource(n.resource);if(!this.validateAsyncId(r,i))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(r);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}};y=n([t.decorators.componentObserver({TilingSprite:[{prop:["resource"],deep:!1},{prop:["tileScale"],deep:!0},{prop:["tilePosition"],deep:!0}]})],y);var h=y;return e.TilingSprite=f,e.TilingSpriteSystem=h,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

@@ -0,0 +1,222 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var eva_js = require('@eva/eva.js');
+var inspectorDecorator = require('@eva/inspector-decorator');
+var pluginRenderer = require('@eva/plugin-renderer');
+var rendererAdapter = require('@eva/renderer-adapter');
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+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) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+function __metadata(metadataKey, metadataValue) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue);
+}
+
+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) : 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;
+            this.tileScale = obj.tileScale;
+            this.tilePosition = obj.tilePosition;
+        }
+    }
+}
+/** 组件名称 */
+TilingSprite$2.componentName = 'TilingSprite';
+__decorate([
+    inspectorDecorator.type('string'),
+    __metadata("design:type", String)
+], TilingSprite$2.prototype, "resource", void 0);
+__decorate([
+    inspectorDecorator.type('vector2'),
+    inspectorDecorator.step(0.1),
+    __metadata("design:type", Object)
+], TilingSprite$2.prototype, "tileScale", void 0);
+__decorate([
+    inspectorDecorator.type('vector2'),
+    inspectorDecorator.step(1),
+    __metadata("design:type", Object)
+], TilingSprite$2.prototype, "tilePosition", void 0);
+
+let TilingSprite = class TilingSprite extends pluginRenderer.Renderer {
+    constructor() {
+        super(...arguments);
+        this.name = 'TilingSprite';
+        this.imgs = {};
+    }
+    init() {
+        this.renderSystem = this.game.getSystem(pluginRenderer.RendererSystem);
+        this.renderSystem.rendererManager.register(this);
+    }
+    rendererUpdate(gameObject) {
+        const { width, height } = gameObject.transform.size;
+        const img = this.imgs[gameObject.id];
+        if (img) {
+            img.tilingSprite.width = width;
+            img.tilingSprite.height = height;
+        }
+    }
+    componentChanged(changed) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const gameObjectId = changed.gameObject.id;
+            if (changed.componentName === 'TilingSprite') {
+                const component = changed.component;
+                if (changed.type === eva_js.OBSERVER_TYPE.ADD) {
+                    const sprite = new rendererAdapter.TilingSprite(null);
+                    this.imgs[changed.gameObject.id] = sprite;
+                    this.containerManager.getContainer(changed.gameObject.id).addChildAt(sprite.tilingSprite, 0);
+                    this.setProp(changed.gameObject.id, component);
+                    const asyncId = this.increaseAsyncId(gameObjectId);
+                    const { data } = yield eva_js.resource.getResource(component.resource);
+                    if (!this.validateAsyncId(gameObjectId, asyncId))
+                        return;
+                    if (!data) {
+                        console.error(`GameObject:${changed.gameObject.name}'s TilingSprite resource load error`);
+                        return;
+                    }
+                    sprite.image = data.image;
+                }
+                else if (changed.type === eva_js.OBSERVER_TYPE.CHANGE) {
+                    if (changed.prop.prop[0] === 'resource') {
+                        const asyncId = this.increaseAsyncId(gameObjectId);
+                        const { data } = yield eva_js.resource.getResource(component.resource);
+                        if (!this.validateAsyncId(gameObjectId, asyncId))
+                            return;
+                        if (!data) {
+                            console.error(`GameObject:${changed.gameObject.name}'s TilingSprite resource load error`);
+                            return;
+                        }
+                        this.imgs[changed.gameObject.id].image = data.image;
+                    }
+                    else {
+                        this.setProp(changed.gameObject.id, component);
+                    }
+                }
+                else if (changed.type === eva_js.OBSERVER_TYPE.REMOVE) {
+                    this.increaseAsyncId(gameObjectId);
+                    const sprite = this.imgs[changed.gameObject.id];
+                    this.containerManager.getContainer(changed.gameObject.id).removeChild(sprite.tilingSprite);
+                    sprite.tilingSprite.destroy({
+                        children: true,
+                    });
+                    delete this.imgs[changed.gameObject.id];
+                }
+            }
+        });
+    }
+    setProp(id, component) {
+        this.imgs[id].tilingSprite.tilePosition = component.tilePosition;
+        this.imgs[id].tilingSprite.tileScale = component.tileScale;
+    }
+};
+TilingSprite = __decorate([
+    eva_js.decorators.componentObserver({
+        TilingSprite: [
+            { prop: ['resource'], deep: false },
+            { prop: ['tileScale'], deep: true },
+            { prop: ['tilePosition'], deep: true },
+        ],
+    })
+], TilingSprite);
+var TilingSprite$1 = TilingSprite;
+
+exports.TilingSprite = TilingSprite$2;
+exports.TilingSpriteSystem = TilingSprite$1;

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

@@ -0,0 +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");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){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)}function s(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 c 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)}}c.componentName="TilingSprite",n([t.type("string"),o("design:type",String)],c.prototype,"resource",void 0),n([t.type("vector2"),t.step(.1),o("design:type",Object)],c.prototype,"tileScale",void 0),n([t.type("vector2"),t.step(1),o("design:type",Object)],c.prototype,"tilePosition",void 0);let a=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 s(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}};a=n([e.decorators.componentObserver({TilingSprite:[{prop:["resource"],deep:!1},{prop:["tileScale"],deep:!0},{prop:["tilePosition"],deep:!0}]})],a);var p=a;exports.TilingSprite=c,exports.TilingSpriteSystem=p;

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

@@ -0,0 +1,95 @@
+import { Component } from '@eva/eva.js';
+import { ComponentChanged } from '@eva/eva.js';
+import { ContainerManager } from '@eva/plugin-renderer';
+import { GameObject } from '@eva/eva.js';
+import { Renderer } from '@eva/plugin-renderer';
+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;
+}
+
+export declare interface TilingSpriteParams {
+    resource: string;
+    tileScale: {
+        x: number;
+        y: number;
+    };
+    tilePosition: {
+        x: number;
+        y: number;
+    };
+}
+
+export declare class TilingSpriteSystem extends Renderer {
+    name: string;
+    imgs: {
+        [propName: number]: TilingSprite_2;
+    };
+    renderSystem: RendererSystem;
+    rendererManager: RendererManager;
+    containerManager: ContainerManager;
+    init(): void;
+    rendererUpdate(gameObject: GameObject): void;
+    componentChanged(changed: ComponentChanged): Promise<void>;
+    setProp(id: number, component: TilingSprite): void;
+}
+
+export { }

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

@@ -0,0 +1,217 @@
+import { Component, decorators, OBSERVER_TYPE, resource } from '@eva/eva.js';
+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.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+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) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+function __metadata(metadataKey, metadataValue) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue);
+}
+
+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) : 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;
+            this.tileScale = obj.tileScale;
+            this.tilePosition = obj.tilePosition;
+        }
+    }
+}
+/** 组件名称 */
+TilingSprite$2.componentName = 'TilingSprite';
+__decorate([
+    type('string'),
+    __metadata("design:type", String)
+], TilingSprite$2.prototype, "resource", void 0);
+__decorate([
+    type('vector2'),
+    step(0.1),
+    __metadata("design:type", Object)
+], TilingSprite$2.prototype, "tileScale", void 0);
+__decorate([
+    type('vector2'),
+    step(1),
+    __metadata("design:type", Object)
+], TilingSprite$2.prototype, "tilePosition", void 0);
+
+let TilingSprite = class TilingSprite extends Renderer {
+    constructor() {
+        super(...arguments);
+        this.name = 'TilingSprite';
+        this.imgs = {};
+    }
+    init() {
+        this.renderSystem = this.game.getSystem(RendererSystem);
+        this.renderSystem.rendererManager.register(this);
+    }
+    rendererUpdate(gameObject) {
+        const { width, height } = gameObject.transform.size;
+        const img = this.imgs[gameObject.id];
+        if (img) {
+            img.tilingSprite.width = width;
+            img.tilingSprite.height = height;
+        }
+    }
+    componentChanged(changed) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const gameObjectId = changed.gameObject.id;
+            if (changed.componentName === 'TilingSprite') {
+                const component = changed.component;
+                if (changed.type === OBSERVER_TYPE.ADD) {
+                    const sprite = new TilingSprite$3(null);
+                    this.imgs[changed.gameObject.id] = sprite;
+                    this.containerManager.getContainer(changed.gameObject.id).addChildAt(sprite.tilingSprite, 0);
+                    this.setProp(changed.gameObject.id, component);
+                    const asyncId = this.increaseAsyncId(gameObjectId);
+                    const { data } = yield resource.getResource(component.resource);
+                    if (!this.validateAsyncId(gameObjectId, asyncId))
+                        return;
+                    if (!data) {
+                        console.error(`GameObject:${changed.gameObject.name}'s TilingSprite resource load error`);
+                        return;
+                    }
+                    sprite.image = data.image;
+                }
+                else if (changed.type === OBSERVER_TYPE.CHANGE) {
+                    if (changed.prop.prop[0] === 'resource') {
+                        const asyncId = this.increaseAsyncId(gameObjectId);
+                        const { data } = yield resource.getResource(component.resource);
+                        if (!this.validateAsyncId(gameObjectId, asyncId))
+                            return;
+                        if (!data) {
+                            console.error(`GameObject:${changed.gameObject.name}'s TilingSprite resource load error`);
+                            return;
+                        }
+                        this.imgs[changed.gameObject.id].image = data.image;
+                    }
+                    else {
+                        this.setProp(changed.gameObject.id, component);
+                    }
+                }
+                else if (changed.type === OBSERVER_TYPE.REMOVE) {
+                    this.increaseAsyncId(gameObjectId);
+                    const sprite = this.imgs[changed.gameObject.id];
+                    this.containerManager.getContainer(changed.gameObject.id).removeChild(sprite.tilingSprite);
+                    sprite.tilingSprite.destroy({
+                        children: true,
+                    });
+                    delete this.imgs[changed.gameObject.id];
+                }
+            }
+        });
+    }
+    setProp(id, component) {
+        this.imgs[id].tilingSprite.tilePosition = component.tilePosition;
+        this.imgs[id].tilingSprite.tileScale = component.tileScale;
+    }
+};
+TilingSprite = __decorate([
+    decorators.componentObserver({
+        TilingSprite: [
+            { prop: ['resource'], deep: false },
+            { prop: ['tileScale'], deep: true },
+            { prop: ['tilePosition'], deep: true },
+        ],
+    })
+], TilingSprite);
+var TilingSprite$1 = TilingSprite;
+
+export { TilingSprite$2 as TilingSprite, TilingSprite$1 as TilingSpriteSystem };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eva/plugin-renderer-tiling-sprite",
-  "version": "2.1.0-beta.3",
+  "version": "2.1.0-beta.4",
   "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": "^2.0.0-beta.0",
-    "@eva/plugin-renderer": "2.1.0-beta.3",
-    "@eva/renderer-adapter": "2.1.0-beta.3",
-    "@eva/eva.js": "2.1.0-beta.3"
+    "@eva/plugin-renderer": "2.1.0-beta.4",
+    "@eva/renderer-adapter": "2.1.0-beta.4",
+    "@eva/eva.js": "2.1.0-beta.4"
   }
 }