From dbc5c76eb1e43a694b34eb616c547121be8952ea Mon Sep 17 00:00:00 2001
From: James Jackson-South <james_south@hotmail.com>
Date: Sun, 8 Sep 2019 22:49:42 +1000
Subject: [PATCH 1/2] Fix #1004

---
 src/ImageSharp/Formats/Png/PngDecoderCore.cs  |  38 ++++++++++++++----
 .../Formats/Png/Zlib/ZlibInflateStream.cs     |  36 +++++++++++++----
 .../Formats/Png/PngDecoderTests.cs            |   3 +-
 tests/ImageSharp.Tests/TestImages.cs          |   1 +
 .../Images/Input/Png/zlib-ztxt-bad-header.png | Bin 0 -> 22781 bytes
 5 files changed, 61 insertions(+), 17 deletions(-)
 create mode 100644 tests/Images/Input/Png/zlib-ztxt-bad-header.png

diff --git a/src/ImageSharp/Formats/Png/PngDecoderCore.cs b/src/ImageSharp/Formats/Png/PngDecoderCore.cs
index 9bc5a5079..a9e588f6e 100644
--- a/src/ImageSharp/Formats/Png/PngDecoderCore.cs
+++ b/src/ImageSharp/Formats/Png/PngDecoderCore.cs
@@ -175,11 +175,18 @@ namespace SixLabors.ImageSharp.Formats.Png
                                     this.InitializeImage(metadata, out image);
                                 }
 
-                                using (var deframeStream = new ZlibInflateStream(this.currentStream, this.ReadNextDataChunk))
+                                var deframeStream = new ZlibInflateStream(this.currentStream, this.ReadNextDataChunk);
+                                try
                                 {
-                                    deframeStream.AllocateNewBytes(chunk.Length);
+                                    deframeStream.AllocateNewBytes(chunk.Length, true);
                                     this.ReadScanlines(deframeStream.CompressedStream, image.Frames.RootFrame, pngMetadata);
                                 }
+                                finally
+                                {
+                                    // If an invalid Zlib stream is discovered the decoder will throw an exception
+                                    // due to the critical nature of the data chunk.
+                                    deframeStream.Dispose();
+                                }
 
                                 break;
                             case PngChunkType.Palette:
@@ -924,7 +931,11 @@ namespace SixLabors.ImageSharp.Formats.Png
             }
 
             ReadOnlySpan<byte> compressedData = data.Slice(zeroIndex + 2);
-            metadata.TextData.Add(new PngTextData(name, this.UncompressTextData(compressedData, PngConstants.Encoding), string.Empty, string.Empty));
+
+            if (this.TryUncompressTextData(compressedData, PngConstants.Encoding, out string uncompressed))
+            {
+                metadata.TextData.Add(new PngTextData(name, uncompressed, string.Empty, string.Empty));
+            }
         }
 
         /// <summary>
@@ -987,7 +998,11 @@ namespace SixLabors.ImageSharp.Formats.Png
             if (compressionFlag == 1)
             {
                 ReadOnlySpan<byte> compressedData = data.Slice(dataStartIdx);
-                metadata.TextData.Add(new PngTextData(keyword, this.UncompressTextData(compressedData, PngConstants.TranslatedEncoding), language, translatedKeyword));
+
+                if (this.TryUncompressTextData(compressedData, PngConstants.TranslatedEncoding, out string uncompressed))
+                {
+                    metadata.TextData.Add(new PngTextData(keyword, uncompressed, language, translatedKeyword));
+                }
             }
             else
             {
@@ -1001,13 +1016,19 @@ namespace SixLabors.ImageSharp.Formats.Png
         /// </summary>
         /// <param name="compressedData">Compressed text data bytes.</param>
         /// <param name="encoding">The string encoding to use.</param>
-        /// <returns>A string.</returns>
-        private string UncompressTextData(ReadOnlySpan<byte> compressedData, Encoding encoding)
+        /// <param name="value">The uncompressed value.</param>
+        /// <returns>The <see cref="bool"/>.</returns>
+        private bool TryUncompressTextData(ReadOnlySpan<byte> compressedData, Encoding encoding, out string value)
         {
             using (var memoryStream = new MemoryStream(compressedData.ToArray()))
             using (var inflateStream = new ZlibInflateStream(memoryStream, () => 0))
             {
-                inflateStream.AllocateNewBytes(compressedData.Length);
+                if (!inflateStream.AllocateNewBytes(compressedData.Length, false))
+                {
+                    value = null;
+                    return false;
+                }
+
                 var uncompressedBytes = new List<byte>();
 
                 // Note: this uses the a buffer which is only 4 bytes long to read the stream, maybe allocating a larger buffer makes sense here.
@@ -1018,7 +1039,8 @@ namespace SixLabors.ImageSharp.Formats.Png
                     bytesRead = inflateStream.CompressedStream.Read(this.buffer, 0, this.buffer.Length);
                 }
 
-                return encoding.GetString(uncompressedBytes.ToArray());
+                value = encoding.GetString(uncompressedBytes.ToArray());
+                return true;
             }
         }
 
