excalibur 0.32.0-alpha.1564 → 0.32.0-alpha.1566

package/CHANGELOG.md

@@ -15,6 +15,18 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ### Added
 
+- Added a convenience parameter to set the initial graphics or material in an Actor
+  ```typescript
+  const cloudSprite = cloud.toSprite();
+  const swirlMaterial = game.graphicsContext.createMaterial({
+    name: 'swirl',
+    fragmentSource
+  });
+  const actor = new ex.Actor({
+      graphic: cloudSprite,
+      material: swirlMaterial
+  });
+  ```
 - Simpler easing functions of the form `(currentTime: number) => number` instead of the 4 parameter legacy ones
 - Support for disabling integration for all offscreen entities, or on a per entity basis
 

package/build/dist/Actor.d.ts

@@ -24,6 +24,7 @@ import { ActionsComponent } from './Actions/ActionsComponent';
 import { CoordPlane } from './Math/coord-plane';
 import type { EventKey, Handler, Subscription } from './EventEmitter';
 import { EventEmitter } from './EventEmitter';
+import type { Graphic, Material } from './Graphics';
 /**
  * Type guard for checking if something is an Actor
  * @param x
@@ -82,6 +83,14 @@ export type ActorArgs = ColliderArgs & {
      * If a width/height or a radius was set a default graphic will be added
      */
     color?: Color;
+    /**
+     * Optionally set the default graphic
+     */
+    graphic?: Graphic;
+    /**
+     * Optionally set the default material
+     */
+    material?: Material;
     /**
      * Optionally set the color of an actor, only used if no graphics are present
      * If a width/height or a radius was set a default graphic will be added

package/build/dist/excalibur.development.js

@@ -1,4 +1,4 @@
-/*! excalibur - 0.32.0-alpha.1564+00e394f - 2025-11-24
+/*! excalibur - 0.32.0-alpha.1566+bfb6759 - 2025-11-24
 https://github.com/excaliburjs/Excalibur
 Copyright (c) 2025 Excalibur.js <https://github.com/excaliburjs/Excalibur/graphs/contributors>
 Licensed BSD-2-Clause
@@ -19467,7 +19467,9 @@ If you want to do custom drawing, use Actor.graphics, or any onPreDraw or onPost
         anchor,
         offset,
         collisionType,
-        collisionGroup
+        collisionGroup,
+        graphic,
+        material
       } = {
         ...config
       };
@@ -19538,6 +19540,12 @@ If you want to do custom drawing, use Actor.graphics, or any onPreDraw or onPost
         }
       }
       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
@@ -33094,7 +33102,7 @@ Read more about this issue at https://excaliburjs.com/docs/performance`
       this._count += count;
     }
   }
-  const EX_VERSION = "0.32.0-alpha.1564+00e394f";
+  const EX_VERSION = "0.32.0-alpha.1566+bfb6759";
   polyfill();
   exports2.ActionCompleteEvent = ActionCompleteEvent;
   exports2.ActionContext = ActionContext;

package/build/dist/excalibur.js

@@ -1,4 +1,4 @@
-/*! excalibur - 0.32.0-alpha.1564+00e394f - 2025-11-24
+/*! excalibur - 0.32.0-alpha.1566+bfb6759 - 2025-11-24
 https://github.com/excaliburjs/Excalibur
 Copyright (c) 2025 Excalibur.js <https://github.com/excaliburjs/Excalibur/graphs/contributors>
 Licensed BSD-2-Clause
@@ -19467,7 +19467,9 @@ If you want to do custom drawing, use Actor.graphics, or any onPreDraw or onPost
         anchor,
         offset,
         collisionType,
-        collisionGroup
+        collisionGroup,
+        graphic,
+        material
       } = {
         ...config
       };
@@ -19538,6 +19540,12 @@ If you want to do custom drawing, use Actor.graphics, or any onPreDraw or onPost
         }
       }
       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
@@ -33094,7 +33102,7 @@ Read more about this issue at https://excaliburjs.com/docs/performance`
       this._count += count;
     }
   }
-  const EX_VERSION = "0.32.0-alpha.1564+00e394f";
+  const EX_VERSION = "0.32.0-alpha.1566+bfb6759";
   polyfill();
   exports2.ActionCompleteEvent = ActionCompleteEvent;
   exports2.ActionContext = ActionContext;