## New features & enhancements in version 26.5.0:

- Added support for reading EXIF metadata.
- Added support for tile mod HEIC files;
- Added format check before load.

Author: Evgeniy Sidenko

README.md

@@ -12,21 +12,27 @@ Openize.HEIC has support for:
 * HEIC coded static images;
   * I slices;
   * 4:2:0, 4:2:2 and 4:4:4 chroma subsampling.
-* HEIC coded animations that use several I slices;
+* HEIC coded animations that use several I-slices;
 * multiple images in a file;
 * alpha channels, depth maps, thumbnails, auxiliary images;
 * correct color transform according to embedded color profiles;
 * image transformations (crop, mirror, rotate), overlay images;
-* reading XML metadata.
+* reading XML metadata;
+* reading EXIF metadata.
 
 Openize.HEIC doesn't support:
 * HDR images;
-* reading EXIF metadata;
 * color transform according to EXIF contained color profiles;
-* HEIC coded animations that use P and B slices;
+* HEIC coded animations that use P and B-slices;
 * deblocking filter.
 
 
+## New features & enhancements in version 26.5.0:
+
+- Added support for reading EXIF metadata.
+- Added support for tile mod HEIC files;
+- Added format check before load.
+
 ## New features & enhancements in version 25.9.0:
 
 - Added `ContentLightLevelInfo` box parsing;
