cross-image 0.2.1 → 0.2.3

package/esm/src/formats/png_base.d.ts

@@ -76,6 +76,8 @@ export declare abstract class PNGBase {
      * Parse eXIf (EXIF) chunk
      */
     protected parseExifChunk(data: Uint8Array, metadata: ImageMetadata): void;
+    protected parseGPSIFD(data: Uint8Array, gpsIfdOffset: number, littleEndian: boolean, metadata: ImageMetadata): void;
+    protected readRational(data: Uint8Array, offset: number, littleEndian: boolean): number;
     /**
      * Create pHYs (physical pixel dimensions) chunk
      */
@@ -88,6 +90,8 @@ export declare abstract class PNGBase {
      * Create eXIf (EXIF) chunk
      */
     protected createExifChunk(metadata: ImageMetadata): Uint8Array | null;
+    protected createGPSIFD(metadata: ImageMetadata, gpsIfdStart: number): number[];
+    protected writeRational(output: number[], numerator: number, denominator: number): void;
     /**
      * Concatenate multiple byte arrays into a single Uint8Array
      */
@@ -104,5 +108,9 @@ export declare abstract class PNGBase {
      * Shared method to avoid duplication between PNG and APNG encoding
      */
     protected addMetadataChunks(chunks: Uint8Array[], metadata: ImageMetadata | undefined): void;
+    /**
+     * Get the list of metadata fields supported by PNG format
+     */
+    getSupportedMetadata(): Array<keyof ImageMetadata>;
 }
 //# sourceMappingURL=png_base.d.ts.map

package/esm/src/formats/png_base.js

@@ -315,6 +315,7 @@ export class PNGBase {
             const numEntries = littleEndian
                 ? data[ifd0Offset] | (data[ifd0Offset + 1] << 8)
                 : (data[ifd0Offset] << 8) | data[ifd0Offset + 1];
+            let gpsIfdOffset = 0;
             for (let i = 0; i < numEntries; i++) {
                 const entryOffset = ifd0Offset + 2 + i * 12;
                 if (entryOffset + 12 > data.length)
@@ -339,12 +340,96 @@ export class PNGBase {
                         }
                     }
                 }
+                // GPS IFD Pointer tag (0x8825)
+                if (tag === 0x8825) {
+                    gpsIfdOffset = littleEndian
+                        ? data[entryOffset + 8] | (data[entryOffset + 9] << 8) |
+                            (data[entryOffset + 10] << 16) | (data[entryOffset + 11] << 24)
+                        : (data[entryOffset + 8] << 24) | (data[entryOffset + 9] << 16) |
+                            (data[entryOffset + 10] << 8) | data[entryOffset + 11];
+                }
+            }
+            // Parse GPS IFD if present
+            if (gpsIfdOffset > 0 && gpsIfdOffset + 2 <= data.length) {
+                this.parseGPSIFD(data, gpsIfdOffset, littleEndian, metadata);
             }
         }
         catch (_e) {
             // Ignore EXIF parsing errors
         }
     }
