@neutrinoparticles/js-v1.1-phaser 1.0.0 → 1.1.0

package/dist/neutrinoparticles.js-v1.1-phaser.d.ts

@@ -103,13 +103,15 @@ declare module '@neutrinoparticles/js-v1.1-phaser/Effect' {
     import { Pause, Vec2, Vec3 } from '@neutrinoparticles/js-v1.1-phaser/types';
     import { GamePlugin } from '@neutrinoparticles/js-v1.1-phaser/GamePlugin';
     import { EffectModel } from '@neutrinoparticles/js-v1.1-phaser/EffectModel';
-    import { NeutrinoSystem } from '@neutrinoparticles/js-v1.1-phaser/types';
+    import { NeutrinoEmitterProperty, NeutrinoSystem } from '@neutrinoparticles/js-v1.1-phaser/types';
+    import { PerspectiveProjection } from '@neutrinoparticles/js-v1.1-phaser/PerspectiveProjection';
     export interface EffectOptions {
         position?: Vec3;
         angle?: number;
         scale?: number;
         pause?: Pause;
         generatorsPaused?: boolean;
+        projection?: PerspectiveProjection;
     }
     /**
       * A NeutrinoParticles effect on a Phaser scene (JS v1.1 runtime).
@@ -135,6 +137,8 @@ declare module '@neutrinoparticles/js-v1.1-phaser/Effect' {
         alpha: number;
         depth: number;
         blendMode: number;
+        /** Optional v1.0-parity perspective projection (Projection3D). */
+        projection?: PerspectiveProjection;
         constructor(effectModel: EffectModel, scene: Phaser.Scene, options?: EffectOptions);
         get ready(): boolean;
         preUpdate(_time: number, ms: number): void;
@@ -156,6 +160,12 @@ declare module '@neutrinoparticles/js-v1.1-phaser/Effect' {
         unpauseGenerators(): void;
         get generatorsPaused(): boolean;
         setPropertyInAllEmitters(name: string, value: Vec3 | Vec2 | number): void;
+        setPropertyInEmitter(emitterName: string, name: string, value: Vec3 | Vec2 | number): void;
+        getEmitterPropertyValue(name: string): number | number[] | undefined;
+        getEmitterPropertyValue(emitterName: string, name: string): number | number[] | undefined;
+        hasEmitterProperty(name: string): boolean;
+        hasEmitterProperty(emitterName: string, name: string): boolean;
+        getEmitterProperties(): NeutrinoEmitterProperty[];
         getNumParticles(): number;
         setScrollFactor(x: number, y?: number): this;
         setAlpha(topLeft?: number, _topRight?: number, _bottomLeft?: number, _bottomRight?: number): this;
@@ -237,6 +247,18 @@ declare module '@neutrinoparticles/js-v1.1-phaser/types' {
         areGeneratorsInAllEmittersPaused(): boolean;
         getNumParticles(): number;
         setPropertyInAllEmitters(name: string, value: number | Vec2 | Vec3): void;
+        setPropertyInEmitter(emitterName: string, name: string, value: number | Vec2 | Vec3): void;
+        getEmitterPropertyValue(name: string): number | number[] | undefined;
+        getEmitterPropertyValue(emitterName: string, name: string): number | number[] | undefined;
+        hasEmitterProperty(name: string): boolean;
+        hasEmitterProperty(emitterName: string, name: string): boolean;
+        getEmitterProperties(): NeutrinoEmitterProperty[];
+    }
+    export interface NeutrinoEmitterProperty {
+        emitterName: string;
+        name: string;
+        arity: number;
+        value: number | number[];
     }
     export interface NeutrinoRuntimeContext {
         initializeNoise(path: string, success: () => void, fail: () => void): void;
@@ -315,6 +337,7 @@ declare module '@neutrinoparticles/js-v1.1-phaser/NeutrinoRenderer' {
     import { DataTextureManager } from "@neutrinoparticles/js-v1.1-phaser/DataTextureManager";
     import { DataTextureManagerGL1 } from "@neutrinoparticles/js-v1.1-phaser/gl1/DataTextureManagerGL1";
     import { NeutrinoSubRect } from "@neutrinoparticles/js-v1.1-phaser/types";
+    import { PerspectiveProjection } from "@neutrinoparticles/js-v1.1-phaser/PerspectiveProjection";
     export interface RenderParams {
             /** Effect world transform (2x3) already including world scale. */
             model: {
@@ -334,6 +357,9 @@ declare module '@neutrinoparticles/js-v1.1-phaser/NeutrinoRenderer' {
             zoom: number;
             /** Host scene-graph world alpha, multiplied into each particle's alpha. */
             worldAlpha: number;
+            /** Optional v1.0-parity perspective projection (Projection3D); when set,
+                *  uViewProjMatrix = ortho * perspective (both in screen space). */
+            projection?: PerspectiveProjection;
             /** Per-particle GL textures (one per render-style texture index). */
             glTextures: (WebGLTexture | null)[];
             remaps: Array<NeutrinoSubRect | null>;
@@ -445,6 +471,16 @@ declare module '@neutrinoparticles/js-v1.1-phaser/PerspectiveProjection' {
                 */
             transformSize(outSize: Vec2, pos: Vec3, size: Vec2): void;
             _getScale(pos: Vec3): number;
+            /**
+                * Writes the projection as a 4x4 column-major matrix operating in screen
+                * space, for the GPU render path. Homogeneous equivalent of
+                * transformPosition(): clip.xy = p.xy - center * (p.z / z),
+                * clip.w = 1 - p.z / z; the z row is zeroed (no depth on this path).
+                * setScreenFrame() must have been called before.
+                *
+                * @param {Float32Array} out 16-element column-major output matrix.
+                */
+            writeMatrix(out: Float32Array): void;
     }
 }