@galacean/effects-core 2.9.0-alpha.1 → 2.9.0-alpha.2

package/dist/material/types.d.ts

@@ -2,6 +2,7 @@ import type * as spec from '@galacean/effects-specification';
 import type { Matrix3, Matrix4, Vector2, Vector3, Vector4 } from '@galacean/effects-math/es/core/index';
 import type { Texture } from '../texture';
 import type { DestroyOptions } from '../utils';
+import type { VFXItem } from '../vfx-item';
 export type UniformSemantic = 'VIEW' | 'MODEL' | 'MODELVIEW' | 'PROJECTION' | 'VIEWPROJECTION' | 'VIEWINVERSE' | 'EDITOR_TRANSFORM' | 'MODELVIEWPROJECTION';
 export interface MaterialBlendingStates {
     blending?: boolean;
@@ -63,6 +64,7 @@ export declare enum ShaderType {
  *
  */
 export interface Maskable {
+    item: VFXItem;
     drawStencilMask(maskRef: number): void;
 }
 /**

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

@@ -1 +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[];
+export declare function buildAdaptiveBezier(points: number[], sX: number, sY: number, cp1x: number, cp1y: number, cp2x: number, cp2y: number, eX: number, eY: number, smoothness?: number, scale?: number): number[];

package/dist/math/shape/circle.d.ts

@@ -191,6 +191,6 @@ export declare class Circle extends ShapePrimitive {
      * @see {@link Circle.clone} For creating new circle copy
      */
     copyTo(circle: Circle): Circle;
-    build(points: number[]): void;
+    build(points: number[], screenScale?: number): void;
     triangulate(points: number[], vertices: number[], verticesOffset: number, indices: number[], indicesOffset: number): void;
 }

package/dist/math/shape/ellipse.d.ts

@@ -74,6 +74,6 @@ export declare class Ellipse extends ShapePrimitive {
     copyTo(ellipse: Ellipse): Ellipse;
     getX(): number;
     getY(): number;
-    build(points: number[]): number[];
+    build(points: number[], screenScale?: number): number[];
     triangulate(points: number[], vertices: number[], verticesOffset: number, indices: number[], indicesOffset: number): void;
 }

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

@@ -23,7 +23,7 @@ export declare class GraphicsPath {
      * @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;
+    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number, smoothness?: number, scale?: number): GraphicsPath;
     /**
      * Connects the current point to a new point with a straight line. This method updates the current path.
      * @param x - The x-coordinate of the new point to connect to.

package/dist/math/shape/poly-star.d.ts

@@ -35,7 +35,7 @@ export declare class PolyStar extends ShapePrimitive {
     clone(): ShapePrimitive;
     copyFrom(source: PolyStar): void;
     copyTo(destination: PolyStar): void;
-    build(points: number[]): void;
+    build(points: number[], screenScale?: number): void;
     triangulate(points: number[], vertices: number[], verticesOffset: number, indices: number[], indicesOffset: number): void;
     private buildStarPath;
     private buildPolygonPath;

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

@@ -58,7 +58,7 @@ export declare class Polygon extends ShapePrimitive {
      * @readonly
      */
     getY(): number;
-    build(points: number[]): void;
+    build(points: number[], screenScale?: number): void;
     triangulate(points: number[], vertices: number[], verticesOffset: number, indices: number[], indicesOffset: number): void;
     /**
      * 获取直线上最远的两个端点坐标组成的三角形

package/dist/math/shape/rectangle.d.ts

@@ -57,6 +57,6 @@ export declare class Rectangle extends ShapePrimitive {
      * @returns Returns given parameter.
      */
     copyTo(rectangle: Rectangle): Rectangle;
-    build(points: number[]): void;
+    build(points: number[], screenScale?: number): void;
     triangulate(points: number[], vertices: number[], verticesOffset: number, indices: number[], indicesOffset: number): void;
 }

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

@@ -26,7 +26,7 @@ export declare class ShapePath {
      * @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;
+    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number, smoothness?: number, scale?: number): ShapePath;
     moveTo(x: number, y: number): ShapePath;
     /**
      * Connects the current point to a new point with a straight line. This method updates the current path.

package/dist/math/shape/shape-primitive.d.ts

@@ -10,6 +10,6 @@ export declare abstract class ShapePrimitive {
     /** Returns the framing rectangle of the ShapePrimitive as a Rectangle object. */
     /** The X coordinate of the shape */
     /** The Y coordinate of the shape */
-    abstract build(points: number[]): void;
+    abstract build(points: number[], screenScale?: number): void;
     abstract triangulate(points: number[], vertices: number[], verticesOffset: number, indices: number[], indicesOffset: number): void;
 }

package/dist/math/shape/triangle.d.ts

@@ -84,6 +84,6 @@ export declare class Triangle extends ShapePrimitive {
     getBounds(out?: Rectangle): Rectangle;
     getX(): number;
     getY(): number;
-    build(points: number[]): void;
+    build(points: number[], screenScale?: number): void;
     triangulate(points: number[], vertices: number[], verticesOffset: number, indices: number[], indicesOffset: number): void;
 }

