Читання метаданих
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)Що вона показала
Section titled “Що вона показала”| Джерело | Формат | Збережений розмір | Орієнтований розмір | Канали | Сторінки | 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 |
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і дорівнює розміру файлу для файлу.
Командний рядок
Section titled “Командний рядок”hokusai inspect --input photo.jpg друкує ті самі факти таблицею; --json друкує один JSON-об’єкт для скриптів.
Пов’язане
Section titled “Пов’язане”- Збереження метаданих: що зберігає вивід
- Параметри входу