@openglobus/og 1.0.0-rc33 → 1.0.0-rc34

package/lib/Globe.d.ts

@@ -43,6 +43,7 @@ export interface IGlobeParams {
     sun?: {
         active?: boolean;
         stopped?: boolean;
+        dateTime?: Date | null;
         localDateTime?: Date | null;
         useTimeZones?: boolean;
     };
@@ -109,6 +110,9 @@ export interface IGlobeParams {
  * @param {string} [options.name] - Planet name. Default is uniq identifier.
  * @param {EmptyTerrain | Array.<EmptyTerrain>} [options.terrain] - Terrain provider or providers array, where the first one becomes active. Default no terrain - og.terrain.EmptyTerrain.
  * @param {Array.<Control>} [options.controls] - Controls.
+ * @param {Object} [options.sun] - Sun control options.
+ * @param {Date|null} [options.sun.dateTime] - Fixed UTC time.
+ * @param {Date|null} [options.sun.localDateTime] - Local time. Overrides dateTime if provided; null resets fixed lighting.
  * @param {Array.<Layer>} [options.layers] - Planet layers.
  * @param {Extent | ExtentBoundingBox} [options.viewExtent] [options.viewExtent] - Viewable starting extent.
  * @param {boolean} [options.autoActivate=true] - Globe rendering auto activation flag. True is default.

package/lib/assets/RgbTerrainWorker.worker-CEntGFYu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RgbTerrainWorker.worker-CEntGFYu.js","names":[],"sources":["../../src/terrain/rgbTerrainGrid.ts","../../src/utils/RgbTerrainWorker.worker.js"],"sourcesContent":["import type { TypedArray } from \"../utils/shared\";\n\nexport const RGB_ENCODING_CUSTOM = -1;\nexport const RGB_ENCODING_RGB = 0;\nexport const RGB_ENCODING_TERRARIUM = 1;\n\n/** Writes a row of pixel heights, NaN for no data pixels. */\nexport type DecodeHeightsRowFunc = (row: number, outHeights: Float32Array) => void;\n\nexport interface IRgbDecodeParams {\n    encoding: number;\n    minHeight: number;\n    resolution: number;\n    heightFactor: number;\n    noDataValues: number[] | TypedArray;\n    parentData: number[] | TypedArray | null;\n    parentOffsetX: number;\n    parentOffsetY: number;\n    parentZoomDiff: number;\n    skipPositiveHeights: boolean;\n}\n\nexport interface IRgbHeightsParams {\n    decode: IRgbDecodeParams;\n    size: number;\n    gridSize: number;\n    levels: number;\n    noDataHeight: number;\n}\n\nconst PARAMS_ID = 0,\n    PARAMS_SIZE = 1,\n    PARAMS_GRID_SIZE = 2,\n    PARAMS_LEVELS = 3,\n    PARAMS_ENCODING = 4,\n    PARAMS_MIN_HEIGHT = 5,\n    PARAMS_RESOLUTION = 6,\n    PARAMS_HEIGHT_FACTOR = 7,\n    PARAMS_PARENT_OFFSET_X = 8,\n    PARAMS_PARENT_OFFSET_Y = 9,\n    PARAMS_PARENT_ZOOM_DIFF = 10,\n    PARAMS_SKIP_POSITIVE_HEIGHTS = 11,\n    PARAMS_NO_DATA_HEIGHT = 12,\n    PARAMS_NO_DATA_VALUES = 13;\n\n/**\n * Packs heights parameters to the buffer for the worker message.\n * @param {number} id - Worker task id.\n * @param {IRgbHeightsParams} p - Heights parameters, parent data is sent separately.\n * @returns {Float64Array} -\n */\nexport function packRgbHeightsParams(id: number, p: IRgbHeightsParams): Float64Array {\n    let d = p.decode,\n        ndv = d.noDataValues;\n    let params = new Float64Array(PARAMS_NO_DATA_VALUES + ndv.length);\n\n    params[PARAMS_ID] = id;\n    params[PARAMS_SIZE] = p.size;\n    params[PARAMS_GRID_SIZE] = p.gridSize;\n    params[PARAMS_LEVELS] = p.levels;\n    params[PARAMS_ENCODING] = d.encoding;\n    params[PARAMS_MIN_HEIGHT] = d.minHeight;\n    params[PARAMS_RESOLUTION] = d.resolution;\n    params[PARAMS_HEIGHT_FACTOR] = d.heightFactor;\n    params[PARAMS_PARENT_OFFSET_X] = d.parentOffsetX;\n    params[PARAMS_PARENT_OFFSET_Y] = d.parentOffsetY;\n    params[PARAMS_PARENT_ZOOM_DIFF] = d.parentZoomDiff;\n    params[PARAMS_SKIP_POSITIVE_HEIGHTS] = d.skipPositiveHeights ? 1 : 0;\n    params[PARAMS_NO_DATA_HEIGHT] = p.noDataHeight;\n\n    for (let i = 0; i < ndv.length; i++) {\n        params[PARAMS_NO_DATA_VALUES + i] = ndv[i];\n    }\n    return params;\n}\n\n/**\n * Unpacks heights parameters from the worker message buffer.\n * @param {Float64Array} params - Packed parameters.\n * @param {Float32Array | null} parentData - Parent segment elevations.\n * @returns {Array} - Task id and parameters (exactly 2 entries).\n */\nexport function unpackRgbHeightsParams(\n    params: Float64Array,\n    parentData: Float32Array | null\n): [number, IRgbHeightsParams] {\n    return [\n        params[PARAMS_ID],\n        {\n            decode: {\n                encoding: params[PARAMS_ENCODING],\n                minHeight: params[PARAMS_MIN_HEIGHT],\n                resolution: params[PARAMS_RESOLUTION],\n                heightFactor: params[PARAMS_HEIGHT_FACTOR],\n                noDataValues: params.subarray(PARAMS_NO_DATA_VALUES),\n                parentData: parentData,\n                parentOffsetX: params[PARAMS_PARENT_OFFSET_X],\n                parentOffsetY: params[PARAMS_PARENT_OFFSET_Y],\n                parentZoomDiff: params[PARAMS_PARENT_ZOOM_DIFF],\n                skipPositiveHeights: params[PARAMS_SKIP_POSITIVE_HEIGHTS] === 1\n            },\n            size: params[PARAMS_SIZE],\n            gridSize: params[PARAMS_GRID_SIZE],\n            levels: params[PARAMS_LEVELS],\n            noDataHeight: params[PARAMS_NO_DATA_HEIGHT]\n        }\n    ];\n}\n\n/**\n * Returns vertex grid cells for the image size, 2^n and (2^n + 1) sizes only.\n * @param {number} size - Image size.\n * @returns {number} -\n */\nexport function getGridCells(size: number): number {\n    return (size & (size - 1)) === 0 ? size : size - 1;\n}\n\nfunction isNoDataValue(noDataValues: number[] | TypedArray, ndMin: number, ndMax: number, h: number): boolean {\n    if (h > 50000) {\n        return true;\n    }\n    if (h <= ndMin || h >= ndMax) {\n        return false;\n    }\n    let start = 0,\n        end = noDataValues.length - 1;\n    while (start <= end) {\n        let k = (start + end) >> 1;\n        if (Math.abs(noDataValues[k] - h) < 1e-3) {\n            return true;\n        } else if (noDataValues[k] < h) {\n            start = k + 1;\n        } else {\n            end = k - 1;\n        }\n    }\n    return false;\n}\n\nexport function getParentHeight(\n    oneByDz2: number,\n    offsetX: number,\n    offsetY: number,\n    heights: TypedArray | number[],\n    i: number,\n    j: number,\n    skipPositiveHeights?: boolean\n) {\n    let parentGridSize = Math.sqrt(heights.length);\n    let pi = Math.floor(offsetY * oneByDz2 * parentGridSize + i * oneByDz2),\n        pj = Math.floor(offsetX * oneByDz2 * parentGridSize + j * oneByDz2);\n    let h = heights[pi * parentGridSize + pj];\n    return skipPositiveHeights ? (h > 0 ? 0 : h) : h;\n}\n\n/**\n * Decodes \"rgb\" or \"terrarium\" encoded pixel row heights.\n * @param {number[] | TypedArray} rgbaData - Image RGBA data.\n * @param {number} row - Pixel row.\n * @param {number} size - Image size.\n * @param {number} parentScale - Parent grid cells by image grid cells.\n * @param {IRgbDecodeParams} p - Decode parameters.\n * @param {Float32Array} outHeights - Row heights.\n * @param {number} noDataHeight - Height for no data pixels.\n */\nexport function decodeRgbHeightsRow(\n    rgbaData: number[] | TypedArray,\n    row: number,\n    size: number,\n    parentScale: number,\n    p: IRgbDecodeParams,\n    outHeights: Float32Array,\n    noDataHeight: number\n) {\n    let ndv = p.noDataValues,\n        ndMin = ndv.length ? ndv[0] - 1e-3 : 0,\n        ndMax = ndv.length ? ndv[ndv.length - 1] + 1e-3 : 0;\n\n    let isTerrarium = p.encoding === RGB_ENCODING_TERRARIUM,\n        minHeight = p.minHeight,\n        resolution = p.resolution,\n        heightFactor = p.heightFactor,\n        parentData = p.parentData;\n\n    let pi = Math.floor(row * parentScale);\n\n    for (let j = 0, k4 = row * size * 4; j < size; j++, k4 += 4) {\n        let r = rgbaData[k4],\n            g = rgbaData[k4 + 1],\n            b = rgbaData[k4 + 2];\n\n        let height = isTerrarium\n            ? r * 256 + g + b / 256 - 32768\n            : r === 255\n              ? minHeight\n              : minHeight + resolution * (r * 65536 + g * 256 + b);\n\n        height *= heightFactor;\n\n        let isNoData = isNoDataValue(ndv, ndMin, ndMax, height);\n\n        if ((isNoData || height === 0) && parentData) {\n            height = getParentHeight(\n                p.parentZoomDiff,\n                p.parentOffsetX,\n                p.parentOffsetY,\n                parentData,\n                pi,\n                Math.floor(j * parentScale),\n                p.skipPositiveHeights\n            );\n            isNoData = isNoDataValue(ndv, ndMin, ndMax, height);\n        }\n\n        outHeights[j] = isNoData ? noDataHeight : height;\n    }\n}\n\n/**\n * Converts size x size pixel heights to (size + 1) x (size + 1) vertex grid in pixel corners.\n * @param {number} size - Image size.\n * @param {DecodeHeightsRowFunc} decodeRow - Decodes pixel row heights, NaN for no data.\n * @param {number} noDataHeight - Height for vertices without data around.\n * @returns {Float32Array} -\n */\nexport function createVertexGrid(size: number, decodeRow: DecodeHeightsRowFunc, noDataHeight: number): Float32Array {\n    let gs = size + 1;\n\n    // Per-axis taps for vertex v: two pixel indices with interpolation weights, and the nearest pixels.\n    let i0 = new Int32Array(gs),\n        i1 = new Int32Array(gs),\n        w0 = new Float32Array(gs),\n        w1 = new Float32Array(gs),\n        n0 = new Int32Array(gs),\n        n1 = new Int32Array(gs);\n\n    for (let v = 0; v < gs; v++) {\n        if (v === 0) {\n            i0[v] = 0;\n            i1[v] = 1;\n            w0[v] = 1.5;\n            w1[v] = -0.5;\n            n0[v] = n1[v] = 0;\n        } else if (v === size) {\n            i0[v] = size - 1;\n            i1[v] = size - 2;\n            w0[v] = 1.5;\n            w1[v] = -0.5;\n            n0[v] = n1[v] = size - 1;\n        } else {\n            i0[v] = n0[v] = v - 1;\n            i1[v] = n1[v] = v;\n            w0[v] = w1[v] = 0.5;\n        }\n    }\n\n    // Pixel row r is kept at (r & 1) * size\n    let heights = new Float32Array(size * 2),\n        rowHeights = [heights.subarray(0, size), heights.subarray(size)],\n        lastRow = -1;\n\n    let out = new Float32Array(gs * gs);\n\n    for (let vi = 0; vi < gs; vi++) {\n        let needRow = vi === 0 ? 1 : Math.min(vi, size - 1);\n        while (lastRow < needRow) {\n            lastRow++;\n            decodeRow(lastRow, rowHeights[lastRow & 1]);\n        }\n\n        let r0 = (i0[vi] & 1) * size,\n            r1 = (i1[vi] & 1) * size,\n            wr0 = w0[vi],\n            wr1 = w1[vi],\n            nr0 = (n0[vi] & 1) * size,\n            nr1 = (n1[vi] & 1) * size;\n\n        for (let vj = 0; vj < gs; vj++) {\n            let c0 = i0[vj],\n                c1 = i1[vj];\n\n            let h =\n                wr0 * (w0[vj] * heights[r0 + c0] + w1[vj] * heights[r0 + c1]) +\n                wr1 * (w0[vj] * heights[r1 + c0] + w1[vj] * heights[r1 + c1]);\n\n            // NaN means at least one tap has no data\n            if (h === h) {\n                out[vi * gs + vj] = h;\n            } else {\n                let h00 = heights[nr0 + n0[vj]],\n                    h01 = heights[nr0 + n1[vj]],\n                    h10 = heights[nr1 + n0[vj]],\n                    h11 = heights[nr1 + n1[vj]];\n\n                let sum = 0,\n                    count = 0;\n\n                if (h00 === h00) {\n                    sum += h00;\n                    count++;\n                }\n                if (h01 === h01) {\n                    sum += h01;\n                    count++;\n                }\n                if (h10 === h10) {\n                    sum += h10;\n                    count++;\n                }\n                if (h11 === h11) {\n                    sum += h11;\n                    count++;\n                }\n\n                out[vi * gs + vj] = count ? sum / count : noDataHeight;\n            }\n        }\n    }\n\n    return out;\n}\n\n/**\n * Takes (gridSize + 1) x (gridSize + 1) vertices of the cells x cells square starting at\n * the row0, col0 vertex of the (size + 1) x (size + 1) grid. Cells must be gridSize multiplied by a power of two.\n */\nexport function sampleSubGrid(\n    grid: Float32Array,\n    size: number,\n    row0: number,\n    col0: number,\n    cells: number,\n    gridSize: number,\n    out: Float32Array = new Float32Array((gridSize + 1) * (gridSize + 1)),\n    outOffset: number = 0\n): Float32Array {\n    let gs = size + 1,\n        outGs = gridSize + 1,\n        step = cells / gridSize;\n\n    for (let i = 0; i < outGs; i++) {\n        let src = (row0 + i * step) * gs + col0,\n            dst = outOffset + i * outGs;\n        for (let j = 0; j < outGs; j++) {\n            out[dst + j] = grid[src + j * step];\n        }\n    }\n\n    return out;\n}\n\n/**\n * Creates the tile heights grid and its subdivision levels, each tile is (gridSize + 1) x (gridSize + 1).\n * Output order is the tile itself, then 2x2 tiles of the first level, 4x4 of the second and so on, row by row.\n * @param {number} size - Image size, 2^n or (2^n + 1).\n * @param {number} gridSize - Tile grid size.\n * @param {number} levels - Subdivision levels.\n * @param {DecodeHeightsRowFunc} decodeRow - Decodes pixel row heights, NaN for no data.\n * @param {number} noDataHeight - Height for vertices without data.\n * @returns {Float32Array} -\n */\nexport function createHeightsLevels(\n    size: number,\n    gridSize: number,\n    levels: number,\n    decodeRow: DecodeHeightsRowFunc,\n    noDataHeight: number\n): Float32Array {\n    let cells = getGridCells(size);\n\n    let grid: Float32Array;\n\n    if (cells === size) {\n        grid = createVertexGrid(size, decodeRow, noDataHeight);\n    } else {\n        grid = new Float32Array(size * size);\n        for (let row = 0; row < size; row++) {\n            let rowHeights = grid.subarray(row * size, (row + 1) * size);\n            decodeRow(row, rowHeights);\n            for (let j = 0; j < size; j++) {\n                if (rowHeights[j] !== rowHeights[j]) {\n                    rowHeights[j] = noDataHeight;\n                }\n            }\n        }\n    }\n\n    let tileLength = (gridSize + 1) * (gridSize + 1),\n        tilesCount = 0;\n\n    for (let k = 0; k <= levels; k++) {\n        tilesCount += 1 << (2 * k);\n    }\n\n    let out = new Float32Array(tilesCount * tileLength);\n\n    for (let k = 0, c = cells, offset = 0; k <= levels; k++, c >>= 1) {\n        let d = 1 << k;\n        for (let i = 0; i < d; i++) {\n            for (let j = 0; j < d; j++) {\n                sampleSubGrid(grid, cells, i * c, j * c, c, gridSize, out, offset);\n                offset += tileLength;\n            }\n        }\n    }\n\n    return out;\n}\n","\"use strict\";\n//\n// RGB terrain heights worker\n//\nimport {\n    createHeightsLevels,\n    decodeRgbHeightsRow,\n    getGridCells,\n    unpackRgbHeightsParams\n} from \"../terrain/rgbTerrainGrid\";\n\nlet ctx = null;\n\nfunction getImageData(bitmap, size) {\n    if (!ctx || ctx.canvas.width !== size) {\n        ctx = new OffscreenCanvas(size, size).getContext(\"2d\", {\n            willReadFrequently: true\n        });\n    }\n\n    ctx.clearRect(0, 0, size, size);\n    ctx.drawImage(bitmap, 0, 0);\n\n    return ctx.getImageData(0, 0, size, size).data;\n}\n\nself.onmessage = function (e) {\n    const [id, p] = unpackRgbHeightsParams(e.data.params, e.data.parentData);\n    const bitmap = e.data.bitmap;\n\n    let heights = null;\n\n    try {\n        const rgbaData = getImageData(bitmap, p.size);\n        const parentScale = p.gridSize / getGridCells(p.size);\n\n        heights = createHeightsLevels(\n            p.size,\n            p.gridSize,\n            p.levels,\n            (row, outHeights) => decodeRgbHeightsRow(rgbaData, row, p.size, parentScale, p.decode, outHeights, NaN),\n            p.noDataHeight\n        );\n    } catch (err) {\n        console.error(err);\n    }\n\n    bitmap.close();\n\n    self.postMessage(\n        {\n            id: id,\n            heights: heights\n        },\n        heights ? [heights.buffer] : []\n    );\n};\n"],"mappings":"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"}

