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

Кодувальники

Кодувальник обирає формат виводу та його налаштування. Кожен має коротку форму з поширеними параметрами та форму options:, що приймає повну структуру параметрів; обидві зводяться до того самого encode(using:). PDF описано в розділі PDF. Що може записувати ваше встановлення, повідомляє Hokusai.capabilities().outputFormats і hokusai info.

let image = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 800)
let encoders: [(String, Hokusai)] = [
("converted.jpg", try image.jpeg(quality: 80)),
("converted.png", try image.png()),
("converted.webp", try image.webp(quality: 80)),
("converted-lossless.webp", try image.webp(lossless: true)),
("converted.avif", try image.avif(quality: 50)),
("converted.tiff", try image.tiff(compression: .deflate)),
("converted.gif", try image.gif()),
]
for (name, encoder) in encoders {
let info = try await encoder.write(to: URL(fileURLWithPath: name))
print(name, "→", info.format.rawValue, info.byteCount, "bytes")
}
  • Пейзаж у форматі JPEG.
    JPEG q80JPEG · 800 × 500 · 27 KB
  • Пейзаж у форматі PNG.
    PNGPNG · 800 × 500 · 184 KB
  • Пейзаж у форматі WebP зі стисненням із втратами.
    WebP q80WEBP · 800 × 500 · 12 KB
  • Пейзаж у форматі WebP без втрат.
    WebP без втратWEBP · 800 × 500 · 107 KB
  • Пейзаж у форматі AVIF.
    AVIF q50AVIF · 800 × 500 · 6 KB
  • Пейзаж у форматі TIFF (показано як попередній перегляд PNG).
    TIFF deflateTIFF · 800 × 500 · 130 KB
  • Пейзаж у форматі GIF із палітрою 256 кольорів.
    GIFGIF · 800 × 500 · 66 KB

Те саме зображення 800 × 500 в кожному форматі: JPEG 27,3 КБ, PNG 188,9 КБ, WebP 12,0 КБ (109,3 КБ без втрат), AVIF 5,6 КБ, TIFF 133,0 КБ, GIF 68,0 КБ. Це вимірювання для цього синтетичного зображення на цій libvips; ваші фото відрізнятимуться, тож вимірюйте власні.

Кодувальник Коротка форма (значення за замовчуванням) Повні параметри Межі
jpeg quality: 80, progressive: false JPEGOptions: quality, progressive, chromaSubsampling (.automatic, .yuv420, .yuv444), optimizeCoding quality 1…100
png compressionLevel: 6, interlaced: false PNGOptions: compressionLevel, interlaced, palette: PNGPalette? рівень 0…9; палітра: quality 0…100, dither 0…1, effort 1…10, bitDepth 1, 2, 4 або 8
webp quality: 80, effort: 4, lossless: false WebPOptions: додає alphaQuality, nearLossless, smartSubsample, preset (.default, .picture, .photo, .drawing, .icon, .text) quality 1…100, effort 0…6, alphaQuality 0…100
avif quality: 50, effort: 4, lossless: false AVIFOptions: додає bitDepth (.eight, .ten, .twelve), chromaSubsampling quality 1…100, effort 0…9
heif compression: .hevc, quality: 50, lossless: false HEIFOptions: compression (.hevc, .av1), quality, effort, lossless, bitDepth, chromaSubsampling quality 1…100, effort 0…9
tiff compression: .none, quality: 75 TIFFOptions: compression (.none, .jpeg, .deflate, .packBits, .ccittFax4, .lzw, .webp, .zstd, .jpeg2000), predictor, tiling: TIFFTiling?, bigTIFF quality 1…100; плитка 16…32768, кратна 16
gif GIFOptions() dither, effort, bitDepth, interlaced (нерухомий, один кадр) dither 0…1, effort 1…10, bitDepth 1…8

Значення поза діапазоном викидають HokusaiError.invalidOption під час вибору кодувальника. AVIF завжди кодує AV1, а не HEVC, який libvips обрала б типово; OutputInfo.format називає фактично записаний формат. heif з .hevc часто недоступний у збірці libvips (capabilities().heifCompressions).

