@galacean/effects-core 2.1.0-alpha.5 → 2.1.0-alpha.6

package/dist/plugins/cal/timeline-asset.d.ts

@@ -1,4 +1,4 @@
-import type * as spec from '@galacean/effects-specification';
+import * as spec from '@galacean/effects-specification';
 import type { RuntimeClip, TrackAsset } from '../timeline/track';
 import type { FrameContext, PlayableGraph } from './playable-graph';
 import { Playable, PlayableAsset } from './playable-graph';

package/dist/plugins/shape/build-adaptive-bezier.d.ts

@@ -0,0 +1 @@
+export declare function buildAdaptiveBezier(points: number[], sX: number, sY: number, cp1x: number, cp1y: number, cp2x: number, cp2y: number, eX: number, eY: number, smoothness?: number): number[];

package/dist/plugins/shape/graphics-path.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Based on:
+ * https://github.com/pixijs/pixijs/blob/dev/src/scene/graphics/shared/path/GraphicsPath.ts
+ */
+import { ShapePath } from './shape-path';
+export declare class GraphicsPath {
+    instructions: PathInstruction[];
+    private dirty;
+    private _shapePath;
+    /**
+     * Provides access to the internal shape path, ensuring it is up-to-date with the current instructions.
+     * @returns The `ShapePath` instance associated with this `GraphicsPath`.
+     */
+    get shapePath(): ShapePath;
+    /**
+     * Adds a cubic Bezier curve to the path.
+     * It requires three points: the first two are control points and the third one is the end point.
+     * The starting point is the last point in the current path.
+     * @param cp1x - The x-coordinate of the first control point.
+     * @param cp1y - The y-coordinate of the first control point.
+     * @param cp2x - The x-coordinate of the second control point.
+     * @param cp2y - The y-coordinate of the second control point.
+     * @param x - The x-coordinate of the end point.
+     * @param y - The y-coordinate of the end point.
+     * @param smoothness - Optional parameter to adjust the smoothness of the curve.
+     * @returns The instance of the current object for chaining.
+     */
+    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number, smoothness?: number): GraphicsPath;
+    moveTo(x: number, y: number): GraphicsPath;
+    clear(): GraphicsPath;
+}
+export interface PathInstruction {
+    action: 'moveTo' | 'lineTo' | 'quadraticCurveTo' | 'bezierCurveTo' | 'arc' | 'closePath' | 'addPath' | 'arcTo' | 'ellipse' | 'rect' | 'roundRect' | 'arcToSvg' | 'poly' | 'circle' | 'regularPoly' | 'roundPoly' | 'roundShape' | 'filletRect' | 'chamferRect';
+    data: any[];
+}

package/dist/plugins/shape/point-data.d.ts

@@ -0,0 +1,6 @@
+export interface PointData {
+    /** X coord */
+    x: number;
+    /** Y coord */
+    y: number;
+}

package/dist/plugins/shape/polygon.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Based on:
+ * https://github.com/pixijs/pixijs/blob/dev/src/maths/shapes/Polygon.ts
+ */
+import type { PointData } from './point-data';
+/**
+ * A class to define a shape via user defined coordinates.
+ */
+export declare class Polygon {
+    /** An array of the points of this polygon. */
+    points: number[];
+    /** `false` after moveTo, `true` after `closePath`. In all other cases it is `true`. */
+    closePath: boolean;
+    constructor(points: PointData[] | number[]);
+    constructor(...points: PointData[] | number[]);
+    /**
+     * Creates a clone of this polygon.
+     * @returns - A copy of the polygon.
+     */
+    clone(): Polygon;
+    /**
+     * Checks whether the x and y coordinates passed to this function are contained within this polygon.
+     * @param x - The X coordinate of the point to test.
+     * @param y - The Y coordinate of the point to test.
+     * @returns - Whether the x/y coordinates are within this polygon.
+     */
+    contains(x: number, y: number): boolean;
+    /**
+     * Copies another polygon to this one.
+     * @param polygon - The polygon to copy from.
+     * @returns Returns itself.
+     */
+    copyFrom(polygon: Polygon): this;
+    /**
+     * Copies this polygon to another one.
+     * @param polygon - The polygon to copy to.
+     * @returns Returns given parameter.
+     */
+    copyTo(polygon: Polygon): Polygon;
+    /**
+     * Get the last X coordinate of the polygon
+     * @readonly
+     */
+    get lastX(): number;
+    /**
+     * Get the last Y coordinate of the polygon
+     * @readonly
+     */
+    get lastY(): number;
+    /**
+     * Get the first X coordinate of the polygon
+     * @readonly
+     */
+    get x(): number;
+    /**
+     * Get the first Y coordinate of the polygon
+     * @readonly
+     */
+    get y(): number;
+}

