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

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

@@ -42,6 +42,7 @@ var _EVA_IIFE_render = function (exports, eva_js, pluginRenderer) {
       this.alpha = 1;
       this.zIndex = 0;
       this.sortableChildren = false;
+      this.resolution = 1;
     }
     init(obj) {
       obj && _extends(this, obj);
@@ -52,6 +53,7 @@ var _EVA_IIFE_render = function (exports, eva_js, pluginRenderer) {
   __decorate([type('number'), step(0.1)], Render$2.prototype, "alpha", void 0);
   __decorate([type('number'), step(1)], Render$2.prototype, "zIndex", void 0);
   __decorate([type('boolean')], Render$2.prototype, "sortableChildren", void 0);
+  __decorate([type('number'), step(0.1)], Render$2.prototype, "resolution", void 0);
   let Render = class Render extends pluginRenderer.Renderer {
     constructor() {
       super(...arguments);
@@ -82,11 +84,24 @@ var _EVA_IIFE_render = function (exports, eva_js, pluginRenderer) {
     add(changed) {
       if (changed.component.name === 'Render') {
         this.setDirty(changed);
+        const component = changed.component;
+        const container = this.containerManager.getContainer(changed.gameObject.id);
+        if (component.resolution !== undefined && component.resolution > 0) {
+          this.applyResolution(container, component.resolution);
+        }
       }
     }
     change(changed) {
-      if (changed.component.name === 'Render' && changed.prop.prop[0] === 'zIndex') {
-        this.setDirty(changed);
+      if (changed.component.name === 'Render') {
+        if (changed.prop.prop[0] === 'zIndex') {
+          this.setDirty(changed);
+        } else if (changed.prop.prop[0] === 'resolution') {
+          const component = changed.component;
+          const container = this.containerManager.getContainer(changed.gameObject.id);
+          if (component.resolution !== undefined && component.resolution > 0) {
+            this.applyResolution(container, component.resolution);
+          }
+        }
       }
     }
     remove(changed) {
@@ -101,10 +116,20 @@ var _EVA_IIFE_render = function (exports, eva_js, pluginRenderer) {
         parentRender.sortDirty = true;
       }
     }
+    applyResolution(container, resolution) {
+      if (!container) return;
+      window.requestAnimationFrame(() => {
+        if (container.children && Array.isArray(container.children)) {
+          for (const child of container.children) {
+            child.resolution = resolution;
+          }
+        }
+      });
+    }
   };
   Render.systemName = 'Render';
   Render = __decorate([eva_js.decorators.componentObserver({
-    Render: ['zIndex']
+    Render: ['zIndex', 'resolution']
   })], Render);
   var Render$1 = Render;
   exports.Render = Render$2;

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

@@ -1 +1 @@
-function _extends(){return _extends=Object.assign?Object.assign.bind():function(e){for(var r=1;r<arguments.length;r++){var t=arguments[r];for(var n in t)({}).hasOwnProperty.call(t,n)&&(e[n]=t[n])}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_render=function(e,r,t){"use strict";function n(e,r,t,n){var o,s=arguments.length,i=s<3?r:null===n?n=Object.getOwnPropertyDescriptor(r,t):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)i=Reflect.decorate(e,r,t,n);else for(var a=e.length-1;a>=0;a--)(o=e[a])&&(i=(s<3?o(i):s>3?o(r,t,i):o(r,t))||i);return s>3&&i&&Object.defineProperty(r,t,i),i}function o(e,r){return e.constructor.IDEProps||(e.constructor.IDEProps={}),e.constructor.IDEProps[r]||(e.constructor.IDEProps[r]={}),e.constructor.IDEProps[r]}function s(e){return function(r,t){var n=o(r,t);n.key=t,n.type=e}}function i(e){return function(r,t){o(r,t).step=e}}class a extends r.Component{constructor(){super(...arguments),this.sortDirty=!1,this.visible=!0,this.alpha=1,this.zIndex=0,this.sortableChildren=!1}init(e){e&&_extends(this,e)}}a.componentName="Render",n([s("boolean")],a.prototype,"visible",void 0),n([s("number"),i(.1)],a.prototype,"alpha",void 0),n([s("number"),i(1)],a.prototype,"zIndex",void 0),n([s("boolean")],a.prototype,"sortableChildren",void 0);let d=class extends t.Renderer{constructor(){super(...arguments),this.name="Render"}init(){this.renderSystem=this.game.getSystem(t.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const r=e.getComponent("Render"),t=this.containerManager.getContainer(e.id);t.alpha=r.alpha,t.visible=r.visible,t.zIndex=r.zIndex}componentChanged(e){e.type!==r.OBSERVER_TYPE.ADD&&e.type!==r.OBSERVER_TYPE.REMOVE||this.add(e),e.type===r.OBSERVER_TYPE.CHANGE&&this.change(e),e.type===r.OBSERVER_TYPE.REMOVE&&this.remove(e)}add(e){"Render"===e.component.name&&this.setDirty(e)}change(e){"Render"===e.component.name&&"zIndex"===e.prop.prop[0]&&this.setDirty(e)}remove(e){if("Render"===e.component.name){this.containerManager.getContainer(e.gameObject.id).alpha=1}}setDirty(e){const r=e.gameObject.parent&&e.gameObject.parent.getComponent("Render");r&&(r.sortDirty=!0)}};d.systemName="Render",d=n([r.decorators.componentObserver({Render:["zIndex"]})],d);var p=d;return e.Render=a,e.RenderSystem=p,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer);globalThis.EVA.plugin.renderer.render=globalThis.EVA.plugin.renderer.render||_EVA_IIFE_render;
+function _extends(){return _extends=Object.assign?Object.assign.bind():function(e){for(var n=1;n<arguments.length;n++){var t=arguments[n];for(var r in t)({}).hasOwnProperty.call(t,r)&&(e[r]=t[r])}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_render=function(e,n,t){"use strict";function r(e,n,t,r){var o,i=arguments.length,s=i<3?n:null===r?r=Object.getOwnPropertyDescriptor(n,t):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,n,t,r);else for(var a=e.length-1;a>=0;a--)(o=e[a])&&(s=(i<3?o(s):i>3?o(n,t,s):o(n,t))||s);return i>3&&s&&Object.defineProperty(n,t,s),s}function o(e,n){return e.constructor.IDEProps||(e.constructor.IDEProps={}),e.constructor.IDEProps[n]||(e.constructor.IDEProps[n]={}),e.constructor.IDEProps[n]}function i(e){return function(n,t){var r=o(n,t);r.key=t,r.type=e}}function s(e){return function(n,t){o(n,t).step=e}}class a extends n.Component{constructor(){super(...arguments),this.sortDirty=!1,this.visible=!0,this.alpha=1,this.zIndex=0,this.sortableChildren=!1,this.resolution=1}init(e){e&&_extends(this,e)}}a.componentName="Render",r([i("boolean")],a.prototype,"visible",void 0),r([i("number"),s(.1)],a.prototype,"alpha",void 0),r([i("number"),s(1)],a.prototype,"zIndex",void 0),r([i("boolean")],a.prototype,"sortableChildren",void 0),r([i("number"),s(.1)],a.prototype,"resolution",void 0);let l=class extends t.Renderer{constructor(){super(...arguments),this.name="Render"}init(){this.renderSystem=this.game.getSystem(t.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const n=e.getComponent("Render"),t=this.containerManager.getContainer(e.id);t.alpha=n.alpha,t.visible=n.visible,t.zIndex=n.zIndex}componentChanged(e){e.type!==n.OBSERVER_TYPE.ADD&&e.type!==n.OBSERVER_TYPE.REMOVE||this.add(e),e.type===n.OBSERVER_TYPE.CHANGE&&this.change(e),e.type===n.OBSERVER_TYPE.REMOVE&&this.remove(e)}add(e){if("Render"===e.component.name){this.setDirty(e);const n=e.component,t=this.containerManager.getContainer(e.gameObject.id);void 0!==n.resolution&&n.resolution>0&&this.applyResolution(t,n.resolution)}}change(e){if("Render"===e.component.name)if("zIndex"===e.prop.prop[0])this.setDirty(e);else if("resolution"===e.prop.prop[0]){const n=e.component,t=this.containerManager.getContainer(e.gameObject.id);void 0!==n.resolution&&n.resolution>0&&this.applyResolution(t,n.resolution)}}remove(e){if("Render"===e.component.name){this.containerManager.getContainer(e.gameObject.id).alpha=1}}setDirty(e){const n=e.gameObject.parent&&e.gameObject.parent.getComponent("Render");n&&(n.sortDirty=!0)}applyResolution(e,n){e&&window.requestAnimationFrame(()=>{if(e.children&&Array.isArray(e.children))for(const t of e.children)t.resolution=n})}};l.systemName="Render",l=r([n.decorators.componentObserver({Render:["zIndex","resolution"]})],l);var p=l;return e.Render=a,e.RenderSystem=p,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer);globalThis.EVA.plugin.renderer.render=globalThis.EVA.plugin.renderer.render||_EVA_IIFE_render;

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

@@ -6,19 +6,19 @@ var eva_js = require('@eva/eva.js');
 var inspectorDecorator = require('@eva/inspector-decorator');
 var pluginRenderer = require('@eva/plugin-renderer');
 
-/*! *****************************************************************************
-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,21 +26,97 @@ function __decorate(decorators, target, key, desc) {
     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;
-}
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
 
+/**
+ * 渲染属性组件
+ *
+ * Render 组件控制游戏对象的渲染相关属性，如可见性、透明度、层级等。
+ * 这些属性影响对象的显示效果和渲染顺序，
+ * 适用于需要控制显示状态、淡入淡出、层级排序等场景。
+ *
+ * 主要属性：
+ * - visible - 控制对象是否可见
+ * - alpha - 控制对象透明度（0-1）
+ * - zIndex - 控制对象渲染层级
+ * - sortableChildren - 是否对子对象按 zIndex 排序
+ * - resolution - 渲染分辨率，值越大越清晰但性能消耗越大
+ *
+ * @example
+ * ```typescript
+ * // 创建带渲染属性的对象
+ * const sprite = new GameObject('sprite');
+ * sprite.addComponent(new Img({ resource: 'player' }));
+ * sprite.addComponent(new Render({
+ *   visible: true,
+ *   alpha: 1,
+ *   zIndex: 10
+ * }));
+ *
+ * // 控制可见性
+ * const render = sprite.getComponent('Render');
+ * render.visible = false; // 隐藏对象
+ *
+ * // 淡入淡出效果
+ * let alpha = 1;
+ * setInterval(() => {
+ *   alpha -= 0.01;
+ *   if (alpha <= 0) alpha = 1;
+ *   render.alpha = alpha;
+ * }, 16);
+ *
+ * // 设置渲染层级
+ * render.zIndex = 100; // 越大越靠前
+ *
+ * // 启用子对象排序
+ * const container = new GameObject('container');
+ * container.addComponent(new Render({
+ *   sortableChildren: true // 子对象将按 zIndex 排序
+ * }));
+ *
+ * // 设置渲染分辨率
+ * const text = new GameObject('text');
+ * text.addComponent(new Text({ text: 'High Resolution' }));
+ * text.addComponent(new Render({
+ *   resolution: 2 // 2倍分辨率，使渲染更清晰
+ * }));
+ * ```
+ */
 class Render$2 extends eva_js.Component {
     constructor() {
         super(...arguments);
+        /** 排序脏标记 */
         this.sortDirty = false;
+        /** 是否可见 */
         this.visible = true;
+        /** 透明度（0-1，0 为完全透明，1 为完全不透明） */
         this.alpha = 1;
+        /** 渲染层级（数值越大越靠前） */
         this.zIndex = 0;
+        /** 是否对子对象按 zIndex 排序 */
         this.sortableChildren = false;
+        /** 渲染分辨率（值越大越清晰但性能消耗越大，默认为 1） */
+        this.resolution = 1;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.visible - 是否可见
+     * @param obj.alpha - 透明度
+     * @param obj.zIndex - 渲染层级
+     * @param obj.sortableChildren - 是否对子对象排序
+     * @param obj.resolution - 渲染分辨率
+     */
     init(obj) {
         obj && Object.assign(this, obj);
     }
 }
+/** 组件名称 */
 Render$2.componentName = 'Render';
 __decorate([
     inspectorDecorator.type('boolean')
@@ -55,7 +131,11 @@ __decorate([
 ], Render$2.prototype, "zIndex", void 0);
 __decorate([
     inspectorDecorator.type('boolean')
-], Render$2.prototype, "sortableChildren", void 0);
+], Render$2.prototype, "sortableChildren", void 0);
+__decorate([
+    inspectorDecorator.type('number'),
+    inspectorDecorator.step(0.1)
+], Render$2.prototype, "resolution", void 0);
 
 let Render = class Render extends pluginRenderer.Renderer {
     constructor() {
@@ -87,11 +167,27 @@ let Render = class Render extends pluginRenderer.Renderer {
     add(changed) {
         if (changed.component.name === 'Render') {
             this.setDirty(changed);
+            // 初始化时应用 resolution
+            const component = changed.component;
+            const container = this.containerManager.getContainer(changed.gameObject.id);
+            if (component.resolution !== undefined && component.resolution > 0) {
+                this.applyResolution(container, component.resolution);
+            }
         }
     }
     change(changed) {
-        if (changed.component.name === 'Render' && changed.prop.prop[0] === 'zIndex') {
-            this.setDirty(changed);
+        if (changed.component.name === 'Render') {
+            if (changed.prop.prop[0] === 'zIndex') {
+                this.setDirty(changed);
+            }
+            else if (changed.prop.prop[0] === 'resolution') {
+                // 当 resolution 改变时，重新应用到子对象
+                const component = changed.component;
+                const container = this.containerManager.getContainer(changed.gameObject.id);
+                if (component.resolution !== undefined && component.resolution > 0) {
+                    this.applyResolution(container, component.resolution);
+                }
+            }
         }
     }
     remove(changed) {
@@ -106,11 +202,26 @@ let Render = class Render extends pluginRenderer.Renderer {
             parentRender.sortDirty = true;
         }
     }
+    /**
+     * 递归应用 resolution 到容器中所有支持该属性的子对象
+     */
+    applyResolution(container, resolution) {
+        if (!container)
+            return;
+        window.requestAnimationFrame(() => {
+            // 遍历容器的所有子对象
+            if (container.children && Array.isArray(container.children)) {
+                for (const child of container.children) {
+                    child.resolution = resolution;
+                }
+            }
+        });
+    }
 };
 Render.systemName = 'Render';
 Render = __decorate([
     eva_js.decorators.componentObserver({
-        Render: ['zIndex'],
+        Render: ['zIndex', 'resolution'],
     })
 ], Render);
 var Render$1 = Render;

package/dist/plugin-renderer-render.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"),r=require("@eva/plugin-renderer");
-/*! *****************************************************************************
-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,r,n){var o,s=arguments.length,i=s<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)i=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(o=e[a])&&(i=(s<3?o(i):s>3?o(t,r,i):o(t,r))||i);return s>3&&i&&Object.defineProperty(t,r,i),i}class o extends e.Component{constructor(){super(...arguments),this.sortDirty=!1,this.visible=!0,this.alpha=1,this.zIndex=0,this.sortableChildren=!1}init(e){e&&Object.assign(this,e)}}o.componentName="Render",n([t.type("boolean")],o.prototype,"visible",void 0),n([t.type("number"),t.step(.1)],o.prototype,"alpha",void 0),n([t.type("number"),t.step(1)],o.prototype,"zIndex",void 0),n([t.type("boolean")],o.prototype,"sortableChildren",void 0);let s=class extends r.Renderer{constructor(){super(...arguments),this.name="Render"}init(){this.renderSystem=this.game.getSystem(r.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const t=e.getComponent("Render"),r=this.containerManager.getContainer(e.id);r.alpha=t.alpha,r.visible=t.visible,r.zIndex=t.zIndex}componentChanged(t){t.type!==e.OBSERVER_TYPE.ADD&&t.type!==e.OBSERVER_TYPE.REMOVE||this.add(t),t.type===e.OBSERVER_TYPE.CHANGE&&this.change(t),t.type===e.OBSERVER_TYPE.REMOVE&&this.remove(t)}add(e){"Render"===e.component.name&&this.setDirty(e)}change(e){"Render"===e.component.name&&"zIndex"===e.prop.prop[0]&&this.setDirty(e)}remove(e){if("Render"===e.component.name){this.containerManager.getContainer(e.gameObject.id).alpha=1}}setDirty(e){const t=e.gameObject.parent&&e.gameObject.parent.getComponent("Render");t&&(t.sortDirty=!0)}};s.systemName="Render",s=n([e.decorators.componentObserver({Render:["zIndex"]})],s);var i=s;exports.Render=o,exports.RenderSystem=i;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/inspector-decorator"),r=require("@eva/plugin-renderer");function n(e,t,r,n){var o,i=arguments.length,s=i<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(o=e[a])&&(s=(i<3?o(s):i>3?o(t,r,s):o(t,r))||s);return i>3&&s&&Object.defineProperty(t,r,s),s}"function"==typeof SuppressedError&&SuppressedError;class o extends e.Component{constructor(){super(...arguments),this.sortDirty=!1,this.visible=!0,this.alpha=1,this.zIndex=0,this.sortableChildren=!1,this.resolution=1}init(e){e&&Object.assign(this,e)}}o.componentName="Render",n([t.type("boolean")],o.prototype,"visible",void 0),n([t.type("number"),t.step(.1)],o.prototype,"alpha",void 0),n([t.type("number"),t.step(1)],o.prototype,"zIndex",void 0),n([t.type("boolean")],o.prototype,"sortableChildren",void 0),n([t.type("number"),t.step(.1)],o.prototype,"resolution",void 0);let i=class extends r.Renderer{constructor(){super(...arguments),this.name="Render"}init(){this.renderSystem=this.game.getSystem(r.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const t=e.getComponent("Render"),r=this.containerManager.getContainer(e.id);r.alpha=t.alpha,r.visible=t.visible,r.zIndex=t.zIndex}componentChanged(t){t.type!==e.OBSERVER_TYPE.ADD&&t.type!==e.OBSERVER_TYPE.REMOVE||this.add(t),t.type===e.OBSERVER_TYPE.CHANGE&&this.change(t),t.type===e.OBSERVER_TYPE.REMOVE&&this.remove(t)}add(e){if("Render"===e.component.name){this.setDirty(e);const t=e.component,r=this.containerManager.getContainer(e.gameObject.id);void 0!==t.resolution&&t.resolution>0&&this.applyResolution(r,t.resolution)}}change(e){if("Render"===e.component.name)if("zIndex"===e.prop.prop[0])this.setDirty(e);else if("resolution"===e.prop.prop[0]){const t=e.component,r=this.containerManager.getContainer(e.gameObject.id);void 0!==t.resolution&&t.resolution>0&&this.applyResolution(r,t.resolution)}}remove(e){if("Render"===e.component.name){this.containerManager.getContainer(e.gameObject.id).alpha=1}}setDirty(e){const t=e.gameObject.parent&&e.gameObject.parent.getComponent("Render");t&&(t.sortDirty=!0)}applyResolution(e,t){e&&window.requestAnimationFrame(()=>{if(e.children&&Array.isArray(e.children))for(const r of e.children)r.resolution=t})}};i.systemName="Render",i=n([e.decorators.componentObserver({Render:["zIndex","resolution"]})],i);var s=i;exports.Render=o,exports.RenderSystem=s;

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

@@ -6,13 +6,84 @@ import { Renderer } from '@eva/plugin-renderer';
 import { RendererManager } from '@eva/plugin-renderer';
 import { RendererSystem } from '@eva/plugin-renderer';
 
+/**
+ * 渲染属性组件
+ *
+ * Render 组件控制游戏对象的渲染相关属性，如可见性、透明度、层级等。
+ * 这些属性影响对象的显示效果和渲染顺序，
+ * 适用于需要控制显示状态、淡入淡出、层级排序等场景。
+ *
+ * 主要属性：
+ * - visible - 控制对象是否可见
+ * - alpha - 控制对象透明度（0-1）
+ * - zIndex - 控制对象渲染层级
+ * - sortableChildren - 是否对子对象按 zIndex 排序
+ * - resolution - 渲染分辨率，值越大越清晰但性能消耗越大
+ *
+ * @example
+ * ```typescript
+ * // 创建带渲染属性的对象
+ * const sprite = new GameObject('sprite');
+ * sprite.addComponent(new Img({ resource: 'player' }));
+ * sprite.addComponent(new Render({
+ *   visible: true,
+ *   alpha: 1,
+ *   zIndex: 10
+ * }));
+ *
+ * // 控制可见性
+ * const render = sprite.getComponent('Render');
+ * render.visible = false; // 隐藏对象
+ *
+ * // 淡入淡出效果
+ * let alpha = 1;
+ * setInterval(() => {
+ *   alpha -= 0.01;
+ *   if (alpha <= 0) alpha = 1;
+ *   render.alpha = alpha;
+ * }, 16);
+ *
+ * // 设置渲染层级
+ * render.zIndex = 100; // 越大越靠前
+ *
+ * // 启用子对象排序
+ * const container = new GameObject('container');
+ * container.addComponent(new Render({
+ *   sortableChildren: true // 子对象将按 zIndex 排序
+ * }));
+ *
+ * // 设置渲染分辨率
+ * const text = new GameObject('text');
+ * text.addComponent(new Text({ text: 'High Resolution' }));
+ * text.addComponent(new Render({
+ *   resolution: 2 // 2倍分辨率，使渲染更清晰
+ * }));
+ * ```
+ */
 export declare class Render extends Component<RenderParams> {
+    /** 组件名称 */
     static componentName: string;
+    /** 排序脏标记 */
     sortDirty: boolean;
+    /** 是否可见 */
     visible: boolean;
+    /** 透明度（0-1，0 为完全透明，1 为完全不透明） */
     alpha: number;
+    /** 渲染层级（数值越大越靠前） */
     zIndex: number;
+    /** 是否对子对象按 zIndex 排序 */
     sortableChildren: boolean;
+    /** 渲染分辨率（值越大越清晰但性能消耗越大，默认为 1） */
+    resolution: number;
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.visible - 是否可见
+     * @param obj.alpha - 透明度
+     * @param obj.zIndex - 渲染层级
+     * @param obj.sortableChildren - 是否对子对象排序
+     * @param obj.resolution - 渲染分辨率
+     */
     init(obj?: RenderParams): void;
 }
 
@@ -21,6 +92,7 @@ export declare interface RenderParams {
     zIndex?: number;
     visible?: boolean;
     sortableChildren?: boolean;
+    resolution?: number;
 }
 
 export declare class RenderSystem extends Renderer {
@@ -36,6 +108,10 @@ export declare class RenderSystem extends Renderer {
     change(changed: ComponentChanged): void;
     remove(changed: ComponentChanged): void;
     setDirty(changed: ComponentChanged): void;
+    /**
+     * 递归应用 resolution 到容器中所有支持该属性的子对象
+     */
+    private applyResolution;
 }
 
 export { }

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

@@ -2,19 +2,19 @@ import { Component, OBSERVER_TYPE, decorators } from '@eva/eva.js';
 import { type, step } from '@eva/inspector-decorator';
 import { Renderer, RendererSystem } from '@eva/plugin-renderer';
 
-/*! *****************************************************************************
-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) {
@@ -22,21 +22,97 @@ function __decorate(decorators, target, key, desc) {
     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;
-}
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
 
+/**
+ * 渲染属性组件
+ *
+ * Render 组件控制游戏对象的渲染相关属性，如可见性、透明度、层级等。
+ * 这些属性影响对象的显示效果和渲染顺序，
+ * 适用于需要控制显示状态、淡入淡出、层级排序等场景。
+ *
+ * 主要属性：
+ * - visible - 控制对象是否可见
+ * - alpha - 控制对象透明度（0-1）
+ * - zIndex - 控制对象渲染层级
+ * - sortableChildren - 是否对子对象按 zIndex 排序
+ * - resolution - 渲染分辨率，值越大越清晰但性能消耗越大
+ *
+ * @example
+ * ```typescript
+ * // 创建带渲染属性的对象
+ * const sprite = new GameObject('sprite');
+ * sprite.addComponent(new Img({ resource: 'player' }));
+ * sprite.addComponent(new Render({
+ *   visible: true,
+ *   alpha: 1,
+ *   zIndex: 10
+ * }));
+ *
+ * // 控制可见性
+ * const render = sprite.getComponent('Render');
+ * render.visible = false; // 隐藏对象
+ *
+ * // 淡入淡出效果
+ * let alpha = 1;
+ * setInterval(() => {
+ *   alpha -= 0.01;
+ *   if (alpha <= 0) alpha = 1;
+ *   render.alpha = alpha;
+ * }, 16);
+ *
+ * // 设置渲染层级
+ * render.zIndex = 100; // 越大越靠前
+ *
+ * // 启用子对象排序
+ * const container = new GameObject('container');
+ * container.addComponent(new Render({
+ *   sortableChildren: true // 子对象将按 zIndex 排序
+ * }));
+ *
+ * // 设置渲染分辨率
+ * const text = new GameObject('text');
+ * text.addComponent(new Text({ text: 'High Resolution' }));
+ * text.addComponent(new Render({
+ *   resolution: 2 // 2倍分辨率，使渲染更清晰
+ * }));
+ * ```
+ */
 class Render$2 extends Component {
     constructor() {
         super(...arguments);
+        /** 排序脏标记 */
         this.sortDirty = false;
+        /** 是否可见 */
         this.visible = true;
+        /** 透明度（0-1，0 为完全透明，1 为完全不透明） */
         this.alpha = 1;
+        /** 渲染层级（数值越大越靠前） */
         this.zIndex = 0;
+        /** 是否对子对象按 zIndex 排序 */
         this.sortableChildren = false;
+        /** 渲染分辨率（值越大越清晰但性能消耗越大，默认为 1） */
+        this.resolution = 1;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.visible - 是否可见
+     * @param obj.alpha - 透明度
+     * @param obj.zIndex - 渲染层级
+     * @param obj.sortableChildren - 是否对子对象排序
+     * @param obj.resolution - 渲染分辨率
+     */
     init(obj) {
         obj && Object.assign(this, obj);
     }
 }
+/** 组件名称 */
 Render$2.componentName = 'Render';
 __decorate([
     type('boolean')
@@ -51,7 +127,11 @@ __decorate([
 ], Render$2.prototype, "zIndex", void 0);
 __decorate([
     type('boolean')
-], Render$2.prototype, "sortableChildren", void 0);
+], Render$2.prototype, "sortableChildren", void 0);
+__decorate([
+    type('number'),
+    step(0.1)
+], Render$2.prototype, "resolution", void 0);
 
 let Render = class Render extends Renderer {
     constructor() {
@@ -83,11 +163,27 @@ let Render = class Render extends Renderer {
     add(changed) {
         if (changed.component.name === 'Render') {
             this.setDirty(changed);
+            // 初始化时应用 resolution
+            const component = changed.component;
+            const container = this.containerManager.getContainer(changed.gameObject.id);
+            if (component.resolution !== undefined && component.resolution > 0) {
+                this.applyResolution(container, component.resolution);
+            }
         }
     }
     change(changed) {
-        if (changed.component.name === 'Render' && changed.prop.prop[0] === 'zIndex') {
-            this.setDirty(changed);
+        if (changed.component.name === 'Render') {
+            if (changed.prop.prop[0] === 'zIndex') {
+                this.setDirty(changed);
+            }
+            else if (changed.prop.prop[0] === 'resolution') {
+                // 当 resolution 改变时，重新应用到子对象
+                const component = changed.component;
+                const container = this.containerManager.getContainer(changed.gameObject.id);
+                if (component.resolution !== undefined && component.resolution > 0) {
+                    this.applyResolution(container, component.resolution);
+                }
+            }
         }
     }
     remove(changed) {
@@ -102,11 +198,26 @@ let Render = class Render extends Renderer {
             parentRender.sortDirty = true;
         }
     }
+    /**
+     * 递归应用 resolution 到容器中所有支持该属性的子对象
+     */
+    applyResolution(container, resolution) {
+        if (!container)
+            return;
+        window.requestAnimationFrame(() => {
+            // 遍历容器的所有子对象
+            if (container.children && Array.isArray(container.children)) {
+                for (const child of container.children) {
+                    child.resolution = resolution;
+                }
+            }
+        });
+    }
 };
 Render.systemName = 'Render';
 Render = __decorate([
     decorators.componentObserver({
-        Render: ['zIndex'],
+        Render: ['zIndex', 'resolution'],
     })
 ], Render);
 var Render$1 = Render;

package/package.json

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