@aura3d/engine 3.0.0 → 3.0.1

package/dist/rendering/effects/ResidentGPUParticleRenderer.d.ts

@@ -0,0 +1,158 @@
+import { type GPUParticleEffectsInput } from "./GPUParticleBackend.js";
+/** Fixed authored camera, shared by clipping, billboard orientation and ground-ray fade. */
+export declare const RESIDENT_PARTICLE_CAMERA: {
+    readonly position: readonly [0, 2.5, 7.2];
+    readonly target: readonly [0, 1.4, 0];
+    readonly fovDegrees: 65;
+    readonly near: 0.05;
+    readonly far: 30;
+};
+export interface ResidentGPUParticleOptions {
+    effects: GPUParticleEffectsInput;
+    count: number;
+    positions: Float32Array;
+    velocities: Float32Array;
+    accelerations: Float32Array;
+    baseAttributes: Float32Array;
+}
+/** CPU wall-clock intervals; these include browser/IPC scheduling, not GPU timestamps. */
+export interface ResidentParticleCPUPhases {
+    encodeSubmitMs: number;
+    mapWaitMs: number;
+    /** Residual validation wait after mapping completes; the promises overlap. */
+    validationWaitMs: number;
+    completionOrderWaitMs?: number;
+}
+export interface ResidentParticlePacingControl {
+    kind: "native-clear-map-pacing-control";
+    cpuPhases: ResidentParticleCPUPhases;
+    totalMs: number;
+    readbackBytes: 128;
+    drawCalls: 0;
+    computeDispatches: 0;
+    nativeSubmissions: number;
+    width: number;
+    height: number;
+}
+export interface ResidentParticleFrame {
+    completionFence?: {
+        submittedAt: number;
+        queueCompletedAt: number;
+        counterMappedAt: number;
+        counterMapMinusQueueCompletionMs: number;
+    };
+    gpuPassMs?: Record<string, number> | null;
+    diagnosticReadbackBytes?: number;
+    /** Actual callback time for this submission's GPU copy/map completion. */
+    queueCompletedAt: number;
+    /** Submission whose compact reduction counters back this receipt. */
+    counterSourceSubmission: number;
+    /** Completed submissions since the mapped counter source (0 on sampled frames). */
+    counterSampleAge: number;
+    cpuPhases: ResidentParticleCPUPhases;
+    live: number;
+    renderedLive: number;
+    frustumRejected: number;
+    fadeRejected: number;
+    alphaRejected: number;
+    sizeRejected: number;
+    trailCount: number;
+    ribbonVertices: number;
+    faded: number;
+    count: number;
+    workgroups: number;
+    readbackBytes: number;
+    collision: number;
+    trails: number;
+    subemitters: number;
+    turbulence: number;
+    curves: number;
+    lighting: number;
+    collisionContacts: number;
+    childRequests: number;
+    childSpawns: number;
+    computeAndReadbackMs: number;
+    diagnostics: {
+        drawCalls: number;
+        nativeSubmissions: number;
+        gpuResident: true;
+        adapterName: string;
+        readbackBytes: number;
+        buffers: number;
+        shaders: number;
+        lastError: string | null;
+        contextLost: boolean;
+        camera: typeof RESIDENT_PARTICLE_CAMERA;
+    };
+}
+/** One native device owns simulation storage, GPU lifecycle, reduction, and vertex-pulled drawing. */
+export declare class ResidentGPUParticleRenderer {
+    private readonly device;
+    private readonly context;
+    private readonly canvas;
+    private readonly options;
+    readonly adapterName: string;
+    readonly camera: {
+        readonly position: readonly [0, 2.5, 7.2];
+        readonly target: readonly [0, 1.4, 0];
+        readonly fovDegrees: 65;
+        readonly near: 0.05;
+        readonly far: 30;
+    };
+    private disposed;
+    private pending;
+    private activeFrames;
+    private exclusiveFrame;
+    private readonly busyReadbacks;
+    private secondReadback?;
+    private thirdReadback?;
+    private completionTail;
+    private failure;
+    private time;
+    private submissions;
+    private counterSourceSubmission;
+    private lastCounters;
+    private visualFlags;
+    private readonly buffers;
+    private readonly effectsPipeline;
+    private readonly effectsGroup;
+    private readonly lifecycle;
+    private readonly collect;
+    private readonly reduce;
+    private readonly auxiliaryGroup;
+    private readonly sprite;
+    private readonly ribbon;
+    private readonly spriteGroup;
+    private readonly ribbonGroup;
+    private readonly params;
+    private readonly simulationUniform;
+    private readonly simulationUniformView;
+    private readonly view;
+    private readonly counters;
+    private readonly requests;
+    private readonly readback;
+    private readonly trailDepth;
+    private timestampQuery?;
+    private timestampResolve?;
+    private timestampReadback?;
+    get supportsGPUTimestamps(): boolean;
+    static create(canvas: HTMLCanvasElement, width: number, height: number, options: ResidentGPUParticleOptions): Promise<ResidentGPUParticleRenderer>;
+    private constructor();
+    resize(width: number, height: number): void;
+    /** Diagnostic controls only; timed full-feature runs must retain all three defaults. */
+    setVisualControl(control: {
+        trails?: boolean;
+        softFade?: boolean;
+        lighting?: boolean;
+    }): void;
+    render(dt: number, gpuDiagnostic?: boolean, allowOverlap?: boolean): Promise<ResidentParticleFrame>;
+    /** Post-measurement diagnostic baseline, never a substitute for render(dt).
+     * Clears this native canvas, then maps the ordered copy without particle work.
+     * Existing particle storage, simulation time and feature settings are retained.
+     */
+    renderPacingControl(): Promise<ResidentParticlePacingControl>;
+    dispose(): void;
+}
+export declare function residentLifecycleShader(count: number, depth: number): string;
+export declare function residentDrawShader(_count: number, depth: number, lighting?: GPUParticleEffectsInput["lighting"]): string;
+//# sourceMappingURL=ResidentGPUParticleRenderer.d.ts.map