package/dist/plugins/shape/shape-path.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Based on:
+ * https://github.com/pixijs/pixijs/blob/dev/src/scene/graphics/shared/path/ShapePath.ts
+ */
+import type { Matrix3 } from '@galacean/effects-math/es/core/matrix3';
+import { Polygon } from './polygon';
+import type { GraphicsPath } from './graphics-path';
+export declare class ShapePath {
+    private graphicsPath;
+    currentPoly: Polygon | null;
+    shapePrimitives: {
+        shape: Polygon;
+        transform?: Matrix3;
+    }[];
+    constructor(graphicsPath: GraphicsPath);
+    /** Builds the path. */
+    buildPath(): void;
+    /**
+     * Adds a cubic Bezier curve to the path.
+     * It requires three points: the first two are control points and the third one is the end point.
+     * The starting point is the last point in the current path.
+     * @param cp1x - The x-coordinate of the first control point.
+     * @param cp1y - The y-coordinate of the first control point.
+     * @param cp2x - The x-coordinate of the second control point.
+     * @param cp2y - The y-coordinate of the second control point.
+     * @param x - The x-coordinate of the end point.
+     * @param y - The y-coordinate of the end point.
+     * @param smoothness - Optional parameter to adjust the smoothness of the curve.
+     * @returns The instance of the current object for chaining.
+     */
+    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number, smoothness?: number): ShapePath;
+    moveTo(x: number, y: number): ShapePath;
+    /**
+     * Starts a new polygon path from the specified starting point.
+     * This method initializes a new polygon or ends the current one if it exists.
+     * @param x - The x-coordinate of the starting point of the new polygon.
+     * @param y - The y-coordinate of the starting point of the new polygon.
+     * @returns The instance of the current object for chaining.
+     */
+    private startPoly;
+    /**
+     * Ends the current polygon path. If `closePath` is set to true,
+     * the path is closed by connecting the last point to the first one.
+     * This method finalizes the current polygon and prepares it for drawing or adding to the shape primitives.
+     * @param closePath - A boolean indicating whether to close the polygon by connecting the last point
+     *  back to the starting point. False by default.
+     * @returns The instance of the current object for chaining.
+     */
+    private endPoly;
+    private ensurePoly;
+}

package/dist/plugins/shape/triangulate.d.ts

@@ -0,0 +1 @@
+export declare function triangulate(contours: number[][]): number[];

package/dist/plugins/timeline/track.d.ts

@@ -1,4 +1,4 @@
-import { EndBehavior } from '@galacean/effects-specification';
+import * as spec from '@galacean/effects-specification';
 import type { PlayableGraph } from '../cal/playable-graph';
 import { Playable, PlayableAsset, PlayableOutput } from '../cal/playable-graph';
 import { ParticleSystem } from '../particle/particle-system';
@@ -12,7 +12,7 @@ export declare class TimelineClip {
     start: number;
     duration: number;
     asset: PlayableAsset;
-    endBehavior: EndBehavior;
+    endBehavior: spec.EndBehavior;
     constructor();
     toLocalTime(time: number): number;
 }

package/dist/render/gpu-capability.d.ts

