Version 25.9

- Added `ContentLightLevelInfo` box parsing;
- Added access to more metadata (including ColourType, GroupsListBox, etc.);
- Added `toString` summary method to image frame;
- Improved parallel processing for enhanced stability;
- Changed the way `Frames` property is calculated (altr group logic and no thumbnails);
- Changed frame properties loading to support iOS18+ files;
- Added box types used in iOS18+ files;
- Performed memory optimizations;
- API markdown fixes;
- Minor spelling fixes.

Author: Evgeniy Sidenko

README.md

@@ -16,15 +16,31 @@ Openize.HEIC has support for:
 * 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.
+* image transformations (crop, mirror, rotate), overlay images;
+* reading XML metadata.
 
 Openize.HEIC doesn't support:
 * HDR images;
-* reading EXIF and XMP metadata;
+* reading EXIF metadata;
 * color transform according to EXIF contained color profiles;
 * HEIC coded animations that use P and B slices;
 * deblocking filter.
 
+
+## New features & enhancements in version 25.9.0:
+
+- Added `ContentLightLevelInfo` box parsing;
+- Added access to more metadata (including ColourType, GroupsListBox, etc.);
+- Added `toString` summary method to image frame;
+- Improved parallel processing for enhanced stability;
+- Changed the way `Frames` property is calculated (altr group logic and no thumbnails);
+- Changed frame properties loading to support iOS18+ files;
+- Added box types used in iOS18+ files;
+- Performed memory optimizations;
+- API markdown fixes;
+- Minor spelling fixes.
+
+
 ## Usage examples
 
 ### Read .heic file to int array with argb32 data
@@ -158,9 +174,12 @@ Name | Type | Description | Parameters | Notes
 #### Properties
 Name | Type | Description
 ------------ | ------------- | ------------- 
+**Header** | **HeicHeader** | Heic image header. Grants convinient access to IsoBmff container meta data.
 **Frames** | **Map<Long, HeicImageFrame>** | Dictionary of public Heic image frames with access by identifier. 
 **AllFrames** | **Map<Long, HeicImageFrame>** | Dictionary of all Heic image frames with access by identifier. 
 **DefaultFrame** | **HeicImageFrame** | Returns the default image frame, which is specified in meta data. 
+**Width** | **long** | Width of the default image frame in pixels.
+**Height** | **long** | Height of the default image frame in pixels.
 
 ### HeicImageFrame
 
@@ -170,10 +189,12 @@ 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. | 
+**toString** | **String** | Returns a string representation of the object. | 
 
 ### Properties
 Name | Type | Description
 ------------ | ------------- | ------------- 
+**ID** | **long** | The unique identifier of the image frame.
 **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.

TestsData/samples/iphone_iOS18_tmap+MatteMaps.heic

@@ -8,7 +8,15 @@ Name | Value | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **Alpha** | - | Transparency layer. | 
 **DepthMap** | - | Depth map layer. | 
-**Hdr** | - | High dynamic range layer. | 
+**HdrGainMap** | - | High dynamic range layer.<br />Defined as "urn:com:apple:photo:2020:aux:hdrgainmap". | 
+**PortraitEffectsMatte** | - | Layer that represents the portrait effects matte of the image.<br />Defined as "urn:com:apple:photo:2018:aux:portraiteffectsmatte". | 
+**SemanticHairMatte** | - | Layer that represents the semantic segmentation hair matte of the image.<br />Defined as "urn:com:apple:photo:2019:aux:semantichairmatte". | 
+**SemanticSkinMatte** | - | Layer that represents the semantic segmentation skin matte of the image.<br />Defined as "urn:com:apple:photo:2019:aux:semanticskinmatte". | 
+**SemanticTeethMatte** | - | Layer that represents the semantic segmentation teeth matte of the image.<br />Defined as "urn:com:apple:photo:2019:aux:semanticteethmatte". | 
+**SemanticGlassesMatte** | - | Layer that represents the semantic segmentation glasses matte of the image.<br />Defined as "urn:com:apple:photo:2020:aux:semanticglassesmatte". | 
+**SemanticSkyMatte** | - | Layer that represents the semantic segmentation sky matte of the image.<br />Defined as "urn:com:apple:photo:2020:aux:semanticskymatte". | 
+**LinearThumbnail** | - | Defined as "tag:apple.com,2023:photo:aux:linearthumbnail". | 
+**StyleDeltaMap** | - | Defined as "tag:apple.com,2023:photo:aux:styledeltamap". | 
 **Undefined** | - | Undefined layer. | 
 
-[[Back to API_README]](API_README.md)
+[Back to API_README](./API_README.md)

docs/Openize.Heic.Decoder/AuxiliaryReferenceType.md

@@ -13,9 +13,9 @@ Name | Type | Description | Notes
 
 Name | Type | Description | Parameters
 ------------ | ------------- | ------------- | -------------