package/lib/control/DragAndDrop.d.ts

@@ -33,5 +33,6 @@ export declare class DragAndDrop extends Control {
     protected _addObj(file: File, lonLat: LonLat, mtlFile?: File | null): Promise<void>;
     protected _selectEntity(entity: Entity): void;
     protected _addBillboard(file: File, lonLat: LonLat): Promise<void>;
+    protected _createTiffLayer(file: File): GeoTIFFLayer;
     protected _addTiff(file: File): Promise<void>;
 }

package/lib/control/entityGizmo/EntityGizmo.d.ts

@@ -20,12 +20,13 @@ type EntityGizmoEventsList = [
  * @class
  * @extends {Control}
  * @param {IEntityGizmoParams} [options] - Gizmo options:
- * @param {GizmoTools} [options.tools] - Gizmo tool set, i.e. which handles are shown. `translate`
+ * @param {GizmoTools} [options.tools] - Gizmo tool set, i.e., which handles are shown. `translate`
  * shows move axes and planes only, `full` adds rotation rings. Orthogonal to `editMode`.
  * @param {EditModeName} [options.editMode] - Rotation mode. `native` rotates in the entity's own
  * frame, `yaw` rotates in the local horizon frame. Affects the rotation rings only, so it does
  * nothing with `tools: "translate"`.
- * @param {boolean} [options.autoSelect] - When `false`, a left click on a map entity does not
+ * @param {boolean} [options.autoSelect] - When `true`, a left click on a map entity selects it and
+ * a left click anywhere else drops the selection. When `false`, clicks do not
  * change the gizmo selection, so the host application stays the only source of the selection.
  * Default is `true`.
  */
@@ -50,7 +51,7 @@ export declare class EntityGizmo extends Control {
     get editMode(): EditModeName;
     set editMode(editMode: EditModeName);
     /**
-     * When `false`, a left click on a map entity does not change the gizmo selection.
+     * When `false`, a left click neither selects a map entity nor drops the current selection.
      * @public
      */
     get autoSelect(): boolean;

package/lib/control/entityGizmo/EntityGizmoScene.d.ts

@@ -133,7 +133,9 @@ declare class EntityGizmoScene extends Scene {
     /** Gizmo tool set: which handles are shown. */
     get tools(): GizmoTools;
     set tools(tools: GizmoTools);
-    /** When `false`, a left click on a map entity does not change the gizmo selection. */
+    /**
+     * When `false`, a left click neither selects a map entity nor drops the current selection.
+     */
     get autoSelect(): boolean;
     set autoSelect(autoSelect: boolean);
     protected get _rotateEnabled(): boolean;
@@ -170,6 +172,16 @@ declare class EntityGizmoScene extends Scene {
     readyToEdit(entity: Entity): boolean;
     select(entity: Entity): void;
     unselect(): void;
+    /**
+     * Returns `true` when the entity is one of the gizmo handles.
+     * @protected
+     */
+    protected _isGizmoEntity(entity: Entity): boolean;
+    /**
+     * `lclick` fires on the left button release without dragging, so dropping the selection
+     * here does not interfere with the map navigation.
+     * @protected
+     */
     protected _onLclick: (e: IMouseState) => void;
     clear(): void;
     protected _onForwardpass: () => void;

package/lib/index.d.ts

@@ -14,6 +14,7 @@ export * from "./control/Control";
 export * from "./entity/index";
 export * from "./layer/index";
 export * from "./Globe";
+export { proj4 } from "./proj/proj4";
 export type { IControlParams } from "./control/Control";
 export type { IMouseState, ITouchState } from "./renderer/RendererEvents";
 export type { IDeferredShadingPass } from "./renderer/IDeferredShadingPass";

package/lib/layer/BaseTileMaterialLayer.d.ts

@@ -20,6 +20,7 @@ export declare abstract class BaseTileMaterialLayer extends Layer {
     events: BaseTileMaterialLayerEventsType;
     minNativeZoom: number;
     maxNativeZoom: number;
+    protected _loadendFrame: number;
     constructor(name?: string | null, options?: IBaseTileMaterialLayerParams);
     addTo(planet: Planet): void;
     remove(): this;

package/lib/layer/GeoTIFFLayer.d.ts

@@ -66,6 +66,14 @@ export declare class GeoTIFFLayer extends BaseTileMaterialLayer {
     clear(): void;
     redraw(): void;
     private _reapplyRenderOptions;
+    /**
+     * Opens the source. If its CRS is unresolved, fetches the projection
+     * from the EPSG registry and reopens the source with it.
+     *
+     * Projections provided via `projFunc` or registered in {@link proj4}
+     * are already resolved and require no lookup.
+     */
+    private _readSource;
     private _initSource;
     private _initSources;
     private _normalizeRenderOptions;

package/lib/layer/geotiff/GeoTIFFReader.d.ts

@@ -14,6 +14,8 @@ export declare class GeoTIFFReader implements IGeoTIFFReader {
     extentWgs84: Extent;
     nativeBBox: [number, number, number, number];
     crsCode: number;
+    /** Whether `crsCode` could be georeferenced, see {@link IGeoTIFFMetadata.crsResolved} */
+    crsResolved: boolean;
     projFunc?: ProjFunc;
     reverseY: boolean;
     requestLevels: number[];

package/lib/layer/geotiff/MultiGeoTIFFReader.d.ts

@@ -16,6 +16,8 @@ export declare class MultiGeoTIFFReader implements IGeoTIFFReader {
     extentWgs84: Extent;
     isReady: boolean;
     crsCode: number;
+    /** Whether every source could be georeferenced, see {@link IGeoTIFFMetadata.crsResolved} */
+    crsResolved: boolean;
     workerPool: Pool | null;
     private _poolHandle;
     private _bandMappings;

package/lib/layer/geotiff/types.d.ts

@@ -63,9 +63,9 @@ export interface IGeoTIFFRequestOptions {
     credentials?: boolean;
     maxRanges?: number;
     allowFullFile?: boolean;
-    /** Size of a cached byte range, 64 KB by default. Fetched ranges are cached only when it is set. */
+    /** Size of a cached byte range, 256 KB by default. */
     blockSize?: number;
-    /** Number of cached byte ranges, 512 by default. */
+    /** Number of cached byte ranges, by default as many as fit in 32 MB. */
     cacheSize?: number;
     [key: string]: any;
 }
@@ -141,6 +141,7 @@ export interface IGeoTIFFReader {
 export interface IGeoTIFFMetadata {
     bbox: [number, number, number, number];
     crsCode: number;
+    crsResolved: boolean;
     width: number;
     height: number;
     samplesPerPixel: number;

package/lib/layer/geotiff/utm.d.ts

@@ -17,6 +17,6 @@ export interface IProjectionHelper {
 }
 /**
  * Returns a projection helper { project, unproject } if the given code is a supported UTM EPSG code
- * (EPSG:32601-32660 or EPSG:32701-32760), or if proj4 is globally registered.
+ * (EPSG:32601-32660 or EPSG:32701-32760), or if its definition is registered in proj4.
  */
 export declare function getProjectionHelper(crsCode: number, customProjFunc?: (code: number) => IProjectionHelper | undefined): IProjectionHelper | null;