tosijs-3d 0.8.2 → 0.8.3

package/dist/b3d-galaxy.d.ts

@@ -2,6 +2,20 @@ import { B3dChild } from './b3d-utils.js';
 import * as BABYLON from '@babylonjs/core';
 import type { B3d } from './tosi-b3d.js';
 import { type StarData, type GalaxyData, type StarSystemData } from './galaxy-data.js';
+/**
+ * A particle as the baker and the picker see it. The field names are the
+ * `SolidParticle` subset those consumers always read (`scaling`, not
+ * `scale`), so code written against the old particle system still reads it.
+ */
+export interface GalaxyPoint {
+    /** Centre, in the mesh's own (Babylon, y-up) frame. */
+    position: BABYLON.Vector3;
+    /** The authored size multiplier — the quad is `particleSize × scaling.x`. */
+    scaling: {
+        x: number;
+    };
+    color: BABYLON.Color4;
+}
 export declare class B3dGalaxy extends B3dChild {
     static preferredTagName: string;
     static shadowStyleSpec: {
@@ -35,31 +49,30 @@ export declare class B3dGalaxy extends B3dChild {
     maxStarApparentSize: number;
     owner: B3d | null;
     private rootNode;
-    private starSps;
+    private starQuads;
     private starMesh;
-    private nebulaSps;
+    private nebulaQuads;
     private nebulaMesh;
+    /** The fixed viewpoint set by `facePoint`, or null to follow the camera. */
+    private faceTarget;
     private blackHoleEl;
     private galaxyData;
     private originalColors;
     private registered;
-    private _beforeRender;
     content: () => string;
     sceneReady(owner: B3d, scene: BABYLON.Scene): void;
     sceneDispose(): void;
     /**
-     * Point every particle at THE CAMERA POSITION — a fixed world point, rather
-     * than at the camera's view plane.
-     *
-     * ⚠️ THIS IS WHAT MAKES A CUBE BAKE WORK. `SolidParticleSystem.billboard`
-     * aligns quads to the camera's VIEW PLANE, which is a different plane for
-     * each of a cube's six faces — so every star and nebula silently re-orients
-     * between captures, and the faces disagree at their seams.
+     * Face every particle at a FIXED world point instead of the live camera, and
+     * clamp star sizes as seen from it. `null` hands orientation back to the
+     * camera.
      *
-     * A cube map is ONE viewpoint photographed six ways. All six share a camera
-     * POSITION and differ only in rotation, so that position is what the
-     * particles should face: do it once, and every face sees each nebula from the
-     * same angle and as the same shape.
+     * The particles always face the viewpoint's POSITION — the vertex shader
+     * does that (see `registerShaders`) — so a cube bake's six faces, which share
+     * a position and differ only in rotation, already agree at their seams
+     * without this. What a fixed point adds is the APPARENT-SIZE CLAMP
+     * (`maxStarApparentSize`), which only means something from one known
+     * viewpoint, and a guarantee that nothing between captures can move it.
      *
      * ⚠️ NOT the galactic centre. This was first written as `faceOrigin`, which
      * named the wrong thing even though the argument was right — Tonio: "No
@@ -67,10 +80,12 @@ export declare class B3dGalaxy extends B3dChild {
      * way out from the core, so facing the core would tilt every particle away
      * from the viewer by a different amount depending where it sits.
      *
-     * Pass `null` to hand orientation back to the live camera.
+     * (This used to write a rotation into every particle on the CPU, alongside
+     * Babylon's own per-frame billboarding — two mechanisms that COMPOSED rather
+     * than replaced each other, which is how a restore once left every star a
+     * vertical smear. One uniform cannot stack with anything.)
      */
     facePoint(target: BABYLON.Vector3 | null): void;
-    private update;
     private disposeMeshes;
     private registerShaders;
     private createShaderMaterial;
@@ -82,31 +97,50 @@ export declare class B3dGalaxy extends B3dChild {
     getStarSystem(index: number): StarSystemData | null;
     /** Get the galaxy data */
     getGalaxyData(): GalaxyData | null;
-    /** Get the star SPS for external picking */
-    getStarSPS(): BABYLON.SolidParticleSystem | null;
-    /** Get the star SPS mesh for pick comparison */
+    /**
+     * @deprecated There is no particle system any more — stars are billboarded
+     * in the vertex shader. Use {@link pickStar} to pick. Returns null; removed
+     * in 0.9.
+     */
+    getStarSPS(): null;
+    /** The star mesh — hide it, fade it, or compare against it. */
     getStarMesh(): BABYLON.Mesh | null;
     /**
-     * The DISTANT STAR particles, for the skybox baker — the tail of the star
-     * SPS, in the same order `generateGalaxy` made them (see the note in
-     * `galaxy-data`).
+     * Every point in the star mesh — the disc stars in generation order, then
+     * the distant stars — in the mesh's own (Babylon) frame.
+     */
+    getStarPoints(): GalaxyPoint[];
+    /**
+     * The star under a screen point, or `-1`.
+     *
+     * ⚠️ NOT `scene.pick`. The mesh's CPU geometry is every quad collapsed to its
+     * centre — the corners only exist in the vertex shader — so a triangle pick
+     * finds nothing. This casts the pick ray and takes the NEAREST star whose
+     * drawn disc it passes through, with a few pixels of slack so a star a
+     * pixel wide is still clickable (the old quad pick was not that kind).
+     */
+    pickStar(x: number, y: number, camera?: BABYLON.Camera | null): number;
+    /**
+     * The DISTANT STAR points, for the skybox baker — the tail of the star
+     * mesh, in the same order `generateGalaxy` made them.
      */
-    getDistantStarParticles(): BABYLON.SolidParticle[];
+    getDistantStarParticles(): GalaxyPoint[];
     /**
-     * The DISTANT GALAXY particles, for the skybox baker.
+     * The DISTANT GALAXY points, for the skybox baker.
      *
-     * They live inside the nebula SPS (appended last, in generation order — see
-     * the note in `galaxy-data`), so the only code that knows which particles
-     * they are without guessing by size or colour is the code next to the build.
-     * That is here: the last `distantGalaxies.length` particles, in the SPS's
+     * They live inside the nebula mesh (appended last, in generation order — see
+     * the note in `galaxy-data`), so the only code that knows which points they
+     * are without guessing by size or colour is the code next to the build.
+     * That is here: the last `distantGalaxies.length` points, in the mesh's
      * own (Babylon) frame — which is the frame a baker photographs in.
      */
-    getDistantGalaxyParticles(): BABYLON.SolidParticle[];
-    /** Hide a star particle (e.g. to replace it with a star system) */
+    getDistantGalaxyParticles(): GalaxyPoint[];
+    private isStarIndex;
+    /** Hide a star (e.g. to replace it with a star system) */
     hideStarAt(index: number): void;
-    /** Show a previously hidden star particle */
+    /** Show a previously hidden star */
     showStarAt(index: number): void;
-    /** Get the world position of a star particle */
+    /** Get the world position of a star */
     getStarPosition(index: number): BABYLON.Vector3 | null;
     /** Filter stars: dim those that don't match criteria */
     filterStars(options?: {

package/dist/b3d-galaxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"b3d-galaxy.d.ts","sourceRoot":"","sources":["../src/b3d-galaxy.ts"],"names":[],"mappings":"AA8UA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAA;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAA;AAGzB,qBAAa,SAAU,SAAQ,QAAQ;IACrC,MAAM,CAAC,gBAAgB,SAAoB;IAE3C,MAAM,CAAC,eAAe;;;;MAIrB;IAED,MAAM,CAAC,cAAc;;;;;;;;;;;;MA0CpB;IAEO,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAEnC,KAAK,EAAE,GAAG,GAAG,IAAI,CAAO;IAExB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAA4B;IAEjD,OAAO,eAAW;IAElB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;IAY3C,YAAY;IAcZ;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI;IAmK/C,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,eAAe;IAuHvB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,WAAW;IAiJnB,OAAO,CAAC,cAAc;IAqBtB,uCAAuC;IACvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAMzC,+DAA+D;IAC/D,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAMnD,0BAA0B;IAC1B,aAAa,IAAI,UAAU,GAAG,IAAI;IAIlC,4CAA4C;IAC5C,UAAU,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI;IAIhD,gDAAgD;IAChD,WAAW,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI;IAIlC;;;;OAIG;IACH,uBAAuB,IAAI,OAAO,CAAC,aAAa,EAAE;IAQlD;;;;;;;;OAQG;IACH,yBAAyB,IAAI,OAAO,CAAC,aAAa,EAAE;IAQpD,mEAAmE;IACnE,UAAU,CAAC,KAAK,EAAE,MAAM;IAWxB,6CAA6C;IAC7C,UAAU,CAAC,KAAK,EAAE,MAAM;IAWxB,gDAAgD;IAChD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI;IAmBtD,wDAAwD;IACxD,WAAW,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAmCjE,gDAAgD;IAChD,aAAa,CAAC,CAAC,EAAE,MAAM;IAQvB,wDAAwD;IACxD,UAAU;CAUX;AAED,eAAO,MAAM,SAAS,4CAA6B,CAAA"}
+{"version":3,"file":"b3d-galaxy.d.ts","sourceRoot":"","sources":["../src/b3d-galaxy.ts"],"names":[],"mappings":"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"}