excalibur 0.32.0-alpha.1563 → 0.32.0-alpha.1565

package/build/esm/excalibur.development.js

@@ -1,4 +1,4 @@
-/*! excalibur - 0.32.0-alpha.1563+eadef91 - 2025-11-24
+/*! excalibur - 0.32.0-alpha.1565+76be137 - 2025-11-24
 https://github.com/excaliburjs/Excalibur
 Copyright (c) 2025 Excalibur.js <https://github.com/excaliburjs/Excalibur/graphs/contributors>
 Licensed BSD-2-Clause
@@ -14354,7 +14354,7 @@ void main() {
   v_screenuv = a_screenuv;
 }
 `;
-class Material {
+const _Material = class _Material2 {
   constructor(options) {
     this._logger = Logger.getInstance();
     this._color = Color.Transparent;
@@ -14376,6 +14376,25 @@ class Material {
     } else {
       this._logger.warn(`Material ${name} was created in 2D Canvas mode, currently only WebGL is supported`);
     }
+    {
+      if (this.images.u_graphic) {
+        this._logger.warn(
+          `Material named "${this.name}" is overriding built in image u_graphic, is this on purpose? If so ignore this warning.`
+        );
+      }
+      if (this.images.u_screen_texture) {
+        this._logger.warn(
+          `Material named "${this.name}" is overriding built in image u_screen_texture, is this on purpose? If so ignore this warning.`
+        );
+      }
+      for (const uniform of Object.keys(this._uniforms)) {
+        if (_Material2.BuiltInUniforms.includes(uniform)) {
+          this._logger.warn(
+            `Material named "${this.name}" is overriding built in uniform ${uniform}, is this on purpose? If so ignore this warning.`
+          );
+        }
+      }
+    }
   }
   _initialize(graphicsContextWebGL) {
     if (this._initialized) {
@@ -14412,6 +14431,9 @@ class Material {
   get isUsingScreenTexture() {
     return this._fragmentSource.includes("u_screen_texture");
   }
+  get isOverridingGraphic() {
+    return !!this._images.u_graphic;
+  }
   update(callback) {
     if (this._shader) {
       this._shader.use();
@@ -14423,6 +14445,18 @@ class Material {
   }
   addImageSource(samplerName, image) {
     this._shader.addImageSource(samplerName, image);
+    {
+      if (this.images.u_graphic) {
+        this._logger.warn(
+          `Material named "${this.name}" is overriding built in image u_graphic, is this on purpose? If so ignore this warning.`
+        );
+      }
+      if (this.images.u_screen_texture) {
+        this._logger.warn(
+          `Material named "${this.name}" is overriding built in image u_screen_texture, is this on purpose? If so ignore this warning.`
+        );
+      }
+    }
   }
   removeImageSource(samplerName) {
     this._shader.removeImageSource(samplerName);
@@ -14435,7 +14469,19 @@ class Material {
       throw Error(`Material ${this.name} not yet initialized, use the ExcaliburGraphicsContext.createMaterial() to work around this.`);
     }
   }
-}
+};
+_Material.BuiltInUniforms = [
+  "u_time_ms",
+  "u_opacity",
+  "u_resolution",
+  "u_graphic_resolution",
+  "u_size",
+  "u_matrix",
+  "u_transform",
+  "u_graphic",
+  "u_screen_texture"
+];
+let Material = _Material;
 const _Debug = class _Debug2 {
   static registerGraphicsContext(ctx) {
     _Debug2._ctx = ctx;
@@ -15551,7 +15597,7 @@ class MaterialRenderer {
     this._gl = null;
   }
   draw(image, sx, sy, swidth, sheight, dx, dy, dwidth, dheight) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const gl = this._gl;
     const material = this._context.material;
     if (!material) {
@@ -15616,7 +15662,7 @@ class MaterialRenderer {
     vertexBuffer[vertexIndex++] = uvy1;
     vertexBuffer[vertexIndex++] = screenUVX1;
     vertexBuffer[vertexIndex++] = screenUVY1;
-    const texture = this._addImageAsTexture(image);
+    let texture = this._addImageAsTexture(image);
     material.use();
     this._layout.shader = shader;
     this._layout.use(true);
@@ -15627,6 +15673,11 @@ class MaterialRenderer {
     shader.trySetUniformFloatVector("u_size", vec(sw, sh));
     shader.trySetUniformMatrix("u_matrix", this._context.ortho);
     shader.trySetUniformMatrix("u_transform", transform.to4x4());
+    if (material.isOverridingGraphic) {
+      if ((_e = material.images.u_graphic) == null ? void 0 : _e.image) {
+        texture = this._addImageAsTexture(material.images.u_graphic.image);
+      }
+    }
     gl.activeTexture(gl.TEXTURE0 + 0);
     gl.bindTexture(gl.TEXTURE_2D, texture);
     shader.trySetUniformInt("u_graphic", 0);
@@ -19412,7 +19463,9 @@ const _Actor = class _Actor2 extends Entity {
       anchor,
       offset,
       collisionType,
-      collisionGroup
+      collisionGroup,
+      graphic,
+      material
     } = {
       ...config
     };
@@ -19483,6 +19536,12 @@ const _Actor = class _Actor2 extends Entity {
       }
     }
     this.graphics.isVisible = visible != null ? visible : true;
+    if (graphic) {
+      this.graphics.use(graphic);
+    }
+    if (material) {
+      this.graphics.material = material;
+    }
   }
   /**
    * Gets the position vector of the actor in pixels
@@ -33039,7 +33098,7 @@ class Semaphore {
     this._count += count;
   }
 }
-const EX_VERSION = "0.32.0-alpha.1563+eadef91";
+const EX_VERSION = "0.32.0-alpha.1565+76be137";
 polyfill();
 export {
   ActionCompleteEvent,

package/build/esm/excalibur.js

@@ -1,4 +1,4 @@
-/*! excalibur - 0.32.0-alpha.1563+eadef91 - 2025-11-24
+/*! excalibur - 0.32.0-alpha.1565+76be137 - 2025-11-24
 https://github.com/excaliburjs/Excalibur
 Copyright (c) 2025 Excalibur.js <https://github.com/excaliburjs/Excalibur/graphs/contributors>
 Licensed BSD-2-Clause
@@ -14354,7 +14354,7 @@ void main() {
   v_screenuv = a_screenuv;
 }
 `;
-class Material {
+const _Material = class _Material2 {
   constructor(options) {
     this._logger = Logger.getInstance();
     this._color = Color.Transparent;
@@ -14376,6 +14376,25 @@ class Material {
     } else {
       this._logger.warn(`Material ${name} was created in 2D Canvas mode, currently only WebGL is supported`);
     }
+    {
+      if (this.images.u_graphic) {
+        this._logger.warn(
+          `Material named "${this.name}" is overriding built in image u_graphic, is this on purpose? If so ignore this warning.`
+        );
+      }
+      if (this.images.u_screen_texture) {
+        this._logger.warn(
+          `Material named "${this.name}" is overriding built in image u_screen_texture, is this on purpose? If so ignore this warning.`
+        );
+      }
+      for (const uniform of Object.keys(this._uniforms)) {
+        if (_Material2.BuiltInUniforms.includes(uniform)) {
+          this._logger.warn(
+            `Material named "${this.name}" is overriding built in uniform ${uniform}, is this on purpose? If so ignore this warning.`
+          );
+        }
+      }
+    }
   }
   _initialize(graphicsContextWebGL) {
     if (this._initialized) {
@@ -14412,6 +14431,9 @@ class Material {
   get isUsingScreenTexture() {
     return this._fragmentSource.includes("u_screen_texture");
   }
+  get isOverridingGraphic() {
+    return !!this._images.u_graphic;
+  }
   update(callback) {
     if (this._shader) {
       this._shader.use();
@@ -14423,6 +14445,18 @@ class Material {
   }
   addImageSource(samplerName, image) {
     this._shader.addImageSource(samplerName, image);
+    {
+      if (this.images.u_graphic) {
+        this._logger.warn(
+          `Material named "${this.name}" is overriding built in image u_graphic, is this on purpose? If so ignore this warning.`
+        );
+      }
+      if (this.images.u_screen_texture) {
+        this._logger.warn(
+          `Material named "${this.name}" is overriding built in image u_screen_texture, is this on purpose? If so ignore this warning.`
+        );
+      }
+    }
   }
   removeImageSource(samplerName) {
     this._shader.removeImageSource(samplerName);
@@ -14435,7 +14469,19 @@ class Material {
       throw Error(`Material ${this.name} not yet initialized, use the ExcaliburGraphicsContext.createMaterial() to work around this.`);
     }
   }
-}
+};
+_Material.BuiltInUniforms = [
+  "u_time_ms",
+  "u_opacity",
+  "u_resolution",
+  "u_graphic_resolution",
+  "u_size",
+  "u_matrix",
+  "u_transform",
+  "u_graphic",
+  "u_screen_texture"
+];
+let Material = _Material;
 const _Debug = class _Debug2 {
   static registerGraphicsContext(ctx) {
     _Debug2._ctx = ctx;
@@ -15551,7 +15597,7 @@ class MaterialRenderer {
     this._gl = null;
   }
   draw(image, sx, sy, swidth, sheight, dx, dy, dwidth, dheight) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const gl = this._gl;
     const material = this._context.material;
     if (!material) {
@@ -15616,7 +15662,7 @@ class MaterialRenderer {
     vertexBuffer[vertexIndex++] = uvy1;
     vertexBuffer[vertexIndex++] = screenUVX1;
     vertexBuffer[vertexIndex++] = screenUVY1;
-    const texture = this._addImageAsTexture(image);
+    let texture = this._addImageAsTexture(image);
     material.use();
     this._layout.shader = shader;
     this._layout.use(true);
@@ -15627,6 +15673,11 @@ class MaterialRenderer {
     shader.trySetUniformFloatVector("u_size", vec(sw, sh));
     shader.trySetUniformMatrix("u_matrix", this._context.ortho);
     shader.trySetUniformMatrix("u_transform", transform.to4x4());
+    if (material.isOverridingGraphic) {
+      if ((_e = material.images.u_graphic) == null ? void 0 : _e.image) {
+        texture = this._addImageAsTexture(material.images.u_graphic.image);
+      }
+    }
     gl.activeTexture(gl.TEXTURE0 + 0);
     gl.bindTexture(gl.TEXTURE_2D, texture);
     shader.trySetUniformInt("u_graphic", 0);
@@ -19412,7 +19463,9 @@ const _Actor = class _Actor2 extends Entity {
       anchor,
       offset,
       collisionType,
-      collisionGroup
+      collisionGroup,
+      graphic,
+      material
     } = {
       ...config
     };
@@ -19483,6 +19536,12 @@ const _Actor = class _Actor2 extends Entity {
       }
     }
     this.graphics.isVisible = visible != null ? visible : true;
+    if (graphic) {
+      this.graphics.use(graphic);
+    }
+    if (material) {
+      this.graphics.material = material;
+    }
   }
   /**
    * Gets the position vector of the actor in pixels
@@ -33039,7 +33098,7 @@ class Semaphore {
     this._count += count;
   }
 }
-const EX_VERSION = "0.32.0-alpha.1563+eadef91";
+const EX_VERSION = "0.32.0-alpha.1565+76be137";
 polyfill();
 export {
   ActionCompleteEvent,