Тон і колір
Ці операції змінюють колір і тон, не переміщуючи пікселі. Усі зберігають альфа-канал (окрім зазначених випадків) і виконуються саме там, де ви їх записали в конвеєрі.
let image = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 360)let dull = try image.linear(multiply: 0.45, add: 70) // a low-contrast starting point (see Filters)
let variants: [(String, Hokusai)] = [ ("original", image), ("grayscale", image.grayscale()), ("tint", try image.tint(Color(red: 0.95, green: 0.55, blue: 0.1))), ("dull", dull), ("normalize", try dull.normalize()), ("clahe", try dull.clahe(width: 48, height: 48, maxSlope: 2)), ("gamma", try image.gamma(2.2)), ("modulate", try image.modulate(brightness: 1.1, saturation: 0.4, hue: 40)), ("negate", image.negate()), ("threshold", try image.threshold(110)),]for (name, pipeline) in variants { try await pipeline.webp(quality: 85).write(to: URL(fileURLWithPath: "\(name).webp"))}
оригіналWEBP · 360 × 225 · 6 KB 
grayscale()WEBP · 360 × 225 · 4 KB 
tint(помаранчевий)WEBP · 360 × 225 · 5 KB 
вхід із низьким контрастомWEBP · 360 × 225 · 3 KB 
normalize()WEBP · 360 × 225 · 7 KB 
clahe()WEBP · 360 × 225 · 4 KB 
gamma(2.2)WEBP · 360 × 225 · 5 KB 
modulateWEBP · 360 × 225 · 5 KB 
negate()WEBP · 360 × 225 · 6 KB 
threshold(110)WEBP · 360 × 225 · 1 KB
Довідник
Section titled “Довідник”| Операція | Параметри (значення за замовчуванням, межі) | Що робить |
|---|---|---|
grayscale() |
немає | Прибирає колір, але зберігає розкладку RGB(A); яскравість із перетворення sRGB у libvips. |
tint(_ color:) |
Color |
Робить зображення сірим, потім відображає яскравість на колір: біле стає тоном, чорне лишається чорним. Власна непрозорість кольору ігнорується. |
normalize(lower:upper:) |
1, 99 |
Відсікає найтемніші lower відсотків і найсвітліші 100 − upper, потім розтягує решту на повний діапазон однією лінійною функцією для всіх смуг, тож відтінок зберігається. Пласке зображення повертається без змін. Лише 8- або 16-бітні. |
clahe(width:height:maxSlope:) |
8, 8, 3; maxSlope у 0…100 |
Локальне посилення контрасту за світлотою (LAB); колір зберігається. width/height — розмір плитки, maxSlope обмежує приріст контрасту на плитку (0 вимикає обмеження). 8- і 16-бітні; float-зображення викидають unsupported. |
gamma(_ value:) |
2.2; 0.1…10 |
out = in ^ (1 / value) для кольорових смуг: понад 1 робить півтони світлішими. |
modulate(brightness:saturation:hue:) |
1, 1, 0; 0…100, 0…100, скінченні градуси |
Працює в LCH: яскравість масштабує світлоту, насиченість — кольоровість, відтінок повертається. |
negate(alpha:) |
false |
Інвертує кольори; альфа інвертується лише за alpha: true. |
threshold(_ level:grayscale:) |
128, true; 0…255 |
Пікселі на рівні level і вище стають білими, решта — чорними. З grayscale результат — одноканальна маска; без нього кожна смуга порівнюється окремо. |
convert(to:) |
.sRGB або .grayscale |
Перетворює на вихідний кольоровий простір. |
normalize і clahe розв’язують одну задачу по-різному: normalize робить одне глобальне розтягування, clahe пристосовується до кожної плитки. На плавних градієнтах мала плитка clahe може показати сітку сходинок, тож для фото неба беріть більші плитки й малий maxSlope (приклад вище використовує плитки 48 px і maxSlope: 2).
grayscale() проти convert(to: .grayscale)
Section titled “grayscale() проти convert(to: .grayscale)”let image = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 360)
// grayscale() keeps the RGB layout; convert(to: .grayscale) produces one colour channel.let looksGray = try await image.grayscale().png().data()let oneChannel = try await image.convert(to: .grayscale).png().data()
for (name, output) in [("grayscale-rgb", looksGray), ("grayscale-1ch", oneChannel)] { let channels = try await Hokusai(data: output.data).metadata().pixel.channels print(name, "→", channels, "channel(s),", output.data.count, "bytes") try output.data.write(to: URL(fileURLWithPath: "\(name).png"))}
grayscale()PNG · 360 × 225 · 23 KB 
convert(to: .grayscale)PNG · 360 × 225 · 17 KB
Обидва виглядають однаково; вони відрізняються розкладкою. grayscale() зберігає три канали, тож подальші кольорові операції (tint, recombine) і RGB-кодувальники поводяться як зі звичайним кольоровим зображенням. convert(to: .grayscale) дає один канал (плюс альфа, якщо є), що менше на диску (тут 17 КБ проти 23 КБ) і саме потрібне масками та 8-бітним сірим виводам.
Помилки
Section titled “Помилки”let image = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 200)
func attempt(_ name: String, _ build: () throws -> Hokusai) { do { _ = try build(); print(name, "→ accepted") } catch { print(name, "→ throws", error) }}
attempt("blur(sigma: 0)") { try image.blur(sigma: 0) }attempt("gamma(20)") { try image.gamma(20) }attempt("median(size: 200)") { try image.median(size: 200) }attempt("dilate(radius: 60)") { try image.dilate(radius: 60) }attempt("threshold(300)") { try image.threshold(300) }attempt("edges(.canny(sigma: 50))") { try image.edges(.canny(sigma: 50)) }| Виклик | Результат |
|---|---|
gamma(20) |
invalidOption: «must be a finite value from 0.1 to 10» |
threshold(300) |
invalidOption: «must be in 0…255» |
modulate з brightness чи saturation поза 0…100 або нескінченним hue |
invalidOption |
clahe з maxSlope поза 0…100 |
invalidOption |
clahe на float-зображенні |
HokusaiError.unsupported |
normalize на зображенні не 8- чи 16-бітному |
не підтримується (операція вимагає 8- або 16-бітного зображення) |
Пов’язане
Section titled “Пов’язане”- Фільтри (
linearіrecombineдля керування по каналах) - Прозорість