@developmentseed/geotiff 0.3.0-beta.3

package/dist/ifd.d.ts

@@ -0,0 +1,84 @@
+import type { TiffImage, TiffTagGeoType, TiffTagType } from "@cogeotiff/core";
+import { TiffTag, TiffTagGeo } from "@cogeotiff/core";
+export declare enum Predictor {
+    None = 1,
+    /** Horizontal differencing */
+    Horizontal = 2,
+    /** Floating point */
+    FloatingPoint = 3
+}
+/** Subset of TIFF tags that we pre-fetch for easier visualization. */
+export interface CachedTags {
+    bitsPerSample: Uint16Array;
+    colorMap?: Uint16Array;
+    compression: TiffTagType[TiffTag.Compression];
+    nodata: number | null;
+    photometric: TiffTagType[TiffTag.Photometric];
+    /** https://web.archive.org/web/20240329145322/https://www.awaresystems.be/imaging/tiff/tifftags/photometricinterpretation.html */
+    planarConfiguration: TiffTagType[TiffTag.PlanarConfiguration];
+    predictor: Predictor;
+    sampleFormat: TiffTagType[TiffTag.SampleFormat];
+    samplesPerPixel: TiffTagType[TiffTag.SamplesPerPixel];
+}
+/** Pre-fetch TIFF tags for easier visualization. */
+export declare function prefetchTags(image: TiffImage): Promise<CachedTags>;
+/**
+ * Parsed GeoKey directory.
+ *
+ * All fields are optional because any given GeoTIFF may only contain a subset
+ * of keys. Types reference `TiffTagGeoType` so `@cogeotiff/core` remains the
+ * source of truth.
+ *
+ * @see https://docs.ogc.org/is/19-008r4/19-008r4.html#_summary_of_geokey_ids_and_names
+ */
+export type GeoKeyDirectory = {
+    modelType: TiffTagGeoType[TiffTagGeo.GTModelTypeGeoKey] | null;
+    rasterType: TiffTagGeoType[TiffTagGeo.GTRasterTypeGeoKey] | null;
+    citation: TiffTagGeoType[TiffTagGeo.GTCitationGeoKey] | null;
+    geodeticCRS: TiffTagGeoType[TiffTagGeo.GeodeticCRSGeoKey] | null;
+    geodeticCitation: TiffTagGeoType[TiffTagGeo.GeodeticCitationGeoKey] | null;
+    geodeticDatum: TiffTagGeoType[TiffTagGeo.GeodeticDatumGeoKey] | null;
+    primeMeridian: TiffTagGeoType[TiffTagGeo.PrimeMeridianGeoKey] | null;
+    linearUnits: TiffTagGeoType[TiffTagGeo.GeogLinearUnitsGeoKey] | null;
+    linearUnitSize: TiffTagGeoType[TiffTagGeo.GeogLinearUnitSizeGeoKey] | null;
+    angularUnits: TiffTagGeoType[TiffTagGeo.GeogAngularUnitsGeoKey] | null;
+    angularUnitSize: TiffTagGeoType[TiffTagGeo.GeogAngularUnitSizeGeoKey] | null;
+    ellipsoid: TiffTagGeoType[TiffTagGeo.EllipsoidGeoKey] | null;
+    ellipsoidSemiMajorAxis: TiffTagGeoType[TiffTagGeo.EllipsoidSemiMajorAxisGeoKey] | null;
+    ellipsoidSemiMinorAxis: TiffTagGeoType[TiffTagGeo.EllipsoidSemiMinorAxisGeoKey] | null;
+    ellipsoidInvFlattening: TiffTagGeoType[TiffTagGeo.EllipsoidInvFlatteningGeoKey] | null;
+    azimuthUnits: TiffTagGeoType[TiffTagGeo.GeogAzimuthUnitsGeoKey] | null;
+    primeMeridianLongitude: TiffTagGeoType[TiffTagGeo.PrimeMeridianLongitudeGeoKey] | null;
+    toWGS84: TiffTagGeoType[TiffTagGeo.GeogTOWGS84GeoKey] | null;
+    projectedCRS: TiffTagGeoType[TiffTagGeo.ProjectedCRSGeoKey] | null;
+    projectedCitation: TiffTagGeoType[TiffTagGeo.ProjectedCitationGeoKey] | null;
+    projection: TiffTagGeoType[TiffTagGeo.ProjectionGeoKey] | null;
+    projMethod: TiffTagGeoType[TiffTagGeo.ProjMethodGeoKey] | null;
+    projLinearUnits: TiffTagGeoType[TiffTagGeo.ProjLinearUnitsGeoKey] | null;
+    projLinearUnitSize: TiffTagGeoType[TiffTagGeo.ProjLinearUnitSizeGeoKey] | null;
+    projStdParallel1: TiffTagGeoType[TiffTagGeo.ProjStdParallel1GeoKey] | null;
+    projStdParallel2: TiffTagGeoType[TiffTagGeo.ProjStdParallel2GeoKey] | null;
+    projNatOriginLong: TiffTagGeoType[TiffTagGeo.ProjNatOriginLongGeoKey] | null;
+    projNatOriginLat: TiffTagGeoType[TiffTagGeo.ProjNatOriginLatGeoKey] | null;
+    projFalseEasting: TiffTagGeoType[TiffTagGeo.ProjFalseEastingGeoKey] | null;
+    projFalseNorthing: TiffTagGeoType[TiffTagGeo.ProjFalseNorthingGeoKey] | null;
+    projFalseOriginLong: TiffTagGeoType[TiffTagGeo.ProjFalseOriginLongGeoKey] | null;
+    projFalseOriginLat: TiffTagGeoType[TiffTagGeo.ProjFalseOriginLatGeoKey] | null;
+    projFalseOriginEasting: TiffTagGeoType[TiffTagGeo.ProjFalseOriginEastingGeoKey] | null;
+    projFalseOriginNorthing: TiffTagGeoType[TiffTagGeo.ProjFalseOriginNorthingGeoKey] | null;
+    projCenterLong: TiffTagGeoType[TiffTagGeo.ProjCenterLongGeoKey] | null;
+    projCenterLat: TiffTagGeoType[TiffTagGeo.ProjCenterLatGeoKey] | null;
+    projCenterEasting: TiffTagGeoType[TiffTagGeo.ProjCenterEastingGeoKey] | null;
+    projCenterNorthing: TiffTagGeoType[TiffTagGeo.ProjCenterNorthingGeoKey] | null;
+    projScaleAtNatOrigin: TiffTagGeoType[TiffTagGeo.ProjScaleAtNatOriginGeoKey] | null;
+    projScaleAtCenter: TiffTagGeoType[TiffTagGeo.ProjScaleAtCenterGeoKey] | null;
+    projAzimuthAngle: TiffTagGeoType[TiffTagGeo.ProjAzimuthAngleGeoKey] | null;
+    projStraightVertPoleLong: TiffTagGeoType[TiffTagGeo.ProjStraightVertPoleLongGeoKey] | null;
+    projRectifiedGridAngle: TiffTagGeoType[TiffTagGeo.ProjRectifiedGridAngleGeoKey] | null;
+    verticalCRS: TiffTagGeoType[TiffTagGeo.VerticalGeoKey] | null;
+    verticalCitation: TiffTagGeoType[TiffTagGeo.VerticalCitationGeoKey] | null;
+    verticalDatum: TiffTagGeoType[TiffTagGeo.VerticalDatumGeoKey] | null;
+    verticalUnits: TiffTagGeoType[TiffTagGeo.VerticalUnitsGeoKey] | null;
+};
+export declare function extractGeoKeyDirectory(image: TiffImage): GeoKeyDirectory;
+//# sourceMappingURL=ifd.d.ts.map