package/dist/plugins/interact/click-handler.d.ts

@@ -3,6 +3,7 @@ import { Vector2 } from '@galacean/effects-math/es/core/vector2';
 import type * as spec from '@galacean/effects-specification';
 import type { VFXItem } from '../../vfx-item';
 import type { Composition } from '../../composition';
+import type { Maskable } from '../../material';
 export declare enum HitTestType {
     triangle = 1,
     box = 2,
@@ -28,23 +29,27 @@ export interface HitTestTriangleParams {
     type: HitTestType.triangle;
     triangles: TriangleLike[];
     backfaceCulling?: boolean;
+    clipMasks: Maskable[];
     behavior?: spec.InteractBehavior;
 }
 export interface HitTestBoxParams {
     type: HitTestType.box;
     center: Vector3;
     size: Vector3;
+    clipMasks: Maskable[];
     behavior?: spec.InteractBehavior;
 }
 export interface HitTestSphereParams {
     type: HitTestType.sphere;
     center: Vector3;
     radius: number;
+    clipMasks: Maskable[];
     behavior?: spec.InteractBehavior;
 }
 export interface HitTestCustomParams {
     type: HitTestType.custom;
     collect(ray: Ray, pointInCanvas: Vector2): Vector3[] | void;
+    clipMasks: Maskable[];
     behavior?: spec.InteractBehavior;
 }
 export type Region = {

package/dist/plugins/text/text-item.d.ts

@@ -133,7 +133,7 @@ export declare class TextComponent extends MaskableGraphic {
      *
      * 说明：
      * - 使用 Canvas 2D 的 measureText，并按当前实现的逐字符排版规则累加宽度（与 updateTexture 保持一致）。
-     * - 结果为"逻辑宽度"（已除去 fontScale，并扣除 fontOffset），可直接写回 options.textWidth。
+     * - 结果为"逻辑宽度"（扣除 fontOffset），可直接写回 options.textWidth。，可直接写回 options.textWidth。
      * - 通过 padding 追加少量冗余像素，用于降低边缘裁切风险。
      *
      * @returns 文本宽度（>= 0）

package/dist/scene.d.ts

@@ -79,7 +79,6 @@ export interface SceneLoadOptions {
     /**
      * 渲染分级。
      * 分级之后，只会加载当前渲染等级的资源。
-     * 当渲染等级被设置为 B 后，player 的 fps 会降到 30 帧
      * @default 'S'
      */
     renderLevel?: SceneRenderLevel;

package/dist/vfx-item.d.ts

@@ -1,11 +1,12 @@
+import type { Ray } from '@galacean/effects-math/es/core/ray';
 import { Vector3 } from '@galacean/effects-math/es/core/vector3';
 import * as spec from '@galacean/effects-specification';
 import type { Component } from './components';
-import type { Composition } from './composition';
+import type { Composition, CompositionHitTestOptions } from './composition';
 import { EffectsObject } from './effects-object';
 import type { Engine } from './engine';
 import type { EventEmitterListener, EventEmitterOptions, ItemEvent } from './events';
-import type { BoundingBoxData, HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, HitTestTriangleParams } from './plugins';
+import type { BoundingBoxData, HitTestBoxParams, HitTestCustomParams, HitTestSphereParams, HitTestTriangleParams, Region } from './plugins';
 import { Transform } from './transform';
 import type { Constructor, Disposable } from './utils';
 /**
@@ -54,7 +55,7 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      */
     type: spec.ItemType;
     /**
-     * @deprecated 2.9.0 Please use `defination` instead
+     * @deprecated 2.9.0 Please use `definition` instead
      */
     props: spec.VFXItemData;
     /**
@@ -275,6 +276,19 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      * @param force - 元素没有开启交互也返回参数
      */
     getHitTestParams(force?: boolean): void | HitTestBoxParams | HitTestTriangleParams | HitTestSphereParams | HitTestCustomParams;
+    /**
+     * 对当前元素及其子节点进行射线命中测试
+     *
+     * @param ray - 射线
+     * @param x - 归一化屏幕坐标 x
+     * @param y - 归一化屏幕坐标 y
+     * @param regions - 命中结果收集数组
+     * @param hitPositions - 共享的命中位置数组，所有 region 共享同一引用
+     * @param force - 是否强制测试无交互信息的元素
+     * @param options - 额外选项（maxCount、stop、skip）
+     * @returns 是否有任何命中
+     */
+    hitTest(ray: Ray, x: number, y: number, regions: Region[], hitPositions: Vector3[], force?: boolean, options?: CompositionHitTestOptions): boolean;
     /**
      * 获取元素当前世界坐标
      */
@@ -286,6 +300,7 @@ export declare class VFXItem extends EffectsObject implements Disposable {
      * @returns 复制的新 VFXItem
      */
     duplicate(): VFXItem;
+    private onParentChanged;
     fromData(data: spec.VFXItemData): void;
     toData(): void;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-core",
-  "version": "2.9.0-alpha.1",
+  "version": "2.9.0-alpha.2",
   "description": "Galacean Effects runtime core for the web",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",