Збереження метаданих
Вбудовані метадані (EXIF, XMP, IPTC, кольоровий профіль ICC, тег орієнтації, роздільність) супроводжують джерело, але не обов’язково вивід. Що зберігає закодований файл, — це типізована MetadataPolicy, яку обирають через metadataPolicy(_:). Це конфігурація завершальної операції: вона не змінює пікселів, останній виклик перемагає, і її однаково застосовують data(), write(to:) та writeChunks.
Політики
Section titled “Політики”| Політика | Результат |
|---|---|
.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 |
Що варто знати
Section titled “Що варто знати”- Орієнтація — це не метадані приватності.
.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(), щоб пікселі були вертикальними.
Пов’язане
Section titled “Пов’язане”- Перевірка: що містило джерело
- Рецепт нормалізації завантаження