package/dist/ifd.d.ts.map

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

package/dist/ifd.js

@@ -0,0 +1,113 @@
+import { SampleFormat, TiffTag, TiffTagGeo } from "@cogeotiff/core";
+// TODO: use upstream: https://github.com/blacha/cogeotiff/pull/1412
+export var Predictor;
+(function (Predictor) {
+    Predictor[Predictor["None"] = 1] = "None";
+    /** Horizontal differencing */
+    Predictor[Predictor["Horizontal"] = 2] = "Horizontal";
+    /** Floating point */
+    Predictor[Predictor["FloatingPoint"] = 3] = "FloatingPoint";
+})(Predictor || (Predictor = {}));
+/** Pre-fetch TIFF tags for easier visualization. */
+export async function prefetchTags(image) {
+    // Compression is pre-fetched in init
+    const compression = image.value(TiffTag.Compression);
+    if (compression === null) {
+        throw new Error("Compression tag should always exist.");
+    }
+    const nodata = image.noData;
+    const [bitsPerSample, colorMap, photometric, planarConfiguration, predictor, sampleFormat, samplesPerPixel,] = await Promise.all([
+        image.fetch(TiffTag.BitsPerSample),
+        image.fetch(TiffTag.ColorMap),
+        image.fetch(TiffTag.Photometric),
+        image.fetch(TiffTag.PlanarConfiguration),
+        image.fetch(TiffTag.Predictor),
+        image.fetch(TiffTag.SampleFormat),
+        image.fetch(TiffTag.SamplesPerPixel),
+    ]);
+    const missingTag = (tagName) => {
+        throw new Error(`${tagName} tag should always exist.`);
+    };
+    if (bitsPerSample === null) {
+        missingTag("BitsPerSample");
+    }
+    if (samplesPerPixel === null) {
+        missingTag("SamplesPerPixel");
+    }
+    if (planarConfiguration === null) {
+        missingTag("PlanarConfiguration");
+    }
+    if (photometric === null) {
+        missingTag("Photometric");
+    }
+    return {
+        bitsPerSample: new Uint16Array(bitsPerSample),
+        colorMap: colorMap ? new Uint16Array(colorMap) : undefined,
+        compression,
+        nodata,
+        photometric,
+        planarConfiguration,
+        predictor: predictor ?? Predictor.None,
+        // Uint is the default sample format according to the spec
+        // https://web.archive.org/web/20240329145340/https://www.awaresystems.be/imaging/tiff/tifftags/sampleformat.html
+        sampleFormat: sampleFormat ?? [SampleFormat.Uint],
+        samplesPerPixel,
+    };
+}
+export function extractGeoKeyDirectory(image) {
+    const geo = (key) => image.valueGeo(key) ?? null;
+    return {
+        // Configuration keys
+        modelType: geo(TiffTagGeo.GTModelTypeGeoKey),
+        rasterType: geo(TiffTagGeo.GTRasterTypeGeoKey),
+        citation: geo(TiffTagGeo.GTCitationGeoKey),
+        // Geographic CRS keys
+        geodeticCRS: geo(TiffTagGeo.GeodeticCRSGeoKey),
+        geodeticCitation: geo(TiffTagGeo.GeodeticCitationGeoKey),
+        geodeticDatum: geo(TiffTagGeo.GeodeticDatumGeoKey),
+        primeMeridian: geo(TiffTagGeo.PrimeMeridianGeoKey),
+        linearUnits: geo(TiffTagGeo.GeogLinearUnitsGeoKey),
+        linearUnitSize: geo(TiffTagGeo.GeogLinearUnitSizeGeoKey),
+        angularUnits: geo(TiffTagGeo.GeogAngularUnitsGeoKey),
+        angularUnitSize: geo(TiffTagGeo.GeogAngularUnitSizeGeoKey),
+        ellipsoid: geo(TiffTagGeo.EllipsoidGeoKey),
+        ellipsoidSemiMajorAxis: geo(TiffTagGeo.EllipsoidSemiMajorAxisGeoKey),
+        ellipsoidSemiMinorAxis: geo(TiffTagGeo.EllipsoidSemiMinorAxisGeoKey),
+        ellipsoidInvFlattening: geo(TiffTagGeo.EllipsoidInvFlatteningGeoKey),
+        azimuthUnits: geo(TiffTagGeo.GeogAzimuthUnitsGeoKey),
+        primeMeridianLongitude: geo(TiffTagGeo.PrimeMeridianLongitudeGeoKey),
+        toWGS84: geo(TiffTagGeo.GeogTOWGS84GeoKey),
+        // Projected CRS keys
+        projectedCRS: geo(TiffTagGeo.ProjectedCRSGeoKey),
+        projectedCitation: geo(TiffTagGeo.ProjectedCitationGeoKey),
+        projection: geo(TiffTagGeo.ProjectionGeoKey),
+        projMethod: geo(TiffTagGeo.ProjMethodGeoKey),
+        projLinearUnits: geo(TiffTagGeo.ProjLinearUnitsGeoKey),
+        projLinearUnitSize: geo(TiffTagGeo.ProjLinearUnitSizeGeoKey),
+        projStdParallel1: geo(TiffTagGeo.ProjStdParallel1GeoKey),
+        projStdParallel2: geo(TiffTagGeo.ProjStdParallel2GeoKey),
+        projNatOriginLong: geo(TiffTagGeo.ProjNatOriginLongGeoKey),
+        projNatOriginLat: geo(TiffTagGeo.ProjNatOriginLatGeoKey),
+        projFalseEasting: geo(TiffTagGeo.ProjFalseEastingGeoKey),
+        projFalseNorthing: geo(TiffTagGeo.ProjFalseNorthingGeoKey),
+        projFalseOriginLong: geo(TiffTagGeo.ProjFalseOriginLongGeoKey),
+        projFalseOriginLat: geo(TiffTagGeo.ProjFalseOriginLatGeoKey),
+        projFalseOriginEasting: geo(TiffTagGeo.ProjFalseOriginEastingGeoKey),
+        projFalseOriginNorthing: geo(TiffTagGeo.ProjFalseOriginNorthingGeoKey),
+        projCenterLong: geo(TiffTagGeo.ProjCenterLongGeoKey),
+        projCenterLat: geo(TiffTagGeo.ProjCenterLatGeoKey),
+        projCenterEasting: geo(TiffTagGeo.ProjCenterEastingGeoKey),
+        projCenterNorthing: geo(TiffTagGeo.ProjCenterNorthingGeoKey),
+        projScaleAtNatOrigin: geo(TiffTagGeo.ProjScaleAtNatOriginGeoKey),
+        projScaleAtCenter: geo(TiffTagGeo.ProjScaleAtCenterGeoKey),
+        projAzimuthAngle: geo(TiffTagGeo.ProjAzimuthAngleGeoKey),
+        projStraightVertPoleLong: geo(TiffTagGeo.ProjStraightVertPoleLongGeoKey),
+        projRectifiedGridAngle: geo(TiffTagGeo.ProjRectifiedGridAngleGeoKey),
+        // Vertical CRS keys
+        verticalCRS: geo(TiffTagGeo.VerticalGeoKey),
+        verticalCitation: geo(TiffTagGeo.VerticalCitationGeoKey),
+        verticalDatum: geo(TiffTagGeo.VerticalDatumGeoKey),
+        verticalUnits: geo(TiffTagGeo.VerticalUnitsGeoKey),
+    };
+}
+//# sourceMappingURL=ifd.js.map