+    parseGPSIFD(data, gpsIfdOffset, littleEndian, metadata) {
+        try {
+            const numEntries = littleEndian
+                ? data[gpsIfdOffset] | (data[gpsIfdOffset + 1] << 8)
+                : (data[gpsIfdOffset] << 8) | data[gpsIfdOffset + 1];
+            let latRef = "";
+            let lonRef = "";
+            let latitude;
+            let longitude;
+            for (let i = 0; i < numEntries; i++) {
+                const entryOffset = gpsIfdOffset + 2 + i * 12;
+                if (entryOffset + 12 > data.length)
+                    break;
+                const tag = littleEndian
+                    ? data[entryOffset] | (data[entryOffset + 1] << 8)
+                    : (data[entryOffset] << 8) | data[entryOffset + 1];
+                const type = littleEndian
+                    ? data[entryOffset + 2] | (data[entryOffset + 3] << 8)
+                    : (data[entryOffset + 2] << 8) | data[entryOffset + 3];
+                const valueOffset = littleEndian
+                    ? data[entryOffset + 8] | (data[entryOffset + 9] << 8) |
+                        (data[entryOffset + 10] << 16) | (data[entryOffset + 11] << 24)
+                    : (data[entryOffset + 8] << 24) | (data[entryOffset + 9] << 16) |
+                        (data[entryOffset + 10] << 8) | data[entryOffset + 11];
+                // GPSLatitudeRef (0x0001)
+                if (tag === 0x0001 && type === 2) {
+                    latRef = String.fromCharCode(data[entryOffset + 8]);
+                }
+                // GPSLatitude (0x0002)
+                if (tag === 0x0002 && type === 5 && valueOffset + 24 <= data.length) {
+                    const degrees = this.readRational(data, valueOffset, littleEndian);
+                    const minutes = this.readRational(data, valueOffset + 8, littleEndian);
+                    const seconds = this.readRational(data, valueOffset + 16, littleEndian);
+                    latitude = degrees + minutes / 60 + seconds / 3600;
+                }
+                // GPSLongitudeRef (0x0003)
+                if (tag === 0x0003 && type === 2) {
+                    lonRef = String.fromCharCode(data[entryOffset + 8]);
+                }
+                // GPSLongitude (0x0004)
+                if (tag === 0x0004 && type === 5 && valueOffset + 24 <= data.length) {
+                    const degrees = this.readRational(data, valueOffset, littleEndian);
+                    const minutes = this.readRational(data, valueOffset + 8, littleEndian);
+                    const seconds = this.readRational(data, valueOffset + 16, littleEndian);
+                    longitude = degrees + minutes / 60 + seconds / 3600;
+                }
+            }
+            // Apply hemisphere references
+            if (latitude !== undefined && latRef) {
+                metadata.latitude = latRef === "S" ? -latitude : latitude;
+            }
+            if (longitude !== undefined && lonRef) {
+                metadata.longitude = lonRef === "W" ? -longitude : longitude;
+            }
+        }
+        catch (_e) {
+            // Ignore GPS parsing errors
+        }
+    }
+    readRational(data, offset, littleEndian) {
+        const numerator = littleEndian
+            ? data[offset] | (data[offset + 1] << 8) | (data[offset + 2] << 16) |
+                (data[offset + 3] << 24)
+            : (data[offset] << 24) | (data[offset + 1] << 16) |
+                (data[offset + 2] << 8) | data[offset + 3];
+        const denominator = littleEndian
+            ? data[offset + 4] | (data[offset + 5] << 8) | (data[offset + 6] << 16) |
+                (data[offset + 7] << 24)
+            : (data[offset + 4] << 24) | (data[offset + 5] << 16) |
+                (data[offset + 6] << 8) | data[offset + 7];
+        return denominator !== 0 ? numerator / denominator : 0;
+    }
     /**
      * Create pHYs (physical pixel dimensions) chunk
      */
@@ -385,14 +470,19 @@ export class PNGBase {
                 value: new TextEncoder().encode(dateStr),
             });
         }
-        if (entries.length === 0)
+        // Check if we have GPS data
+        const hasGPS = metadata.latitude !== undefined &&
+            metadata.longitude !== undefined;
+        if (entries.length === 0 && !hasGPS)
             return null;
         const exif = [];
         exif.push(0x49, 0x49); // "II"
         exif.push(0x2a, 0x00); // 42
         exif.push(0x08, 0x00, 0x00, 0x00);
-        exif.push(entries.length & 0xff, (entries.length >> 8) & 0xff);
-        let dataOffset = 8 + 2 + entries.length * 12 + 4;
+        // Number of entries (add GPS IFD pointer if we have GPS data)
+        const ifd0Entries = entries.length + (hasGPS ? 1 : 0);
+        exif.push(ifd0Entries & 0xff, (ifd0Entries >> 8) & 0xff);
+        let dataOffset = 8 + 2 + ifd0Entries * 12 + 4;
         for (const entry of entries) {
             exif.push(entry.tag & 0xff, (entry.tag >> 8) & 0xff);
             exif.push(entry.type & 0xff, (entry.type >> 8) & 0xff);
@@ -408,6 +498,16 @@ export class PNGBase {
                 dataOffset += entry.value.length;
             }
         }