-**createNewImageContext** | **void** | Creates an image context object. | uint **imageId** - Image identificator.
-**deleteImageContext** | **void** | Deletes the image context object by id. | uint **imageId** - Image identificator.
-**turnOnNalUnitMode** | **void** | Turns on Nal Unit reader mode which ignores specified by standart byte sequences. | 
+**createNewImageContext** | **void** | Creates an image context object. | long **imageId** - Image identifier.
+**deleteImageContext** | **void** | Deletes the image context object by id. | long **imageId** - Image identifier.
+**turnOnNalUnitMode** | **void** | Turns on Nal Unit reader mode which ignores specified by standard byte sequences. | 
 **turnOffNulUnitMode** | **void** | Turns off Nal Unit reader mode. | 
 **read** | **int** | Reads the specified number of bits from the stream. | int **bitCount** - The required number of bits to read.
 **readString** | **String** | Reads bytes as ASCII characters until '\0'. | 

docs/Openize.Heic.Decoder/BitStreamWithNalSupport.md

@@ -7,6 +7,7 @@ Heic image header class. Grants convinient access to IsoBmff container meta data
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **Meta** | **MetaBox** | Meta data IsoBmff box. | 
+**DefaultFrameId** | **long** | The identifier of the default frame. | 
 
 ## Constructors
 

docs/Openize.Heic.Decoder/HeicHeader.md

@@ -7,6 +7,7 @@ Contains hevc coded data or meta data.
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**ID** | **long** | The unique identifier of the image frame. | 
 **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. | 
@@ -26,12 +27,15 @@ Name | Type | Description | Parameters
 **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.<br />Returns null if frame does not contain image data. In general, it equals to ***dstArray***. | **PixelFormat **<br/>***pixelFormat*** - Pixel format that defines the order of colors and the presence of alpha byte.<br />**Rectangle**<br/>***boundsRectangle*** - Bounds of the requested area.<br/>**byte[]**<br/>***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.<br />Each int value refers to one pixel left to right top to bottom line by line.<br />Returns null if frame does not contain image data. In general, it equals to ***dstArray***. | **PixelFormat**<br/>***pixelFormat*** - Pixel format that defines the order of colors.<br />**Rectangle**<br/>***boundsRectangle*** - Bounds of the requested area.<br/>**int[]**<br/>***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. |  | 
 
 ## Fields
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **hvcConfig** | **HEVCDecoderConfigurationRecord** | Hevc decoder configuration information from Isobmff container. | 
-**rawPixels** | **int[][][]** | Raw YUV pixel data. <br />Multidimantional array: chroma or luma index, then two-dimentional array with x and y navigation. | 
+**rawPixels** | **byte[][][]** | Raw YUV pixel data, used when bit depth is less or equal 8. <br />Multi-dimensional array: chroma or luma index, then two-dimensional array with x and y navigation. | 
+**rawPixelsHighColorRange** | **int[][][]** | Raw YUV pixel data, used when bit depth is greater than 8. <br />Multi-dimensional array: chroma or luma index, then two-dimensional array with x and y navigation. | 
+
 
 [[Back to API_README]](API_README.md)

docs/Openize.Heic.Decoder/HeicImageFrame.md

@@ -12,5 +12,7 @@ Name | Value | Description | Notes
 **grid** | 0x67726964 | Image Grid.<br />Reconstructing a grid of input images of the same width and height. | 
 **Exif** | 0x45786966 | Exif metadata.<br />Exchangeable image file format metadata. | 
 **mime** | 0x6d696d65 | MIME metadata.<br />Resource Description Framework metadata. | 
+**tmap** | 0x746d6170 | Tone map.<br />HDR metadata. | 
+**uri** | 0x75726920 | Uri. | 
 
 [[Back to API_README]](API_README.md)

docs/Openize.Heic.Decoder/ImageFrameType.md

@@ -5,6 +5,7 @@
  - [openize.isobmff.Box](Box.md)
  - [openize.isobmff.CleanApertureBox](CleanApertureBox.md)
  - [openize.isobmff.ColourInformationBox](ColourInformationBox.md)
+ - [Openize.IsoBmff.ContentLightLevelInfo](ContentLightLevelInfo.md)
  - [openize.isobmff.DataEntryUrlBox](DataEntryUrlBox.md)
  - [openize.isobmff.DataInformationBox](DataInformationBox.md)
  - [openize.isobmff.DataReferenceBox](DataReferenceBox.md)

docs/Openize.IsoBmff/API_README.md

@@ -3,11 +3,11 @@
 AuxiliaryTypeProperty box includes a URN identifying the type of the auxiliary image.
 AuxiliaryTypeProperty may additionally include other fields, as required by the URN.
 
-## Properties
+## Methods
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**ToString** | **String** | Text summary of the box. | 
+**toString** | **String** | Text summary of the box. | 
 
 ## Fields
 

docs/Openize.IsoBmff/AuxiliaryTypeProperty.md

@@ -3,6 +3,12 @@
 Contains colour information about the image.
 If colour information is supplied in both this box, and also in the video bitstream, this box takes precedence, and over‐rides the information in the bitstream.
 
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**ColourType** | **String** | Color type code as a string. | 
+
 ## Methods
 
 Name | Type | Description | Notes