Якість не можна порівнювати між форматами, а вартість кожного кроку в байтах різна. Крупний план маяка 380 × 380, закодований за трьох значень якості:

// A close-up of the lighthouse, where compression artefacts show.
let detail = try Hokusai(url: URL(fileURLWithPath: "scene.png"))
.extract(x: 1000, y: 120, width: 380, height: 380)
for quality in [10, 40, 85] {
let jpeg = try await detail.jpeg(quality: quality).data()
let webp = try await detail.webp(quality: quality).data()
print("quality", quality, "→ jpeg", jpeg.info.byteCount, "webp", webp.info.byteCount)
try jpeg.data.write(to: URL(fileURLWithPath: "q\(quality).jpg"))
try webp.data.write(to: URL(fileURLWithPath: "q\(quality).webp"))
}
  • Крупний план у JPEG якості 10: помітні смуги й блоки в небі.
    JPEG 10 · 3,7 КБJPEG · 380 × 380 · 4 KB
  • Крупний план у JPEG якості 40: легкі смуги.
    JPEG 40 · 5,5 КБJPEG · 380 × 380 · 5 KB
  • Крупний план у JPEG якості 85: чисто.
    JPEG 85 · 9,7 КБJPEG · 380 × 380 · 9 KB
  • Крупний план у WebP якості 10.
    WebP 10 · 1,4 КБWEBP · 380 × 380 · 1 KB
  • Крупний план у WebP якості 40.
    WebP 40 · 2,0 КБWEBP · 380 × 380 · 2 KB
  • Крупний план у WebP якості 85.
    WebP 85 · 3,7 КБWEBP · 380 × 380 · 4 KB
Якість Байти JPEG Байти WebP
10 3 663 1 436
40 5 536 1 990
85 9 682 3 662

Для фотографій починайте з JPEG 80–85 або WebP 80 і порівнюйте на власних зображеннях.

PNG — формат без втрат; compressionLevel обмінює час на розмір, а palette (індексований колір) — кольори на розмір.

let image = try Hokusai(url: URL(fileURLWithPath: "emblem.png"))
for (name, options) in [
("level-1", PNGOptions(compressionLevel: 1)),
("level-9", PNGOptions(compressionLevel: 9)),
("palette", PNGOptions(palette: PNGPalette(bitDepth: 4))),
] {
let output = try await image.png(options: options).data()
print(name, "→", output.info.byteCount, "bytes")
try output.data.write(to: URL(fileURLWithPath: "\(name).png"))
}
  • Емблема у PNG з рівнем стиснення 1.
    рівень 1 · 12,6 КБPNG · 400 × 400 · 12 KB
  • Емблема у PNG з рівнем стиснення 9.
    рівень 9 · 6,2 КБPNG · 400 × 400 · 6 KB
  • Емблема в індексованому PNG на 16 кольорів.
    4-бітна палітра · 3,8 КБPNG · 400 × 400 · 4 KB

Вивід із палітрою потребує libimagequant або quantizr у збірці libvips (capabilities().pngPalette); без них libvips мовчки записала б повний колір, тож Hokusai про це повідомляє. Він необов’язковий, бо змінює представлення кольору й триває довше.

JPEG не може зберігати альфу. Прозоре зображення, закодоване в JPEG без flatten, має прозорі кути, що стають чорними (спостережено з libvips 8.18):

let emblem = try Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 200)
// JPEG has no alpha. Without flatten, the encoder decides what the transparent corners become.
try await emblem.jpeg().write(to: URL(fileURLWithPath: "unflattened.jpg"))
// With flatten, you choose.
try await emblem.flatten(background: .white).jpeg().write(to: URL(fileURLWithPath: "flattened.jpg"))
  • Емблема в JPEG із чорними кутами там, де вона була прозорою.
    без flattenJPEG · 200 × 200 · 7 KB
  • Емблема в JPEG з білими кутами.
    flatten(.white)JPEG · 200 × 200 · 8 KB

Згладжуйте на колір, який обираєте самі (Канали та альфа).