package/dist/ifd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifd.js","sourceRoot":"","sources":["../src/ifd.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEpE,oEAAoE;AACpE,MAAM,CAAN,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,yCAAQ,CAAA;IACR,8BAA8B;IAC9B,qDAAc,CAAA;IACd,qBAAqB;IACrB,2DAAiB,CAAA;AACnB,CAAC,EANW,SAAS,KAAT,SAAS,QAMpB;AAgBD,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAgB;IACjD,qCAAqC;IACrC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAE5B,MAAM,CACJ,aAAa,EACb,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,eAAe,EAChB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;QAClC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC7B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAChC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACxC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAC9B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QACjC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;KACrC,CAAC,CAAC;IAEH,MAAM,UAAU,GAA+B,CAAC,OAAe,EAAE,EAAE;QACjE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,2BAA2B,CAAC,CAAC;IACzD,CAAC,CAAC;IAEF,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,UAAU,CAAC,eAAe,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;QACjC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,UAAU,CAAC,aAAa,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,aAAa,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;QAC7C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,QAAoB,CAAC,CAAC,CAAC,CAAC,SAAS;QACtE,WAAW;QACX,MAAM;QACN,WAAW;QACX,mBAAmB;QACnB,SAAS,EAAG,SAAuB,IAAI,SAAS,CAAC,IAAI;QACrD,0DAA0D;QAC1D,iHAAiH;QACjH,YAAY,EAAE,YAAY,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QACjD,eAAe;KAChB,CAAC;AACJ,CAAC;AA8FD,MAAM,UAAU,sBAAsB,CAAC,KAAgB;IACrD,MAAM,GAAG,GAAG,CAAuB,GAAM,EAA4B,EAAE,CACrE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IAE9B,OAAO;QACL,qBAAqB;QACrB,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAC5C,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAC9C,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAE1C,sBAAsB;QACtB,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAC9C,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACxD,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAClD,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAClD,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,qBAAqB,CAAC;QAClD,cAAc,EAAE,GAAG,CAAC,UAAU,CAAC,wBAAwB,CAAC;QACxD,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACpD,eAAe,EAAE,GAAG,CAAC,UAAU,CAAC,yBAAyB,CAAC;QAC1D,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QAC1C,sBAAsB,EAAE,GAAG,CAAC,UAAU,CAAC,4BAA4B,CAAC;QACpE,sBAAsB,EAAE,GAAG,CAAC,UAAU,CAAC,4BAA4B,CAAC;QACpE,sBAAsB,EAAE,GAAG,CAAC,UAAU,CAAC,4BAA4B,CAAC;QACpE,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACpD,sBAAsB,EAAE,GAAG,CAAC,UAAU,CAAC,4BAA4B,CAAC;QACpE,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAE1C,qBAAqB;QACrB,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAChD,iBAAiB,EAAE,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC;QAC1D,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAC5C,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAC5C,eAAe,EAAE,GAAG,CAAC,UAAU,CAAC,qBAAqB,CAAC;QACtD,kBAAkB,EAAE,GAAG,CAAC,UAAU,CAAC,wBAAwB,CAAC;QAC5D,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACxD,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACxD,iBAAiB,EAAE,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC;QAC1D,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACxD,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACxD,iBAAiB,EAAE,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC;QAC1D,mBAAmB,EAAE,GAAG,CAAC,UAAU,CAAC,yBAAyB,CAAC;QAC9D,kBAAkB,EAAE,GAAG,CAAC,UAAU,CAAC,wBAAwB,CAAC;QAC5D,sBAAsB,EAAE,GAAG,CAAC,UAAU,CAAC,4BAA4B,CAAC;QACpE,uBAAuB,EAAE,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC;QACtE,cAAc,EAAE,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC;QACpD,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAClD,iBAAiB,EAAE,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC;QAC1D,kBAAkB,EAAE,GAAG,CAAC,UAAU,CAAC,wBAAwB,CAAC;QAC5D,oBAAoB,EAAE,GAAG,CAAC,UAAU,CAAC,0BAA0B,CAAC;QAChE,iBAAiB,EAAE,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC;QAC1D,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACxD,wBAAwB,EAAE,GAAG,CAAC,UAAU,CAAC,8BAA8B,CAAC;QACxE,sBAAsB,EAAE,GAAG,CAAC,UAAU,CAAC,4BAA4B,CAAC;QAEpE,oBAAoB;QACpB,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC;QAC3C,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,sBAAsB,CAAC;QACxD,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC;QAClD,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { RasterArray } from "./array.js";
+export { parseColormap } from "./colormap.js";
+export type { ProjJson } from "./crs.js";
+export type { DecodedPixels, Decoder, DecoderMetadata } from "./decode.js";
+export { decode, registry } from "./decode.js";
+export { GeoTIFF } from "./geotiff.js";
+export { Overview } from "./overview.js";
+export type { Tile } from "./tile.js";
+export { generateTileMatrixSet } from "./tile-matrix-set.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { parseColormap } from "./colormap.js";
+export { decode, registry } from "./decode.js";
+export { GeoTIFF } from "./geotiff.js";
+export { Overview } from "./overview.js";
+export { generateTileMatrixSet } from "./tile-matrix-set.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/overview.d.ts

