isard 1.2.0 → 1.3.0

package/dist/wasm/isard_core.js

@@ -231,6 +231,22 @@ export class Engine {
         }
         return ret[0] >>> 0;
     }
+    /**
+     * An empty layer of vector tiles drawn as geometry: its style layers come with `setVectorSublayers`, its tiles
+     * with `setVectorTile`
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a shader fails to compile (the error carries its info log)
+     * @returns {number}
+     */
+    addVectorTiles() {
+        const ret = wasm.engine_addVectorTiles(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] >>> 0;
+    }
     /**
      * Longitudes and latitudes the view covers on the ground, `[west, south, east, north]` (degrees): the screen's
      * border cast on the ground, or on the far plane where it passes the horizon
@@ -449,6 +465,14 @@ export class Engine {
     removeLayer(id) {
         wasm.engine_removeLayer(this.__wbg_ptr, id);
     }
+    /**
+     * Removes tile `key` of a vector tile layer (nothing if there is none)
+     * @param {number} id
+     * @param {number} key
+     */
+    removeVectorTile(id, key) {
+        wasm.engine_removeVectorTile(this.__wbg_ptr, id, key);
+    }
     /**
      * Draws a frame: the backdrop, the ground and the layers over it bottom to top, then the panorama and the
      * viewshed; returns true while tiles are still loading (a new frame will be asked through `redraw`)
@@ -647,10 +671,10 @@ export class Engine {
         wasm.engine_setFeatureRamp(this.__wbg_ptr, id, ptr0, len0, min, max);
     }
     /**
-     * Style of the features of a line, circle, fill or extrusion layer (batch `key` of the latter): 32 floats per
-     * feature, its color (RGBA 0-1), its second color (a circle's stroke), then two sizes as zoom stops (four zooms,
-     * four values each): a line's width; a circle's radius and stroke width, CSS pixels; a block's height and base
-     * height, metres
+     * Style of the features of a line, circle, fill, extrusion or vector tile layer (batch or tile `key` of the last
+     * two): 32 floats per feature, its color (RGBA 0-1), its second color (a circle's stroke), then two sizes as zoom
+     * stops (four zooms, four values each): a line's width; a circle's radius and stroke width, CSS pixels; a block's
+     * height and base height, metres
      * @param {number} id
      * @param {Float32Array} style
      * @param {number | null} [key]
@@ -977,17 +1001,40 @@ export class Engine {
     setSky(enabled) {
         wasm.engine_setSky(this.__wbg_ptr, enabled);
     }
+    /**
+     * The sun casting shadows and the night: its azimuth (degrees clockwise from north) and altitude (degrees above
+     * the horizon), the shadows' opacity (0 to 1; none under the horizon or not a number), how dark the night is (0 to
+     * 1: the frame tinted, the lights of the layers on). Neither shadows nor night: nothing drawn
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object cannot be created or the pass fails to compile
+     * @param {number} azimuth
+     * @param {number} altitude
+     * @param {number} opacity
+     * @param {number} night
+     */
+    setSun(azimuth, altitude, opacity, night) {
+        const ret = wasm.engine_setSun(this.__wbg_ptr, azimuth, altitude, opacity, night);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Shows `layers` on one side of a vertical line only, the others beneath on the other side (comparing two states
-     * of a place): left of `x` (CSS pixels from the left of the canvas), or right of it; a non-finite `x` stops
+     * of a place): left of `x` (CSS pixels from the left of the canvas), or right of it; `others` on the other side
+     * only (two meshes of the same place, each on its side, never drawn over each other); a non-finite `x` stops
      * @param {number} x
      * @param {boolean} right
      * @param {Uint32Array} layers
+     * @param {Uint32Array} others
      */
