CR3 and HEIC/AVIF parsing (irot/imir orientation table, multi-extent XMP), the box walker's edge cases, RAF/WebP/PNG/GIF/BMP/JPEG XL/JPEG XR, ExifWriter round trips through MetadataReader, and robustness: 200 truncations plus 500 seeded corruptions per fixture with no exception or parser fault, previews always inside the file, 50 MB DNG and CR3 read with well under 512 KB, 2,000 JPEG headers under 2 s, cancellation and shared file access. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
148 lines
6.1 KiB
C#
148 lines
6.1 KiB
C#
using System.Buffers.Binary;
|
||
using Titano.Core.Metadata;
|
||
using Titano.Core.Metadata.Tiff;
|
||
using Titano.Core.Model;
|
||
using Titano.Testing;
|
||
using static Titano.Core.Tests.Metadata.MetadataTestHelpers;
|
||
|
||
namespace Titano.Core.Tests.Metadata;
|
||
|
||
public sealed class ExifWriterTests
|
||
{
|
||
private static readonly FrameMetadata Sample = new()
|
||
{
|
||
Make = "TestCam",
|
||
Model = "TC-1 Mark II",
|
||
Orientation = 8,
|
||
Software = "Titano 1.0",
|
||
Artist = "Ada Lovelace",
|
||
Copyright = "© 2024 Ada",
|
||
CapturedAt = new DateTime(2024, 5, 1, 12, 34, 56).AddTicks(1_234_500),
|
||
UtcOffsetMinutes = -330,
|
||
ExposureTime = 1 / 8000.0,
|
||
FNumber = 2.8,
|
||
Iso = 3200,
|
||
FocalLength = 23.5,
|
||
FocalLength35 = 35,
|
||
ExposureBias = -1 / 3.0,
|
||
BodySerial = "BODY-42",
|
||
LensModel = "XF23mmF1.4 R",
|
||
Gps = new GpsPosition(-33.8567844, 151.2152967, -12.25, new DateTime(2024, 5, 1, 2, 4, 56, 500, DateTimeKind.Utc)),
|
||
};
|
||
|
||
[Test]
|
||
public void RoundTripsThroughMetadataReader()
|
||
{
|
||
var m = Read(Wrap(ExifWriter.BuildJpegApp1(Sample)));
|
||
AssertNoFault(m);
|
||
Assert.Equal(Sample.Make, m.Make);
|
||
Assert.Equal(Sample.Model, m.Model);
|
||
Assert.Equal(8, m.Orientation);
|
||
Assert.Equal(Sample.Software, m.Software);
|
||
Assert.Equal(Sample.Artist, m.Artist);
|
||
Assert.Equal(Sample.Copyright, m.Copyright);
|
||
Assert.Equal(Sample.CapturedAt, m.CapturedAt);
|
||
Assert.Equal(-330, m.UtcOffsetMinutes);
|
||
Assert.Equal(TimestampSource.ExifOriginal, m.TimestampSource);
|
||
Assert.Approximately(Sample.ExposureTime!.Value, m.ExposureTime!.Value, 1e-15);
|
||
Assert.Approximately(2.8, m.FNumber!.Value, 1e-12);
|
||
Assert.Equal(3200, m.Iso);
|
||
Assert.Approximately(23.5, m.FocalLength!.Value, 1e-12);
|
||
Assert.Approximately(35, m.FocalLength35!.Value, 1e-12);
|
||
Assert.Approximately(-1 / 3.0, m.ExposureBias!.Value, 1e-4);
|
||
Assert.Equal(Sample.BodySerial, m.BodySerial);
|
||
Assert.Equal(Sample.LensModel, m.LensModel);
|
||
var gps = Assert.NotNull(m.Gps);
|
||
Assert.Approximately(-33.8567844, gps.Latitude, 1e-7);
|
||
Assert.Approximately(151.2152967, gps.Longitude, 1e-7);
|
||
Assert.Approximately(-12.25, gps.Altitude!.Value, 1e-9);
|
||
Assert.Equal(Sample.Gps!.UtcTimestamp, gps.UtcTimestamp);
|
||
}
|
||
|
||
[Test]
|
||
public void App1SegmentIsWellFormed()
|
||
{
|
||
var app1 = ExifWriter.BuildJpegApp1(Sample);
|
||
Assert.Equal(0xFF, app1[0]);
|
||
Assert.Equal(0xE1, app1[1]);
|
||
Assert.Equal(app1.Length - 2, BinaryPrimitives.ReadUInt16BigEndian(app1.AsSpan(2)));
|
||
Assert.True(app1.AsSpan(4).StartsWith("Exif\0\0II*\0"u8));
|
||
}
|
||
|
||
[Test]
|
||
public void TiffIsSortedAndPointersResolve()
|
||
{
|
||
var tiff = ExifWriter.BuildTiff(Sample);
|
||
var reader = Assert.NotNull(TiffReader.Open(new MemoryStream(tiff)));
|
||
Assert.True(reader.LittleEndian);
|
||
var chain = reader.ReadChain();
|
||
Assert.Equal(1, chain.Count);
|
||
var ifd0 = chain[0];
|
||
AssertSorted(reader, ifd0);
|
||
var exif = Assert.NotNull(reader.ReadIfd(reader.GetUInt(ifd0, TiffTags.ExifIfd)!.Value));
|
||
AssertSorted(reader, exif);
|
||
Assert.Equal("0232", reader.GetString(exif, TiffTags.ExifVersion));
|
||
Assert.NotNull(reader.ReadIfd(reader.GetUInt(ifd0, TiffTags.GpsIfd)!.Value));
|
||
Assert.Empty(reader.Warnings);
|
||
}
|
||
|
||
[Test]
|
||
public void OmitsUnknownValuesAndGps()
|
||
{
|
||
var tiff = ExifWriter.BuildTiff(new FrameMetadata { Make = "Only" });
|
||
var reader = TiffReader.Open(new MemoryStream(tiff))!;
|
||
var ifd0 = reader.ReadChain()[0];
|
||
Assert.False(ifd0.Has(TiffTags.GpsIfd));
|
||
Assert.False(ifd0.Has(TiffTags.DateTime));
|
||
Assert.Equal((ushort)1, (ushort)reader.GetUInt(ifd0, TiffTags.Orientation)!.Value);
|
||
var exif = reader.ReadIfd(reader.GetUInt(ifd0, TiffTags.ExifIfd)!.Value)!;
|
||
Assert.False(exif.Has(TiffTags.ExposureTime));
|
||
Assert.False(exif.Has(TiffTags.SubSecTimeOriginal));
|
||
Assert.False(exif.Has(TiffTags.OffsetTimeOriginal));
|
||
}
|
||
|
||
[Test]
|
||
public void HighIsoUsesRecommendedExposureIndex()
|
||
{
|
||
var m = Read(Wrap(ExifWriter.BuildJpegApp1(Sample with { Iso = 204800 })));
|
||
Assert.Equal(204800, m.Iso);
|
||
}
|
||
|
||
[Theory]
|
||
[Case(1 / 8000.0, 1u, 8000u)]
|
||
[Case(0.3, 3u, 10u)]
|
||
[Case(2.8, 14u, 5u)]
|
||
[Case(30.0, 30u, 1u)]
|
||
public void EncodesExposureRationals(double seconds, uint numerator, uint denominator)
|
||
{
|
||
var tiff = ExifWriter.BuildTiff(new FrameMetadata { ExposureTime = seconds });
|
||
var reader = TiffReader.Open(new MemoryStream(tiff))!;
|
||
var exif = reader.ReadIfd(reader.GetUInt(reader.ReadChain()[0], TiffTags.ExifIfd)!.Value)!;
|
||
var raw = reader.ReadBytes(exif.Entries[TiffTags.ExposureTime])!;
|
||
Assert.Equal(numerator, BinaryPrimitives.ReadUInt32LittleEndian(raw));
|
||
Assert.Equal(denominator, BinaryPrimitives.ReadUInt32LittleEndian(raw.AsSpan(4)));
|
||
}
|
||
|
||
[Test]
|
||
public void TruncatesLongStringsOnCharacterBoundaries()
|
||
{
|
||
var longText = new string('é', ExifWriter.MaxStringBytes);
|
||
var app1 = ExifWriter.BuildJpegApp1(new FrameMetadata { Artist = longText, Copyright = longText, Make = longText, Model = longText, Software = longText, BodySerial = longText, LensModel = longText });
|
||
Assert.Less(app1.Length, 65535);
|
||
var m = Read(Wrap(app1));
|
||
Assert.Equal(ExifWriter.MaxStringBytes / 2, m.Artist!.Length);
|
||
Assert.True(m.Artist.All(c => c == 'é'));
|
||
}
|
||
|
||
/// <summary>SOI + APP1 + a minimal 64×48 frame.</summary>
|
||
private static byte[] Wrap(byte[] app1) => [0xFF, 0xD8, .. app1, .. Builders.JpegBuilder.Minimal(64, 48).AsSpan(2)];
|
||
|
||
private static void AssertSorted(TiffReader reader, Ifd ifd)
|
||
{
|
||
var count = BinaryPrimitives.ReadUInt16LittleEndian(reader.ReadRelative(ifd.Position, 2)!);
|
||
var tags = new List<double>();
|
||
for (var i = 0; i < count; i++) tags.Add(BinaryPrimitives.ReadUInt16LittleEndian(reader.ReadRelative(ifd.Position + 2 + 12 * i, 2)!));
|
||
Assert.Monotonic(tags, strict: true);
|
||
}
|
||
}
|