@@ -0,0 +1,55 @@
+import type { TiffImage } from "@cogeotiff/core";
+import type { Affine } from "@developmentseed/affine";
+import type { ProjJson } from "./crs.js";
+import type { GeoTIFF } from "./geotiff.js";
+import type { CachedTags, GeoKeyDirectory } from "./ifd.js";
+import type { Tile } from "./tile.js";
+/**
+ * A single resolution level of a GeoTIFF — either the full-resolution image
+ * or a reduced-resolution overview.  Pairs the data IFD with its
+ * corresponding mask IFD (if any).
+ */
+export declare class Overview {
+    readonly cachedTags: CachedTags;
+    /** A reference to the parent GeoTIFF object. */
+    readonly geotiff: GeoTIFF;
+    /** The GeoKeyDirectory of the primary IFD. */
+    readonly gkd: GeoKeyDirectory;
+    /** The data IFD for this resolution level. */
+    readonly image: TiffImage;
+    /** The IFD for the mask associated with this overview level, if any. */
+    readonly maskImage: TiffImage | null;
+    constructor(geotiff: GeoTIFF, gkd: GeoKeyDirectory, image: TiffImage, maskImage: TiffImage | null, cachedTags: CachedTags);
+    get crs(): number | ProjJson;
+    get height(): number;
+    get nodata(): number | null;
+    get tileHeight(): number;
+    get tileWidth(): number;
+    get transform(): Affine;
+    get width(): number;
+    /** Fetch a single tile from the full-resolution image. */
+    fetchTile(x: number, y: number, options?: {
+        boundless?: boolean;
+        signal?: AbortSignal;
+    }): Promise<Tile>;
+    /**
+     * Get the (row, col) pixel index containing the geographic coordinate (x, y).
+     *
+     * @param x          x coordinate in the CRS.
+     * @param y          y coordinate in the CRS.
+     * @param op         Rounding function applied to fractional pixel indices.
+     *                   Defaults to Math.floor.
+     * @returns          [row, col] pixel indices.
+     */
+    index(x: number, y: number, op?: (n: number) => number): [number, number];
+    /**
+     * Get the geographic (x, y) coordinate of the pixel at (row, col).
+     *
+     * @param row        Pixel row.
+     * @param col        Pixel column.
+     * @param offset     Which part of the pixel to return.  Defaults to "center".
+     * @returns          [x, y] in the CRS.
+     */
+    xy(row: number, col: number, offset?: "center" | "ul" | "ur" | "ll" | "lr"): [number, number];
+}
+//# sourceMappingURL=overview.d.ts.map

