Кодувальники
Кодувальник обирає формат виводу та його налаштування. Кожен має коротку форму з поширеними параметрами та форму 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 q80JPEG · 800 × 500 · 27 KB 
PNGPNG · 800 × 500 · 184 KB 
WebP q80WEBP · 800 × 500 · 12 KB 
WebP без втратWEBP · 800 × 500 · 107 KB 
AVIF q50AVIF · 800 × 500 · 6 KB 
TIFF deflateTIFF · 800 × 500 · 130 KB 
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; ваші фото відрізнятимуться, тож вимірюйте власні.
Параметри та межі
Section titled “Параметри та межі”| Кодувальник | Коротка форма (значення за замовчуванням) | Повні параметри | Межі |
|---|---|---|---|
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).
Якість і розмір
Section titled “Якість і розмір”Якість не можна порівнювати між форматами, а вартість кожного кроку в байтах різна. Крупний план маяка 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 · 3,7 КБJPEG · 380 × 380 · 4 KB 
JPEG 40 · 5,5 КБJPEG · 380 × 380 · 5 KB 
JPEG 85 · 9,7 КБJPEG · 380 × 380 · 9 KB 
WebP 10 · 1,4 КБWEBP · 380 × 380 · 1 KB 
WebP 40 · 2,0 КБWEBP · 380 × 380 · 2 KB 
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"))}
рівень 1 · 12,6 КБPNG · 400 × 400 · 12 KB 
рівень 9 · 6,2 КБPNG · 400 × 400 · 6 KB 
4-бітна палітра · 3,8 КБPNG · 400 × 400 · 4 KB
Вивід із палітрою потребує libimagequant або quantizr у збірці libvips (capabilities().pngPalette); без них libvips мовчки записала б повний колір, тож Hokusai про це повідомляє. Він необов’язковий, бо змінює представлення кольору й триває довше.
Формати без альфи
Section titled “Формати без альфи”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"))
без flattenJPEG · 200 × 200 · 7 KB 
flatten(.white)JPEG · 200 × 200 · 8 KB
Згладжуйте на колір, який обираєте самі (Канали та альфа).