three-base 2.0.142 → 2.0.166

package/WaterFlow/GPUFluidSimulation.d.ts

@@ -1,56 +1,56 @@
-import * as THREE from 'three';
-import { SPHField } from './SPHField';
-import type { BasinConfig, FluidParameters, FluidSimulationOptions, ReservoirState } from './types';
-/**
- * GPUFluidSimulation —— GPGPU 粒子流体模拟（ping-pong 状态纹理 + 网格辅助 SPH）。
- *
- * ⚠️ 不支持时（非 WebGL2 或缺 EXT_color_buffer_float）构造器**提前 return**，
- *    下列标记 `| null` 的资源字段在空壳实例上不会被赋值；所有读它们的入口
- *    （reset / update / 各 setXxx / dispose / positionTexture）都先过 `if (!this.supported) return;` 守卫。
- */
-export declare class GPUFluidSimulation {
-    readonly renderer: THREE.WebGLRenderer;
-    readonly size: number;
-    readonly count: number;
-    readonly nozzle: THREE.Vector3;
-    /** x=minX, y=maxX, z=zHalfExtent, w=waterY（与 shader 的 uBasin 一致）。 */
-    readonly basin: THREE.Vector4;
-    readonly jetDirection: THREE.Vector3;
-    /** 1=开启粒子与 basin/地面碰撞回弹，0=关闭（喂给 shader 的 uCollision，故为 0/1）。 */
-    collision: number;
-    readonly supported: boolean;
-    /** ping-pong 状态目标；update() 每帧整体交换 read/write，故非 readonly。 */
-    read: THREE.WebGLRenderTarget | null;
-    /** ping-pong 状态目标；update() 每帧整体交换 read/write，故非 readonly。 */
-    write: THREE.WebGLRenderTarget | null;
-    readonly sphField: SPHField | null;
-    readonly sphDomainMinimum: THREE.Vector3;
-    readonly sphDomainMaximum: THREE.Vector3;
-    readonly scene: THREE.Scene;
-    readonly camera: THREE.OrthographicCamera;
-    /** 材质在 reset/update 间切换（initMaterial ↔ updateMaterial），故类型含 null。 */
-    readonly mesh: THREE.Mesh<THREE.PlaneGeometry, THREE.ShaderMaterial | null>;
-    readonly initialPosition: THREE.DataTexture | null;
-    readonly initialVelocity: THREE.DataTexture | null;
-    readonly initMaterial: THREE.ShaderMaterial | null;
-    readonly updateMaterial: THREE.ShaderMaterial | null;
-    constructor(renderer: THREE.WebGLRenderer, { size, nozzle, basin, speed, aperture, jetDirection, collision, }?: FluidSimulationOptions);
-    hash(value: number): number;
-    reset(): void;
-    update(delta: number, elapsed: number): void;
-    setParameters({ speed, aperture, fillRatio, emitting, turbulence }: FluidParameters): void;
-    setReservoirState({ active, fillRatio }?: ReservoirState): void;
-    setContainerMotion(accelerationX?: number, accelerationZ?: number): void;
-    setBasin({ minX, maxX, halfZ, centerZ, waterY, wallTop, floorY, containerFloorY, rimWidth, }: BasinConfig): void;
-    updateSPHDomain(): void;
-    /** 运行时改喷流起点（喷嘴）坐标；会重算 SPH 域，已发射粒子在下一次 respawn 时回到新起点 */
-    setNozzle(x: number, y: number, z: number): void;
-    /** 运行时改喷流方向（轴向，会被归一化） */
-    setJetDirection(dx: number, dy: number, dz: number): void;
-    /** 运行时开关粒子与 basin/地面碰撞回弹（默认开启） */
-    setCollision(enabled: boolean): void;
-    setSPHActiveCount(count: number): void;
-    get positionTexture(): THREE.Texture | null;
-    get velocityTexture(): THREE.Texture | null;
-    dispose(): void;
-}
+import * as THREE from 'three';
+import { SPHField } from './SPHField';
+import type { BasinConfig, FluidParameters, FluidSimulationOptions, ReservoirState } from './types';
+/**
+ * GPUFluidSimulation —— GPGPU 粒子流体模拟（ping-pong 状态纹理 + 网格辅助 SPH）。
+ *
+ * ⚠️ 不支持时（非 WebGL2 或缺 EXT_color_buffer_float）构造器**提前 return**，
+ *    下列标记 `| null` 的资源字段在空壳实例上不会被赋值；所有读它们的入口
+ *    （reset / update / 各 setXxx / dispose / positionTexture）都先过 `if (!this.supported) return;` 守卫。
+ */
+export declare class GPUFluidSimulation {
+    readonly renderer: THREE.WebGLRenderer;
+    readonly size: number;
+    readonly count: number;
+    readonly nozzle: THREE.Vector3;
+    /** x=minX, y=maxX, z=zHalfExtent, w=waterY（与 shader 的 uBasin 一致）。 */
+    readonly basin: THREE.Vector4;
+    readonly jetDirection: THREE.Vector3;
+    /** 1=开启粒子与 basin/地面碰撞回弹，0=关闭（喂给 shader 的 uCollision，故为 0/1）。 */
+    collision: number;
+    readonly supported: boolean;
+    /** ping-pong 状态目标；update() 每帧整体交换 read/write，故非 readonly。 */
+    read: THREE.WebGLRenderTarget | null;
+    /** ping-pong 状态目标；update() 每帧整体交换 read/write，故非 readonly。 */
+    write: THREE.WebGLRenderTarget | null;
+    readonly sphField: SPHField | null;
+    readonly sphDomainMinimum: THREE.Vector3;
+    readonly sphDomainMaximum: THREE.Vector3;
+    readonly scene: THREE.Scene;
+    readonly camera: THREE.OrthographicCamera;
+    /** 材质在 reset/update 间切换（initMaterial ↔ updateMaterial），故类型含 null。 */
+    readonly mesh: THREE.Mesh<THREE.PlaneGeometry, THREE.ShaderMaterial | null>;
+    readonly initialPosition: THREE.DataTexture | null;
+    readonly initialVelocity: THREE.DataTexture | null;
+    readonly initMaterial: THREE.ShaderMaterial | null;
+    readonly updateMaterial: THREE.ShaderMaterial | null;
+    constructor(renderer: THREE.WebGLRenderer, { size, nozzle, basin, speed, aperture, jetDirection, collision, }?: FluidSimulationOptions);
+    hash(value: number): number;
+    reset(): void;
+    update(delta: number, elapsed: number): void;
+    setParameters({ speed, aperture, fillRatio, emitting, turbulence }: FluidParameters): void;
+    setReservoirState({ active, fillRatio }?: ReservoirState): void;
+    setContainerMotion(accelerationX?: number, accelerationZ?: number): void;
+    setBasin({ minX, maxX, halfZ, centerZ, waterY, wallTop, floorY, containerFloorY, rimWidth, }: BasinConfig): void;
+    updateSPHDomain(): void;
+    /** 运行时改喷流起点（喷嘴）坐标；会重算 SPH 域，已发射粒子在下一次 respawn 时回到新起点 */
+    setNozzle(x: number, y: number, z: number): void;
+    /** 运行时改喷流方向（轴向，会被归一化） */
+    setJetDirection(dx: number, dy: number, dz: number): void;
+    /** 运行时开关粒子与 basin/地面碰撞回弹（默认开启） */
+    setCollision(enabled: boolean): void;
+    setSPHActiveCount(count: number): void;
+    get positionTexture(): THREE.Texture | null;
+    get velocityTexture(): THREE.Texture | null;
+    dispose(): void;
+}