package/dist/overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../src/overview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAE9B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAE1B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAG1C,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,UAAU,EAAE,UAAU;IASxB,IAAI,GAAG,IAAI,MAAM,GAAG,QAAQ,CAE3B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,SAAS,IAAI,MAAM,CAKtB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,0DAA0D;IACpD,SAAS,CACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAC1D,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;;;OAQG;IACH,KAAK,CACH,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAmB,GACrC,CAAC,MAAM,EAAE,MAAM,CAAC;IAInB;;;;;;;OAOG;IACH,EAAE,CACA,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAe,GACtD,CAAC,MAAM,EAAE,MAAM,CAAC;CAGpB"}

package/dist/overview.js

@@ -0,0 +1,78 @@
+import { compose, scale } from "@developmentseed/affine";
+import { fetchTile } from "./fetch.js";
+import { index, xy } from "./transform.js";
+/**
+ * A single resolution level of a GeoTIFF — either the full-resolution image
+ * or a reduced-resolution overview.  Pairs the data IFD with its
+ * corresponding mask IFD (if any).
+ */
+export class Overview {
+    cachedTags;
+    /** A reference to the parent GeoTIFF object. */
+    geotiff;
+    /** The GeoKeyDirectory of the primary IFD. */
+    gkd;
+    /** The data IFD for this resolution level. */
+    image;
+    /** The IFD for the mask associated with this overview level, if any. */
+    maskImage = null;
+    constructor(geotiff, gkd, image, maskImage, cachedTags) {
+        this.geotiff = geotiff;
+        this.gkd = gkd;
+        this.image = image;
+        this.maskImage = maskImage;
+        this.cachedTags = cachedTags;
+    }
+    get crs() {
+        return this.geotiff.crs;
+    }
+    get height() {
+        return this.image.size.height;
+    }
+    get nodata() {
+        return this.geotiff.nodata;
+    }
+    get tileHeight() {
+        return this.image.tileSize.height;
+    }
+    get tileWidth() {
+        return this.image.tileSize.width;
+    }
+    get transform() {
+        const fullTransform = this.geotiff.transform;
+        const scaleX = this.geotiff.width / this.width;
+        const scaleY = this.geotiff.height / this.height;
+        return compose(fullTransform, scale(scaleX, scaleY));
+    }
+    get width() {
+        return this.image.size.width;
+    }
+    /** Fetch a single tile from the full-resolution image. */
+    async fetchTile(x, y, options = {}) {
+        return await fetchTile(this, x, y, options);
+    }
+    /**
+     * Get the (row, col) pixel index containing the geographic coordinate (x, y).
+     *
+     * @param x          x coordinate in the CRS.
+     * @param y          y coordinate in the CRS.
+     * @param op         Rounding function applied to fractional pixel indices.
+     *                   Defaults to Math.floor.
+     * @returns          [row, col] pixel indices.
+     */
+    index(x, y, op = Math.floor) {
+        return index(this, x, y, op);
+    }
+    /**
+     * Get the geographic (x, y) coordinate of the pixel at (row, col).
+     *
+     * @param row        Pixel row.
+     * @param col        Pixel column.
+     * @param offset     Which part of the pixel to return.  Defaults to "center".
+     * @returns          [x, y] in the CRS.
+     */
+    xy(row, col, offset = "center") {
+        return xy(this, row, col, offset);
+    }
+}
+//# sourceMappingURL=overview.js.map

