Add support for HEIF based images

src/ImageSharp/Configuration.cs

@@ -5,6 +5,7 @@
 using SixLabors.ImageSharp.Formats;
 using SixLabors.ImageSharp.Formats.Bmp;
 using SixLabors.ImageSharp.Formats.Gif;
+using SixLabors.ImageSharp.Formats.Heif;
 using SixLabors.ImageSharp.Formats.Jpeg;
 using SixLabors.ImageSharp.Formats.Pbm;
 using SixLabors.ImageSharp.Formats.Png;
@@ -211,6 +212,7 @@ public void Configure(IImageFormatConfigurationModule configuration)
     /// <see cref="TiffConfigurationModule"/>.
     /// <see cref="WebpConfigurationModule"/>.
     /// <see cref="QoiConfigurationModule"/>.
+    /// <see cref="HeifConfigurationModule"/>.
     /// </summary>
     /// <returns>The default configuration of <see cref="Configuration"/>.</returns>
     internal static Configuration CreateDefaultInstance() => new(
@@ -222,5 +224,6 @@ public void Configure(IImageFormatConfigurationModule configuration)
             new TgaConfigurationModule(),
             new TiffConfigurationModule(),
             new WebpConfigurationModule(),
-            new QoiConfigurationModule());
+            new QoiConfigurationModule(),
+            new HeifConfigurationModule());
 }

src/ImageSharp/Formats/Heif/Heif4CharCode.cs

@@ -0,0 +1,261 @@
+// Copyright (c) Six Labors.
+// Licensed under the Six Labors Split License.
+
+// <auto-generated />
+
+using System.CodeDom.Compiler;
+
+namespace SixLabors.ImageSharp.Formats.Heif;
+
+/// <summary>
+/// Supported 4 character codes for use in HEIF images.
+/// </summary>
+[GeneratedCode("TextTemplateFileGenerator", "")]
+public enum Heif4CharCode : uint
+{
+    /// <summary>
+    /// File Type.
+    /// </summary>
+    Ftyp = 0x66747970U,
+
+    /// <summary>
+    /// Metadata.
+    /// </summary>
+    Meta = 0x6D657461U,
+
+    /// <summary>
+    /// Media Data.
+    /// </summary>
+    Mdat = 0x6D646174U,
+
+    /// <summary>
+    /// Item Information Entry.
+    /// </summary>
+    Infe = 0x696E6665U,
+
+    /// <summary>
+    /// Item Data.
+    /// </summary>
+    Idat = 0x69646174U,
+
+    /// <summary>
+    /// Item Location.
+    /// </summary>
+    Iloc = 0x696C6F63U,
+
+    /// <summary>
+    /// EXIF metadata.
+    /// </summary>
+    Exif = 0x45786966U,
+
+    /// <summary>
+    /// Data Reference.
+    /// </summary>
+    Dref = 0x64726566U,
+
+    /// <summary>
+    /// Primary Item.
+    /// </summary>
+    Pitm = 0x7069746DU,
+
+    /// <summary>
+    /// Item Spatial Extent.
+    /// </summary>
+    Ispe = 0x69737065U,
+
+    /// <summary>
+    /// Alternative text.
+    /// </summary>
+    Altt = 0x616C7474U,
+
+    /// <summary>
+    /// Colour information.
+    /// </summary>
+    Colr = 0x636F6C72U,
+
+    /// <summary>
+    /// HVC configuration.
+    /// </summary>
+    HvcC = 0x68766343U,
+
+    /// <summary>
+    /// AV1 configuration.
+    /// </summary>
+    Av1C = 0x61763143U,
+
+    /// <summary>
+    /// Image Mirror.
+    /// </summary>
+    Imir = 0x696D6972U,
+
+    /// <summary>
+    /// Image Rotation.
+    /// </summary>
+    Irot = 0x69726F74U,
+
+    /// <summary>
+    /// Image Scaling.
+    /// </summary>
+    Iscl = 0x6973636CU,
+
+    /// <summary>
+    /// Pixel Aspect Ratio.
+    /// </summary>
+    Pasp = 0x70617370U,
+
+    /// <summary>
+    /// Pixel Information.
+    /// </summary>
+    Pixi = 0x70697869U,
+
+    /// <summary>
+    /// Reference Location.
+    /// </summary>
+    Rloc = 0x726C6F63U,
+
+    /// <summary>
+    /// User Description.
+    /// </summary>
+    Udes = 0x75646573U,
+
+    /// <summary>
+    /// IPMP Control Box.
+    /// </summary>
+    Ipmc = 0x69706D63U,
+
+    /// <summary>
+    /// Item Property Container.
+    /// </summary>
+    Ipco = 0x6970636FU,
+
+    /// <summary>
+    /// Item Property Association.
+    /// </summary>
+    Ipma = 0x69706D61U,
+
+    /// <summary>
+    /// High Efficient Image Coding brand.
+    /// </summary>
+    Heic = 0x68656963U,
+
+    /// <summary>
+    /// High Efficient Image Coding brand (legacy name).
+    /// </summary>
+    Heix = 0x68656978U,
+
+    /// <summary>
+    /// High Efficient File brand.
+    /// </summary>
+    Mif1 = 0x6D696631U,
+
+    /// <summary>
+    /// AVIF brand.
+    /// </summary>
+    Avif = 0x61766966U,
+
+    /// <summary>
+    /// High Efficiency Coding tile.
+    /// </summary>
+    Hvc1 = 0x68766331U,
+
+    /// <summary>
+    /// Legacy JPEG coded tile.
+    /// </summary>
+    Jpeg = 0x6A706567U,
+
+    /// <summary>
+    /// AOMedia Video Coding tile.
+    /// </summary>
+    Av01 = 0x61763031U,
+
+    /// <summary>
+    /// Data Information.
+    /// </summary>
+    Dinf = 0x64696E66U,
+
+    /// <summary>
+    /// Group list.
+    /// </summary>
+    Grpl = 0x6772706CU,
+
+    /// <summary>
+    /// Handler.
+    /// </summary>
+    Hdlr = 0x68646C72U,
+
+    /// <summary>
+    /// Item Information.
+    /// </summary>
+    Iinf = 0x69696E66U,
+
+    /// <summary>
+    /// Item Property.
+    /// </summary>
+    Iprp = 0x69707270U,
+
+    /// <summary>
+    /// Item Protection.
+    /// </summary>
+    Ipro = 0x6970726FU,
+
+    /// <summary>
+    /// Item Reference.
+    /// </summary>
+    Iref = 0x69726566U,
+
+    /// <summary>
+    /// Grid.
+    /// </summary>
+    Grid = 0x67726964U,
+
+    /// <summary>
+    /// Derived Image.
+    /// </summary>
+    Dimg = 0x64696D67U,
+
+    /// <summary>
+    /// Thumbnail.
+    /// </summary>
+    Thmb = 0x74686D62U,
+
+    /// <summary>
+    /// Content Description.
+    /// </summary>
+    Cdsc = 0x63647363U,
+
+    /// <summary>
+    /// MIME type.
+    /// </summary>
+    Mime = 0x6D696D65U,
+
+    /// <summary>
+    /// URI.
+    /// </summary>
+    Uri  = 0x75726920U,
+
+    /// <summary>
+    /// Picture handler type.
+    /// </summary>
+    Pict = 0x70696374U,
+
+    /// <summary>
+    /// Unique Identifier.
+    /// </summary>
+    Uuid = 0x75756964U,
+
+    /// <summary>
+    /// Free space.
+    /// </summary>
+    Free = 0x66726565U,
+
+    /// <summary>
+    /// ICC Color Profile.
+    /// </summary>
+    RICC = 0x72494343U,
+
+    /// <summary>
+    /// ICC Color Profile.
+    /// </summary>
+    Prof = 0x70726F66U,
+
+}

