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

Розмиття та різкість

blur пом’якшує зображення гауссовим фільтром, для тла, приватності та згладжування. sharpen застосовує нерізку маску до яскравості, щоб повернути чіткість, втрачену під час зменшення.

blur(sigma:precision:minAmplitude:); простий blur() — це легке розмиття з sigma: 1.

Параметр Тип За замовчуванням Примітки
sigma Double 1 Радіус розмиття в пікселях; скінченний і більший за нуль.
precision BlurPrecision .integer .integer, .float, .approximate: обмін точності на швидкість.
minAmplitude Double 0.2 Скінченний, більший за нуль і не більший за 10; менший дає ширшу, точнішу маску.
let image = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 480)
for sigma in [1.0, 4.0, 10.0] {
try await image.blur(sigma: sigma).webp(quality: 85)
.write(to: URL(fileURLWithPath: "sigma-\(Int(sigma)).webp"))
}
// Pixels are weighted by alpha, so a transparent edge does not bleed colour into the blur.
try await Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 200)
.blur(sigma: 6).png().write(to: URL(fileURLWithPath: "emblem-blur.png"))
  • Пейзаж із ледь помітним розмиттям.
    sigma 1WEBP · 480 × 300 · 7 KB
  • Пейзаж із чітким розмиттям; смуги маяка зливаються.
    sigma 4WEBP · 480 × 300 · 3 KB
  • Сильно розмитий пейзаж; лишилися лише форми й кольори.
    sigma 10WEBP · 480 × 300 · 2 KB
  • Розмита емблема на прозорості з м’якими краями й без темного німба.
    з альфа-каналомPNG · 200 × 200 · 36 KB

Пікселі зважуються за альфою, тож прозорі ділянки не розтікаються кольором у розмитті: краї емблеми пом’якшуються без темної облямівки. Більший sigma коштує більше часу й пам’яті на піксель.

sharpen(sigma:) — коротка форма (sigma за замовчуванням 1). sharpen(_ options: SharpenOptions) відкриває керування нерізкою маскою. Альфа не змінюється.

SharpenOptions За замовчуванням Значення
sigma 1 Радіус гауссіана для пошуку деталей, у пікселях; більший за нуль.
flat 0 Сила для пласких ділянок.
jagged 3 Сила для різких країв.
threshold 2 Різниця, що відокремлює пласкі ділянки від різких країв.
maxBrightening 10 Максимум, на який піксель може посвітлішати.
maxDarkening 20 Максимум, на який піксель може потемніти.

flat, jagged, threshold, maxBrightening і maxDarkening — скінченні значення від 0 до 1 000 000; типові значення належать libvips.

// Shrinking softens an image; sharpen after resizing, not before.
let small = try Hokusai(url: URL(fileURLWithPath: "scene.png"))
.resize(width: 640)
.extract(x: 380, y: 60, width: 220, height: 220) // look at the lighthouse close up
try await small.png().write(to: URL(fileURLWithPath: "none.png"))
try await small.sharpen().png().write(to: URL(fileURLWithPath: "default.png"))
try await small.sharpen(sigma: 2).png().write(to: URL(fileURLWithPath: "sigma-2.png"))
try await small.sharpen(SharpenOptions(sigma: 1.5, flat: 1, jagged: 6)).png()
.write(to: URL(fileURLWithPath: "custom.png"))
  • Крупний план маяка після зменшення, трохи м’який.
    без різкостіPNG · 220 × 220 · 41 KB
  • Той самий крупний план із чіткішими краями смуг.
    sharpen()PNG · 220 × 220 · 41 KB
  • Крупний план із різкістю ширшого радіуса: краї виразніші.
    sigma 2PNG · 220 × 220 · 45 KB
  • Крупний план із сильною різкістю, зокрема на пласких ділянках.
    flat 1, jagged 6PNG · 220 × 220 · 52 KB
  • Додавайте різкість після зміни розміру, а не до. Зменшення пом’якшує зображення, а різкість повнорозмірного зображення перед великим зменшенням частково втрачається. Дивіться Порядок операцій.
  • Розмиття перед великим зменшенням також марна робота: спершу зменшіть, потім розмийте в остаточному масштабі.
  • blur і sharpen не змінюють розмір зображення; sharpen не чіпає альфу, а blur зважує пікселі за альфою.

blur(sigma: 0) викидає HokusaiError.invalidOption («must be a finite value above zero»), як і нескінченний sigma, minAmplitude поза (0, 10] та SharpenOptions поза діапазоном. Усе викидається під час побудови конвеєра.