+        // Add GPS IFD pointer if we have GPS data
+        let gpsIfdOffset = 0;
+        if (hasGPS) {
+            gpsIfdOffset = dataOffset;
+            // GPS IFD Pointer tag (0x8825), type 4 (LONG), count 1
+            exif.push(0x25, 0x88); // Tag
+            exif.push(0x04, 0x00); // Type
+            exif.push(0x01, 0x00, 0x00, 0x00); // Count
+            exif.push(gpsIfdOffset & 0xff, (gpsIfdOffset >> 8) & 0xff, (gpsIfdOffset >> 16) & 0xff, (gpsIfdOffset >> 24) & 0xff);
+        }
         exif.push(0x00, 0x00, 0x00, 0x00);
         for (const entry of entries) {
             if (entry.value.length > 4) {
@@ -416,8 +516,65 @@ export class PNGBase {
                 }
             }
         }
+        // Add GPS IFD if we have GPS data
+        if (hasGPS) {
+            const gpsIfd = this.createGPSIFD(metadata, gpsIfdOffset);
+            for (const byte of gpsIfd) {
+                exif.push(byte);
+            }
+        }
         return new Uint8Array(exif);
     }
+    createGPSIFD(metadata, gpsIfdStart) {
+        const gps = [];
+        const numEntries = 4;
+        gps.push(numEntries & 0xff, (numEntries >> 8) & 0xff);
+        const latitude = metadata.latitude;
+        const longitude = metadata.longitude;
+        const absLat = Math.abs(latitude);
+        const absLon = Math.abs(longitude);
+        const latDeg = Math.floor(absLat);
+        const latMin = Math.floor((absLat - latDeg) * 60);
+        const latSec = ((absLat - latDeg) * 60 - latMin) * 60;
+        const lonDeg = Math.floor(absLon);
+        const lonMin = Math.floor((absLon - lonDeg) * 60);
+        const lonSec = ((absLon - lonDeg) * 60 - lonMin) * 60;
+        let dataOffset = gpsIfdStart + 2 + numEntries * 12 + 4;
+        // Entry 1: GPSLatitudeRef
+        gps.push(0x01, 0x00);
+        gps.push(0x02, 0x00);
+        gps.push(0x02, 0x00, 0x00, 0x00);
+        gps.push(latitude >= 0 ? 78 : 83, 0x00, 0x00, 0x00);
+        // Entry 2: GPSLatitude
+        gps.push(0x02, 0x00);
+        gps.push(0x05, 0x00);
+        gps.push(0x03, 0x00, 0x00, 0x00);
+        gps.push(dataOffset & 0xff, (dataOffset >> 8) & 0xff, (dataOffset >> 16) & 0xff, (dataOffset >> 24) & 0xff);
+        dataOffset += 24;
+        // Entry 3: GPSLongitudeRef
+        gps.push(0x03, 0x00);
+        gps.push(0x02, 0x00);
+        gps.push(0x02, 0x00, 0x00, 0x00);
+        gps.push(longitude >= 0 ? 69 : 87, 0x00, 0x00, 0x00);
+        // Entry 4: GPSLongitude
+        gps.push(0x04, 0x00);
+        gps.push(0x05, 0x00);
+        gps.push(0x03, 0x00, 0x00, 0x00);
+        gps.push(dataOffset & 0xff, (dataOffset >> 8) & 0xff, (dataOffset >> 16) & 0xff, (dataOffset >> 24) & 0xff);
+        gps.push(0x00, 0x00, 0x00, 0x00);
+        // Write rationals
+        this.writeRational(gps, latDeg, 1);
+        this.writeRational(gps, latMin, 1);
+        this.writeRational(gps, Math.round(latSec * 1000000), 1000000);
+        this.writeRational(gps, lonDeg, 1);
+        this.writeRational(gps, lonMin, 1);
+        this.writeRational(gps, Math.round(lonSec * 1000000), 1000000);
+        return gps;
+    }
+    writeRational(output, numerator, denominator) {
+        output.push(numerator & 0xff, (numerator >> 8) & 0xff, (numerator >> 16) & 0xff, (numerator >> 24) & 0xff);
+        output.push(denominator & 0xff, (denominator >> 8) & 0xff, (denominator >> 16) & 0xff, (denominator >> 24) & 0xff);
+    }
     /**
      * Concatenate multiple byte arrays into a single Uint8Array
      */
