cross-image 0.2.2 → 0.2.3

package/README.md

@@ -16,7 +16,8 @@ dependencies.
   PAM, PPM, PCX and ASCII support
 - ✂️ **Image manipulation** - Resize, crop, composite, and more
 - 🎛️ **Image processing** - Chainable filters including `brightness`,
-  `contrast`, `saturation`, `exposure`, `blur`, `sharpen`, `sepia`, and more
+  `contrast`, `saturation`, `hue`, `exposure`, `blur`, `sharpen`, `sepia`, and
+  more
 - 🖌️ **Drawing operations** - Create, fill, and manipulate pixels
 - 🧩 **Multi-frame** - Decode/encode animated GIFs, APNGs and multi-page TIFFs
 - 🔧 **Simple API** - Easy to use, intuitive interface
@@ -32,21 +33,21 @@ import { Image } from "jsr:@cross/image";
 ### Node.js
 
 ```bash
-npx jsr add @cross/image
+npm install cross-image
 ```
 
 ```ts
-import { Image } from "@cross/image";
+import { Image } from "cross-image";
 ```
 
 ### Bun
 
 ```bash
-bunx jsr add @cross/image
+npm install cross-image
 ```
 
 ```ts
-import { Image } from "@cross/image";
+import { Image } from "cross-image";
 ```
 
 ## Quick Start
