Розмиття та різкість
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
Section titled “sharpen”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
Порядок і поєднання
Section titled “Порядок і поєднання”- Додавайте різкість після зміни розміру, а не до. Зменшення пом’якшує зображення, а різкість повнорозмірного зображення перед великим зменшенням частково втрачається. Дивіться Порядок операцій.
- Розмиття перед великим зменшенням також марна робота: спершу зменшіть, потім розмийте в остаточному масштабі.
blurіsharpenне змінюють розмір зображення;sharpenне чіпає альфу, аblurзважує пікселі за альфою.
Помилки
Section titled “Помилки”blur(sigma: 0) викидає HokusaiError.invalidOption («must be a finite value above zero»), як і нескінченний sigma, minAmplitude поза (0, 10] та SharpenOptions поза діапазоном. Усе викидається під час побудови конвеєра.