@@ -146,6 +152,17 @@ try (IOFileStream fs = new IOFileStream("filename.heic", IOMode.READ))
 }
 ```
 
+### Read .heic file exif data
+```java
+import com.drew.metadata.exif.*;
+
+try (IOFileStream fs = new IOFileStream("filename.heic", IOMode.READ))
+{
+    HeicImage image = HeicImage.load(fs);
+    Object xResolution = image.getExif().getExifRawData(ExifDirectoryType.ExifIfd0Directory, ExifIFD0Directory.TAG_X_RESOLUTION);
+}
+```
+
 ## Documentation
 
 All public classes, methods and properties are documented in corresponding API_README:
@@ -178,9 +195,9 @@ Name | Type | Description
 #### Methods
 Name | Type | Description | Parameters
 ------------ | ------------- | ------------- | -------------
-**getByteArray** | **byte[]** | Get pixel data in the format of byte array. Each three or four bytes (the count depends on the pixel format) refer to one pixel left to right top to bottom line by line. In general, it equals to `dstArray`. | `PixelFormat pixelFormat` - Pixel format that defines the order of colors and the presence of alpha byte. `Rectangle boundsRectangle` - Bounds of the requested area.<br/>`byte[] dstArray` - Byte array for storing the pixel values. If it is `null` or its length is less than necessary the new array will be allocated and returned.
-**getInt32Array** | **int[]** | Get pixel data in the format of integer array. Each int value refers to one pixel left to right top to bottom line by line. In general, it equals to `dstArray`. | `PixelFormat pixelFormat` - Pixel format that defines the order of colors. `Rectangle boundsRectangle` - Bounds of the requested area.<br/>`int[] dstArray` - Integer array for storing the argb values. If it is `null` or its length is less than necessary the new array will be allocated and returned.
-**getTextData** | **String** | Get frame text data. Exists only for mime frame types. | 
+**getByteArray** | **byte[]** | Get pixel data in the format of byte array.<br />Each three or four bytes (the count depends on the pixel format) refer to one pixel left to right top to bottom line by line. In general, it equals to `dstArray`.<br />Returns null if frame does not contain image data. | `PixelFormat pixelFormat` - Pixel format that defines the order of colors and the presence of alpha byte.<br />`Rectangle boundsRectangle` - Bounds of the requested area.<br/>`byte[] dstArray` - Byte array for storing the pixel values. If it is `null` or its length is less than necessary the new array will be allocated and returned.
+**getInt32Array** | **int[]** | Get pixel data in the format of integer array. Each int value refers to one pixel left to right top to bottom line by line. In general, it equals to `dstArray`.<br />Returns null if frame does not contain image data. | `PixelFormat pixelFormat` - Pixel format that defines the order of colors.<br />`Rectangle boundsRectangle` - Bounds of the requested area.<br/>`int[] dstArray` - Integer array for storing the argb values. If it is `null` or its length is less than necessary the new array will be allocated and returned.
+**getTextData** | **String** | Get frame text data.<br />Exists only for mime frame types. | 
 **toString** | **String** | Returns a string representation of the object. | 
 
 ### Properties
@@ -190,23 +207,25 @@ Name | Type | Description
 **ImageType** | **ImageFrameType** | Type of an image frame content.
 **Width** | **long** | Width of the image frame in pixels. 
 **Height** | **long** | Height of the image frame in pixels.
-**HasAlpha** | **boolean** | Indicates the presence of transparency of transparency layer. True if frame is linked with alpha data frame, false otherwise.
-**IsHidden** | **boolean** | Indicates the fact that frame is marked as hidden. True if frame is hidden, false otherwise.
-**IsImage** | **boolean** | Indicates the fact that frame contains image data. True if frame is image, false otherwise.
-**IsDerived** | **boolean** | Indicates the fact that frame contains image transform data and is inherited from another frame(-s). True if frame is derived, false otherwise.
+**HasAlpha** | **boolean** | Indicates the presence of transparency of transparency layer.<br />True if frame is linked with alpha data frame, false otherwise.
+**IsHidden** | **boolean** | Indicates the fact that frame is marked as hidden.<br />True if frame is hidden, false otherwise.
+**IsImage** | **boolean** | Indicates the fact that frame contains image data.<br />True if frame is image, false otherwise.
+**IsDerived** | **boolean** | Indicates the fact that frame contains image transform data and is inherited from another frame(-s).<br />True if frame is derived, false otherwise.
 **DerivativeType** | **BoxType** | Indicates the type of derivative content if the frame is derived.
 **AuxiliaryReferenceType** | **AuxiliaryReferenceType** | Indicates the type of auxiliary reference layer if the frame type is auxiliary.
 **NumberOfChannels** | **byte** | Number of channels with color data.
 **BitsPerChannel** | **byte[]** | Bits per channel with color data.
 
 ## License
-Openize.HEIC is available under [Openize License](https://github.com/openize-heic/Openize.HEIC-for-Java/blob/main/LICENSE).
+Openize.HEIC is available under [Openize License](LICENSE).
 > [!CAUTION]
 > Openize does not and cannot grant You a patent license for the utilization of HEVC/H.265 image compression/decompression technologies.
 
-Openize.HEIC uses Openize.IsoBmff that is distributed under [MIT License](https://github.com/openize-heic/Openize.HEIC-for-Java/blob/main/licenses/Openize.IsoBmff/LICENSE).
+Openize.HEIC uses Openize.IsoBmff that is distributed under [MIT License](/Openize.IsoBmff/LICENSE).
+
+Openize.HEIC uses [MetadataExtractor](https://github.com/drewnoakes/metadata-extractor) that is distributed under [Apache-2.0 license](https://github.com/drewnoakes/metadata-extractor?tab=Apache-2.0-1-ov-file#readme).
 
 ## OSS Notice
-Sample files used for tests and located in the "https://github.com/openize-heic/Openize.HEIC-for-Java/blob/main/Openize.Heic.Tests/TestsData/samples/nokia" folder belong to Nokia Technologies and are used according to [Nokia High-Efficiency Image File Format (HEIF) License](https://github.com/nokiatech/heif/blob/master/LICENSE.TXT)
+Sample files used for tests and located in the "./Openize.Heic.Tests/TestsData/samples/nokia" folder belong to Nokia Technologies and are used according to [Nokia High-Efficiency Image File Format (HEIF) License](https://github.com/nokiatech/heif/blob/master/LICENSE.TXT)
 
 > Licensed Field means the non-commercial purposes of evaluation, testing and academic research in each non-commercial case to use, run, modify (in a way that still complies with the Specification) and copy the Software to (a) generate, using one or more encoded pictures as inputs, a file complying with the Specification and including the one or more encoded pictures that were given as inputs; and/or (b) read a file complying with the Specification, resulting into one or more encoded pictures included in the file as outputs.

docs/Openize.Heic.Decoder/API_README.md

@@ -1,16 +1,18 @@
-<a name="documentation-for-models"></a>
-## Documentation for Models
-
- - [openize.heic.decoder.AuxiliaryReferenceType](AuxiliaryReferenceType.md)
- - [openize.heic.decoder.HeicHeader](HeicHeader.md)
- - [openize.heic.decoder.HeicImage](HeicImage.md)
- - [openize.heic.decoder.HeicImageFrame](HeicImageFrame.md)
- - [openize.heic.decoder.ImageFrameType](ImageFrameType.md)
- - [openize.heic.decoder.io.BitStreamWithNalSupport](BitStreamWithNalSupport.md)
- - [openize.heic.Decoder.PixelFormat](PixelFormat.md)
- - [openize.MathUtils](MathUtils.md)
- - [openize.io.IOSeekMode](IOSeekMode.md)
- - [openize.io.IOStream](IOStream.md)
- - [openize.io.IOMode](IOMode.md)
- - [openize.io.IOException](IOException.md)
+<a name="documentation-for-models"></a>
+## Documentation for Models
+
+ - [openize.heic.decoder.AuxiliaryReferenceType](AuxiliaryReferenceType.md)
+ - [openize.heic.decoder.ExifData](ExifData.md)
+ - [openize.heic.decoder.ExifDirectoryType](ExifDirectoryType.md)
+ - [openize.heic.decoder.HeicHeader](HeicHeader.md)
+ - [openize.heic.decoder.HeicImage](HeicImage.md)
+ - [openize.heic.decoder.HeicImageFrame](HeicImageFrame.md)
+ - [openize.heic.decoder.ImageFrameType](ImageFrameType.md)
+ - [openize.heic.decoder.io.BitStreamWithNalSupport](BitStreamWithNalSupport.md)
+ - [openize.heic.Decoder.PixelFormat](PixelFormat.md)
+ - [openize.MathUtils](MathUtils.md)
+ - [openize.io.IOSeekMode](IOSeekMode.md)
+ - [openize.io.IOStream](IOStream.md)
+ - [openize.io.IOMode](IOMode.md)
+ - [openize.io.IOException](IOException.md)
  - [openize.io.IOFileStream](IOFileStream.md)

docs/Openize.Heic.Decoder/ExifData.md

@@ -0,0 +1,29 @@
+# openize.heic.decoder.ExifData
+
+Exchangeable image file format class.
+Grants access to raw EXIF-data and to data by specific tags.
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**DirectoriesList** | **List<com.drew.metadata.Directory>** | List of EXIF directories in frame. | 
+**TagList** | **List<com.drew.metadata.Tag>** | List of all tags that present in directories. | 
+**RawBytes** | **byte[]** | Raw EXIF data in bytes. | 
+
+## Constructors
+
+Name | Description | Parameters
+------------ | ------------- | -------------
+**ExifData** | Create EXIF-data object. | **BitStreamWithNalSupport** <b>stream</b> - File stream.<br />**HeicImage** <b>image</b> - Parent heic image.<br />**HeicImageFrame** <b>exifFrame</b> - EXIF HEIC frame.
+
+## Methods
+
+Name | Type | Description | Parameters
+------------ | ------------- | ------------- | -------------
+**getExifRawData<T>** | **&lt;T&gt;** | Returns the string value for the particular tag type and the directory specified as a class. | **Class&lt;T&gt;** **dirType** - The directory class.<br/> int <b>tagType</b> - The tag type identifier. | 
+**getExifRawData** | **Object** | Returns the raw value for the particular tag type and the directory specified as a class. | int <b>tagType</b> - The tag type identifier. | 
+**getExifString&lt;T&gt;** | **String** | Returns the string value for the particular tag type and the directory specified as a parameter. |  **Class&lt;T&gt;** **dirType** - The directory class.<br/>ExifDirectoryType <b>dirType</b> - The directory type identifier.<br />int <b>tagType</b> - The tag type identifier. | 
+**getExifString** | **String** | Returns the string value for the particular tag type and the directory specified as a parameter. | ExifDirectoryType <b>dirType</b> - The directory type identifier.<br />int <b>tagType</b> - The tag type identifier. | 
+
+[[Back to API_README]](API_README.md)

docs/Openize.Heic.Decoder/ExifDirectoryType.md

@@ -0,0 +1,103 @@
+# openize.heic.decoder.ExifDirectoryType
+
+Type of an EXIF directory.
+
+## Enumeration
+
+Name | Description 
+------------ | ------------- 
+**ExifIfd0Directory** | IFD0 directory.
+**ExifImageDirectory** | One of several EXIF directories.<br />Holds information about image IFD's in a chain after the first.
+**ExifInteropDirectory** | EXIF interoperability tags directory.
+**ExifSubIfdDirectory** | SubIFD directory.
+**ExifThumbnailDirectory** | IFD1 directory. Holds information about an embedded thumbnail image.
+**GpsDirectory** | GPS EXIF tags directory.
+**AdobeJpegDirectory** | Directory for image encoding information for DCT filters, as stored by Adobe.
+**AppleMakernoteDirectory** | Directory for tags specific to Apple cameras.
+**AviDirectory** | Directory for basic metadata for Avi files.
+**BmpHeaderDirectory** | Directory for basic metadata for Bmp files.
+**CanonMakernoteDirectory** | Directory for tags specific to Canon cameras.
+**CasioType1MakernoteDirectory** | Directory for tags specific to Casio (type 1) cameras.
+**CasioType2MakernoteDirectory** | Directory for tags specific to Casio (type 2) cameras.
+**DjiMakernoteDirectory** | Directory for tags specific to DJI aircraft cameras.
+**DuckyDirectory** | Directory for tags from Photoshop "ducky" segments.
+**EpsDirectory** | Directory for basic metadata for EPS files.
+**ErrorDirectory** | Directory for the reporting of errors.
+**FileMetadataDirectory** | Directory for OS tags.
+**FileTypeDirectory** | Directory for tags derived from filename.
+**FlirCameraInfoDirectory** | Directory for camera info tags specific to FLIR cameras.
+**FlirHeaderDirectory** | Directory for header tags specific to FLIR cameras.
+**FlirMakernoteDirectory** | Directory for tags specific to FLIR cameras.
+**FlirRawDataDirectory** | Directory for raw tags specific to FLIR cameras.
+**FujifilmMakernoteDirectory** | Directory for tags specific to Fujifilm cameras.
+**GeoTiffDirectory** | Directory for tiff geo tags.
+**GifAnimationDirectory** | Directory for animation metadata for Gif files.
+**GifCommentDirectory** | Directory for comment metadata for Gif files.
+**GifControlDirectory** | Directory for control metadata for Gif files.
+**GifHeaderDirectory** | Directory for header metadata for Gif files.
+**GifImageDirectory** | Directory for basic metadata for Gif files.
+**HeicImagePropertiesDirectory** | Directory for basic metadata for Heic files.
+**HeicThumbnailDirectory** | Directory for basic metadata for Heic thumbnails.
+**HuffmanTablesDirectory** | Directory of tables for the DHT (Define Huffman Table(s)) segment.
+**IccDirectory** | Directory for basic metadata for Icc files.
+**IcoDirectory** | Directory for basic metadata for Ico files.
+**IptcDirectory** | Directory for tags used by the International Press Telecommunications Council (IPTC) metadata format.
+**JfifDirectory** | Directory for basic metadata for Jfif files.
+**JfxxDirectory** | Directory for basic metadata for Jfxx files.
+**JpegCommentDirectory** | Directory for comment metadata for Jpeg files.
+**JpegDirectory** | Directory for basic metadata for Jpeg files.
+**JpegDnlDirectory** | Directory for DNL metadata for Jpeg files.
+**KodakMakernoteDirectory** | Directory for tags specific to Kodak cameras.
+**KyoceraMakernoteDirectory** | Directory for tags specific to Kyocera cameras.
+**LeicaMakernoteDirectory** | Directory for tags specific to Leica cameras.
+**LeicaType5MakernoteDirectory** | Directory for tags specific to Leica (type 5) cameras.
+**Mp3Directory** | Directory for basic metadata for Mp3 files.
+**NetpbmHeaderDirectory** | Directory for header metadata for Netpbm files.
+**NikonPictureControl1Directory** | Directory for picture control tags specific to Nikon (type 1) cameras.
+**NikonPictureControl2Directory** | Directory for picture control tags specific to Nikon (type 1) cameras.
+**NikonType1MakernoteDirectory** | Directory for tags specific to Nikon (type 1) cameras.
+**NikonType2MakernoteDirectory** | Directory for tags specific to Nikon (type 1) cameras.
+**OlympusCameraSettingsMakernoteDirectory** | Directory for camera settings tags specific to Olympus cameras (Epson, Konica, Minolta and Agfa...).
+**OlympusEquipmentMakernoteDirectory** | Directory for equipment tags specific to Olympus cameras (Epson, Konica, Minolta and Agfa...).
+**OlympusFocusInfoMakernoteDirectory** | Directory for focus info tags specific to Olympus cameras (Epson, Konica, Minolta and Agfa...).
+**OlympusImageProcessingMakernoteDirectory** | Directory for image processing tags specific to Olympus cameras (Epson, Konica, Minolta and Agfa...).
+**OlympusMakernoteDirectory** | Directory for tags specific to Olympus cameras (Epson, Konica, Minolta and Agfa...).
+**OlympusRawDevelopment2MakernoteDirectory** | Directory for raw development 2 makernotes specific to Olympus cameras (Epson, Konica, Minolta and Agfa...).
+**OlympusRawDevelopmentMakernoteDirectory** | Directory for raw development 2 makernotes specific to Olympus cameras (Epson, Konica, Minolta and Agfa...).
+**OlympusRawInfoMakernoteDirectory** | Directory for raw info makernotes tags specific to Olympus cameras (Epson, Konica, Minolta and Agfa...).
+**PanasonicMakernoteDirectory** | Directory for tags specific to Panasonic cameras.
+**PanasonicRawDistortionDirectory** | Directory for raw distortion tags specific to Panasonic cameras.
+**PanasonicRawIfd0Directory** | Directory for raw Ifd0 tags specific to Panasonic cameras.
+**PanasonicRawWbInfo2Directory** | Directory for raw info tags specific to Panasonic cameras.
+**PanasonicRawWbInfoDirectory** | Directory for raw info tags specific to Panasonic cameras.
+**PcxDirectory** | Directory for basic metadata for Pcx files.
+**PentaxMakernoteDirectory** | Directory for tags specific to Pentax cameras.
+**PentaxType2MakernoteDirectory** | Directory for tags specific to Pentax (type 2) cameras.
+**PhotoshopDirectory** | Directory for the metadata found in the APPD segment of a JPEG file saved by Photoshop.
+**PngChromaticitiesDirectory** | Directory for chromaticities metadata for Png files.
+**PngDirectory** | Directory for basic metadata for Png files.
+**PrintIMDirectory** | Directory for Epson proprietary metadata.
+**PsdHeaderDirectory** | Directory for header metadata for Psd files.
+**QuickTimeFileTypeDirectory** | Directory for QuickTime file type metadata.
+**QuickTimeMetadataHeaderDirectory** | Directory for QuickTime metadata header tags.
+**QuickTimeMovieHeaderDirectory** | Directory for QuickTime movie header tags.
+**QuickTimeTrackHeaderDirectory** | Directory for QuickTime track header metadata.
+**ReconyxHyperFire2MakernoteDirectory** | Directory for tags specific to Reconyx HyperFire 2 cameras.
+**ReconyxHyperFireMakernoteDirectory** | Directory for tags specific to Reconyx HyperFire cameras.
+**ReconyxUltraFireMakernoteDirectory** | Directory for tags specific to Reconyx UltraFire cameras.
+**RicohMakernoteDirectory** | Directory for tags specific to Ricoh cameras.
+**SamsungType2MakernoteDirectory** | Directory for tags specific to certain 'newer' Samsung cameras.
+**SanyoMakernoteDirectory** | Directory for tags specific to Sanyo cameras.
+**SigmaMakernoteDirectory** | Directory for tags specific to Sigma cameras.
+**SonyType1MakernoteDirectory** | Directory for tags specific to Sony (type 1) cameras.
+**SonyType6MakernoteDirectory** | Directory for tags specific to Sony (type 6) cameras.
+**TgaDeveloperDirectory** | Directory for developer metadata for Tga files.
+**TgaExtensionDirectory** | Directory for extention metadata for Tga files.
+**TgaHeaderDirectory** | Directory for header metadata for Tga files.
+**WavFactDirectory** | Directory for fact metadata for Wav files.
+**WavFormatDirectory** | Directory for format metadata for Wav files.
+**WebPDirectory** | Directory for basic metadata for WebP files.
+**XmpDirectory** | Directory for basic metadata for Xmp files.
+**Undefined** | Undefined directory.
+
+[[Back to API_README]](API_README.md)