autumnplot-gl 2.2.3 → 3.1.0

package/lib/RawField.js

@@ -1,313 +1,6 @@
 import { Float16Array } from "@petamoriken/float16";
-import { lambertConformalConic, rotateSphere } from "./Map";
-import { layer_worker } from "./PlotComponent";
+import { contourCreator } from "./ContourCreator";
 import { Cache, zip } from "./utils";
-import { WGLBuffer } from "autumn-wgl";
-async function makeWGLDomainBuffers(gl, grid, native_grid) {
-    native_grid = native_grid !== undefined ? native_grid : grid;
-    const texcoord_margin_r = 1 / (2 * native_grid.ni);
-    const texcoord_margin_s = 1 / (2 * native_grid.nj);
-    const grid_cell_size_multiplier = (grid.ni * grid.nj) / (native_grid.ni * native_grid.nj);
-    const { lats: field_lats, lons: field_lons } = grid.getEarthCoords();
-    const domain_coords = await layer_worker.makeDomainVerticesAndTexCoords(field_lats, field_lons, grid.ni, grid.nj, texcoord_margin_r, texcoord_margin_s);
-    for (let icd = 0; icd < domain_coords['grid_cell_size'].length; icd++) {
-        domain_coords['grid_cell_size'][icd] *= grid_cell_size_multiplier;
-    }
-    const vertices = new WGLBuffer(gl, domain_coords['vertices'], 2, gl.TRIANGLE_STRIP);
-    const texcoords = new WGLBuffer(gl, domain_coords['tex_coords'], 2, gl.TRIANGLE_STRIP);
-    const grid_cell_size = new WGLBuffer(gl, domain_coords['grid_cell_size'], 1, gl.TRIANGLE_STRIP);
-    return { 'vertices': vertices, 'texcoords': texcoords, 'cellsize': grid_cell_size };
-}
-async function makeWGLBillboardBuffers(gl, grid, thin_fac, max_zoom) {
-    const { lats: field_lats, lons: field_lons } = grid.getEarthCoords();
-    const bb_elements = await layer_worker.makeBBElements(field_lats, field_lons, grid.ni, grid.nj, thin_fac, max_zoom);
-    const vertices = new WGLBuffer(gl, bb_elements['pts'], 3, gl.TRIANGLE_STRIP);
-    const texcoords = new WGLBuffer(gl, bb_elements['tex_coords'], 2, gl.TRIANGLE_STRIP);
-    return { 'vertices': vertices, 'texcoords': texcoords };
-}
-class Grid {
-    constructor(type, is_conformal, ni, nj) {
-        this.type = type;
-        this.is_conformal = is_conformal;
-        this.ni = ni;
-        this.nj = nj;
-        this.buffer_cache = new Cache((gl) => {
-            const new_ni = Math.max(Math.floor(this.ni / 50), 20);
-            const new_nj = Math.max(Math.floor(this.nj / 50), 20);
-            return makeWGLDomainBuffers(gl, this.copy({ ni: new_ni, nj: new_nj }), this);
-        });
-        this.billboard_buffer_cache = new Cache((gl, thin_fac, max_zoom) => {
-            return makeWGLBillboardBuffers(gl, this, thin_fac, max_zoom);
-        });
-    }
-    async getWGLBuffers(gl) {
-        return await this.buffer_cache.getValue(gl);
-    }
-    async getWGLBillboardBuffers(gl, thin_fac, max_zoom) {
-        return await this.billboard_buffer_cache.getValue(gl, thin_fac, max_zoom);
-    }
-}
-/** A plate carree (a.k.a. lat/lon) grid with uniform grid spacing */
-class PlateCarreeGrid extends Grid {
-    /**
-     * Create a plate carree grid
-     * @param ni     - The number of grid points in the i (longitude) direction
-     * @param nj     - The number of grid points in the j (latitude) direction
-     * @param ll_lon - The longitude of the lower left corner of the grid
-     * @param ll_lat - The latitude of the lower left corner of the grid
-     * @param ur_lon - The longitude of the upper right corner of the grid
-     * @param ur_lat - The latitude of the upper right corner of the grid
-     */
-    constructor(ni, nj, ll_lon, ll_lat, ur_lon, ur_lat) {
-        super('latlon', true, ni, nj);
-        this.ll_lon = ll_lon;
-        this.ll_lat = ll_lat;
-        this.ur_lon = ur_lon;
-        this.ur_lat = ur_lat;
-        const dlon = (this.ur_lon - this.ll_lon) / (this.ni - 1);
-        const dlat = (this.ur_lat - this.ll_lat) / (this.nj - 1);
-        this.ll_cache = new Cache(() => {
-            const lons = new Float32Array(this.ni * this.nj);
-            const lats = new Float32Array(this.ni * this.nj);
-            for (let i = 0; i < this.ni; i++) {
-                for (let j = 0; j < this.nj; j++) {
-                    const idx = i + j * this.ni;
-                    lons[idx] = this.ll_lon + i * dlon;
-                    lats[idx] = this.ll_lat + j * dlat;
-                }
-            }
-            return { 'lons': lons, 'lats': lats };
-        });
-        this.gc_cache = new Cache(() => {
-            const x = new Float32Array(this.ni);
-            const y = new Float32Array(this.nj);
-            for (let i = 0; i < this.ni; i++) {
-                x[i] = this.ll_lon + i * dlon;
-            }
-            for (let j = 0; j < this.nj; j++) {
-                y[j] = this.ll_lat + j * dlat;
-            }
-            return { x: x, y: y };
-        });
-    }
-    copy(opts) {
-        opts = opts !== undefined ? opts : {};
-        const ni = opts.ni !== undefined ? opts.ni : this.ni;
-        const nj = opts.nj !== undefined ? opts.nj : this.nj;
-        const ll_lon = opts.ll_lon !== undefined ? opts.ll_lon : this.ll_lon;
-        const ll_lat = opts.ll_lat !== undefined ? opts.ll_lat : this.ll_lat;
-        const ur_lon = opts.ur_lon !== undefined ? opts.ur_lon : this.ur_lon;
-        const ur_lat = opts.ur_lat !== undefined ? opts.ur_lat : this.ur_lat;
-        return new PlateCarreeGrid(ni, nj, ll_lon, ll_lat, ur_lon, ur_lat);
-    }
-    /**
-     * Get a list of longitudes and latitudes on the grid (internal method)
-     */
-    getEarthCoords() {
-        return this.ll_cache.getValue();
-    }
-    getGridCoords() {
-        return this.gc_cache.getValue();
-    }
-    transform(x, y, opts) {
-        return [x, y];
-    }
-    getThinnedGrid(thin_x, thin_y) {
-        const dlon = (this.ur_lon - this.ll_lon) / this.ni;
-        const dlat = (this.ur_lat - this.ll_lat) / this.nj;
-        const ni = Math.ceil(this.ni / thin_x);
-        const nj = Math.ceil(this.nj / thin_y);
-        const ni_remove = (this.ni - 1) % thin_x;
-        const nj_remove = (this.nj - 1) % thin_y;
-        const ll_lon = this.ll_lon;
-        const ll_lat = this.ll_lat;
-        const ur_lon = this.ur_lon - ni_remove * dlon;
-        const ur_lat = this.ur_lat - nj_remove * dlat;
-        return new PlateCarreeGrid(ni, nj, ll_lon, ll_lat, ur_lon, ur_lat);
-    }
-}
-/** A rotated lat-lon (plate carree) grid with uniform grid spacing */
-class PlateCarreeRotatedGrid extends Grid {
-    /**
-     * Create a Lambert conformal conic grid
-     * @param ni        - The number of grid points in the i (longitude) direction
-     * @param nj        - The number of grid points in the j (latitude) direction
-     * @param np_lon    - The longitude of the north pole for the rotated grid
-     * @param np_lat    - The latitude of the north pole for the rotated grid
-     * @param lon_shift - The angle around the rotated north pole to shift the central meridian
-     * @param ll_lon    - The longitude of the lower left corner of the grid (on the rotated earth)
-     * @param ll_lat    - The latitude of the lower left corner of the grid (on the rotated earth)
-     * @param ur_lon    - The longitude of the upper right corner of the grid (on the rotated earth)
-     * @param ur_lat    - The latitude of the upper right corner of the grid (on the rotated earth)
-     */
-    constructor(ni, nj, np_lon, np_lat, lon_shift, ll_lon, ll_lat, ur_lon, ur_lat) {
-        super('latlonrot', true, ni, nj);
-        this.np_lon = np_lon;
-        this.np_lat = np_lat;
-        this.lon_shift = lon_shift;
-        this.ll_lon = ll_lon;
-        this.ll_lat = ll_lat;
-        this.ur_lon = ur_lon;
-        this.ur_lat = ur_lat;
-        this.llrot = rotateSphere({ np_lon: np_lon, np_lat: np_lat, lon_shift: lon_shift });
-        const dlon = (this.ur_lon - this.ll_lon) / (this.ni - 1);
-        const dlat = (this.ur_lat - this.ll_lat) / (this.nj - 1);
-        this.ll_cache = new Cache(() => {
-            const lons = new Float32Array(this.ni * this.nj);
-            const lats = new Float32Array(this.ni * this.nj);
-            for (let i = 0; i < this.ni; i++) {
-                const lon_p = this.ll_lon + i * dlon;
-                for (let j = 0; j < this.nj; j++) {
-                    const lat_p = this.ll_lat + j * dlat;
-                    const [lon, lat] = this.llrot(lon_p, lat_p);
-                    const idx = i + j * this.ni;
-                    lons[idx] = lon;
-                    lats[idx] = lat;
-                }
-            }
-            return { lons: lons, lats: lats };
-        });
-        this.gc_cache = new Cache(() => {
-            const x = new Float32Array(this.ni);
-            const y = new Float32Array(this.nj);
-            for (let i = 0; i < this.ni; i++) {
-                x[i] = this.ll_lon + i * dlon;
-            }
-            for (let j = 0; j < this.nj; j++) {
-                y[j] = this.ll_lat + j * dlat;
-            }
-            return { x: x, y: y };
-        });
-    }
-    copy(opts) {
-        opts = opts !== undefined ? opts : {};
-        const ni = opts.ni !== undefined ? opts.ni : this.ni;
-        const nj = opts.nj !== undefined ? opts.nj : this.nj;
-        const ll_lon = opts.ll_lon !== undefined ? opts.ll_lon : this.ll_lon;
-        const ll_lat = opts.ll_lat !== undefined ? opts.ll_lat : this.ll_lat;
-        const ur_lon = opts.ur_lon !== undefined ? opts.ur_lon : this.ur_lon;
-        const ur_lat = opts.ur_lat !== undefined ? opts.ur_lat : this.ur_lat;
-        return new PlateCarreeRotatedGrid(ni, nj, this.np_lon, this.np_lat, this.lon_shift, ll_lon, ll_lat, ur_lon, ur_lat);
-    }
-    /**
-     * Get a list of longitudes and latitudes on the grid (internal method)
-     */
-    getEarthCoords() {
-        return this.ll_cache.getValue();
-    }
-    getGridCoords() {
-        return this.gc_cache.getValue();
-    }
-    transform(x, y, opts) {
-        opts = opts === undefined ? {} : opts;
-        const inverse = 'inverse' in opts ? opts.inverse : false;
-        return this.llrot(x, y, { inverse: !inverse });
-    }
-    getThinnedGrid(thin_x, thin_y) {
-        const dlon = (this.ur_lon - this.ll_lon) / this.ni;
-        const dlat = (this.ur_lat - this.ll_lat) / this.nj;
-        const ni = Math.ceil(this.ni / thin_x);
-        const nj = Math.ceil(this.nj / thin_y);
-        const ni_remove = (this.ni - 1) % thin_x;
-        const nj_remove = (this.nj - 1) % thin_y;
-        const ll_lon = this.ll_lon;
-        const ll_lat = this.ll_lat;
-        const ur_lon = this.ur_lon - ni_remove * dlon;
-        const ur_lat = this.ur_lat - nj_remove * dlat;
-        return new PlateCarreeRotatedGrid(ni, nj, this.np_lon, this.np_lat, this.lon_shift, ll_lon, ll_lat, ur_lon, ur_lat);
-    }
-}
-/** A Lambert conformal conic grid with uniform grid spacing */
-class LambertGrid extends Grid {
-    /**
-     * Create a Lambert conformal conic grid
-     * @param ni      - The number of grid points in the i (longitude) direction
-     * @param nj      - The number of grid points in the j (latitude) direction
-     * @param lon_0   - The standard longitude for the projection; this is also the center longitude for the projection
-     * @param lat_0   - The center latitude for the projection
-     * @param lat_std - The standard latitudes for the projection
-     * @param ll_x    - The x coordinate in projection space of the lower-left corner of the grid
-     * @param ll_y    - The y coordinate in projection space of the lower-left corner of the grid
-     * @param ur_x    - The x coordinate in projection space of the upper-right corner of the grid
-     * @param ur_y    - The y coordinate in projection space of the upper-right corner of the grid
-     */
-    constructor(ni, nj, lon_0, lat_0, lat_std, ll_x, ll_y, ur_x, ur_y) {
-        super('lcc', true, ni, nj);
-        this.lon_0 = lon_0;
-        this.lat_0 = lat_0;
-        this.lat_std = lat_std;
-        this.ll_x = ll_x;
-        this.ll_y = ll_y;
-        this.ur_x = ur_x;
-        this.ur_y = ur_y;
-        this.lcc = lambertConformalConic({ lon_0: lon_0, lat_0: lat_0, lat_std: lat_std });
-        const dx = (this.ur_x - this.ll_x) / (this.ni - 1);
-        const dy = (this.ur_y - this.ll_y) / (this.nj - 1);
-        this.ll_cache = new Cache(() => {
-            const lons = new Float32Array(this.ni * this.nj);
-            const lats = new Float32Array(this.ni * this.nj);
-            for (let i = 0; i < this.ni; i++) {
-                const x = this.ll_x + i * dx;
-                for (let j = 0; j < this.nj; j++) {
-                    const y = this.ll_y + j * dy;
-                    const [lon, lat] = this.lcc(x, y, { inverse: true });
-                    const idx = i + j * this.ni;
-                    lons[idx] = lon;
-                    lats[idx] = lat;
-                }
-            }
-            return { lons: lons, lats: lats };
-        });
-        this.gc_cache = new Cache(() => {
-            const x = new Float32Array(this.ni);
-            const y = new Float32Array(this.nj);
-            for (let i = 0; i < this.ni; i++) {
-                x[i] = this.ll_x + i * dx;
-            }
-            for (let j = 0; j < this.nj; j++) {
-                y[j] = this.ll_y + j * dy;
-            }
-            return { x: x, y: y };
-        });
-    }
-    copy(opts) {
-        opts = opts !== undefined ? opts : {};
-        const ni = opts.ni !== undefined ? opts.ni : this.ni;
-        const nj = opts.nj !== undefined ? opts.nj : this.nj;
-        const ll_x = opts.ll_x !== undefined ? opts.ll_x : this.ll_x;
-        const ll_y = opts.ll_y !== undefined ? opts.ll_y : this.ll_y;
-        const ur_x = opts.ur_x !== undefined ? opts.ur_x : this.ur_x;
-        const ur_y = opts.ur_y !== undefined ? opts.ur_y : this.ur_y;
-        return new LambertGrid(ni, nj, this.lon_0, this.lat_0, this.lat_std, ll_x, ll_y, ur_x, ur_y);
-    }
-    /**
-     * Get a list of longitudes and latitudes on the grid (internal method)
-     */
-    getEarthCoords() {
-        return this.ll_cache.getValue();
-    }
-    getGridCoords() {
-        return this.gc_cache.getValue();
-    }
-    transform(x, y, opts) {
-        opts = opts === undefined ? {} : opts;
-        const inverse = 'inverse' in opts ? opts.inverse : false;
-        return this.lcc(x, y, { inverse: inverse });
-    }
-    getThinnedGrid(thin_x, thin_y) {
-        const dx = (this.ur_x - this.ll_x) / this.ni;
-        const dy = (this.ur_y - this.ll_y) / this.nj;
-        const ni = Math.ceil(this.ni / thin_x);
-        const nj = Math.ceil(this.nj / thin_y);
-        const ni_remove = (this.ni - 1) % thin_x;
-        const nj_remove = (this.nj - 1) % thin_y;
-        const ll_x = this.ll_x;
-        const ll_y = this.ll_y;
-        const ur_x = this.ur_x - ni_remove * dx;
-        const ur_y = this.ur_y - nj_remove * dy;
-        return new LambertGrid(ni, nj, this.lon_0, this.lat_0, this.lat_std, ll_x, ll_y, ur_x, ur_y);
-    }
-}
 function getArrayConstructor(ary) {
     return ary.constructor;
 }