diff --git a/src/ImageSharp/Formats/Png/Zlib/ZlibInflateStream.cs b/src/ImageSharp/Formats/Png/Zlib/ZlibInflateStream.cs
index 405eeafeb..df0e72332 100644
--- a/src/ImageSharp/Formats/Png/Zlib/ZlibInflateStream.cs
+++ b/src/ImageSharp/Formats/Png/Zlib/ZlibInflateStream.cs
@@ -87,13 +87,17 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
         /// Adds new bytes from a frame found in the original stream
         /// </summary>
         /// <param name="bytes">blabla</param>
-        public void AllocateNewBytes(int bytes)
+        /// <param name="isCriticalChunk">Whether the chunk to be inflated is a critical chunk.</param>
+        /// <returns>The <see cref="bool"/>.</returns>
+        public bool AllocateNewBytes(int bytes, bool isCriticalChunk)
         {
             this.currentDataRemaining = bytes;
             if (this.compressedStream is null)
             {
-                this.InitializeInflateStream();
+                return this.InitializeInflateStream(isCriticalChunk);
             }
+
+            return true;
         }
 
         /// <inheritdoc/>
@@ -197,7 +201,7 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
             this.isDisposed = true;
         }
 
-        private void InitializeInflateStream()
+        private bool InitializeInflateStream(bool isCriticalChunk)
         {
             // Read the zlib header : http://tools.ietf.org/html/rfc1950
             // CMF(Compression Method and flags)
@@ -215,7 +219,7 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
             this.currentDataRemaining -= 2;
             if (cmf == -1 || flag == -1)
             {
-                return;
+                return false;
             }
 
             if ((cmf & 0x0F) == 8)
@@ -225,14 +229,28 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
 
                 if (cinfo > 7)
                 {
-                    // Values of CINFO above 7 are not allowed in RFC1950.
-                    // CINFO is not defined in this specification for CM not equal to 8.
-                    throw new ImageFormatException($"Invalid window size for ZLIB header: cinfo={cinfo}");
+                    if (isCriticalChunk)
+                    {
+                        // Values of CINFO above 7 are not allowed in RFC1950.
+                        // CINFO is not defined in this specification for CM not equal to 8.
+                        throw new ImageFormatException($"Invalid window size for ZLIB header: cinfo={cinfo}");
+                    }
+                    else
+                    {
+                        return false;
+                    }
                 }
             }
             else
             {
-                throw new ImageFormatException($"Bad method for ZLIB header: cmf={cmf}");
+                if (isCriticalChunk)
+                {
+                    throw new ImageFormatException($"Bad method for ZLIB header: cmf={cmf}");
+                }
+                else
+                {
+                    return false;
+                }
             }
 
             // The preset dictionary.
@@ -247,6 +265,8 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
 
             // Initialize the deflate Stream.
             this.compressedStream = new DeflateStream(this, CompressionMode.Decompress, true);
+
+            return true;
         }
     }
 }
diff --git a/tests/ImageSharp.Tests/Formats/Png/PngDecoderTests.cs b/tests/ImageSharp.Tests/Formats/Png/PngDecoderTests.cs
index 2e9fd7481..91b1ef2c1 100644
--- a/tests/ImageSharp.Tests/Formats/Png/PngDecoderTests.cs
+++ b/tests/ImageSharp.Tests/Formats/Png/PngDecoderTests.cs
@@ -40,7 +40,8 @@ namespace SixLabors.ImageSharp.Tests.Formats.Png
             TestImages.Png.GrayAlpha8Bit,
             TestImages.Png.Gray1BitTrans,
             TestImages.Png.Bad.ZlibOverflow,
-            TestImages.Png.Bad.ZlibOverflow2
+            TestImages.Png.Bad.ZlibOverflow2,
+            TestImages.Png.Bad.ZlibZtxtBadHeader,
         };
 
         public static readonly string[] TestImages48Bpp =
