Композиція
composite(_:space:) малює один або кілька CompositeLayer поверх конвеєра, у порядку масиву, однією нативною операцією. Шар сам є конвеєром, тож логотип можна підготувати раз і застосувати до багатьох зображень. Діють лише перетворення зображення шару; його кодувальник і налаштування метаданих ігноруються, і шар ніколи не кодується для накладання.
CompositeLayer
Section titled “CompositeLayer”| Властивість | За замовчуванням | Примітки |
|---|---|---|
| зображення | обов’язково | Інший конвеєр Hokusai. |
placement / x, y |
.at(x: 0, y: 0) |
CompositeLayer(_:x:y:blend:opacity:) — коротка форма. |
blend |
.over |
Як пікселі шару поєднуються з тим, що під ним. |
opacity |
1 |
Множить альфу шару, 0…1; поза цим діапазоном invalidOption під час виклику composite. |
Розміщення
Section titled “Розміщення”Placement — це положення лівого верхнього кута шару, записане трьома способами:
.at(x:y:): точні координати в пікселях. Вони можуть бути від’ємними чи виходити за основу; шар обрізається за основою..gravity(_:offsetX:offsetY:): прив’язка до сторони світу основи. Біля краю зсув — це відступ усередину (для.southEastвліво й угору); уздовж центрованої осі це зсув зі знаком..tile(gravity:): шар, повторений від краю до краю по всій основі, одна плитка вирівняна заgravity; для шарів-зображень.
let photo = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 560)let logo = try Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 90)
let placements: [(String, Placement, Double)] = [ ("at", .at(x: 20, y: 20), 1), ("gravity", .gravity(.southEast, offsetX: 16, offsetY: 16), 0.85), ("clipped", .at(x: -45, y: 300), 1), // partly outside: clipped to the base ("tile", .tile(gravity: .northWest), 0.25),]for (name, placement, opacity) in placements { try await photo .composite([CompositeLayer(logo, placement: placement, opacity: opacity)]) .webp(quality: 85) .write(to: URL(fileURLWithPath: "\(name).webp"))}
.at(20, 20)WEBP · 560 × 350 · 11 KB 
.southEast, відступ 16WEBP · 560 × 350 · 10 KB 
.at(−45, 300)WEBP · 560 × 350 · 10 KB 
.tile, opacity 0.25WEBP · 560 × 350 · 20 KB
Режими змішування
Section titled “Режими змішування”BlendMode відповідає наборам Porter-Duff і PDF, які реалізує libvips: clear, source, over (типово), in, out, atop, варіанти destination…, xor, add, saturate, multiply, screen, overlay, darken, lighten, colorDodge, colorBurn, hardLight, softLight, difference, exclusion. source замінює те, що під ним, clear стирає; in, out і atop залишають частину шару чи основи залежно від альфи іншого боку.
Тут шар — це рампа від чорного до білого поверх пейзажу:
let photo = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 360)// The layer is the black-to-white ramp, resized to the photo.let ramp = try Hokusai(url: URL(fileURLWithPath: "mask.png")).resize(width: 360, height: 225, fit: .fill)
let modes: [(String, BlendMode)] = [ ("over", .over), ("multiply", .multiply), ("screen", .screen), ("overlay", .overlay), ("difference", .difference), ("softLight", .softLight),]for (name, mode) in modes { try await photo .composite([CompositeLayer(ramp, blend: mode)]) .webp(quality: 85) .write(to: URL(fileURLWithPath: "\(name).webp"))}
.overWEBP · 360 × 225 · 1 KB 
.multiplyWEBP · 360 × 225 · 4 KB 
.screenWEBP · 360 × 225 · 4 KB 
.overlayWEBP · 360 × 225 · 6 KB 
.differenceWEBP · 360 × 225 · 6 KB 
.softLightWEBP · 360 × 225 · 6 KB
.over з непрозорим шаром просто замінює основу. .multiply затемнює, .screen освітлює, .overlay і .softLight додають контраст, .difference — для порівняння, а .over лишайте для логотипів із прозорістю.
Кольоровий простір
Section titled “Кольоровий простір”space — це кольоровий простір, у якому змішуються шари: .srgb (типово) змішує збережені значення, як це роблять дизайнерські інструменти й браузери; .linear змішує лінійне світло, тобто так, як змішується світло. Чорний шар на 50 % поверх сірої рампи:
let backdrop = try Hokusai(url: URL(fileURLWithPath: "mask.png")).resize(width: 360, height: 120, fit: .fill)// A single black pixel enlarged into a 360 × 120 layer, at half opacity.let black = try Hokusai(raw: Data([0, 0, 0]), width: 1, height: 1, format: .rgb8) .resize(width: 360, height: 120, fit: .fill, kernel: .nearest)
for (name, space) in [("srgb", CompositingSpace.srgb), ("linear", .linear)] { try await backdrop .composite([CompositeLayer(black, opacity: 0.5)], space: space) .png() .write(to: URL(fileURLWithPath: "\(name).png"))}
.srgbPNG · 360 × 120 · 2 KB 
.linearPNG · 360 × 120 · 2 KB
У .linear напівпрозорий чорний шар виходить світлішим, ніж у .srgb, як показує приклад. Використовуйте .linear для фізично правдоподібного змішування світла; лишайте типове, щоб збігатися з тим, що намалював би браузер.
Порядок
Section titled “Порядок”Пізніші шари малюються поверх ранніх, а порядок масиву — це порядок нашарування. Оскільки шар — це конвеєр, його можна спершу розмити, змінити розмір чи перефарбувати:
let base = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 360)let big = try Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 200)let small = try Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 120).negate()
// Later layers draw over earlier ones.let a = [CompositeLayer(big, x: 90, y: 10), CompositeLayer(small, x: 150, y: 50)]try await base.composite(a).webp(quality: 85).write(to: URL(fileURLWithPath: "small-on-top.webp"))try await base.composite(a.reversed()).webp(quality: 85).write(to: URL(fileURLWithPath: "big-on-top.webp"))
// A layer is a pipeline of its own: its transformations apply, its encoder choice is ignored.let blurred = try big.blur(sigma: 6).png()try await base.composite([CompositeLayer(blurred, x: 90, y: 10)]).webp(quality: 85) .write(to: URL(fileURLWithPath: "layer-pipeline.webp"))
велика, потім малаWEBP · 360 × 225 · 8 KB 
у зворотному порядкуWEBP · 360 × 225 · 7 KB 
шар спершу розмитоWEBP · 360 × 225 · 5 KB
Помилки
Section titled “Помилки”| Ситуація | Результат |
|---|---|
opacity поза 0…1 або нескінченна |
invalidOption, викидається composite |
| Шар, що не завантажується чи не виконується | помилка завершальної операції, яка виконує основу |