package/dist/rendering/effects/ResidentGPUParticleRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResidentGPUParticleRenderer.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ResidentGPUParticleRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAErI,4FAA4F;AAC5F,eAAO,MAAM,wBAAwB;;;;;;CAE3B,CAAC;AAsBX,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,uBAAuB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,YAAY,CAAC;IACnG,aAAa,EAAE,YAAY,CAAC;IAAC,cAAc,EAAE,YAAY,CAAC;CAC3D;AACD,0FAA0F;AAC1F,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AACD,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,iCAAiC,CAAC;IACxC,SAAS,EAAE,yBAAyB,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,GAAG,CAAC;IACnB,SAAS,EAAE,CAAC,CAAC;IACb,iBAAiB,EAAE,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,gCAAgC,EAAE,MAAM,CAAC;KAC1C,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,uBAAuB,EAAE,MAAM,CAAC;IAChC,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,yBAAyB,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAC1L,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC5F,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IACrG,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAC;IACzE,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,wBAAwB,CAAA;KAAE,CAAC;CACzP;AAED,sGAAsG;AACtG,qBAAa,2BAA2B;IA0DlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAgB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAW,OAAO,CAAC,QAAQ,CAAC,MAAM;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAA8B,QAAQ,CAAC,WAAW,EAAE,MAAM;IA1DnI,QAAQ,CAAC,MAAM;;;;;;MAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,cAAc,CAAC,CAAW;IAClC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,IAAI,qBAAqB,IAAI,OAAO,CAAkE;WAEzF,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAkBxJ,OAAO;IAoEP,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO3C,wFAAwF;IACxF,gBAAgB,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAQvF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,UAAQ,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0FrG;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAiCnE,OAAO,IAAI,IAAI;CAMhB;AAsBD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgG5E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,GAAG,MAAM,CAoDxH"}