@@ -484,4 +641,20 @@ export class PNGBase {
             }
         }
     }
+    /**
+     * Get the list of metadata fields supported by PNG format
+     */
+    getSupportedMetadata() {
+        return [
+            "creationDate", // eXIf chunk
+            "latitude", // eXIf chunk (GPS IFD)
+            "longitude", // eXIf chunk (GPS IFD)
+            "dpiX", // pHYs chunk
+            "dpiY", // pHYs chunk
+            "title", // tEXt chunk
+            "author", // tEXt chunk
+            "description", // tEXt chunk
+            "copyright", // tEXt chunk
+        ];
+    }
 }

package/esm/src/formats/ppm.d.ts

@@ -0,0 +1,50 @@
+import type { ImageData, ImageFormat } from "../types.js";
+/**
+ * PPM format handler
+ * Implements the Netpbm PPM (Portable PixMap) format.
+ * This is a simple uncompressed RGB format supported by many image tools.
+ *
+ * Format structure:
+ * - P3 (ASCII format):
+ *   P3
+ *   <width> <height>
+ *   <maxval>
+ *   R G B R G B ... (space-separated decimal values)
+ *
+ * - P6 (Binary format):
+ *   P6
+ *   <width> <height>
+ *   <maxval>
+ *   RGB RGB RGB ... (binary byte data)
+ */
+export declare class PPMFormat implements ImageFormat {
+    /** Format name identifier */
+    readonly name = "ppm";
+    /** MIME type for PPM images */
+    readonly mimeType = "image/x-portable-pixmap";
+    /**
+     * Check if the given data is a PPM image
+     * @param data Raw image data to check
+     * @returns true if data has PPM signature (P3 or P6)
+     */
+    canDecode(data: Uint8Array): boolean;
+    /**
+     * Decode PPM image data to RGBA
+     * Supports both P3 (ASCII) and P6 (binary) formats
+     * @param data Raw PPM image data
+     * @returns Decoded image data with RGBA pixels
+     */
+    decode(data: Uint8Array): Promise<ImageData>;
+    /**
+     * Encode RGBA image data to PPM format (P6 binary)
+     * Note: Alpha channel is ignored as PPM doesn't support transparency
+     * @param imageData Image data to encode
+     * @returns Encoded PPM image bytes
+     */
+    encode(imageData: ImageData): Promise<Uint8Array>;
+    /**
+     * Check if a byte is whitespace (space, tab, CR, LF)
+     */
+    private isWhitespace;
+}
+//# sourceMappingURL=ppm.d.ts.map

package/esm/src/formats/ppm.js