-    setSwipe(x, right, layers) {
+    setSwipe(x, right, layers, others) {
         const ptr0 = passArray32ToWasm0(layers, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        wasm.engine_setSwipe(this.__wbg_ptr, x, right, ptr0, len0);
+        const ptr1 = passArray32ToWasm0(others, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        wasm.engine_setSwipe(this.__wbg_ptr, x, right, ptr0, len0, ptr1, len1);
     }
     /**
      * Layer-wide style of a symbol layer: size scale and opacity as zoom stops (four zooms then four values each),
@@ -1062,6 +1109,160 @@ export class Engine {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * The style layers of a vector tile layer, in drawing order: per layer, its kind (0 fill, 1 line, 2 extrusion), its zoom range
+     * (two numbers: shown from the first, included, to the second, excluded), whether it shows (0 or 1), its dashes
+     * (four numbers: dash, gap, dash, gap, in line widths; 0: solid), its opacity as zoom stops (four zooms then four
+     * values; missing: opaque), the caps of its lines' ends (0 butt, 1 round, 2 square; missing: round), whether its
+     * lines glow at night (streets; 0 or 1)
+     * @param {number} id
+     * @param {Uint8Array} kinds
+     * @param {Float64Array} zooms
+     * @param {Uint8Array} visible
+     * @param {Float32Array} dashes
+     * @param {Float32Array} opacities
+     * @param {Uint8Array} caps
+     * @param {Uint8Array} lit
+     */
+    setVectorSublayers(id, kinds, zooms, visible, dashes, opacities, caps, lit) {
+        const ptr0 = passArray8ToWasm0(kinds, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArrayF64ToWasm0(zooms, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passArray8ToWasm0(visible, wasm.__wbindgen_malloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passArrayF32ToWasm0(dashes, wasm.__wbindgen_malloc);
+        const len3 = WASM_VECTOR_LEN;
+        const ptr4 = passArrayF32ToWasm0(opacities, wasm.__wbindgen_malloc);
+        const len4 = WASM_VECTOR_LEN;
+        const ptr5 = passArray8ToWasm0(caps, wasm.__wbindgen_malloc);
+        const len5 = WASM_VECTOR_LEN;
+        const ptr6 = passArray8ToWasm0(lit, wasm.__wbindgen_malloc);
+        const len6 = WASM_VECTOR_LEN;
+        wasm.engine_setVectorSublayers(this.__wbg_ptr, id, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5, ptr6, len6);
+    }
+    /**
+     * Adds or replaces tile `key` of a vector tile layer ready for the GPU, as the basemap workers make it (the
+     * tessellation module): its polygons as for `setVectorTile` (picked here; their prisms built here if drawn in
+     * relief while `prism` is false), the vertices of its fills (`shapes::Vertex` as bytes, each with its feature),
+     * their triangles, per sublayer its top cap and the rest of its prism (`fill_ranges`: four numbers, first and
+     * end of each), its line pieces (`pieces::Piece` as bytes), the line table (feature and length of each line),
+     * per sublayer its pieces (`line_ranges`: first, end), the blocks of its extrusion sublayers (`shapes::Block` as
+     * bytes), their triangles, per sublayer its blocks' triangles (`block_ranges`: first, end), the extent of its
+     * points (`bounds`: min x, min y, max x, max y), `feature_count` features
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when the vertices, pieces or blocks are cut short, when a WebGL object of the tile cannot be
+     * created, or when its features or lines need a table texture past the GPU's `MAX_TEXTURE_SIZE`
+     * @param {number} id
+     * @param {number} key
+     * @param {Float64Array} points
+     * @param {Uint32Array} ring_start
+     * @param {Uint32Array} polygon_start
+     * @param {Uint32Array} polygon_feature
+     * @param {Uint32Array} fill_start
+     * @param {Uint8Array} vertices
+     * @param {Uint32Array} indices
+     * @param {Uint32Array} fill_ranges
+     * @param {boolean} prism
+     * @param {Uint8Array} pieces
+     * @param {Float32Array} line_table
+     * @param {Uint32Array} line_ranges
+     * @param {Uint8Array} blocks
+     * @param {Uint32Array} block_indices
+     * @param {Uint32Array} block_ranges
+     * @param {Float64Array} bounds
+     * @param {number} feature_count
+     */
+    setVectorTileMesh(id, key, points, ring_start, polygon_start, polygon_feature, fill_start, vertices, indices, fill_ranges, prism, pieces, line_table, line_ranges, blocks, block_indices, block_ranges, bounds, feature_count) {
+        const ptr0 = passArrayF64ToWasm0(points, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray32ToWasm0(ring_start, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passArray32ToWasm0(polygon_start, wasm.__wbindgen_malloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passArray32ToWasm0(polygon_feature, wasm.__wbindgen_malloc);
+        const len3 = WASM_VECTOR_LEN;
+        const ptr4 = passArray32ToWasm0(fill_start, wasm.__wbindgen_malloc);
+        const len4 = WASM_VECTOR_LEN;
+        const ptr5 = passArray8ToWasm0(vertices, wasm.__wbindgen_malloc);
+        const len5 = WASM_VECTOR_LEN;
+        const ptr6 = passArray32ToWasm0(indices, wasm.__wbindgen_malloc);
+        const len6 = WASM_VECTOR_LEN;
+        const ptr7 = passArray32ToWasm0(fill_ranges, wasm.__wbindgen_malloc);
+        const len7 = WASM_VECTOR_LEN;
+        const ptr8 = passArray8ToWasm0(pieces, wasm.__wbindgen_malloc);
+        const len8 = WASM_VECTOR_LEN;
+        const ptr9 = passArrayF32ToWasm0(line_table, wasm.__wbindgen_malloc);
+        const len9 = WASM_VECTOR_LEN;
+        const ptr10 = passArray32ToWasm0(line_ranges, wasm.__wbindgen_malloc);
+        const len10 = WASM_VECTOR_LEN;
+        const ptr11 = passArray8ToWasm0(blocks, wasm.__wbindgen_malloc);
+        const len11 = WASM_VECTOR_LEN;
+        const ptr12 = passArray32ToWasm0(block_indices, wasm.__wbindgen_malloc);
+        const len12 = WASM_VECTOR_LEN;
+        const ptr13 = passArray32ToWasm0(block_ranges, wasm.__wbindgen_malloc);
+        const len13 = WASM_VECTOR_LEN;
+        const ptr14 = passArrayF64ToWasm0(bounds, wasm.__wbindgen_malloc);
+        const len14 = WASM_VECTOR_LEN;
+        const ret = wasm.engine_setVectorTileMesh(this.__wbg_ptr, id, key, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5, ptr6, len6, ptr7, len7, prism, ptr8, len8, ptr9, len9, ptr10, len10, ptr11, len11, ptr12, len12, ptr13, len13, ptr14, len14, feature_count);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Adds or replaces tile `key` of a vector tile layer: its polygons as for `addFills` (`fill_start`: the first
+     * polygon of each sublayer, and the end; those of an extrusion sublayer raised into blocks), its lines as for
+     * `addLines` (`line_start`: the first line of each sublayer, and the end), `feature_count` features, styled as an
+     * extrusion layer's (`setFeatureStyle` with the key: a color, then a line's width or a block's height and base);
+     * `tile`: the corners of the tile they are cut to (west, north, east, south; empty: none), along whose edges no
+     * wall of a block rises
+     *
+     * # Errors
+     *
+     * Throws (to JavaScript) when a WebGL object of the tile cannot be created, or when its features or lines need a
+     * table texture past the GPU's `MAX_TEXTURE_SIZE`
+     * @param {number} id
+     * @param {number} key
+     * @param {Float64Array} points
+     * @param {Uint32Array} ring_start
+     * @param {Uint32Array} polygon_start
+     * @param {Uint32Array} polygon_feature
+     * @param {Uint32Array} fill_start
+     * @param {Float64Array} line_points
+     * @param {Uint32Array} line_first
+     * @param {Uint32Array} line_feature
+     * @param {Uint32Array} line_start
+     * @param {number} feature_count
+     * @param {Float64Array} tile
+     */
+    setVectorTile(id, key, points, ring_start, polygon_start, polygon_feature, fill_start, line_points, line_first, line_feature, line_start, feature_count, tile) {
+        const ptr0 = passArrayF64ToWasm0(points, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray32ToWasm0(ring_start, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passArray32ToWasm0(polygon_start, wasm.__wbindgen_malloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passArray32ToWasm0(polygon_feature, wasm.__wbindgen_malloc);
+        const len3 = WASM_VECTOR_LEN;
+        const ptr4 = passArray32ToWasm0(fill_start, wasm.__wbindgen_malloc);
+        const len4 = WASM_VECTOR_LEN;
+        const ptr5 = passArrayF64ToWasm0(line_points, wasm.__wbindgen_malloc);
+        const len5 = WASM_VECTOR_LEN;
+        const ptr6 = passArray32ToWasm0(line_first, wasm.__wbindgen_malloc);
+        const len6 = WASM_VECTOR_LEN;
+        const ptr7 = passArray32ToWasm0(line_feature, wasm.__wbindgen_malloc);
+        const len7 = WASM_VECTOR_LEN;
+        const ptr8 = passArray32ToWasm0(line_start, wasm.__wbindgen_malloc);
+        const len8 = WASM_VECTOR_LEN;
+        const ptr9 = passArrayF64ToWasm0(tile, wasm.__wbindgen_malloc);
+        const len9 = WASM_VECTOR_LEN;
+        const ret = wasm.engine_setVectorTile(this.__wbg_ptr, id, key, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4, ptr5, len5, ptr6, len6, ptr7, len7, ptr8, len8, feature_count, ptr9, len9);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Shows what can be seen from points, each within its range: `observers` holds 8 numbers per observer
      * (16 at most): longitude, latitude (degrees), metres above the ground, range (metres), then to look one way
@@ -1199,6 +1400,20 @@ export class Engine {
         const len0 = WASM_VECTOR_LEN;
         wasm.engine_updateIconAtlas(this.__wbg_ptr, x, y, width, height, ptr0, len0);
     }
+    /**
+     * Vector tiles (512 CSS pixels across at their level, as `MapLibre`'s) for the view of the last frame (else the
+     * camera's), levels `min_z` to `max_z`, three numbers per tile (z, x, y), the nearest to the eye first: what a
+     * vector tile layer draws (`addVectorTiles`), coarser far away in a tilted view as the raster layers
+     * @param {number} min_z
+     * @param {number} max_z
+     * @returns {Uint32Array}
+     */
+    vectorTilesInView(min_z, max_z) {
+        const ret = wasm.engine_vectorTilesInView(this.__wbg_ptr, min_z, max_z);
+        var v1 = getArrayU32FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
     /**
      * Tiles a raster layer wants for the view of the last frame, three numbers per tile (z, x, y), the nearest to
      * the eye first: the level each area of the ground is drawn at, for the labels of a vector style to follow it
@@ -1880,6 +2095,12 @@ function __wbg_get_imports() {
         __wbg_pixelStorei_cb4e43466f5b8703: function(arg0, arg1, arg2) {
             arg0.pixelStorei(arg1 >>> 0, arg2);
         },
+        __wbg_polygonOffset_81dc8ca84e29572b: function(arg0, arg1, arg2) {
+            arg0.polygonOffset(arg1, arg2);
+        },
+        __wbg_polygonOffset_8f922d9173d8849d: function(arg0, arg1, arg2) {
+            arg0.polygonOffset(arg1, arg2);
+        },
         __wbg_prototypesetcall_8b03c01e2c0f8066: function(arg0, arg1, arg2) {
             Float32Array.prototype.set.call(getArrayF32FromWasm0(arg0, arg1), arg2);
         },
@@ -2218,7 +2439,7 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_generic_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 92, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 106, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen_2e566c63402fe7fa___convert__closures_____invoke___wasm_bindgen_2e566c63402fe7fa___JsValue__core_37ee0ce0c4cd57d5___result__Result_____wasm_bindgen_2e566c63402fe7fa___JsError___true_);
             return ret;
         },

package/dist/wasm/isard_tess.d.ts

@@ -0,0 +1,109 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * A vector tile ready for the GPU (`geo::mesh::vector_tiles::TileMesh`), as the engine's `setVectorTileMesh` takes it
+ */
+export class TessellatedTile {
+    private constructor();
+    free(): void;
+    /**
+     * Their triangles
+     */
+    blockIndices(): Uint32Array;
+    /**
+     * Per sublayer: its blocks' indices, first and end
+     */
+    blockRanges(): Uint32Array;
+    /**
+     * The blocks of the raised sublayers (`shapes::Block`, 32 bytes each), as bytes
+     */
+    blocks(): Uint8Array;
+    /**
+     * The extent of the tile's points: min x, min y, max x, max y
+     */
+    bounds(): Float64Array;
+    /**
+     * Per sublayer: its top cap and the rest of its prism, first and end of each (four numbers)
+     */
+    fillRanges(): Uint32Array;
+    /**
+     * The fill triangles
+     */
+    indices(): Uint32Array;
+    /**
+     * Per sublayer: its pieces, first and end
+     */
+    lineRanges(): Uint32Array;
+    /**
+     * Feature and length of each line
+     */
+    lineTable(): Float32Array;
+    /**
+     * The line pieces (`pieces::Piece`, 28 bytes each), as bytes
+     */
+    pieces(): Uint8Array;
+    /**
+     * Whether the prisms were built
+     */
+    prism(): boolean;
+    /**
+     * The fill vertices (`shapes::Vertex`, 24 bytes each), as bytes
+     */
+    vertices(): Uint8Array;
+}
+
+/**
+ * The geometry of a vector tile made ready for the GPU, as the engine's `setVectorTile` takes it: its polygons
+ * (interleaved points, `ring_start`, `polygon_start`, the feature of each, `fill_start`: the first polygon of each
+ * sublayer and the end), its lines (interleaved points, `line_first`: the first point of each, the feature of each,
+ * `line_start`: the first line of each sublayer and the end); `raised`: per sublayer, whether its polygons are extruded
+ * into blocks rather than filled; `prism`: with the prisms the fills need over the relief; `tile`: the corners of the
+ * tile they are cut to (west, north, east, south, Mercator; empty: none), along whose edges no wall of a block rises
+ */
+export function tessellateVectorTile(points: Float64Array, ring_start: Uint32Array, polygon_start: Uint32Array, polygon_feature: Uint32Array, fill_start: Uint32Array, line_points: Float64Array, line_first: Uint32Array, line_feature: Uint32Array, line_start: Uint32Array, raised: Uint8Array, prism: boolean, tile: Float64Array): TessellatedTile;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_tessellatedtile_free: (a: number, b: number) => void;
+    readonly tessellateVectorTile: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number) => number;
+    readonly tessellatedtile_blockIndices: (a: number) => any;
+    readonly tessellatedtile_blockRanges: (a: number) => [number, number];
+    readonly tessellatedtile_blocks: (a: number) => any;
+    readonly tessellatedtile_bounds: (a: number) => [number, number];
+    readonly tessellatedtile_fillRanges: (a: number) => [number, number];
+    readonly tessellatedtile_indices: (a: number) => any;
+    readonly tessellatedtile_lineRanges: (a: number) => [number, number];
+    readonly tessellatedtile_lineTable: (a: number) => any;
+    readonly tessellatedtile_pieces: (a: number) => any;
+    readonly tessellatedtile_prism: (a: number) => number;
+    readonly tessellatedtile_vertices: (a: number) => any;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;