package/dist/overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.js","sourceRoot":"","sources":["../src/overview.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACV,UAAU,CAAa;IAEhC,gDAAgD;IACvC,OAAO,CAAU;IAE1B,8CAA8C;IACrC,GAAG,CAAkB;IAE9B,8CAA8C;IACrC,KAAK,CAAY;IAE1B,wEAAwE;IAC/D,SAAS,GAAqB,IAAI,CAAC;IAE5C,YACE,OAAgB,EAChB,GAAoB,EACpB,KAAgB,EAChB,SAA2B,EAC3B,UAAsB;QAEtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,IAAI,SAAS;QACX,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACjD,OAAO,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,SAAS,CACb,CAAS,EACT,CAAS,EACT,UAAyD,EAAE;QAE3D,OAAO,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CACH,CAAS,EACT,CAAS,EACT,KAA4B,IAAI,CAAC,KAAK;QAEtC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,EAAE,CACA,GAAW,EACX,GAAW,EACX,SAA+C,QAAQ;QAEvD,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/tile-matrix-set.d.ts

@@ -0,0 +1,36 @@
+import type { TileMatrixSet } from "@developmentseed/morecantile";
+import type { GeoTIFF } from "./geotiff.js";
+/**
+ * A minimal projection definition compatible with what wkt-parser returns.
+ *
+ * This type extracts only the partial properties we need from the full
+ * wkt-parser output.
+ */
+interface ProjectionDefinition {
+    datum?: {
+        /** Semi-major axis of the ellipsoid. */
+        a: number;
+    };
+    a?: number;
+    to_meter?: number;
+    units?: string;
+}
+/**
+ * Generate a Tile Matrix Set from a GeoTIFF file.
+ *
+ * Produces one TileMatrix per overview (coarsest first) plus a final entry
+ * for the full-resolution level. The GeoTIFF must be tiled.
+ *
+ * This requires a crs definition that includes a `units` property, so that we
+ * can convert pixel sizes to physical screen units. Use [`wkt-parser`] to parse
+ * a WKT string or PROJJSON object, then pass the result as the `crs` argument.
+ *
+ * [`wkt-parser`]: https://github.com/proj4js/wkt-parser
+ *
+ * @see https://docs.ogc.org/is/17-083r4/17-083r4.html
+ */
+export declare function generateTileMatrixSet(geotiff: GeoTIFF, crs: ProjectionDefinition, { id }?: {
+    id?: string;
+}): TileMatrixSet;
+export {};
+//# sourceMappingURL=tile-matrix-set.d.ts.map