src/ImageSharp/Formats/Heif/Heif4CharCode.tt

@@ -0,0 +1,103 @@
+<#@ template language="C#" #>
+<#@ import namespace="System.Collections.Generic" #>
+<#@ import namespace="System.Text" #>
+// Copyright (c) Six Labors.
+// Licensed under the Six Labors Split License.
+
+// <auto-generated />
+<#
+    var codes = new []{
+        "ftyp", "File Type",
+        "meta", "Metadata",
+        "mdat", "Media Data",
+        "infe", "Item Information Entry",
+        "idat", "Item Data",
+        "iloc", "Item Location",
+        "Exif", "EXIF metadata",
+        "dref", "Data Reference",
+        "pitm", "Primary Item",
+        "ispe", "Item Spatial Extent",
+        "altt", "Alternative text",
+        "colr", "Colour information",
+        "hvcC", "HVC configuration",
+        "av1C", "AV1 configuration",
+        "imir", "Image Mirror",
+        "irot", "Image Rotation",
+        "iscl", "Image Scaling",
+        "pasp", "Pixel Aspect Ratio",
+        "pixi", "Pixel Information",
+        "rloc", "Reference Location",
+        "udes", "User Description",
+        "ipmc", "IPMP Control Box",
+        "ipco", "Item Property Container",
+        "ipma", "Item Property Association",
+        "heic", "High Efficient Image Coding brand",
+        "heix", "High Efficient Image Coding brand (legacy name)",
+        "mif1", "High Efficient File brand",
+        "avif", "AVIF brand",
+        "hvc1", "High Efficiency Coding tile",
+        "jpeg", "Legacy JPEG coded tile",
+        "av01", "AOMedia Video Coding tile",
+        "dinf", "Data Information",
+        "grpl", "Group list",
+        "hdlr", "Handler",
+        "iinf", "Item Information",
+        "iprp", "Item Property",
+        "ipro", "Item Protection",
+        "iref", "Item Reference",
+        "grid", "Grid",
+        "dimg", "Derived Image",
+        "thmb", "Thumbnail",
+        "cdsc", "Content Description",
+        "mime", "MIME type",
+        "uri ", "URI",
+        "pict", "Picture handler type",
+        "uuid", "Unique Identifier",
+        "free", "Free space",
+        "rICC", "ICC Color Profile",
+        "prof", "ICC Color Profile",
+    };
+#>
+
+using System.CodeDom.Compiler;
+
+namespace SixLabors.ImageSharp.Formats.Heif;
+
+/// <summary>
+/// Supported 4 character codes for use in HEIF images.
+/// </summary>
+[GeneratedCode("TextTemplateFileGenerator", "")]
+public enum Heif4CharCode : uint
+{
+<#
+    for (int i = 0; i < codes.Length; i += 2)
+    {
+        string shortName = codes[i];
+        string longName = codes[i + 1];
+        string pascal = PascalCasing(shortName);
+        string hex = Code2Hex(shortName);
+#>
+    /// <summary>
+    /// <#= longName #>.
+    /// </summary>
+    <#= pascal #> = <#= hex #>,
+
+<#
+    }
+#>
+}
+<#+
+
+private string PascalCasing(string code)
+{
+    char firstChar = char.ToUpper(code[0], System.Globalization.CultureInfo.InvariantCulture);
+    return string.Concat(firstChar, code.Substring(1));
+}
+
+private string Code2Hex(string code)
+{
+    byte[] b = Encoding.ASCII.GetBytes(code);
+    return String.Format("0x{0:X2}{1:X2}{2:X2}{3:X2}U", b[0], b[1], b[2], b[3]);
+}
+
+#>