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

Тон і колір

Ці операції змінюють колір і тон, не переміщуючи пікселі. Усі зберігають альфа-канал (окрім зазначених випадків) і виконуються саме там, де ви їх записали в конвеєрі.

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
  • Вицвілий пейзаж із посиленим локальним контрастом, делікатніше, ніж normalize.
    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
Операція Параметри (значення за замовчуванням, межі) Що робить
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-бітним сірим виводам.

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-бітного зображення)