@@ -123,14 +124,134 @@ See the
 [full format support documentation](https://cross-image.56k.guru/formats/) for
 detailed compatibility information.
 
+## Metadata Support
+
+@cross/image provides comprehensive EXIF 3.0 compliant metadata support for
+image files, including camera information, GPS coordinates, and InteropIFD
+compatibility markers.
+
+### Supported Metadata Fields
+
+**Basic Metadata:**
+
+- `title`, `description`, `author`, `copyright`
+- `creationDate` - Date/time image was created
+
+**Camera Settings (JPEG, TIFF, WebP via XMP):**
+
+- `cameraMake`, `cameraModel` - Camera manufacturer and model
+- `lensMake`, `lensModel` - Lens information
+- `iso` - ISO speed rating
+- `exposureTime` - Shutter speed in seconds
+- `fNumber` - Aperture (f-number)
+- `focalLength` - Focal length in mm
+- `flash`, `whiteBalance` - Capture settings
+- `orientation` - Image orientation (1=normal, 3=180°, 6=90°CW, 8=90°CCW)
+- `software` - Software used
+- `userComment` - User notes
+
+**GPS Coordinates (All EXIF formats: JPEG, PNG, WebP, TIFF):**
+
+- `latitude`, `longitude` - GPS coordinates in decimal degrees
+- Full microsecond precision with DMS (degrees-minutes-seconds) conversion
+
+**DPI (JPEG, PNG, TIFF):**
+
+- `dpiX`, `dpiY` - Dots per inch for printing
+
+### EXIF 3.0 Specification Compliance
+
+The library implements the EXIF 3.0 specification with:
+
+- **50+ Exif Sub-IFD tags** for comprehensive camera metadata
+- **30+ IFD0 tags** for image information
+- **InteropIFD support** for format compatibility (R98/sRGB, R03/Adobe RGB,
+  THM/thumbnail)
+- **GPS IFD** with proper coordinate conversion
+- All EXIF data types (BYTE, ASCII, SHORT, LONG, RATIONAL, etc.)
+
+### Example Usage
+
+```typescript
+import { Image } from "@cross/image";
+
+// Load an image
+const data = await Deno.readFile("photo.jpg");
+const image = await Image.decode(data);
+
+// Set metadata
+image.setMetadata({
+  author: "Jane Photographer",
+  copyright: "© 2024",
+  cameraMake: "Canon",
+  cameraModel: "EOS R5",
+  iso: 800,
+  exposureTime: 0.004, // 1/250s
+  fNumber: 2.8,
+  focalLength: 50,
+});
+
+// Set GPS coordinates
+image.setPosition(40.7128, -74.0060); // NYC
+
+// Check what metadata a format supports
+const jpegSupports = Image.getSupportedMetadata("jpeg");
+console.log(jpegSupports); // Includes ISO, camera info, GPS, etc.
+
+// Save with metadata
+const jpeg = await image.save("jpeg");
+await Deno.writeFile("output.jpg", jpeg);
+
+// Metadata is preserved on reload!
+const loaded = await Image.decode(jpeg);
+console.log(loaded.metadata?.cameraMake); // "Canon"
+console.log(loaded.getPosition()); // { latitude: 40.7128, longitude: -74.0060 }
+```
+
+### Format-Specific Support
+
+Use `Image.getSupportedMetadata(format)` to check which fields are supported:
+
+```typescript
+Image.getSupportedMetadata("jpeg"); // Full camera metadata + GPS (21 fields)
+Image.getSupportedMetadata("tiff"); // Comprehensive EXIF + GPS + InteropIFD (23+ fields)
+Image.getSupportedMetadata("png"); // DateTime, GPS, DPI, basic text (9 fields)
+Image.getSupportedMetadata("webp"); // Enhanced XMP + GPS (15 fields - includes camera metadata!)
+```
+
+**Format Highlights:**
+
+- **JPEG**: Most comprehensive EXIF support, including all camera settings and
+  GPS
+- **TIFF**: Full EXIF 3.0 support with IFD structure, InteropIFD compatibility
+- **WebP**: Enhanced XMP implementation with Dublin Core, EXIF, and TIFF
+  namespaces
+- **PNG**: Basic EXIF support via eXIf chunk plus GPS coordinates
+
 ## Documentation
 
 - **[API Reference](https://cross-image.56k.guru/api/)** - Complete API
   documentation
-- **[Examples](https://cross-image.56k.guru/examples/)** - Usage examples for
-  common tasks
 - **[Format Support](https://cross-image.56k.guru/formats/)** - Supported
   formats and specifications
+- **[Image Processing](https://cross-image.56k.guru/processing/)** - Filters,
+  manipulation, and color adjustments
+  - [Filters](https://cross-image.56k.guru/processing/filters/) - Blur, sharpen,
+    and noise reduction
+  - [Manipulation](https://cross-image.56k.guru/processing/manipulation/) -
+    Resize, crop, composite, and draw
+  - [Color Adjustments](https://cross-image.56k.guru/processing/color-adjustments/) -
+    Brightness, contrast, saturation, and more
+- **[Examples](https://cross-image.56k.guru/examples/)** - Practical examples
+  for common tasks
+  - [Decoding & Encoding](https://cross-image.56k.guru/examples/decoding-encoding/) -
+    Format-specific examples
+  - [Using Filters](https://cross-image.56k.guru/examples/filters/) - Filter
+    workflows and techniques
+  - [Manipulation](https://cross-image.56k.guru/examples/manipulation/) -
+    Resizing, cropping, and compositing
+  - [Multi-Frame Images](https://cross-image.56k.guru/examples/multi-frame/) -
+    Animated GIFs, APNGs, and TIFFs
 - **[JPEG Implementation](https://cross-image.56k.guru/implementation/jpeg-implementation/)** -
   Technical details for JPEG
 - **[WebP Implementation](https://cross-image.56k.guru/implementation/webp-implementation/)** -

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

@@ -1,4 +1,4 @@
-import type { ImageData, ImageFormat } from "../types.js";
+import type { ImageData, ImageFormat, ImageMetadata } from "../types.js";
 /**
  * JPEG format handler
  * Implements a basic JPEG decoder and encoder
@@ -30,6 +30,17 @@ export declare class JPEGFormat implements ImageFormat {
     private decodeUsingRuntime;
     private parseJFIF;
     private parseEXIF;
+    private parseExifSubIFD;
+    private parseGPSIFD;
+    private readRational;
     private createEXIFData;
+    private createGPSIFD;
+    private createExifSubIFD;
+    private toRational;
+    private writeRational;
+    /**
+     * Get the list of metadata fields supported by JPEG format
+     */
+    getSupportedMetadata(): Array<keyof ImageMetadata>;
 }
 //# sourceMappingURL=jpeg.d.ts.map