@@ -324,34 +17,25 @@ class RawScalarField {
         if (grid.ni * grid.nj != data.length) {
             throw `Data size (${data.length}) doesn't match the grid dimensions (${grid.ni} x ${grid.nj}; expected ${grid.ni * grid.nj} points)`;
         }
+        this.contour_cache = new Cache(async (opts) => {
+            return await contourCreator(this.data, this.grid, opts);
+        });
     }
     /** @internal */
     getTextureData() {
         // Need to give float16 data as uint16s to make WebGL happy: https://github.com/petamoriken/float16/issues/105
+        const raw_data = this.data;
         let data;
-        if (this.data instanceof Float32Array) {
-            data = this.data;
+        if (raw_data instanceof Float32Array) {
+            data = raw_data;
         }
         else {
-            data = new Uint16Array(this.data.buffer);
+            data = new Uint16Array(raw_data.buffer);
         }
         return data;
     }
-    isFloat16() {
-        return !(this.data instanceof Float32Array);
-    }
-    getThinnedField(thin_x, thin_y) {
-        const arrayType = getArrayConstructor(this.data);
-        const new_grid = this.grid.getThinnedGrid(thin_x, thin_y);
-        const new_data = new arrayType(new_grid.ni * new_grid.nj);
-        for (let i = 0; i < new_grid.ni; i++) {
-            for (let j = 0; j < new_grid.nj; j++) {
-                const idx_old = i * thin_x + this.grid.ni * j * thin_y;
-                const idx = i + new_grid.ni * j;
-                new_data[idx] = this.data[idx_old];
-            }
-        }
-        return new RawScalarField(new_grid, new_data);
+    async getContours(opts) {
+        return await this.contour_cache.getValue(opts);
     }
     /**
      * Create a new field by aggregating a number of fields using a specific function
@@ -385,70 +69,39 @@ class RawVectorField {
      */
     constructor(grid, u, v, opts) {
         opts = opts === undefined ? {} : opts;
-        const arrayType = getArrayConstructor(u);
         this.u = new RawScalarField(grid, u);
         this.v = new RawScalarField(grid, v);
         this.relative_to = opts.relative_to === undefined ? 'grid' : opts.relative_to;
-        this.rotate_cache = new Cache(() => {
-            const grid = this.u.grid;
-            const coords = grid.getEarthCoords();
-            const u_rot = new arrayType(coords.lats.length);
-            const v_rot = new arrayType(coords.lats.length);
-            for (let icd = 0; icd < coords.lats.length; icd++) {
-                const lon = coords.lons[icd];
-                const lat = coords.lats[icd];
-                const u = this.u.data[icd];
-                const v = this.v.data[icd];
-                if (Math.abs(u) < 1e-6 && Math.abs(v) < 1e-6) {
-                    u_rot[icd] = 0;
-                    v_rot[icd] = 0;
-                    continue;
-                }
-                const [x, y] = grid.transform(lon, lat);
-                const [x_pertlon, y_pertlon] = grid.transform(lon + 0.01, lat);
-                const mag_pertlon = Math.hypot(x - x_pertlon, y - y_pertlon);
-                const x_dotlon = (x_pertlon - x) / mag_pertlon;
-                const y_dotlon = (y_pertlon - y) / mag_pertlon;
-                let x_dotlat, y_dotlat;
-                if (grid.is_conformal) {
-                    // If the grid is conformal, v and u are rotated by the same amount in the same direction.
-                    x_dotlat = -y_dotlon;
-                    y_dotlat = x_dotlon;
-                }
-                else {
-                    // If the grid is non-conformal, we need a fully general change of basis from grid coordinates to earth coordinates.
-                    const [x_pertlat, y_pertlat] = grid.transform(lon, lat + 0.01);
-                    const mag_pertlat = Math.hypot(x - x_pertlat, y - y_pertlat);
-                    x_dotlat = (x_pertlat - x) / mag_pertlat;
-                    y_dotlat = (y_pertlat - y) / mag_pertlat;
-                }
-                u_rot[icd] = x_dotlon * u + y_dotlon * v;
-                v_rot[icd] = x_dotlat * u + y_dotlat * v;
-            }
-            return { u: new RawScalarField(grid, u_rot), v: new RawScalarField(grid, v_rot) };
-        });
+    }
+    getTextureData() {
+        // Need to give float16 data as uint16s to make WebGL happy: https://github.com/petamoriken/float16/issues/105
+        const raw_u = this.u.data;
+        const raw_v = this.v.data;
+        const u = raw_u instanceof Float32Array ? raw_u : new Uint16Array(raw_u.buffer);
+        const v = raw_v instanceof Float32Array ? raw_v : new Uint16Array(raw_v.buffer);
+        return { u: u, v: v };
     }
     getThinnedField(thin_x, thin_y) {
-        const thin_u = this.u.getThinnedField(thin_x, thin_y);
-        const thin_v = this.v.getThinnedField(thin_x, thin_y);
-        return new RawVectorField(thin_u.grid, thin_u.data, thin_v.data, { relative_to: this.relative_to });
+        const new_grid = this.grid.getThinnedGrid(thin_x, thin_y);
+        const thinGrid = (data) => {
+            const arrayType = getArrayConstructor(data);
+            const new_data = new arrayType(new_grid.ni * new_grid.nj);
+            for (let i = 0; i < new_grid.ni; i++) {
+                for (let j = 0; j < new_grid.nj; j++) {
+                    const idx_old = i * thin_x + this.grid.ni * j * thin_y;
+                    const idx = i + new_grid.ni * j;
+                    new_data[idx] = data[idx_old];
+                }
+            }
+            return new_data;
+        };
+        const thin_u = thinGrid(this.u.data);
+        const thin_v = thinGrid(this.v.data);
+        return new RawVectorField(new_grid, thin_u, thin_v, { relative_to: this.relative_to });
     }
     get grid() {
         return this.u.grid;
     }
-    toEarthRelative() {
-        let u, v;
-        if (this.relative_to == 'earth') {
-            u = this.u;
-            v = this.v;
-        }
-        else {
-            const { u: u_, v: v_ } = this.rotate_cache.getValue();
-            u = u_;
-            v = v_;
-        }
-        return new RawVectorField(u.grid, u.data, v.data, { relative_to: 'earth' });
-    }
 }
 /** A class grid of wind profiles */
 class RawProfileField {
@@ -463,9 +116,10 @@ class RawProfileField {
     }
     /** Get the gridded storm motion vector field (internal method) */
     getStormMotionGrid() {
+        const profiles = this.profiles;
         const u = new Float16Array(this.grid.ni * this.grid.nj).fill(parseFloat('nan'));
         const v = new Float16Array(this.grid.ni * this.grid.nj).fill(parseFloat('nan'));
-        this.profiles.forEach(prof => {
+        profiles.forEach(prof => {
             const idx = prof.ilon + this.grid.ni * prof.jlat;
             u[idx] = prof.smu;
             v[idx] = prof.smv;
@@ -473,4 +127,4 @@ class RawProfileField {
         return new RawVectorField(this.grid, u, v, { relative_to: 'grid' });
     }
 }
-export { RawScalarField, RawVectorField, RawProfileField, PlateCarreeGrid, PlateCarreeRotatedGrid, LambertGrid, Grid };
+export { RawScalarField, RawVectorField, RawProfileField };

package/lib/TextCollection.d.ts

@@ -0,0 +1,31 @@
+import { WebGLAnyRenderingContext } from "./AutumnTypes";
+import { WGLBuffer, WGLProgram, WGLTexture } from "autumn-wgl";
+interface TextSpec {
+    lat: number;
+    lon: number;
+    text: string;
+    min_zoom?: number;
+}
+type HorizontalAlign = 'left' | 'center' | 'right';
+type VerticalAlign = 'baseline' | 'middle' | 'top';
+interface TextCollectionOptions {
+    horizontal_align?: HorizontalAlign;
+    vertical_align?: VerticalAlign;
+    font_size?: number;
+    text_color?: [number, number, number];
+    halo_color?: [number, number, number];
+    halo?: boolean;
+}
+declare class TextCollection {
+    readonly program: WGLProgram;
+    readonly anchors: WGLBuffer;
+    readonly offsets: WGLBuffer;
+    readonly texcoords: WGLBuffer;
+    readonly texture: WGLTexture;
+    readonly opts: Required<TextCollectionOptions>;
+    private constructor();
+    static make(gl: WebGLAnyRenderingContext, text_locs: TextSpec[], fontstack_url: string, opts?: TextCollectionOptions): Promise<TextCollection>;
+    render(gl: WebGLAnyRenderingContext, matrix: number[], [map_width, map_height]: [number, number], map_zoom: number): void;
+}
+export { TextCollection };
+export type { TextSpec, TextCollectionOptions };