Обертання, віддзеркалення та афінні перетворення
Ці операції переміщують пікселі, не змінюючи їхнього кольору: autoOrient застосовує орієнтацію, записану камерою, rotate повертає зображення на будь-який кут, flip і flop віддзеркалюють його, а affine застосовує загальне перетворення 2 × 2.
autoOrient
Section titled “autoOrient”Камери часто зберігають пікселі боком і записують в 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 appliedprint("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 
autoOrient()JPEG · 1600 × 1000 · 76 KB
Без autoOrient() виклик resize(width: 800) для цього фото змінив би збережену ширину, що є короткою стороною картинки. Ставте його перед resize (і перед extract, smartCrop чи будь-чим, що залежить від ширини й висоти). Він нічого не робить для зображення без тега орієнтації або з орієнтацією «вгору». Чи зберігатиме вивід тег орієнтації, вирішує окремо політика метаданих: за замовчуванням тег орієнтації зберігається, removeAll прибирає його, не чіпаючи пікселів (вище саме тому як збережено показує пікселі боком).
rotate
Section titled “rotate”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"))
90°PNG · 200 × 200 · 9 KB 
30°, тло паперуPNG · 273 × 273 · 23 KB 
30°, типовоPNG · 273 × 273 · 19 KB
Точні прямі кути без втрат: ширина й висота міняються місцями, жоден піксель не ресемплюється. Будь-який інший кут ресемплює за interpolation і збільшує полотно, щоб вмістити повернуте зображення (200 × 200 на 30° стає 273 × 273). Для піксель-арту використовуйте .nearest, в інших випадках — типове. Для орієнтації камери використовуйте autoOrient(), а не rotate.
flip і flop
Section titled “flip і flop”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 ↔ bottomtry 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
Section titled “affine”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 
масштаб + outputAreaPNG · 260 × 100 · 7 KB
Порядок і поєднання
Section titled “Порядок і поєднання”- Спершу
autoOrient(), потім операції, що залежать від розміру (Орієнтація та зміна розміру). - Обертання не на прямий кут збільшує полотно, тож наступні
extractабоresizeбачать більший розмір. - Повернуте зображення має прозорі кути; кодування в JPEG, який не має альфа-каналу, потребує попереднього
flatten(Прозорість).