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

Збереження метаданих

Вбудовані метадані (EXIF, XMP, IPTC, кольоровий профіль ICC, тег орієнтації, роздільність) супроводжують джерело, але не обов’язково вивід. Що зберігає закодований файл, — це типізована MetadataPolicy, яку обирають через metadataPolicy(_:). Це конфігурація завершальної операції: вона не змінює пікселів, останній виклик перемагає, і її однаково застосовують data(), write(to:) та writeChunks.

Політика Результат
.default Вилучає EXIF, XMP, IPTC і коментарі; зберігає профіль ICC, орієнтацію та щільність, бо вони впливають на показ зображення. Мінімізує приватність, але безпечна для відображення.
.preserveAll Зберігає все, що може нести формат.
.removeAll Вилучає все, зокрема профіль, тег орієнтації та щільність. Пікселі не змінюються, тож зображення, яке на щось із цього покладалося, може відображатися інакше.
власна MetadataPolicy(exif:icc:xmp:iptc:other:orientation:density:), кожне .preserve або .remove.
// phone.jpg carries EXIF (camera make, software, orientation 6).
let phone = try Hokusai(url: URL(fileURLWithPath: "phone.jpg"))
let policies: [(String, MetadataPolicy)] = [
("default", .default),
("preserveAll", .preserveAll),
("removeAll", .removeAll),
("keep-exif-only", MetadataPolicy(exif: .preserve, icc: .remove, orientation: .remove)),
]
for (name, policy) in policies {
let output = try await phone.jpeg().metadataPolicy(policy).data()
let meta = try await Hokusai(data: output.data).metadata()
print(name, "→ exif:", meta.exif?.count ?? 0, "bytes, orientation:", meta.orientation.map { "\($0)" } ?? "none",
", size", meta.width, "×", meta.height)
}

Для phone.jpg (виробник камери й програма в EXIF, орієнтація 6, збережені пікселі 1000 × 1600) метадані виводу, прочитані назад, були такими:

Політика Байти EXIF Орієнтація
.default 126 right (збережено)
.preserveAll 162 right
.removeAll 0 немає
exif: .preserve, icc: .remove, orientation: .remove 162 up
  • Орієнтація — це не метадані приватності. .remove видаляє тег без обертання пікселів; autoOrient() застосовує його. Якщо EXIF збережено повністю, вилучення орієнтації записує нейтральне значення «вгору» (як показує останній рядок). За типової політики блок EXIF, що лишається, мінімальний: орієнтація та технічні записи, які libvips пише сама, без описових чи геолокаційних полів.
  • Щільність. Формати завжди записують якусь роздільність, тож .remove не дає перенести роздільність джерела, а кодувальник пише власну типову.
  • Збереження ICC — це не перетворення кольору: жоден профіль не застосовується, не прикріплюється й не змінюється.
  • Ранні версії вилучали все разом із профілем; після зміни типової поведінки зображення з профілем його зберігає.

Що може нести кожен формат

Section titled “Що може нести кожен формат”
EXIF XMP IPTC ICC Орієнтація Щільність
JPEG так так так так тег EXIF так
PNG так так ні так тег EXIF так
WebP так так ні так тег EXIF ні
AVIF так так ні так обертання контейнера ні

Родина, яку формат не може нести, у його виводі просто відсутня. AVIF — виняток щодо орієнтації: він зберігає обертання контейнера, а не тег, а читач застосовує його й не повідомляє тега. Чи записує libvips це обертання, залежить від збірки (libvips 8.18 записує; базова 8.16 лишає орієнтацію лише як тег EXIF, який переглядачі AVIF ігнорують). Для AVIF на такій збірці спершу викличте autoOrient(), щоб пікселі були вертикальними.