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

Композиція

composite(_:space:) малює один або кілька CompositeLayer поверх конвеєра, у порядку масиву, однією нативною операцією. Шар сам є конвеєром, тож логотип можна підготувати раз і застосувати до багатьох зображень. Діють лише перетворення зображення шару; його кодувальник і налаштування метаданих ігноруються, і шар ніколи не кодується для накладання.

Властивість За замовчуванням Примітки
зображення обов’язково Інший конвеєр Hokusai.
placement / x, y .at(x: 0, y: 0) CompositeLayer(_:x:y:blend:opacity:) — коротка форма.
blend .over Як пікселі шару поєднуються з тим, що під ним.
opacity 1 Множить альфу шару, 0…1; поза цим діапазоном invalidOption під час виклику composite.

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
  • Пейзаж з емблемою біля нижнього правого кута з непрозорістю 85 відсотків.
    .southEast, відступ 16WEBP · 560 × 350 · 10 KB
  • У нижньому лівому куті видно лише частину емблеми: решта обрізана.
    .at(−45, 300)WEBP · 560 × 350 · 10 KB
  • Емблема, повторена як ледь помітний візерунок по всьому пейзажу.
    .tile, opacity 0.25WEBP · 560 × 350 · 20 KB

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 лишайте для логотипів із прозорістю.

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
  • Рампа від чорного до світліше-сірого, ніж у результаті sRGB.
    .linearPNG · 360 × 120 · 2 KB

У .linear напівпрозорий чорний шар виходить світлішим, ніж у .srgb, як показує приклад. Використовуйте .linear для фізично правдоподібного змішування світла; лишайте типове, щоб збігатися з тим, що намалював би браузер.

Пізніші шари малюються поверх ранніх, а порядок масиву — це порядок нашарування. Оскільки шар — це конвеєр, його можна спершу розмити, змінити розмір чи перефарбувати:

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
Ситуація Результат
opacity поза 0…1 або нескінченна invalidOption, викидається composite
Шар, що не завантажується чи не виконується помилка завершальної операції, яка виконує основу