Перейти до вмісту
Hokusai2.2.2
ivantokar.com

Читання метаданих

metadata() має одне значення: що кореневе джерело повідомило під час відкриття. Вона ніколи не описує перетворений конвеєр. Вона async, бо відкриває джерело поза кооперативним виконавцем Swift на планувальнику обчислень Hokusai, і читає лише заголовок.

_ = try await Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 300).pdf().write(to: URL(fileURLWithPath: "page.pdf"))
for name in ["scene.png", "phone.jpg", "emblem.png", "page.pdf"] {
let m = try await Hokusai(url: URL(fileURLWithPath: name)).metadata()
print(name, "→", m.format?.rawValue ?? "unknown", "\(m.width)×\(m.height)",
"oriented \(m.orientedSize.width)×\(m.orientedSize.height)",
"· channels", m.pixel.channels, "alpha", m.pixel.hasAlpha, m.pixel.interpretation,
"· pages", m.pages.count, "· exif", m.exif?.count ?? 0, "bytes",
"· source", m.sourceByteSize.map(String.init) ?? "n/a", "bytes")
}
// metadata() describes the source as opened, never the pipeline built on it.
let original = try await Hokusai(url: URL(fileURLWithPath: "scene.png")).metadata()
let afterResize = try await Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 100).metadata()
print("same metadata after resize:", original == afterResize)
// A truncated header is an error from metadata(); a file with an intact header reads even if its pixels are damaged.
let bytes = try Data(contentsOf: URL(fileURLWithPath: "scene.png"))
let damaged = try await Hokusai(data: bytes.prefix(bytes.count / 2)).metadata()
print("half a PNG still reports", damaged.width, "×", damaged.height)
Джерело Формат Збережений розмір Орієнтований розмір Канали Сторінки EXIF
scene.png png 1600 × 1000 1600 × 1000 3 (без альфи) 1 немає
phone.jpg jpeg 1000 × 1600 1600 × 1000 3 1 32 байти
emblem.png png 400 × 400 400 × 400 4 (альфа) 1 немає
page.pdf pdf 300 × 300 300 × 300 4 1 немає
  • image.metadata() і image.resize(width: 100).metadata() однакові (програма вивела true). Те, що дасть конвеєр, описує OutputInfo із завершальної операції, а не metadata().
  • Складений конвеєр повідомляє лише про свою основу; викличте metadata() на власному значенні накладення, щоб його перевірити.
  • Оскільки читається лише заголовок, половина PNG усе одно повідомляє 1600 × 1000, хоча декодування її пікселів завершилося б помилкою. Пікселі перевіряють завершальні операції, а не metadata().
  • InputOptions застосовуються: обрана page, ліміти й режим доступу.
  • Розміри (width, height) — збережений розмір обраної сторінки. Орієнтація EXIF — окремий типізований orientation (ImageOrientation, nil, коли її немає чи вона хибна); orientedSize міняє ширину й висоту місцями лише для орієнтацій на чверть оберту, як показує phone.jpg.
  • pixel (PixelMetadata): channels, hasAlpha, упорядкована interpretation (.grayscale, .sRGB, .rgb, .cmyk, .lab, …; вона каже, як читаються збережені значення, і не означає, що застосовано профіль ICC), sampleFormat, bitsPerSample, а для PNG — чи він палітровий.
  • format береться від завантажувача, який використала libvips, а не з імені файлу; nil, коли його не вдається визначити (наприклад, JPEG XL). AVIF і HEIC мають один завантажувач і розрізняються за стисненням HEIF.
  • pages (PageMetadata): count > 1 означає багатосторінковий.
  • animation: кількість циклів і затримки кадрів; є лише тоді, коли джерело містить затримки кадрів, тож багатосторінковий TIFF не вважається анімованим.
  • Щільність: одне значення в DPI плюс бажана одиниця джерела, коли вона записана. libvips повідомляє 1 піксель/мм для файлу без записаної роздільності; це типове значення трактується як «немає», а не як 25,4 DPI.
  • Вбудовані блоки (exif, iccProfile, xmp, iptc) — це власні необроблені Data. Блок IPTC — це ресурсний блок зображення Photoshop із записами IPTC, точно так, як його подає libvips; xmpString декодує XMP, лише коли він є коректним UTF-8.
  • sourceByteSize точний для Data і дорівнює розміру файлу для файлу.

hokusai inspect --input photo.jpg друкує ті самі факти таблицею; --json друкує один JSON-об’єкт для скриптів.