exifreader 4.48.1 → 4.49.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +38 -32
- package/dist/exif-reader.js +1 -1
- package/dist/exif-reader.js.map +1 -1
- package/package.json +1 -1
- package/src/exif-reader.js +241 -166
- package/src/image-header-iso-bmff.js +261 -39
- package/src/image-header-jxl.js +6 -6
- package/src/iptc-tag-names.js +35 -17
- package/src/iso-bmff-file-tags.js +86 -0
- package/src/loadview-pipeline.js +106 -28
- package/src/png-text-tags.js +88 -49
- package/src/tag-decoder.js +3 -3
- package/src/tag-names-0th-ifd.js +51 -42
- package/src/tag-names-common.js +19 -15
- package/src/tag-names-exif-ifd.js +7 -7
- package/src/tag-names-utils.js +24 -3
- package/src/tags-helpers.js +20 -0
- package/src/utils.js +66 -4
- package/src/xmp-tag-names.js +1 -1
package/README.md
CHANGED
|
@@ -23,21 +23,20 @@ You can try it out on the
|
|
|
23
23
|
|
|
24
24
|
**Support table**
|
|
25
25
|
|
|
26
|
-
| File type | Exif | IPTC
|
|
27
|
-
|
|
|
28
|
-
| JPEG | **yes** | **yes**
|
|
29
|
-
| JPEG XL*** | **yes** |
|
|
30
|
-
| TIFF | **yes** | **yes**
|
|
31
|
-
| PNG | **yes** | **yes**
|
|
32
|
-
| HEIC/HEIF | **yes** |
|
|
33
|
-
| AVIF | **yes** |
|
|
34
|
-
| WebP | **yes** |
|
|
35
|
-
| GIF | N/A | N/A
|
|
26
|
+
| File type | Exif | IPTC | XMP | ICC | MPF | Photoshop | MakerNote | Thumbnail | Image details |
|
|
27
|
+
| -----------------------|---------|------------------------------|---------|------------------------------|---------|---------------|--------------------|-----------|---------------|
|
|
28
|
+
| JPEG | **yes** | **yes** | **yes** | **yes** | **yes** | **some*** | **some**** | **yes** | **yes** |
|
|
29
|
+
| JPEG XL*** | **yes** | **yes****** | **yes** | **some****** | N/A | **some*** | **some**** | **yes** | **yes** |
|
|
30
|
+
| TIFF | **yes** | **yes** | **yes** | **yes** | N/A | **some*** | **some**** | **yes** | N/A |
|
|
31
|
+
| PNG | **yes** | **yes** | **yes** | **yes** | N/A | **some*** | **some**** | **yes** | **yes** |
|
|
32
|
+
| HEIC/HEIF | **yes** | **yes****** | **yes** | **yes** | N/A | **some*** | **some**** | **yes** | **yes** |
|
|
33
|
+
| AVIF | **yes** | **yes****** | **yes** | **yes** | N/A | **some*** | **some**** | **yes** | **yes** |
|
|
34
|
+
| WebP | **yes** | **yes****** | **yes** | **yes** | N/A | **some*** | **some**** | **yes** | **yes** |
|
|
35
|
+
| GIF | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | **yes** |
|
|
36
36
|
|
|
37
37
|
- `MakerNote` = Manufacturers' proprietary MakerNote tags.
|
|
38
38
|
- `Image details` = image width, height, etc. read from image header.
|
|
39
39
|
- `N/A` = The feature is not applicable to this file type.
|
|
40
|
-
- `???` = may be supported but has not been tested.
|
|
41
40
|
- `*` = A draft implementation of Photoshop tags have been added with
|
|
42
41
|
`ClippingPathName` and `PathInformation` currently supported. Photoshop tags
|
|
43
42
|
are very different from other tags and need a lot of extra code so they have
|
|
@@ -49,6 +48,13 @@ You can try it out on the
|
|
|
49
48
|
compression. This is supported in some environments when using
|
|
50
49
|
`async: true`. See the [Asynchronous tags](#asynchronous-tags) and
|
|
51
50
|
[Custom decompression](#custom-decompression) sections for details.
|
|
51
|
+
JPEG XL defines no MPF block. A JPEG recompressed to JPEG XL keeps its MPF
|
|
52
|
+
segment only in its JPEG reconstruction data, which ExifReader does not
|
|
53
|
+
read.
|
|
54
|
+
- `****` = Read from the Exif data, where the `IPTC-NAA` and `ICC_Profile`
|
|
55
|
+
tags can carry them, in the same way as for TIFF files. The HEIC/HEIF,
|
|
56
|
+
AVIF and WebP formats define no IPTC block of their own. The ICC profile
|
|
57
|
+
inside a JPEG XL codestream is not read.
|
|
52
58
|
|
|
53
59
|
If you're missing something that you think should be supported, file an issue
|
|
54
60
|
with an attached example image and I'll see what I can do.
|
|
@@ -279,23 +285,23 @@ For PNG, filtering is done with the `png` group only. (The `pngFile` and
|
|
|
279
285
|
`pngText` groups exist in `expanded` output today, but `png` is the filtering
|
|
280
286
|
key and those groups will be deprecated later.)
|
|
281
287
|
|
|
282
|
-
| Group key | Description
|
|
283
|
-
| ------------- |
|
|
284
|
-
| `exif` | Exif tags (including GPS IFD, interoperability).
|
|
285
|
-
| `iptc` | IPTC tags.
|
|
286
|
-
| `xmp` | XMP tags.
|
|
287
|
-
| `icc` | ICC profile tags.
|
|
288
|
-
| `photoshop` | Photoshop resource tags.
|
|
289
|
-
| `makerNotes` | MakerNote tags (e.g. Canon/Pentax).
|
|
290
|
-
| `mpf` | MPF tags.
|
|
291
|
-
| `file` | JPEG file details and `FileType`.
|
|
292
|
-
| `jfif` | JFIF tags.
|
|
293
|
-
| `png` | PNG header, chunk, and text tags.
|
|
294
|
-
| `riff` | WebP (RIFF) tags.
|
|
295
|
-
| `gif` | GIF tags.
|
|
296
|
-
| `gps` | Computed GPS group (only when `expanded: true`).
|
|
297
|
-
| `composite` | Composite tags (e.g. FieldOfView).
|
|
298
|
-
| `thumbnail` | Top-level `Thumbnail` output.
|
|
288
|
+
| Group key | Description | Supports IDs |
|
|
289
|
+
| ------------- | ----------------------------------------------------------------------------- | ------------ |
|
|
290
|
+
| `exif` | Exif tags (including GPS IFD, interoperability). | yes |
|
|
291
|
+
| `iptc` | IPTC tags. | yes |
|
|
292
|
+
| `xmp` | XMP tags. | no |
|
|
293
|
+
| `icc` | ICC profile tags. | no |
|
|
294
|
+
| `photoshop` | Photoshop resource tags. | yes |
|
|
295
|
+
| `makerNotes` | MakerNote tags (e.g. Canon/Pentax). | yes |
|
|
296
|
+
| `mpf` | MPF tags. | yes |
|
|
297
|
+
| `file` | JPEG file details, image details of JPEG XL, HEIC/HEIF and AVIF, and `FileType`. | no |
|
|
298
|
+
| `jfif` | JFIF tags. | no |
|
|
299
|
+
| `png` | PNG header, chunk, and text tags. | no |
|
|
300
|
+
| `riff` | WebP (RIFF) tags. | no |
|
|
301
|
+
| `gif` | GIF tags. | no |
|
|
302
|
+
| `gps` | Computed GPS group (only when `expanded: true`). | no |
|
|
303
|
+
| `composite` | Composite tags (e.g. FieldOfView). | no |
|
|
304
|
+
| `thumbnail` | Top-level `Thumbnail` output. | no |
|
|
299
305
|
|
|
300
306
|
**Important: dependency tags**
|
|
301
307
|
|
|
@@ -303,8 +309,8 @@ Some tags act as pointers or containers to other metadata. Excluding them can
|
|
|
303
309
|
cause other tags or entire groups to disappear. Some important examples:
|
|
304
310
|
|
|
305
311
|
- `Exif IFD Pointer`, `GPS Info IFD Pointer`, `Interoperability IFD Pointer`
|
|
306
|
-
- `IPTC-NAA` (
|
|
307
|
-
`ICC_Profile` (
|
|
312
|
+
- `IPTC-NAA` (Exif embedded IPTC), `ApplicationNotes` (Exif embedded XMP),
|
|
313
|
+
`ICC_Profile` (Exif embedded ICC)
|
|
308
314
|
- `MakerNote` and `Make` (maker note parsing)
|
|
309
315
|
- `ImageSourceData` and `PhotoshopSettings` (Photoshop parsing)
|
|
310
316
|
- `JPEGInterchangeFormat` and `JPEGInterchangeFormatLength` (thumbnails)
|
|
@@ -956,10 +962,10 @@ Possible modules to include or exclude:
|
|
|
956
962
|
| `webp` | WebP images. |
|
|
957
963
|
| `jxl` | JPEG XL images. |
|
|
958
964
|
| `gif` | GIF images. |
|
|
959
|
-
| `file` | JPEG file details: image width, height etc.
|
|
965
|
+
| `file` | JPEG file details: image width, height etc. The image details of JPEG XL, HEIC/HEIF and AVIF files come with their format module. |
|
|
960
966
|
| `jfif` | JFIF details in JPEG files: resolution, thumbnail etc. |
|
|
961
967
|
| `png_file` | PNG file details: image width, height etc. |
|
|
962
|
-
| `exif` | Regular Exif tags. If excluded, will also exclude `photoshop`, `maker_notes`, and `thumbnail`.
|
|
968
|
+
| `exif` | Regular Exif tags. If excluded, will also exclude `photoshop`, `maker_notes`, and `thumbnail`. Also excludes the IPTC, XMP and ICC tags that are read from the Exif data, which in TIFF files is all of them. |
|
|
963
969
|
| `iptc` | IPTC tags. |
|
|
964
970
|
| `xmp` | XMP tags. |
|
|
965
971
|
| `icc` | ICC color profile tags. |
|