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

Обертання, віддзеркалення та афінні перетворення

Ці операції переміщують пікселі, не змінюючи їхнього кольору: autoOrient застосовує орієнтацію, записану камерою, rotate повертає зображення на будь-який кут, flip і flop віддзеркалюють його, а affine застосовує загальне перетворення 2 × 2.

Камери часто зберігають пікселі боком і записують в EXIF-тегу, як їх повернути для показу. autoOrient() застосовує цей тег до пікселів, тож наступні операції та кожен переглядач бачать зображення вертикально. Зразок phone.jpg збережений як 1000 × 1600 пікселів з орієнтацією 6.

// phone.jpg is stored as 1000 × 1600 pixels with EXIF orientation 6 ("rotate to view").
let phone = try Hokusai(url: URL(fileURLWithPath: "phone.jpg"))
// Dropping the orientation tag shows the pixels exactly as stored (browsers would
// otherwise apply the tag and display the stored image upright).
let stored = try await phone.jpeg().metadataPolicy(.removeAll).data()
let upright = try await phone.autoOrient().jpeg().data() // orientation applied
print("stored:", stored.info.width, "×", stored.info.height,
" upright:", upright.info.width, "×", upright.info.height)
try stored.data.write(to: URL(fileURLWithPath: "stored.jpg"))
try upright.data.write(to: URL(fileURLWithPath: "upright.jpg"))
  • Сцена з маяком, що лежить на боці, так, як насправді збережені пікселі.
    як збереженоJPEG · 1000 × 1600 · 81 KB
  • Та сама сцена вертикально, 1600 на 1000 пікселів.
    autoOrient()JPEG · 1600 × 1000 · 76 KB

Без autoOrient() виклик resize(width: 800) для цього фото змінив би збережену ширину, що є короткою стороною картинки. Ставте його перед resize (і перед extract, smartCrop чи будь-чим, що залежить від ширини й висоти). Він нічого не робить для зображення без тега орієнтації або з орієнтацією «вгору». Чи зберігатиме вивід тег орієнтації, вирішує окремо політика метаданих: за замовчуванням тег орієнтації зберігається, removeAll прибирає його, не чіпаючи пікселів (вище саме тому як збережено показує пікселі боком).

rotate(by:background:interpolation:) повертає зображення за годинниковою стрілкою на degrees (скінченне, будь-якого знака).

Параметр Тип За замовчуванням Примітки
by Double обов’язковий Градуси за годинниковою стрілкою. Нескінченне значення викидає invalidOption.
background Color .transparent Заповнює кути, відкриті обертанням не на прямий кут.
interpolation Interpolation .bilinear .nearest, .bilinear, .bicubic, .lbb, .nohalo, .vsqbs.
let image = try Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 200)
let paper = Color(red: 0.96, green: 0.94, blue: 0.88)
// Right angles are exact: width and height swap, no resampling.
let quarter = try await image.rotate(by: 90).png().data()
print("90°:", quarter.info.width, "×", quarter.info.height)
// Any other angle resamples and grows the canvas; the corners are filled with `background`.
let tilted = try await image.rotate(by: 30, background: paper).png().data()
print("30°:", tilted.info.width, "×", tilted.info.height)
try quarter.data.write(to: URL(fileURLWithPath: "rotate-90.png"))
try tilted.data.write(to: URL(fileURLWithPath: "rotate-30.png"))
try await image.rotate(by: 30).png().write(to: URL(fileURLWithPath: "rotate-30-transparent.png"))
  • Емблема 200 пікселів, повернута на чверть оберту; усе ще 200 на 200.
    90°PNG · 200 × 200 · 9 KB
  • Емблема, нахилена на 30 градусів на більшому полотні з кутами кольору паперу.
    30°, тло паперуPNG · 273 × 273 · 23 KB
  • Та сама нахилена емблема з прозорими відкритими кутами.
    30°, типовоPNG · 273 × 273 · 19 KB

Точні прямі кути без втрат: ширина й висота міняються місцями, жоден піксель не ресемплюється. Будь-який інший кут ресемплює за interpolation і збільшує полотно, щоб вмістити повернуте зображення (200 × 200 на 30° стає 273 × 273). Для піксель-арту використовуйте .nearest, в інших випадках — типове. Для орієнтації камери використовуйте autoOrient(), а не rotate.

flip() віддзеркалює зверху вниз; flop() — зліва направо. Обидва точні й не мають параметрів.

let image = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 360)
try await image.flip().png().write(to: URL(fileURLWithPath: "flip.png")) // top ↔ bottom
try await image.flop().png().write(to: URL(fileURLWithPath: "flop.png")) // left ↔ right
  • Пейзаж догори дриґом: море вгорі, небо внизу.
    flip()PNG · 360 × 225 · 58 KB
  • Пейзаж, віддзеркалений зліва направо: маяк тепер ліворуч.
    flop()PNG · 360 × 225 · 58 KB

affine(_:inputOffset:outputOffset:outputArea:edges:interpolation:) застосовує x' = a·x + b·y, y' = c·x + d·y з AffineMatrix(a:b:c:d:). inputOffset та outputOffset (AffineOffset) зсувають до й після матриці, outputArea (AffineArea(x:y:width:height:)) обрізає результат, а edges (ExtendMode, типово прозоро) заповнює те, що відображається ззовні джерела. Матриця має бути оборотною (a·d − b·c ≠ 0), а всі значення — скінченними й розумного розміру, інакше викидається invalidOption.

let image = try Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 200)
let paper = Color(red: 0.96, green: 0.94, blue: 0.88)
// x' = a·x + b·y, y' = c·x + d·y. A shear leans the image; the output grows to fit.
try await image
.affine(AffineMatrix(a: 1, b: 0.4, c: 0, d: 1), edges: .background(paper))
.png().write(to: URL(fileURLWithPath: "shear.png"))
// A non-uniform scale, then `outputArea` crops the result.
try await image
.affine(AffineMatrix(a: 1.6, b: 0, c: 0, d: 0.6),
outputArea: AffineArea(x: 0, y: 0, width: 260, height: 100),
edges: .background(paper))
.png().write(to: URL(fileURLWithPath: "scale-crop.png"))
  • Емблема, зсунута так, що нахилена, на ширшому полотні з кутами кольору паперу.
    зсув b: 0,4PNG · 280 × 200 · 15 KB
  • Емблема, розтягнута по горизонталі й стиснута по вертикалі, а потім обрізана до 260 на 100.
    масштаб + outputAreaPNG · 260 × 100 · 7 KB
  • Спершу autoOrient(), потім операції, що залежать від розміру (Орієнтація та зміна розміру).
  • Обертання не на прямий кут збільшує полотно, тож наступні extract або resize бачать більший розмір.
  • Повернуте зображення має прозорі кути; кодування в JPEG, який не має альфа-каналу, потребує попереднього flatten (Прозорість).