using System.IO.Compression; using System.Text; using Engine.Assets; namespace Engine.Assets.Tests; /// /// Builds tiny test PNGs by hand rather than reusing Engine.Render's /// PngWriter — keeps this test project independent of a second plugin, /// and a from-scratch encoder here is also a second, independent /// implementation of the format to check PngReader against, not the same /// code testing itself. /// public class PngReaderTests { [Fact] public void Read_Recovers_Exact_Pixel_Values_Through_A_Round_Trip() { // 2x2, four distinct colors — catches row-order and channel-order // mistakes that a single flat color would hide. byte[] pixels = [ 255, 0, 0, 255, 0, 255, 0, 255, // row 0: red, green 0, 0, 255, 255, 255, 255, 0, 255, // row 1: blue, yellow ]; var path = WriteTestPng(2, 2, pixels, filterType: 0); try { var (width, height, rgba) = PngReader.Read(path); Assert.Equal(2, width); Assert.Equal(2, height); Assert.Equal(pixels, rgba); } finally { File.Delete(path); } } [Theory] [InlineData((byte)0)] // None [InlineData((byte)1)] // Sub [InlineData((byte)2)] // Up [InlineData((byte)3)] // Average [InlineData((byte)4)] // Paeth public void Read_Correctly_Unfilters_Every_Filter_Type(byte filterType) { byte[] pixels = [ 10, 20, 30, 255, 40, 50, 60, 255, 70, 80, 90, 255, 100, 110, 120, 255, ]; var path = WriteTestPng(2, 2, pixels, filterType); try { var (_, _, rgba) = PngReader.Read(path); Assert.Equal(pixels, rgba); } finally { File.Delete(path); } } [Fact] public void Read_Throws_On_A_File_That_Is_Not_A_PNG() { var path = Path.GetTempFileName(); File.WriteAllText(path, "not a png"); try { Assert.Throws(() => PngReader.Read(path)); } finally { File.Delete(path); } } [Fact] public void Read_Throws_On_An_Unsupported_Color_Type() { // Grayscale (color type 0) instead of RGBA (6) — the reader is // deliberately scoped to the one subset it actually supports. var path = WriteTestPng(1, 1, [128], filterType: 0, colorType: 0, bytesPerPixel: 1); try { Assert.Throws(() => PngReader.Read(path)); } finally { File.Delete(path); } } private static string WriteTestPng( int width, int height, byte[] rgba, byte filterType, byte colorType = 6, int bytesPerPixel = 4) { var path = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.png"); using var file = File.Create(path); file.Write((byte[]) [137, 80, 78, 71, 13, 10, 26, 10]); var ihdr = new byte[13]; WriteUInt32BE(ihdr, 0, (uint)width); WriteUInt32BE(ihdr, 4, (uint)height); ihdr[8] = 8; // bit depth ihdr[9] = colorType; ihdr[10] = 0; ihdr[11] = 0; ihdr[12] = 0; // interlace: none WriteChunk(file, "IHDR", ihdr); var stride = width * bytesPerPixel; using var raw = new MemoryStream(); for (var y = 0; y < height; y++) { var row = new byte[stride]; Array.Copy(rgba, y * stride, row, 0, stride); var filtered = ApplyFilter(filterType, row, y > 0 ? Slice(rgba, (y - 1) * stride, stride) : null, bytesPerPixel); raw.WriteByte(filterType); raw.Write(filtered); } using var compressed = new MemoryStream(); using (var zlib = new ZLibStream(compressed, CompressionLevel.Optimal, leaveOpen: true)) zlib.Write(raw.ToArray()); WriteChunk(file, "IDAT", compressed.ToArray()); WriteChunk(file, "IEND", []); return path; } private static byte[] Slice(byte[] source, int offset, int length) { var slice = new byte[length]; Array.Copy(source, offset, slice, 0, length); return slice; } private static byte[] ApplyFilter(byte filterType, byte[] row, byte[]? previousRow, int bytesPerPixel) { var result = new byte[row.Length]; for (var x = 0; x < row.Length; x++) { int a = x >= bytesPerPixel ? row[x - bytesPerPixel] : 0; int b = previousRow?[x] ?? 0; int c = x >= bytesPerPixel ? previousRow?[x - bytesPerPixel] ?? 0 : 0; result[x] = filterType switch { 0 => row[x], 1 => (byte)(row[x] - a), 2 => (byte)(row[x] - b), 3 => (byte)(row[x] - (a + b) / 2), 4 => (byte)(row[x] - Paeth(a, b, c)), _ => throw new ArgumentOutOfRangeException(nameof(filterType)), }; } return result; } private static int Paeth(int a, int b, int c) { var p = a + b - c; var pa = Math.Abs(p - a); var pb = Math.Abs(p - b); var pc = Math.Abs(p - c); if (pa <= pb && pa <= pc) return a; return pb <= pc ? b : c; } private static void WriteChunk(Stream stream, string type, byte[] data) { var typeBytes = Encoding.ASCII.GetBytes(type); var length = new byte[4]; WriteUInt32BE(length, 0, (uint)data.Length); stream.Write(length); stream.Write(typeBytes); stream.Write(data); var crc = new byte[4]; WriteUInt32BE(crc, 0, Crc32(typeBytes, data)); stream.Write(crc); } private static void WriteUInt32BE(byte[] buffer, int offset, uint value) { buffer[offset] = (byte)(value >> 24); buffer[offset + 1] = (byte)(value >> 16); buffer[offset + 2] = (byte)(value >> 8); buffer[offset + 3] = (byte)value; } private static readonly uint[] Crc32Table = BuildCrc32Table(); private static uint[] BuildCrc32Table() { var table = new uint[256]; for (uint n = 0; n < 256; n++) { var c = n; for (var k = 0; k < 8; k++) c = (c & 1) != 0 ? 0xEDB88320 ^ (c >> 1) : c >> 1; table[n] = c; } return table; } private static uint Crc32(byte[] type, byte[] data) { var crc = 0xFFFFFFFFu; foreach (var b in type) crc = Crc32Table[(crc ^ b) & 0xFF] ^ (crc >> 8); foreach (var b in data) crc = Crc32Table[(crc ^ b) & 0xFF] ^ (crc >> 8); return crc ^ 0xFFFFFFFFu; } }