@galacean/engine-spine 4.2.2 → 4.2.4

package/package.json

@@ -1,15 +1,16 @@
 {
-  "version": "4.2.2",
+  "version": "4.2.4",
   "description": "galacean spine runtime",
   "name": "@galacean/engine-spine",
   "main": "dist/main.js",
   "browser": "dist/browser.js",
   "module": "dist/module.js",
+  "packageManager": "pnpm@9.3.0",
   "dependencies": {
     "@esotericsoftware/spine-core": "~4.2.66"
   },
   "peerDependencies": {
-    "@galacean/engine": ">=1.5.0"
+    "@galacean/engine": ">=1.5.0-0"
   },
   "devDependencies": {
     "@babel/core": "^7.26.0",
@@ -20,7 +21,7 @@
     "@babel/plugin-transform-object-assign": "^7.25.9",
     "@babel/preset-env": "^7.26.0",
     "@babel/preset-typescript": "^7.26.0",
-    "@galacean/engine": "^1.5.0",
+    "@galacean/engine": ">=1.5.0-0",
     "@galacean/engine-toolkit": "beta",
     "@rollup/plugin-babel": "^5.3.1",
     "@rollup/plugin-commonjs": "^16.0.0",
@@ -128,4 +129,4 @@
   },
   "types": "types/index.d.ts",
   "repository": "https://github.com/johanzhu/engine-spine.git"
-}
+}

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,6 +24,14 @@ export declare class SpineAnimationRenderer extends Renderer {
    If this option is enabled, the Spine editor must export textures with "Premultiply Alpha" checked.
      */
     premultipliedAlpha: boolean;
+    private _tintBlack;
+    /**
+     * Whether to enable tint black feature for dark color tinting.
+     *
+     * @remarks Should be enabled when using "Tint Black" feature in Spine editor.
+     */
+    get tintBlack(): boolean;
+    set tintBlack(value: boolean);
     /**
      * Default state for spine animation.
      * Contains the default animation name to be played, whether this animation should loop, the default skin name.
@@ -111,6 +118,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;
 }

package/types/SpineAnimation.d.ts

@@ -1,48 +0,0 @@
-import { Skeleton } from "./spine-core/Skeleton";
-import { SkeletonData } from "./spine-core/SkeletonData";
-import { AnimationState } from "./spine-core/AnimationState";
-import { MeshGenerator } from "./core/MeshGenerator";
-import { SpineRenderSetting } from "./types";
-import { Script, Entity, Texture2D, Material, Engine } from "@galacean/engine";
-export declare class SpineAnimation extends Script {
-    /** Spine 材质 */
-    private static _defaultMaterial;
-    static getDefaultMaterial(engine: Engine): Material;
-    /** @internal */
-    _heldTextures: Texture2D[];
-    private _skeletonData;
-    private _skeleton;
-    private _state;
-    private _tempOffset;
-    private _tempSize;
-    private _tempArray;
-    protected _meshGenerator: MeshGenerator;
-    setting: SpineRenderSetting;
-    autoUpdateBounds: boolean;
-    noPause: boolean;
-    get skeletonData(): SkeletonData;
-    get skeleton(): Skeleton;
-    get state(): AnimationState;
-    get mesh(): import("@galacean/engine").BufferMesh;
-    set scale(v: number);
-    constructor(entity: Entity);
-    setSkeletonData(skeletonData: SkeletonData, setting?: SpineRenderSetting): void;
-    /**
-     * Separate slot by slot name. This will add a new sub mesh, and new materials.
-     */
-    addSeparateSlot(slotName: string): void;
-    /**
-     * Change texture of a separated slot by name.
-     */
-    hackSeparateSlotTexture(slotName: string, texture: Texture2D): void;
-    onUpdate(delta: number): void;
-    updateGeometry(): void;
-    updateBounds(): void;
-    /**
-     * Spine animation custom clone.
-     */
-    _cloneTo(target: SpineAnimation): void;
-    private _disposeCurrentSkeleton;
-    private _disposeTextures;
-    onDestroy(): void;
-}

package/types/SpineLoader.d.ts

