@galacean/engine-spine 0.0.0-experimental-engine-spine-20250613-2 → 0.0.0-experimental-engine-spine-20250624

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.0-experimental-engine-spine-20250613-2",
+  "version": "0.0.0-experimental-engine-spine-20250624",
   "description": "galacean spine runtime",
   "name": "@galacean/engine-spine",
   "main": "dist/main.js",

package/types/renderer/SpineAnimationRenderer.d.ts

@@ -1,19 +1,18 @@
-import { AnimationState, Skeleton } from "@esotericsoftware/spine-core";
-import { BoundingBox, Buffer, Engine, Entity, Material, Primitive, Renderer, SubPrimitive } from "@galacean/engine";
+import { AnimationState, Skeleton, BlendMode } from "@esotericsoftware/spine-core";
+import { BoundingBox, Buffer, Entity, Material, Primitive, Renderer, SubPrimitive, Texture2D } from "@galacean/engine";
 import { SpineResource } from "../loader/SpineResource";
+import { SpineMaterial } from "./SpineMaterial";
 /**
  * Spine animation renderer, capable of rendering spine animations and providing functions for animation and skeleton manipulation.
  */
 export declare class SpineAnimationRenderer extends Renderer {
-    private static _defaultMaterial;
     private static _spineGenerator;
     private static _positionVertexElement;
-    private static _colorVertexElement;
+    private static _lightColorVertexElement;
     private static _uvVertexElement;
+    private static _darkColorVertexElement;
     /** @internal */
-    static _materialCache: Map<string, Material>;
-    /** @internal */
-    static _getDefaultMaterial(engine: Engine): Material;
+    static _materialCacheMap: Map<string, SpineMaterial>;
     /**
      * The spacing between z layers in world units.
      */
@@ -25,16 +24,17 @@ export declare class SpineAnimationRenderer extends Renderer {
    If this option is enabled, the Spine editor must export textures with "Premultiply Alpha" checked.
      */
     premultipliedAlpha: boolean;
+    /**
+     * Whether to enable dark color tint for your spine animation.
+     * When your Spine animation uses "Tint Black" feature in the Spine editor, enable this to ensure
+     * the rendered result matches the Spine editor preview.
+     */
+    tintBlack: boolean;
     /**
      * Default state for spine animation.
      * Contains the default animation name to be played, whether this animation should loop, the default skin name.
      */
     readonly defaultConfig: SpineAnimationDefaultConfig;
-    /**
-     * Hook function called after animation applied and before building render primitive.
-     * This allows custom logic to be executed after animation state is applied but before buffer upload.
-     */
-    onBeforeBuildPrimitive?: () => void;
     /** @internal */
     _primitive: Primitive;
     /** @internal */
@@ -116,6 +116,10 @@ export declare class SpineAnimationRenderer extends Renderer {
      * @internal
      */
     _clearSubPrimitives(): void;
+    /**
+     * @internal
+     */
+    _getMaterial(texture: Texture2D, blendMode: BlendMode): Material;
     private _clearMaterialCache;
     private _applyDefaultConfig;
     /**

package/types/renderer/SpineGenerator.d.ts

@@ -1,8 +1,8 @@
 import { BlendMode, Color, Skeleton } from "@esotericsoftware/spine-core";
 import { SubPrimitive, Texture2D } from "@galacean/engine";
-import { SpineAnimationRenderer } from "./SpineAnimationRenderer";
 import { ClearablePool } from "../util/ClearablePool";
 import { ReturnablePool } from "../util/ReturnablePool";
+import { SpineAnimationRenderer } from "./SpineAnimationRenderer";
 declare class SubRenderItem {
     subPrimitive: SubPrimitive;
     blendMode: BlendMode;
@@ -13,8 +13,8 @@ declare class SubRenderItem {
  * @internal
  */
 export declare class SpineGenerator {
-    static VERTEX_SIZE: number;
-    static VERTEX_STRIDE: number;
+    static vertexStrideWithoutTint: number;
+    static vertexStrideWithTint: number;
     static tempDark: Color;
     static tempColor: Color;
     static tempVerts: any[];
@@ -28,7 +28,6 @@ export declare class SpineGenerator {
     buildPrimitive(skeleton: Skeleton, renderer: SpineAnimationRenderer): void;
     addSeparateSlot(slotName: string): void;
     addSeparateSlotTexture(slotName: string, texture: Texture2D): void;
-    private _createMaterialForTexture;
     private _createRenderItem;
     private _expandBounds;
 }

package/types/renderer/SpineMaterial.d.ts

@@ -1,6 +1,28 @@
-import { Engine, Material } from "@galacean/engine";
+import { Engine, Material, Texture2D } from "@galacean/engine";
+import { BlendMode } from "@esotericsoftware/spine-core";
 export declare class SpineMaterial extends Material {
+    private _blendMode;
     private static _spineVS;
     private static _spineFS;
+    /**
+     * @internal
+     */
+    _setTintBlack(enabled: boolean): void;
+    /**
+     * @internal
+     */
+    _setPremultipliedAlpha(enabled: boolean): void;
+    /**
+     * @internal
+     */
+    _setTexture(value: Texture2D): void;
     constructor(engine: Engine);
+    /**
+     * @internal
+     */
+    _setBlendMode(blendMode: BlendMode, premultipliedAlpha: boolean): void;
+    /**
+     * @internal
+     */
+    _getBlendMode(): BlendMode;
 }