@navaramap/engine-api 0.0.6 → 0.0.7

package/navara_wasm_api.d.ts

@@ -459,6 +459,10 @@ export class ConstructedPolygonOutlineGeometry {
     batch_index(): Float32Array | undefined;
     batch_index_size(): number | undefined;
     position(): Float32Array;
+    position_3d_high(): Float32Array | undefined;
+    position_3d_high_size(): number | undefined;
+    position_3d_low(): Float32Array | undefined;
+    position_3d_low_size(): number | undefined;
     position_size(): number;
     scale_normal_and_cap(): Float32Array;
     scale_normal_and_cap_size(): number;
@@ -542,6 +546,13 @@ export class EllipsoidGeodesic {
     interpolateDistance(distance: number): LLE;
     interpolateGeodeticPoints(granularity?: number | null): LLE[];
     constructor(start: LLE, end: LLE);
+    /**
+     * Whether Vincenty's inverse iteration converged. `false` for
+     * near-antipodal endpoints, where `distance` is only a rough estimate
+     * and interpolation snaps to the endpoints instead of following the
+     * (unreliable) capped solution.
+     */
+    converged: boolean;
     distance: number;
     end_heading: number;
     end: LLE;
@@ -2020,10 +2031,39 @@ export function parseCssUnicodeRange(value: string): any;
 
 export function parseFontFamilyFromCss(family: string, css_text: string, options: any): any;
 
+/**
+ * Heights of a quantized-mesh tile at each `[lng, lat]` pair (radians),
+ * interpolated across the decoded mesh's own triangles. Returns `undefined`
+ * when the bytes don't decode as quantized-mesh. Positions are expected to
+ * lie inside tile (x, y, z); ones outside read the nearest mesh vertex.
+ */
+export function sampleQuantizedMeshHeights(bytes: Uint8Array, geographic: boolean, x: number, y: number, z: number, positions: Float64Array): Float64Array | undefined;
+
+/**
+ * Heights of a raster-DEM tile (WebMercator, square RGBA image) at each
+ * `[lng, lat]` pair (radians), bilinear over the decoded grid. `decoder` is
+ * a plain `ElevationDecoder`-shaped object. Returns `undefined` when the
+ * decoder doesn't deserialize or the image is empty.
+ */
+export function sampleRasterDemHeights(rgba: Uint8Array, decoder: any, x: number, y: number, z: number, positions: Float64Array): Float64Array | undefined;
+
 export function screenToWorld(window: Window, transform: Transform, frustum: CameraFrustum, screen_pos: Vec2): Vec3 | undefined;
 
 export function start(): void;
 
+/**
+ * Tile (x, y) containing each `[lng, lat]` pair at `level`, flattened as
+ * `[x0, y0, x1, y1, ...]`. Internal XYZ-style y (north-origin) — the TMS
+ * flip happens in URL building, not here.
+ */
+export function terrainPositionsToTiles(geographic: boolean, level: number, positions: Float64Array): Uint32Array;
+
+/**
+ * Tile URL from the engine's own template expansion, including the TMS
+ * y-flip — sampling must fetch exactly the URLs rendering would.
+ */
+export function terrainTileUrl(template: string, geographic: boolean, tms: boolean, x: number, y: number, z: number): string;
+
 export function worldToScreen(window: Window, transform: Transform, frustum: CameraFrustum, world_pos: Vec3): Vec2 | undefined;
 
 export function xyzToGeodetic(vec3: Vec3): LLE;
@@ -2053,8 +2093,12 @@ export interface InitOutput {
     readonly northWestUpToFixedFrame: (a: number) => [number, number];
     readonly parseCssUnicodeRange: (a: number, b: number) => [number, number, number];
     readonly parseFontFamilyFromCss: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
+    readonly sampleQuantizedMeshHeights: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
+    readonly sampleRasterDemHeights: (a: number, b: number, c: any, d: number, e: number, f: number, g: number, h: number) => [number, number];
     readonly screenToWorld: (a: number, b: number, c: number, d: number) => number;
     readonly start: () => void;
+    readonly terrainPositionsToTiles: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly terrainTileUrl: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
     readonly worldToScreen: (a: number, b: number, c: number, d: number) => number;
     readonly xyzToGeodetic: (a: number) => number;
     readonly __wbg_aabb_free: (a: number, b: number) => void;
@@ -2124,11 +2168,10 @@ export interface InitOutput {
     readonly __wbg_get_elevationdecoder_max_offset: (a: number) => number;
     readonly __wbg_get_elevationdecoder_min_offset: (a: number) => number;
     readonly __wbg_get_elevationheatmapmaterial_logarithmic: (a: number) => number;
-    readonly __wbg_get_ellipsoidgeodesic_distance: (a: number) => number;
+    readonly __wbg_get_ellipsoidgeodesic_converged: (a: number) => number;
     readonly __wbg_get_ellipsoidgeodesic_end: (a: number) => number;
     readonly __wbg_get_ellipsoidgeodesic_end_heading: (a: number) => number;
     readonly __wbg_get_ellipsoidgeodesic_start: (a: number) => number;
-    readonly __wbg_get_ellipsoidgeodesic_start_heading: (a: number) => number;
     readonly __wbg_get_extentradianf32_east: (a: number) => number;
     readonly __wbg_get_extentradianf32_north: (a: number) => number;
     readonly __wbg_get_extentradianf32_south: (a: number) => number;
@@ -2146,7 +2189,6 @@ export interface InitOutput {
     readonly __wbg_get_hillshadematerial_exaggeration: (a: number) => number;
     readonly __wbg_get_modelinternalmaterial_dracoCompressed: (a: number) => number;
     readonly __wbg_get_modelinternalmaterial_pointCloud: (a: number) => number;
-    readonly __wbg_get_modelinternalmaterial_pointCloudGeodeticNormal: (a: number) => number;
     readonly __wbg_get_modelmaterial___internal__: (a: number) => number;
     readonly __wbg_get_modelmaterial_animationActiveClip: (a: number) => [number, number];
     readonly __wbg_get_modelmaterial_animationSpeed: (a: number) => number;
@@ -2234,7 +2276,6 @@ export interface InitOutput {
     readonly __wbg_get_rastermaterial_showBoundingBox: (a: number) => number;
     readonly __wbg_get_rastertileinternalmaterial_castShadow: (a: number) => number;
     readonly __wbg_get_rastertileinternalmaterial_colors: (a: number) => [number, number];
-    readonly __wbg_get_rastertileinternalmaterial_elevationEpsilon: (a: number) => number;
     readonly __wbg_get_rastertileinternalmaterial_elevationOffset: (a: number) => number;
     readonly __wbg_get_rastertileinternalmaterial_hillshadeBScaler: (a: number) => number;
     readonly __wbg_get_rastertileinternalmaterial_hillshadeBoundary: (a: number) => number;
@@ -2354,11 +2395,8 @@ export interface InitOutput {
     readonly __wbg_set_elevationdecoder_max_offset: (a: number, b: number) => void;
     readonly __wbg_set_elevationdecoder_min_offset: (a: number, b: number) => void;
     readonly __wbg_set_elevationheatmapmaterial_logarithmic: (a: number, b: number) => void;
-    readonly __wbg_set_ellipsoidgeodesic_distance: (a: number, b: number) => void;
-    readonly __wbg_set_ellipsoidgeodesic_end: (a: number, b: number) => void;
+    readonly __wbg_set_ellipsoidgeodesic_converged: (a: number, b: number) => void;
     readonly __wbg_set_ellipsoidgeodesic_end_heading: (a: number, b: number) => void;
-    readonly __wbg_set_ellipsoidgeodesic_start: (a: number, b: number) => void;
-    readonly __wbg_set_ellipsoidgeodesic_start_heading: (a: number, b: number) => void;
     readonly __wbg_set_extentradianf32_east: (a: number, b: number) => void;
     readonly __wbg_set_extentradianf32_north: (a: number, b: number) => void;
     readonly __wbg_set_extentradianf32_south: (a: number, b: number) => void;
@@ -2463,7 +2501,6 @@ export interface InitOutput {
     readonly __wbg_set_rastermaterial_showBoundingBox: (a: number, b: number) => void;
     readonly __wbg_set_rastertileinternalmaterial_castShadow: (a: number, b: number) => void;
     readonly __wbg_set_rastertileinternalmaterial_colors: (a: number, b: number, c: number) => void;
-    readonly __wbg_set_rastertileinternalmaterial_elevationEpsilon: (a: number, b: number) => void;
     readonly __wbg_set_rastertileinternalmaterial_elevationOffset: (a: number, b: number) => void;
     readonly __wbg_set_rastertileinternalmaterial_hillshadeBScaler: (a: number, b: number) => void;
     readonly __wbg_set_rastertileinternalmaterial_hillshadeBoundary: (a: number, b: number) => void;
@@ -2557,6 +2594,10 @@ export interface InitOutput {
     readonly constructedpolygonoutlinegeometry_batch_index: (a: number) => any;
     readonly constructedpolygonoutlinegeometry_batch_index_size: (a: number) => number;
     readonly constructedpolygonoutlinegeometry_position: (a: number) => any;
+    readonly constructedpolygonoutlinegeometry_position_3d_high: (a: number) => any;
+    readonly constructedpolygonoutlinegeometry_position_3d_high_size: (a: number) => number;
+    readonly constructedpolygonoutlinegeometry_position_3d_low: (a: number) => any;
+    readonly constructedpolygonoutlinegeometry_position_3d_low_size: (a: number) => number;
     readonly constructedpolygonoutlinegeometry_position_size: (a: number) => number;
     readonly constructedpolygonoutlinegeometry_scale_normal_and_cap: (a: number) => any;
     readonly constructedpolygonoutlinegeometry_scale_normal_and_cap_size: (a: number) => number;
@@ -2801,6 +2842,9 @@ export interface InitOutput {
     readonly __wbg_get_textmaterial_outlineColor: (a: number) => number;
     readonly __wbg_get_textmaterial_color: (a: number) => number;
     readonly __wbg_get_pointmaterial_color: (a: number) => number;
+    readonly __wbg_get_rastertileinternalmaterial_elevationMinOffset: (a: number) => number;
+    readonly __wbg_get_rastertileinternalmaterial_elevationEpsilon: (a: number) => number;
+    readonly __wbg_get_rastertileinternalmaterial_elevationMaxOffset: (a: number) => number;
     readonly __wbg_get_tilexyz_x: (a: number) => number;
     readonly __wbg_get_vec2_y: (a: number) => number;
     readonly __wbg_get_vec3_z: (a: number) => number;
@@ -2835,8 +2879,8 @@ export interface InitOutput {
     readonly __wbg_get_rastertileinternalmaterial_elevationBoundary: (a: number) => number;
     readonly __wbg_get_rastertileinternalmaterial_elevationBScaler: (a: number) => number;
     readonly __wbg_get_elevationdecoder_g_scaler: (a: number) => number;
-    readonly __wbg_get_rastertileinternalmaterial_elevationMinOffset: (a: number) => number;
-    readonly __wbg_get_rastertileinternalmaterial_elevationMaxOffset: (a: number) => number;
+    readonly __wbg_get_ellipsoidgeodesic_start_heading: (a: number) => number;
+    readonly __wbg_get_ellipsoidgeodesic_distance: (a: number) => number;
     readonly __wbg_get_elevationdecoder_b_scaler: (a: number) => number;
     readonly __wbg_get_returnedconstructedterrainmesh_min_height: (a: number) => number;
     readonly __wbg_get_returnedconstructedterrainmesh_max_height: (a: number) => number;
@@ -2850,6 +2894,9 @@ export interface InitOutput {
     readonly __wbg_set_pointmaterial_center: (a: number, b: number) => void;
     readonly __wbg_set_terrainmaterial_skirtExaggeration: (a: number, b: number) => void;
     readonly __wbg_set_polylineinternalmaterial_minMaxHeights: (a: number, b: number, c: number) => void;
+    readonly __wbg_set_rastertileinternalmaterial_elevationMinOffset: (a: number, b: number) => void;
+    readonly __wbg_set_rastertileinternalmaterial_elevationEpsilon: (a: number, b: number) => void;
+    readonly __wbg_set_rastertileinternalmaterial_elevationMaxOffset: (a: number, b: number) => void;
     readonly __wbg_set_ray_origin: (a: number, b: number) => void;
     readonly __wbg_set_ray_direction: (a: number, b: number) => void;
     readonly __wbg_set_modelinternalmaterial_pointCloudGeodeticNormal: (a: number, b: number) => void;
@@ -2891,8 +2938,8 @@ export interface InitOutput {
     readonly __wbg_set_rastertileinternalmaterial_elevationBoundary: (a: number, b: number) => void;
     readonly __wbg_set_rastertileinternalmaterial_elevationBScaler: (a: number, b: number) => void;
     readonly __wbg_set_elevationdecoder_g_scaler: (a: number, b: number) => void;
-    readonly __wbg_set_rastertileinternalmaterial_elevationMinOffset: (a: number, b: number) => void;
-    readonly __wbg_set_rastertileinternalmaterial_elevationMaxOffset: (a: number, b: number) => void;
+    readonly __wbg_set_ellipsoidgeodesic_start_heading: (a: number, b: number) => void;
+    readonly __wbg_set_ellipsoidgeodesic_distance: (a: number, b: number) => void;
     readonly __wbg_set_elevationdecoder_b_scaler: (a: number, b: number) => void;
     readonly __wbg_set_returnedconstructedterrainmesh_min_height: (a: number, b: number) => void;
     readonly __wbg_set_returnedconstructedterrainmesh_max_height: (a: number, b: number) => void;
@@ -2931,6 +2978,7 @@ export interface InitOutput {
     readonly __wbg_get_pointmaterial_center: (a: number) => number;
     readonly __wbg_get_modelmaterial_waterScaleNormal: (a: number) => number;
     readonly __wbg_get_polylineinternalmaterial_minMaxHeights: (a: number) => [number, number];
+    readonly __wbg_get_modelinternalmaterial_pointCloudGeodeticNormal: (a: number) => number;
     readonly __wbg_get_ray_origin: (a: number) => number;
     readonly __wbg_get_tilexyz_y: (a: number) => number;
     readonly __wbg_get_vec2_x: (a: number) => number;
@@ -2961,6 +3009,8 @@ export interface InitOutput {
     readonly __wbg_modelinternalmaterial_free: (a: number, b: number) => void;
     readonly __wbg_polylineinternalmaterial_free: (a: number, b: number) => void;
     readonly __wbg_vec3_free: (a: number, b: number) => void;
+    readonly __wbg_set_ellipsoidgeodesic_end: (a: number, b: number) => void;
+    readonly __wbg_set_ellipsoidgeodesic_start: (a: number, b: number) => void;
     readonly __wbg_compiledfilter_free: (a: number, b: number) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/navara_wasm_api.js

@@ -1356,6 +1356,34 @@ export class ConstructedPolygonOutlineGeometry {
         const ret = wasm.constructedpolygonoutlinegeometry_position(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * @returns {Float32Array | undefined}
+     */
+    position_3d_high() {
+        const ret = wasm.constructedpolygonoutlinegeometry_position_3d_high(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @returns {number | undefined}
+     */
+    position_3d_high_size() {
+        const ret = wasm.constructedpolygonoutlinegeometry_position_3d_high_size(this.__wbg_ptr);
+        return ret === 0xFFFFFF ? undefined : ret;
+    }
+    /**
+     * @returns {Float32Array | undefined}
+     */
+    position_3d_low() {
+        const ret = wasm.constructedpolygonoutlinegeometry_position_3d_low(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * @returns {number | undefined}
+     */
+    position_3d_low_size() {
+        const ret = wasm.constructedpolygonoutlinegeometry_position_3d_low_size(this.__wbg_ptr);
+        return ret === 0xFFFFFF ? undefined : ret;
+    }
     /**
      * @returns {number}
      */
@@ -1885,6 +1913,17 @@ export class EllipsoidGeodesic {
         EllipsoidGeodesicFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
+    /**
+     * Whether Vincenty's inverse iteration converged. `false` for
+     * near-antipodal endpoints, where `distance` is only a rough estimate
+     * and interpolation snaps to the endpoints instead of following the
+     * (unreliable) capped solution.
+     * @returns {boolean}
+     */
+    get converged() {
+        const ret = wasm.__wbg_get_ellipsoidgeodesic_converged(this.__wbg_ptr);
+        return ret !== 0;
+    }
     /**
      * @returns {number}
      */
@@ -1920,6 +1959,16 @@ export class EllipsoidGeodesic {
         const ret = wasm.__wbg_get_ellipsoidgeodesic_start(this.__wbg_ptr);
         return LLE.__wrap(ret);
     }
+    /**
+     * Whether Vincenty's inverse iteration converged. `false` for
+     * near-antipodal endpoints, where `distance` is only a rough estimate
+     * and interpolation snaps to the endpoints instead of following the
+     * (unreliable) capped solution.
+     * @param {boolean} arg0
+     */
+    set converged(arg0) {
+        wasm.__wbg_set_ellipsoidgeodesic_converged(this.__wbg_ptr, arg0);
+    }
     /**
      * @param {number} arg0
      */
@@ -7765,6 +7814,60 @@ export function parseFontFamilyFromCss(family, css_text, options) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * Heights of a quantized-mesh tile at each `[lng, lat]` pair (radians),
+ * interpolated across the decoded mesh's own triangles. Returns `undefined`
+ * when the bytes don't decode as quantized-mesh. Positions are expected to
+ * lie inside tile (x, y, z); ones outside read the nearest mesh vertex.
+ * @param {Uint8Array} bytes
+ * @param {boolean} geographic
+ * @param {number} x
+ * @param {number} y
+ * @param {number} z
+ * @param {Float64Array} positions
+ * @returns {Float64Array | undefined}
+ */
+export function sampleQuantizedMeshHeights(bytes, geographic, x, y, z, positions) {
+    const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passArrayF64ToWasm0(positions, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.sampleQuantizedMeshHeights(ptr0, len0, geographic, x, y, z, ptr1, len1);
+    let v3;
+    if (ret[0] !== 0) {
+        v3 = getArrayF64FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    }
+    return v3;
+}
+
+/**
+ * Heights of a raster-DEM tile (WebMercator, square RGBA image) at each
+ * `[lng, lat]` pair (radians), bilinear over the decoded grid. `decoder` is
+ * a plain `ElevationDecoder`-shaped object. Returns `undefined` when the
+ * decoder doesn't deserialize or the image is empty.
+ * @param {Uint8Array} rgba
+ * @param {any} decoder
+ * @param {number} x
+ * @param {number} y
+ * @param {number} z
+ * @param {Float64Array} positions
+ * @returns {Float64Array | undefined}
+ */
+export function sampleRasterDemHeights(rgba, decoder, x, y, z, positions) {
+    const ptr0 = passArray8ToWasm0(rgba, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passArrayF64ToWasm0(positions, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.sampleRasterDemHeights(ptr0, len0, decoder, x, y, z, ptr1, len1);
+    let v3;
+    if (ret[0] !== 0) {
+        v3 = getArrayF64FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
+    }
+    return v3;
+}
+
 /**
  * @param {Window} window
  * @param {Transform} transform
@@ -7789,6 +7892,50 @@ export function start() {
     wasm.start();
 }
 
+/**
+ * Tile (x, y) containing each `[lng, lat]` pair at `level`, flattened as
+ * `[x0, y0, x1, y1, ...]`. Internal XYZ-style y (north-origin) — the TMS
+ * flip happens in URL building, not here.
+ * @param {boolean} geographic
+ * @param {number} level
+ * @param {Float64Array} positions
+ * @returns {Uint32Array}
+ */
+export function terrainPositionsToTiles(geographic, level, positions) {
+    const ptr0 = passArrayF64ToWasm0(positions, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.terrainPositionsToTiles(geographic, level, ptr0, len0);
+    var v2 = getArrayU32FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v2;
+}
+
+/**
+ * Tile URL from the engine's own template expansion, including the TMS
+ * y-flip — sampling must fetch exactly the URLs rendering would.
+ * @param {string} template
+ * @param {boolean} geographic
+ * @param {boolean} tms
+ * @param {number} x
+ * @param {number} y
+ * @param {number} z
+ * @returns {string}
+ */
+export function terrainTileUrl(template, geographic, tms, x, y, z) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const ptr0 = passStringToWasm0(template, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.terrainTileUrl(ptr0, len0, geographic, tms, x, y, z);
+        deferred2_0 = ret[0];
+        deferred2_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+    }
+}
+
 /**
  * @param {Window} window
  * @param {Transform} transform

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@navaramap/engine-api",
   "type": "module",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "license": "MIT OR Apache-2.0",
   "repository": {
     "type": "git",