@@ -1,32 +0,0 @@
-import { AssetPromise, Loader, LoadItem, ResourceManager, TextureWrapMode, Texture2D, Entity, AssetType } from "@galacean/engine";
-import { AssetManager } from "./spine-core/AssetManager";
-import { Texture } from "./spine-core/Texture";
-type SpineResouce = {
-    skeletonFile: string;
-    atlasFile: string;
-    textureFile?: string;
-    textureType?: AssetType;
-};
-type SpineOpt = {
-    scale: number;
-};
-type SpineLoadItem = LoadItem & SpineOpt;
-declare class SpineLoader extends Loader<Entity> {
-    load(item: SpineLoadItem, resourceManager: ResourceManager): AssetPromise<Entity>;
-    handleResource(resourceManager: ResourceManager, item: SpineLoadItem, resource: SpineResouce, resolve: any, reject: any): void;
-    textureAssetPicker(assetManager: AssetManager, textureFile: string): any;
-    createAdaptiveTexture(texture: Texture2D): AdaptiveTexture;
-    isBinFile(url: string): boolean;
-    checkUrl(url: string): boolean;
-    getResouceFromUrl(url: any): SpineResouce;
-    checkUrls(urls: string[]): boolean;
-    getResouceFromUrls(urls: string[], type?: AssetType): SpineResouce;
-    getExtFromUrl(url: string): string;
-}
-export declare class AdaptiveTexture extends Texture {
-    constructor(texture: Texture2D);
-    setFilters(minFilter: any, magFilter: any): void;
-    setWraps(uWrap: TextureWrapMode, vWrap: TextureWrapMode): void;
-    dispose(): void;
-}
-export { SpineLoader };

package/types/SpineMaterial.d.ts

@@ -1,6 +0,0 @@
-import { Engine, Material } from "@galacean/engine";
-export declare class SpineMaterial extends Material {
-    private static _spineVS;
-    private static _spineFS;
-    constructor(engine: Engine);
-}

package/types/SpineRenderer.d.ts

@@ -1,38 +0,0 @@
-import { Script, Entity } from "@galacean/engine";
-import { SpineAnimation } from "./SpineAnimation";
-export declare class SpineRenderer extends Script {
-    private _priority;
-    private _resource;
-    private _animationName;
-    private _loop;
-    private _paused;
-    private _autoPlay;
-    private _skinName;
-    private _scale;
-    private _spineAnimation;
-    /** @internal */
-    _animationNames: Array<string>;
-    /** @internal */
-    _skinNames: Array<string>;
-    get priority(): number;
-    set priority(value: number);
-    get resource(): Entity | null;
-    set resource(value: Entity | null);
-    get animationName(): string;
-    set animationName(name: string);
-    get loop(): boolean;
-    set loop(value: boolean);
-    get paused(): boolean;
-    set paused(value: boolean);
-    get autoPlay(): boolean;
-    set autoPlay(value: boolean);
-    get skinName(): string;
-    set skinName(name: string);
-    get scale(): number;
-    set scale(value: number);
-    get spineAnimation(): SpineAnimation;
-    onDestroy(): void;
-    play(name?: string, loop?: boolean): void;
-    _cloneTo(target: SpineRenderer): void;
-    private _removeResource;
-}

package/types/core/MeshGenerator.d.ts

@@ -1,43 +0,0 @@
-import { Engine, Entity, SubMesh, Texture2D } from "@galacean/engine";
-import { Skeleton } from "../spine-core/Skeleton";
-import { SkeletonData } from "../spine-core/SkeletonData";
-import { Color } from "../spine-core/Utils";
-import { SpineRenderSetting } from "../types";
-import { BlendMode } from "../spine-core/BlendMode";
-type SubMeshItem = {
-    subMesh: SubMesh;
-    blendMode: BlendMode;
-    texture: any;
-    slotName?: string;
-};
-export declare class MeshGenerator {
-    static QUAD_TRIANGLES: number[];
-    static VERTEX_SIZE: number;
-    static VERTEX_STRIDE: number;
-    static tempColor: Color;
-    static tempBlendMode: BlendMode | null;
-    private _setting;
-    private _engine;
-    private _entity;
-    private _clipper;
-    private _spineMesh;
-    private _vertexCount;
-    private _vertices;
-    private _verticesWithZ;
-    private _indices;
-    private _needResize;
-    private _meshRenderer;
-    private _subMeshItems;
-    readonly separateSlots: string[];
-    readonly separateSlotTextureMap: Map<string, Texture2D>;
-    get mesh(): import("@galacean/engine").BufferMesh;
-    get subMeshItems(): SubMeshItem[];
-    constructor(engine: Engine, entity: Entity);
-    initialize(skeletonData: SkeletonData, setting?: SpineRenderSetting): void;
-    buildMesh(skeleton: Skeleton): void;
-    addSeparateSlot(slotName: string): void;
-    addSeparateSlotTexture(slotName: string, texture: Texture2D): void;
-    private _prepareBufferData;
-    private setBlendMode;
-}
-export {};

package/types/core/SpineMesh.d.ts

@@ -1,11 +0,0 @@
-import { BufferMesh, Engine, Buffer } from '@galacean/engine';
-export declare class SpineMesh {
-    private _mesh;
-    private _indexBuffer;
-    private _vertexBuffer;
-    get mesh(): BufferMesh;
-    get indexBuffer(): Buffer;
-    get vertexBuffer(): Buffer;
-    initialize(engine: Engine, vertexCount: number): void;
-    changeBuffer(engine: Engine, vertexCount: number): void;
-}