@@ -0,0 +1,242 @@
+import { validateImageDimensions } from "../utils/security.js";
+/**
+ * PPM format handler
+ * Implements the Netpbm PPM (Portable PixMap) format.
+ * This is a simple uncompressed RGB format supported by many image tools.
+ *
+ * Format structure:
+ * - P3 (ASCII format):
+ *   P3
+ *   <width> <height>
+ *   <maxval>
+ *   R G B R G B ... (space-separated decimal values)
+ *
+ * - P6 (Binary format):
+ *   P6
+ *   <width> <height>
+ *   <maxval>
+ *   RGB RGB RGB ... (binary byte data)
+ */
+export class PPMFormat {
+    constructor() {
+        /** Format name identifier */
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "ppm"
+        });
+        /** MIME type for PPM images */
+        Object.defineProperty(this, "mimeType", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "image/x-portable-pixmap"
+        });
+    }
+    /**
+     * Check if the given data is a PPM image
+     * @param data Raw image data to check
+     * @returns true if data has PPM signature (P3 or P6)
+     */
+    canDecode(data) {
+        // Check if data has at least magic bytes
+        if (data.length < 3) {
+            return false;
+        }
+        // Check for P3 or P6 followed by whitespace
+        return data[0] === 0x50 && // P
+            (data[1] === 0x33 || data[1] === 0x36) && // 3 or 6
+            (data[2] === 0x0a || data[2] === 0x0d || data[2] === 0x20 ||
+                data[2] === 0x09); // \n, \r, space, or tab
+    }
+    /**
+     * Decode PPM image data to RGBA
+     * Supports both P3 (ASCII) and P6 (binary) formats
+     * @param data Raw PPM image data
+     * @returns Decoded image data with RGBA pixels
+     */
+    decode(data) {
+        if (!this.canDecode(data)) {
+            throw new Error("Invalid PPM signature");
+        }
+        const isBinary = data[1] === 0x36; // P6
+        // Parse header
+        let offset = 0;
+        let width = 0;
+        let height = 0;
+        let maxval = 0;
+        let headerValues = 0; // Track how many values we've parsed (need 3: width, height, maxval)
+        // Skip magic number and whitespace
+        offset = 2;
+        while (offset < data.length && this.isWhitespace(data[offset])) {
+            offset++;
+        }
+        // Parse header values (width, height, maxval)
+        while (headerValues < 3 && offset < data.length) {
+            // Skip comments (lines starting with #)
+            if (data[offset] === 0x23) { // #
+                // Skip until newline
+                while (offset < data.length && data[offset] !== 0x0a) {
+                    offset++;
+                }
+                if (offset < data.length)
+                    offset++; // Skip the newline
+                continue;
+            }
+            // Skip whitespace
+            while (offset < data.length && this.isWhitespace(data[offset])) {
+                offset++;
+            }
+            // Read number
+            let numStr = "";
+            while (offset < data.length &&
+                !this.isWhitespace(data[offset]) &&
+                data[offset] !== 0x23) {
+                numStr += String.fromCharCode(data[offset]);
+                offset++;
+            }
+            if (numStr) {
+                const num = parseInt(numStr, 10);
+                if (isNaN(num) || num <= 0) {
+                    throw new Error(`Invalid PPM header value: ${numStr}`);
+                }
+                if (headerValues === 0) {
+                    width = num;
+                }
+                else if (headerValues === 1) {
+                    height = num;
+                }
+                else if (headerValues === 2) {
+                    maxval = num;
+                }
+                headerValues++;
+            }
+        }
+        if (headerValues < 3) {
+            throw new Error("Incomplete PPM header");
+        }
+        // Skip single whitespace character after maxval (required by spec)
+        if (offset < data.length && this.isWhitespace(data[offset])) {
+            offset++;
+        }
+        // Validate dimensions
+        validateImageDimensions(width, height);
+        // Validate maxval
+        if (maxval > 255) {
+            throw new Error(`Unsupported PPM maxval: ${maxval}. Only maxval <= 255 is supported.`);
+        }
+        const pixelCount = width * height;
+        const rgba = new Uint8Array(pixelCount * 4);
+        if (isBinary) {
+            // P6: Binary format
+            const expectedDataLength = pixelCount * 3;
+            const actualDataLength = data.length - offset;
+            if (actualDataLength < expectedDataLength) {
+                throw new Error(`Invalid PPM data length: expected ${expectedDataLength}, got ${actualDataLength}`);
+            }
+            // Read RGB data and convert to RGBA
+            for (let i = 0; i < pixelCount; i++) {
+                const srcIndex = offset + i * 3;
+                const dstIndex = i * 4;
+                rgba[dstIndex] = data[srcIndex]; // R
+                rgba[dstIndex + 1] = data[srcIndex + 1]; // G
+                rgba[dstIndex + 2] = data[srcIndex + 2]; // B
+                rgba[dstIndex + 3] = 255; // A (fully opaque)
+            }
+        }
+        else {
+            // P3: ASCII format
+            let pixelIndex = 0;
+            while (pixelIndex < pixelCount * 3 && offset < data.length) {
+                // Skip whitespace and comments
+                while (offset < data.length) {
+                    if (data[offset] === 0x23) { // #
+                        // Skip comment
+                        while (offset < data.length && data[offset] !== 0x0a) {
+                            offset++;
+                        }
+                        if (offset < data.length)
+                            offset++;
+                    }
+                    else if (this.isWhitespace(data[offset])) {
+                        offset++;
+                    }
+                    else {
+                        break;
+                    }
+                }
+                // Read number
+                let numStr = "";
+                while (offset < data.length &&
+                    !this.isWhitespace(data[offset]) &&
+                    data[offset] !== 0x23) {
+                    numStr += String.fromCharCode(data[offset]);
+                    offset++;
+                }
+                if (numStr) {
+                    const value = parseInt(numStr, 10);
+                    if (isNaN(value) || value < 0 || value > maxval) {
+                        throw new Error(`Invalid PPM pixel value: ${numStr}`);
+                    }
+                    // Scale to 0-255 if needed
+                    const scaledValue = maxval === 255 ? value : Math.round((value * 255) / maxval);
+                    const component = pixelIndex % 3;
+                    const rgbaIndex = Math.floor(pixelIndex / 3) * 4;
+                    if (component === 0) {
+                        rgba[rgbaIndex] = scaledValue; // R
+                    }
+                    else if (component === 1) {
+                        rgba[rgbaIndex + 1] = scaledValue; // G
+                    }
+                    else {
+                        rgba[rgbaIndex + 2] = scaledValue; // B
+                        rgba[rgbaIndex + 3] = 255; // A
+                    }
+                    pixelIndex++;
+                }
+            }
+            if (pixelIndex < pixelCount * 3) {
+                throw new Error(`Incomplete PPM pixel data: expected ${pixelCount * 3} values, got ${pixelIndex}`);
+            }
+        }
+        return Promise.resolve({ width, height, data: rgba });
+    }
+    /**
+     * Encode RGBA image data to PPM format (P6 binary)
+     * Note: Alpha channel is ignored as PPM doesn't support transparency
+     * @param imageData Image data to encode
+     * @returns Encoded PPM image bytes
+     */
+    encode(imageData) {
+        const { width, height, data } = imageData;
+        // Validate input
+        if (data.length !== width * height * 4) {
+            throw new Error(`Data length mismatch: expected ${width * height * 4}, got ${data.length}`);
+        }
+        // Create header
+        const header = `P6\n${width} ${height}\n255\n`;
+        const encoder = new TextEncoder();
+        const headerBytes = encoder.encode(header);
+        // Create output buffer (header + RGB data)
+        const pixelCount = width * height;
+        const output = new Uint8Array(headerBytes.length + pixelCount * 3);
+        // Write header
+        output.set(headerBytes, 0);
+        // Write RGB pixel data (discard alpha channel)
+        let outputOffset = headerBytes.length;
+        for (let i = 0; i < pixelCount; i++) {
+            const srcIndex = i * 4;
+            output[outputOffset++] = data[srcIndex]; // R
+            output[outputOffset++] = data[srcIndex + 1]; // G
+            output[outputOffset++] = data[srcIndex + 2]; // B
+        }
+        return Promise.resolve(output);
+    }
+    /**
+     * Check if a byte is whitespace (space, tab, CR, LF)
+     */
+    isWhitespace(byte) {
+        return byte === 0x20 || byte === 0x09 || byte === 0x0a || byte === 0x0d;
+    }
+}

package/esm/src/formats/tiff.d.ts

@@ -1,10 +1,14 @@
-import type { ImageData, ImageFormat, MultiFrameImageData } from "../types.js";
+import type { ImageData, ImageFormat, ImageMetadata, MultiFrameImageData } from "../types.js";
 /**
  * Options for TIFF encoding
  */
 export interface TIFFEncodeOptions {
     /** Compression method: "none" for uncompressed (default), "lzw" for LZW compression */
     compression?: "none" | "lzw";
+    /** Encode as grayscale instead of RGB/RGBA */
+    grayscale?: boolean;
+    /** Encode as RGB without alpha channel (ignored if grayscale is true) */
+    rgb?: boolean;
 }
 /**
  * TIFF format handler
@@ -70,5 +74,10 @@ export declare class TIFFFormat implements ImageFormat {
      * Returns null if the TIFF uses unsupported features
      */
     private decodePureJSFromIFD;
+    /**
+     * Get list of metadata fields supported by TIFF format
+     * TIFF supports extensive EXIF metadata including GPS and InteropIFD
+     */
+    getSupportedMetadata(): Array<keyof ImageMetadata>;
 }
 //# sourceMappingURL=tiff.d.ts.map