@pascal-app/viewer 1.0.7 → 1.1.1

package/dist/lib/daylight/room-map.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Which room a point is in, at any scale: a sparse, tiled room-id map.
+ *
+ * Every level keeps its own map of 10 cm cells, cut into square tiles. A tile entirely inside one
+ * room (or outside every room) is a single value; only tiles a room edge crosses keep their cells,
+ * packed into one shared atlas. A level's rooms are grouped into clusters, each with its own tile
+ * rect, so open ground between distant rooms costs nothing. Memory then follows the length of the
+ * walls, not the site's area, and no texture grows with the number of floors. Tiles are built one
+ * at a time, so neither does the build.
+ *
+ * A point finds its level by height within its own building (a coarse directory lists the
+ * buildings near it), so neighbouring buildings with different floor heights, or a 40-storey
+ * tower, each keep their floors. Within a building, levels sorted by height stay sorted when they
+ * explode apart, so the search runs on live heights.
+ *
+ * Each building's map is turned to its own walls: its cells run along the direction most of its
+ * room edges take, so a house drawn at 40° to the world reads exactly like the same house drawn
+ * square. Walls at other angles within a building still cross the cells in steps.
+ */
+type N = any;
+export declare const CELL = 0.1;
+/** Cells per tile side. */
+export declare const TILE = 16;
+/** Room ids are stored as two bytes (id + 1). */
+export declare const MAX_ROOMS = 65535;
+/** WebGPU guarantees 8192 texels a side; the renderer asks for no more. */
+export declare const DEFAULT_TEXTURE_LIMIT = 8192;
+export type MapLevel = {
+    /** World Y of the level's floor, assembled (not exploded). */
+    y: number;
+    /** Index of the level's building; levels of one building stack. */
+    building: number;
+};
+export type MapRoom = {
+    level: number;
+    /** World XZ. */
+    polygon: [number, number][];
+    holes?: [number, number][][];
+};
+/** A level's walls in plan: triangles of their footprints, six numbers each (world XZ × 3). */
+export type MapWalls = {
+    level: number;
+    triangles: ArrayLike<number>;
+};
+/** One tile while it is being built, inside its row's dilated cells (with a margin all round). */
+export type TileCells = {
+    level: number;
+    /** Site cell index of `cells[0]`. */
+    ci0: number;
+    cj0: number;
+    /** XZ of `cells[0]`'s lower corner, in the building's turned frame. */
+    x0: number;
+    z0: number;
+    /** The frame's turn [cos, sin]: world x = x·cos − z·sin, world z = x·sin + z·cos. */
+    turn: [number, number];
+    /** Cells per buffer row. */
+    stride: number;
+    /** The tile's first cell in the buffer. */
+    i0: number;
+    j0: number;
+    /** Room index + 1 per cell, 0 outside. */
+    cells: Uint16Array;
+    /** Every cell of the tile itself holds the same value (no edge inside). */
+    uniform: boolean;
+};
+export declare class RoomMap {
+    /** The device's largest 2D texture side; set before `build`. */
+    textureLimit: number;
+    private levels;
+    /** Level indices sorted by building, then height: the order the GPU searches in. */
+    private order;
+    private position;
+    /** Per building: its range in `order`. */
+    private buildingRange;
+    /** Per building: the turn [cos, sin] that lays its walls along the cells. */
+    private turns;
+    private originX;
+    private originZ;
+    /** The directory's corner: it stays on the world axes, whatever the buildings' turns. */
+    private dirX;
+    private dirZ;
+    private dirTiles;
+    private dirW;
+    private dirH;
+    /** Per directory cell: the buildings whose rooms reach it. */
+    private dirLists;
+    private atlas;
+    private atlasTilesW;
+    private atlasTiles;
+    private indexBytes;
+    private warnedOverflow;
+    readonly u: {
+        origin: N;
+        dirOrigin: N;
+        /** The only building's turn (with `single`). */
+        turn: N;
+        dirTiles: import("three/webgpu").UniformNode<"int", number>;
+        dirW: import("three/webgpu").UniformNode<"int", number>;
+        dirH: import("three/webgpu").UniformNode<"int", number>;
+        /** One building: its level range is the only candidate (no directory reads). */
+        single: import("three/webgpu").UniformNode<"int", number>;
+        singleCount: import("three/webgpu").UniformNode<"int", number>;
+        /** Binary-search steps for the tallest building. */
+        searchSteps: import("three/webgpu").UniformNode<"int", number>;
+        atlasTilesW: import("three/webgpu").UniformNode<"int", number>;
+        indexW: import("three/webgpu").UniformNode<"int", number>;
+        index: N;
+        levels: N;
+        atlas: N;
+    };
+    private levelData;
+    /**
+     * Rebuild from rooms. `onTile` sees every built tile (the doorway search walks room edges).
+     * `walls` keep a room from growing out through them: a wall's far side stays outside.
+     */
+    build(levels: MapLevel[], rooms: MapRoom[], onTile?: (tile: TileCells) => void, walls?: MapWalls[]): void;
+    /** CPU lookup in assembled space (same rule as the shader). */
+    roomAt(x: number, y: number, z: number): number;
+    /**
+     * A level's room at a point of its building's frame; clusters' rects can overlap (a wing around
+     * a courtyard pavilion).
+     */
+    private levelRoomAt;
+    /** The level stacked right above `level` in its building, or −1. */
+    levelAbove(level: number): number;
+    /** Index the GPU uses for `level` (rooms store it). */
+    gpuLevel(level: number): number;
+    /**
+     * Live presentation per level (input order): explode offset, whether it is shown, and whether
+     * the levels over it are hidden (its rooms open to the sky from above).
+     */
+    setPresentation(offsets: number[], shown: boolean[], focused: boolean[]): void;
+    memoryBytes(): number;
+    get stats(): {
+        atlasTiles: number;
+        dirW: number;
+        dirH: number;
+    };
+    private upload;
+    private indexTexel;
+    /** [liveY, clusterStart, clusterCount, 0] of the level at GPU position `pos`. */
+    levelTexel0(pos: N): N;
+    /** [0, 0, offset, flags] of the level at GPU position `pos`. */
+    levelTexel1(pos: N): N;
+    /** Room index (−1 outside) at a world-space position (live heights). */
+    roomAtNode: import("three/tsl").FnNode<[any], import("three/webgpu").VarNode<"int", import("three/webgpu").ConstNode<"int", number>>>;
+}
+export {};
+//# sourceMappingURL=room-map.d.ts.map

package/dist/lib/daylight/room-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-map.d.ts","sourceRoot":"","sources":["../../../src/lib/daylight/room-map.ts"],"names":[],"mappings":"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"}