package/dist/tile-matrix-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-matrix-set.d.ts","sourceRoot":"","sources":["../src/tile-matrix-set.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,aAAa,EACd,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;GAKG;AACH,UAAU,oBAAoB;IAC5B,KAAK,CAAC,EAAE;QACN,wCAAwC;QACxC,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA2CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,oBAAoB,EACzB,EAAE,EAAa,EAAE,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC,aAAa,CAoFf"}

package/dist/tile-matrix-set.js

@@ -0,0 +1,87 @@
+import * as affine from "@developmentseed/affine";
+import { metersPerUnit } from "@developmentseed/morecantile";
+import { v4 as uuidv4 } from "uuid";
+const SCREEN_PIXEL_SIZE = 0.28e-3;
+function buildCrs(crs) {
+    if (typeof crs === "number") {
+        return {
+            uri: `http://www.opengis.net/def/crs/EPSG/0/${crs}`,
+        };
+    }
+    // @ts-expect-error - typing issues between different projjson definitions.
+    return {
+        wkt: crs,
+    };
+}
+/**
+ * Build a TileMatrix entry for a single resolution level.
+ */
+function buildTileMatrix(id, transform, mpu, cornerOfOrigin, tileWidth, tileHeight, width, height) {
+    return {
+        id,
+        scaleDenominator: (affine.a(transform) * mpu) / SCREEN_PIXEL_SIZE,
+        cellSize: affine.a(transform),
+        cornerOfOrigin,
+        pointOfOrigin: [affine.c(transform), affine.f(transform)],
+        tileWidth,
+        tileHeight,
+        matrixWidth: Math.ceil(width / tileWidth),
+        matrixHeight: Math.ceil(height / tileHeight),
+    };
+}
+/**
+ * Generate a Tile Matrix Set from a GeoTIFF file.
+ *
+ * Produces one TileMatrix per overview (coarsest first) plus a final entry
+ * for the full-resolution level. The GeoTIFF must be tiled.
+ *
+ * This requires a crs definition that includes a `units` property, so that we
+ * can convert pixel sizes to physical screen units. Use [`wkt-parser`] to parse
+ * a WKT string or PROJJSON object, then pass the result as the `crs` argument.
+ *
+ * [`wkt-parser`]: https://github.com/proj4js/wkt-parser
+ *
+ * @see https://docs.ogc.org/is/17-083r4/17-083r4.html
+ */
+export function generateTileMatrixSet(geotiff, crs, { id = uuidv4() } = {}) {
+    const bbox = geotiff.bbox;
+    const tr = geotiff.transform;
+    // Full-resolution level is appended last.
+    if (!geotiff.isTiled) {
+        throw new Error("GeoTIFF must be tiled to generate a TMS.");
+    }
+    if (tr[1] !== 0 || tr[3] !== 0) {
+        // TileMatrixSet assumes orthogonal axes
+        throw new Error("COG TileMatrixSet with rotation/skewed geotransform is not supported");
+    }
+    // Perhaps we should allow metersPerUnit to take any string
+    const crsUnit = crs.units;
+    if (!crsUnit) {
+        throw new Error(`CRS definition must include "units" property`);
+    }
+    const semiMajorAxis = crs.a || crs.datum?.a;
+    const mpu = metersPerUnit(crsUnit, { semiMajorAxis });
+    const cornerOfOrigin = affine.e(tr) > 0 ? "bottomLeft" : "topLeft";
+    const tileMatrices = [];
+    // Overviews are sorted finest-to-coarsest; reverse to emit coarsest first.
+    const overviewsCoarseFirst = [...geotiff.overviews].reverse();
+    for (let idx = 0; idx < overviewsCoarseFirst.length; idx++) {
+        const overview = overviewsCoarseFirst[idx];
+        tileMatrices.push(buildTileMatrix(String(idx), overview.transform, mpu, cornerOfOrigin, overview.tileWidth, overview.tileHeight, overview.width, overview.height));
+    }
+    tileMatrices.push(buildTileMatrix(String(geotiff.overviews.length), tr, mpu, cornerOfOrigin, geotiff.tileWidth, geotiff.tileHeight, geotiff.width, geotiff.height));
+    const tmsCrs = buildCrs(geotiff.crs);
+    const boundingBox = {
+        lowerLeft: [bbox[0], bbox[1]],
+        upperRight: [bbox[2], bbox[3]],
+        crs: tmsCrs,
+    };
+    return {
+        title: "Generated TMS",
+        id,
+        crs: tmsCrs,
+        boundingBox,
+        tileMatrices,
+    };
+}
+//# sourceMappingURL=tile-matrix-set.js.map

package/dist/tile-matrix-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-matrix-set.js","sourceRoot":"","sources":["../src/tile-matrix-set.ts"],"names":[],"mappings":"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"}

package/dist/tile.d.ts