@@ -16,7 +16,7 @@ export interface GPUCapabilityDetail {
     shaderTextureLod: boolean;
     instanceDraw?: boolean;
     drawBuffers?: boolean;
-    asyncShaderCompile?: boolean;
+    asyncShaderCompile: boolean;
     intIndexElementBuffer?: boolean;
     readableDepthStencilTextures?: boolean;
     writableFragDepth?: boolean;

package/dist/render/shader.d.ts

@@ -1,4 +1,4 @@
-import type * as spec from '@galacean/effects-specification';
+import * as spec from '@galacean/effects-specification';
 import { EffectsObject } from '../effects-object';
 import type { Engine } from '../engine';
 export type ShaderMacros = [key: string, value: string | number | boolean][];

package/dist/scene.d.ts

@@ -2,7 +2,7 @@ import type * as spec from '@galacean/effects-specification';
 import type { Texture } from './texture';
 import type { PluginSystem } from './plugin-system';
 import type { PickEnum } from './utils';
-export type ImageSource = spec.TemplateImage | spec.Image | spec.CompressedImage;
+export type ImageLike = spec.HTMLImageLike | ArrayBuffer | Texture;
 export type SceneRenderLevel = PickEnum<spec.RenderLevel, spec.RenderLevel.A | spec.RenderLevel.B | spec.RenderLevel.S>;
 /**
  * 场景类型
@@ -14,7 +14,7 @@ export interface Scene {
     readonly renderLevel?: SceneRenderLevel;
     readonly storage: Record<string, any>;
     textureOptions: Record<string, any>[];
-    images: ImageSource[];
+    images: ImageLike[];
     consumed?: boolean;
     textures?: Texture[];
     /**
@@ -29,8 +29,21 @@ export interface Scene {
      * 加载分段时长
      */
     timeInfos: Record<string, number>;
-    url: SceneType;
-    usedImages: Record<number, boolean>;
+    url: Scene.LoadType;
+}
+export declare namespace Scene {
+    type URLType = {
+        url: string;
+        options?: SceneLoadOptions;
+    };
+    /**
+     * 接受用于加载的数据类型
+     */
+    export type LoadType = string | Scene | URLType | spec.JSONScene | Record<string, unknown>;
+    export function isJSONObject(scene: any): scene is Scene;
+    export function isURL(scene: any): scene is URLType;
+    export function isWithOptions(scene: any): scene is URLType;
+    export {};
 }
 /**
  * 场景加载参数
@@ -96,17 +109,3 @@ export interface SceneLoadOptions {
      */
     speed?: number;
 }
-/**
- * 接受用于加载的数据类型
- */
-export type SceneURLType = {
-    url: string;
-};
-export type SceneType = string | Scene | SceneURLType | Record<string, any>;
-export type SceneWithOptionsType = {
-    options: SceneLoadOptions;
-};
-export type SceneLoadType = SceneType | SceneWithOptionsType;
-export declare function isSceneJSON(scene: any): scene is Scene;
-export declare function isSceneURL(scene: any): scene is Scene;
-export declare function isSceneWithOptions(scene: any): scene is SceneWithOptionsType;

package/dist/shape/geometry.d.ts

@@ -15,9 +15,9 @@ type ShapeGeometryPre = {
 };
 export type ShapeData = {
     gs: ShapeGeometryPre[];
-} & {
+} | {
     g: ShapeGeometryPre;
-} & spec.ShapeGeometry;
+} | spec.ShapeGeometry;
 export declare function getGeometryTriangles(geometry: spec.ShapeGeometry, options: {
     indexBase?: number;
     uvTransform?: number[];
@@ -25,6 +25,6 @@ export declare function getGeometryTriangles(geometry: spec.ShapeGeometry, optio
     aPoint: Float32Array;
     index: Uint16Array;
 };
-export declare function getGeometryByShape(shape: ShapeData, uvTransform: number[]): GeometryFromShape;
+export declare function getGeometryByShape(shape: ShapeData, uvTransform?: number[]): GeometryFromShape;
 export declare function rotateVec2(out: vec2 | number[], vec2: vec2, angleInRad: number): vec2;
 export {};

package/dist/texture/utils.d.ts

@@ -1,6 +1,5 @@
 import type * as spec from '@galacean/effects-specification';
 import type { Texture2DSourceOptions, TextureCubeSourceOptions } from './types';
-import type { Engine } from '../engine';
 type TextureJSONOptions = spec.SerializedTextureSource & spec.TextureConfigOptionsBase & spec.TextureFormatOptions;
-export declare function deserializeMipmapTexture(textureOptions: TextureJSONOptions, bins: ArrayBuffer[], engine: Engine, files?: spec.BinaryFile[]): Promise<Texture2DSourceOptions | TextureCubeSourceOptions>;
+export declare function deserializeMipmapTexture(textureOptions: TextureJSONOptions, bins: ArrayBuffer[], assets: Record<string, any>, files?: spec.BinaryFile[]): Promise<Texture2DSourceOptions | TextureCubeSourceOptions>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.1.0-alpha.5",
+  "version": "2.1.0-alpha.6",
   "description": "Galacean Effects runtime core for the web",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",
@@ -42,10 +42,11 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@galacean/effects-specification": "2.0.1",
+    "@galacean/effects-specification": "2.1.0-alpha.0",
     "@galacean/effects-math": "1.1.0",
     "flatbuffers": "24.3.25",
-    "uuid": "9.0.1"
+    "uuid": "9.0.1",
+    "libtess": "1.2.2"
   },
   "scripts": {
     "prebuild": "pnpm clean",