feat(metadata): parse TIFF/Exif, JPEG segments and MakerNotes

ExifParser walks IFD0, Exif, GPS and SubIFDs, selects the main raster
(largest full-resolution IFD), and enumerates embedded JPEG previews
(JPEGInterchangeFormat, single-strip/tile Compression 6/7, lossless
raw strips excluded). JpegParser scans APP1 Exif/XMP/extended XMP,
APP2 MPF large thumbnails and SOFn up to SOS, tolerating fill bytes
and garbage. Vendor MakerNotes (Canon, Nikon, Sony, Fujifilm,
Olympus/OM, Panasonic) fill serial, lens, shutter count, stabiliser,
ISO and colour temperature only when standard tags did not.
TiffTags gains GPSVersionID, GPSStatus, YCbCrPositioning,
StandardOutputSensitivity and ISOSpeed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
Claude committed 2026-10-02 10:01:12 +00:00
1 parent 654c45a274
commit d12c0b41c5
11 files changed
+918

No files matched your search

@@ -0,0 +1,81 @@
using System.Globalization;
using Titano.Core.Metadata.Tiff;
namespace Titano.Core.Metadata.MakerNotes;
/// <summary>
/// Locates the vendor IFD inside an Exif MakerNote (by header signature, then by camera make) and hands it to the
/// vendor parser. Best effort: unknown layouts are skipped, and every read goes through the bounds-checked
/// <see cref="TiffReader"/>.
/// </summary>
internal static class MakerNoteParser
{
private const int HeaderBytes = 16;
/// <param name="exif">Reader of the TIFF block holding the Exif IFD (base and byte order of relative offsets).</param>
/// <param name="makerNote">The Exif 0x927C entry.</param>
public static void Parse(TiffReader exif, IfdEntry makerNote, MetadataBuilder m)
{
if (makerNote.IsInline || makerNote.ByteLength < 14) return;
var start = makerNote.ValuePosition(exif.Base);
if (start < exif.Base || start > m.Length - makerNote.ByteLength)
{
m.Warn("MakerNote outside the file");
return;
}
Span<byte> head = stackalloc byte[HeaderBytes];
var h = head[..m.Stream.ReadUpTo(start, head[..(int)Math.Min(HeaderBytes, makerNote.ByteLength)])];
var make = m.Make ?? string.Empty;
var relative = (uint)(start - exif.Base);
if (h.StartsWith("Nikon\0"u8))
{
NikonMakerNote.Parse(exif, start, h, m);
}
else if (h.StartsWith("OLYMPUS\0"u8) || h.StartsWith("OM SYSTEM\0"u8) || h.StartsWith("OLYMP\0"u8))
{
OlympusMakerNote.Parse(exif, start, h, m);
}
else if (h.StartsWith("FUJIFILM"u8))
{
FujifilmMakerNote.Parse(m, start, h);
}
else if (h.StartsWith("Panasonic\0"u8))
{
Vendor(exif, relative + 12, m, PanasonicMakerNote.Parse);
}
else if (h.StartsWith("SONY"u8))
{
Vendor(exif, relative + 12, m, SonyMakerNote.Parse);
}
else if (make.StartsWith("Canon", StringComparison.OrdinalIgnoreCase))
{
Vendor(exif, relative, m, CanonMakerNote.Parse);
}
else if (make.StartsWith("NIKON", StringComparison.OrdinalIgnoreCase))
{
Vendor(exif, relative, m, NikonMakerNote.ParseIfd);
}
else if (make.StartsWith("SONY", StringComparison.OrdinalIgnoreCase))
{
Vendor(exif, relative, m, SonyMakerNote.Parse);
}
}
/// <summary>Reads the IFD at a base-relative offset with <paramref name="reader"/> and runs <paramref name="parse"/> on it.</summary>
internal static void Vendor(TiffReader reader, uint offset, MetadataBuilder m, Action<TiffReader, Ifd, MetadataBuilder> parse)
{
if (reader.ReadIfd(offset) is { } ifd) parse(reader, ifd, m);
else m.Warn("MakerNote IFD unreadable");
}
/// <summary>"24-70mm f/2.8", "50mm f/1.8" or "18-55mm F3.5-5.6" from focal-length and aperture ranges.</summary>
internal static string FormatLens(double minFocal, double maxFocal, double minAperture, double maxAperture, string aperturePrefix)
{
static string N(double v) => Math.Round(v, 1).ToString("0.#", CultureInfo.InvariantCulture);
var focal = maxFocal > minFocal ? $"{N(minFocal)}-{N(maxFocal)}mm" : $"{N(minFocal)}mm";
if (minAperture <= 0) return focal;
var aperture = maxAperture > minAperture ? $"{N(minAperture)}-{N(maxAperture)}" : N(minAperture);
return $"{focal} {aperturePrefix}{aperture}";
}
}