@@ -0,0 +1,11 @@
+import type { RasterArray } from "./array.js";
+/** A single tile fetched from a GeoTIFF or Overview. */
+export type Tile = {
+    /** Tile column index in the image's tile grid. */
+    x: number;
+    /** Tile row index in the image's tile grid. */
+    y: number;
+    /** Decoded raster data for this tile. */
+    array: RasterArray;
+};
+//# sourceMappingURL=tile.d.ts.map

package/dist/tile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.d.ts","sourceRoot":"","sources":["../src/tile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wDAAwD;AACxD,MAAM,MAAM,IAAI,GAAG;IACjB,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAC;IACV,+CAA+C;IAC/C,CAAC,EAAE,MAAM,CAAC;IACV,yCAAyC;IACzC,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC"}

package/dist/tile.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tile.js.map

package/dist/tile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.js","sourceRoot":"","sources":["../src/tile.ts"],"names":[],"mappings":""}

package/dist/transform.d.ts

@@ -0,0 +1,28 @@
+import type { Affine } from "@developmentseed/affine";
+/**
+ * Interface for objects that have an affine transform.
+ */
+export interface HasTransform {
+    /** The affine transform. */
+    readonly transform: Affine;
+}
+/**
+ * Get the (row, col) pixel index containing the geographic coordinate (x, y).
+ *
+ * @param x          x coordinate in the CRS.
+ * @param y          y coordinate in the CRS.
+ * @param op         Rounding function applied to fractional pixel indices.
+ *                   Defaults to Math.floor.
+ * @returns          [row, col] pixel indices.
+ */
+export declare function index(self: HasTransform, x: number, y: number, op?: (n: number) => number): [number, number];
+/**
+ * Get the geographic (x, y) coordinate of the pixel at (row, col).
+ *
+ * @param row        Pixel row.
+ * @param col        Pixel column.
+ * @param offset     Which part of the pixel to return.  Defaults to "center".
+ * @returns          [x, y] in the CRS.
+ */
+export declare function xy(self: HasTransform, row: number, col: number, offset?: "center" | "ul" | "ur" | "ll" | "lr"): [number, number];
+//# sourceMappingURL=transform.d.ts.map

package/dist/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,YAAY,EAClB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAmB,GACrC,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlB;AAED;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAChB,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAe,GACtD,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BlB"}

package/dist/transform.js

@@ -0,0 +1,51 @@
+import { apply, invert } from "@developmentseed/affine";
+/**
+ * Get the (row, col) pixel index containing the geographic coordinate (x, y).
+ *
+ * @param x          x coordinate in the CRS.
+ * @param y          y coordinate in the CRS.
+ * @param op         Rounding function applied to fractional pixel indices.
+ *                   Defaults to Math.floor.
+ * @returns          [row, col] pixel indices.
+ */
+export function index(self, x, y, op = Math.floor) {
+    const inv = invert(self.transform);
+    const [col, row] = apply(inv, x, y);
+    return [op(row), op(col)];
+}
+/**
+ * Get the geographic (x, y) coordinate of the pixel at (row, col).
+ *
+ * @param row        Pixel row.
+ * @param col        Pixel column.
+ * @param offset     Which part of the pixel to return.  Defaults to "center".
+ * @returns          [x, y] in the CRS.
+ */
+export function xy(self, row, col, offset = "center") {
+    let c;
+    let r;
+    switch (offset) {
+        case "center":
+            c = col + 0.5;
+            r = row + 0.5;
+            break;
+        case "ul":
+            c = col;
+            r = row;
+            break;
+        case "ur":
+            c = col + 1;
+            r = row;
+            break;
+        case "ll":
+            c = col;
+            r = row + 1;
+            break;
+        case "lr":
+            c = col + 1;
+            r = row + 1;
+            break;
+    }
+    return apply(self.transform, c, r);
+}
+//# sourceMappingURL=transform.js.map

package/dist/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAUxD;;;;;;;;GAQG;AACH,MAAM,UAAU,KAAK,CACnB,IAAkB,EAClB,CAAS,EACT,CAAS,EACT,KAA4B,IAAI,CAAC,KAAK;IAEtC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,EAAE,CAChB,IAAkB,EAClB,GAAW,EACX,GAAW,EACX,SAA+C,QAAQ;IAEvD,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IAEd,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;YACd,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;YACd,MAAM;QACR,KAAK,IAAI;YACP,CAAC,GAAG,GAAG,CAAC;YACR,CAAC,GAAG,GAAG,CAAC;YACR,MAAM;QACR,KAAK,IAAI;YACP,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YACZ,CAAC,GAAG,GAAG,CAAC;YACR,MAAM;QACR,KAAK,IAAI;YACP,CAAC,GAAG,GAAG,CAAC;YACR,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YACZ,MAAM;QACR,KAAK,IAAI;YACP,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YACZ,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YACZ,MAAM;IACV,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC"}