diff --git a/tests/ImageSharp.Tests/TestImages.cs b/tests/ImageSharp.Tests/TestImages.cs
index e95ce0907..163d09bdd 100644
--- a/tests/ImageSharp.Tests/TestImages.cs
+++ b/tests/ImageSharp.Tests/TestImages.cs
@@ -90,6 +90,7 @@ namespace SixLabors.ImageSharp.Tests
                 public const string CorruptedChunk = "Png/big-corrupted-chunk.png";
                 public const string ZlibOverflow = "Png/zlib-overflow.png";
                 public const string ZlibOverflow2 = "Png/zlib-overflow2.png";
+                public const string ZlibZtxtBadHeader = "Png/zlib-ztxt-bad-header.png";
             }
 
             public static readonly string[] All =
diff --git a/tests/Images/Input/Png/zlib-ztxt-bad-header.png b/tests/Images/Input/Png/zlib-ztxt-bad-header.png
new file mode 100644
index 0000000000000000000000000000000000000000..c13f98fd16ed8318e88c2e550f31cca566aabdf9
GIT binary patch
literal 22781
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
NKp2?lzl7h3{3lL=9&`Wz

literal 0
HcmV?d00001


From 221000ed036ea81a093cfe7733e532ae648d7e90 Mon Sep 17 00:00:00 2001
From: James Jackson-South <james_south@hotmail.com>
Date: Tue, 10 Sep 2019 17:34:14 +1000
Subject: [PATCH 2/2] Clean up scanline decoding code.

---
 src/ImageSharp/Formats/Png/PngDecoderCore.cs  | 38 ++++++++----------
 .../Formats/Png/Zlib/ZlibInflateStream.cs     | 40 +++++++++++--------
 2 files changed, 40 insertions(+), 38 deletions(-)

diff --git a/src/ImageSharp/Formats/Png/PngDecoderCore.cs b/src/ImageSharp/Formats/Png/PngDecoderCore.cs
index a9e588f6e..037f648f0 100644
--- a/src/ImageSharp/Formats/Png/PngDecoderCore.cs
+++ b/src/ImageSharp/Formats/Png/PngDecoderCore.cs
@@ -5,6 +5,7 @@ using System;
 using System.Buffers.Binary;
 using System.Collections.Generic;
 using System.IO;
+using System.IO.Compression;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 using System.Text;
@@ -175,18 +176,7 @@ namespace SixLabors.ImageSharp.Formats.Png
                                     this.InitializeImage(metadata, out image);
                                 }
 
-                                var deframeStream = new ZlibInflateStream(this.currentStream, this.ReadNextDataChunk);
-                                try
-                                {
-                                    deframeStream.AllocateNewBytes(chunk.Length, true);
-                                    this.ReadScanlines(deframeStream.CompressedStream, image.Frames.RootFrame, pngMetadata);
-                                }
-                                finally
-                                {
-                                    // If an invalid Zlib stream is discovered the decoder will throw an exception
-                                    // due to the critical nature of the data chunk.
-                                    deframeStream.Dispose();
-                                }
+                                this.ReadScanlines(chunk, image.Frames.RootFrame, pngMetadata);
 
                                 break;
                             case PngChunkType.Palette:
@@ -472,19 +462,25 @@ namespace SixLabors.ImageSharp.Formats.Png
         /// Reads the scanlines within the image.
         /// </summary>
         /// <typeparam name="TPixel">The pixel format.</typeparam>
-        /// <param name="dataStream">The <see cref="MemoryStream"/> containing data.</param>
+        /// <param name="chunk">The png chunk containing the compressed scanline data.</param>
         /// <param name="image"> The pixel data.</param>
         /// <param name="pngMetadata">The png metadata</param>
-        private void ReadScanlines<TPixel>(Stream dataStream, ImageFrame<TPixel> image, PngMetadata pngMetadata)
+        private void ReadScanlines<TPixel>(PngChunk chunk, ImageFrame<TPixel> image, PngMetadata pngMetadata)
             where TPixel : struct, IPixel<TPixel>
         {
-            if (this.header.InterlaceMethod == PngInterlaceMode.Adam7)
-            {
-                this.DecodeInterlacedPixelData(dataStream, image, pngMetadata);
-            }
-            else
+            using (var deframeStream = new ZlibInflateStream(this.currentStream, this.ReadNextDataChunk))
             {
-                this.DecodePixelData(dataStream, image, pngMetadata);
+                deframeStream.AllocateNewBytes(chunk.Length, true);
+                DeflateStream dataStream = deframeStream.CompressedStream;
+
+                if (this.header.InterlaceMethod == PngInterlaceMode.Adam7)
+                {
+                    this.DecodeInterlacedPixelData(dataStream, image, pngMetadata);
+                }
+                else
+                {
+                    this.DecodePixelData(dataStream, image, pngMetadata);
+                }
             }
         }
 
@@ -1021,7 +1017,7 @@ namespace SixLabors.ImageSharp.Formats.Png
         private bool TryUncompressTextData(ReadOnlySpan<byte> compressedData, Encoding encoding, out string value)
         {
             using (var memoryStream = new MemoryStream(compressedData.ToArray()))
-            using (var inflateStream = new ZlibInflateStream(memoryStream, () => 0))
+            using (var inflateStream = new ZlibInflateStream(memoryStream))
             {
                 if (!inflateStream.AllocateNewBytes(compressedData.Length, false))
                 {
diff --git a/src/ImageSharp/Formats/Png/Zlib/ZlibInflateStream.cs b/src/ImageSharp/Formats/Png/Zlib/ZlibInflateStream.cs
index df0e72332..e4645c44a 100644
--- a/src/ImageSharp/Formats/Png/Zlib/ZlibInflateStream.cs
+++ b/src/ImageSharp/Formats/Png/Zlib/ZlibInflateStream.cs
@@ -20,14 +20,14 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
         private static readonly byte[] ChecksumBuffer = new byte[4];
 
         /// <summary>
-        /// The inner raw memory stream
+        /// A default delegate to get more data from the inner stream.
         /// </summary>
-        private readonly Stream innerStream;
+        private static readonly Func<int> GetDataNoOp = () => 0;
 
         /// <summary>
-        /// The compressed stream sitting over the top of the deframer
+        /// The inner raw memory stream
         /// </summary>
-        private DeflateStream compressedStream;
+        private readonly Stream innerStream;
 
         /// <summary>
         /// A value indicating whether this instance of the given entity has been disposed.
@@ -55,8 +55,17 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
         /// <summary>
         /// Initializes a new instance of the <see cref="ZlibInflateStream"/> class.
         /// </summary>
-        /// <param name="innerStream">The inner raw stream</param>
-        /// <param name="getData">A delegate to get more data from the inner stream</param>
+        /// <param name="innerStream">The inner raw stream.</param>
+        public ZlibInflateStream(Stream innerStream)
+            : this(innerStream, GetDataNoOp)
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ZlibInflateStream"/> class.
+        /// </summary>
+        /// <param name="innerStream">The inner raw stream.</param>
+        /// <param name="getData">A delegate to get more data from the inner stream.</param>
         public ZlibInflateStream(Stream innerStream, Func<int> getData)
         {
             this.innerStream = innerStream;
@@ -76,12 +85,12 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
         public override long Length => throw new NotSupportedException();
 
         /// <inheritdoc/>
-        public override long Position { get => throw new NotImplementedException(); set => throw new NotImplementedException(); }
+        public override long Position { get => throw new NotSupportedException(); set => throw new NotSupportedException(); }
 
         /// <summary>
         /// Gets the compressed stream over the deframed inner stream
         /// </summary>
-        public DeflateStream CompressedStream => this.compressedStream;
+        public DeflateStream CompressedStream { get; private set; }
 
         /// <summary>
         /// Adds new bytes from a frame found in the original stream
@@ -92,7 +101,7 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
         public bool AllocateNewBytes(int bytes, bool isCriticalChunk)
         {
             this.currentDataRemaining = bytes;
-            if (this.compressedStream is null)
+            if (this.CompressedStream is null)
             {
                 return this.InitializeInflateStream(isCriticalChunk);
             }
@@ -101,10 +110,7 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
         }
 
         /// <inheritdoc/>
-        public override void Flush()
-        {
-            throw new NotSupportedException();
-        }
+        public override void Flush() => throw new NotSupportedException();
 
         /// <inheritdoc/>
         public override int ReadByte()
@@ -186,10 +192,10 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
             if (disposing)
             {
                 // dispose managed resources
-                if (this.compressedStream != null)
+                if (this.CompressedStream != null)
                 {
-                    this.compressedStream.Dispose();
-                    this.compressedStream = null;
+                    this.CompressedStream.Dispose();
+                    this.CompressedStream = null;
                 }
             }
 
@@ -264,7 +270,7 @@ namespace SixLabors.ImageSharp.Formats.Png.Zlib
             }
 
             // Initialize the deflate Stream.
-            this.compressedStream = new DeflateStream(this, CompressionMode.Decompress, true);
+            this.CompressedStream = new DeflateStream(this, CompressionMode.Decompress, true);
 
             return true;
         }