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

Соціальна картка

Мета. Перетворити фото й заголовок на зображення 1200 × 630, яке месенджери та соцмережі показують для посилання. Вхідні дані: scene.png і phone.jpg. Потрібно: Hokusai 2.2.2 із відтворенням тексту (capabilities().textRendering).

// 1200 × 630 is the usual size for link previews.
func socialCard(from photo: URL, title: String) throws -> Hokusai {
var style = TextStyle(font: "sans Bold", fontSize: 64, color: .white)
style.shadow = TextShadow(offsetX: 3, offsetY: 3, blur: 4, color: Color(red: 0, green: 0, blue: 0, opacity: 0.75))
return try Hokusai(url: photo)
.autoOrient()
.resize(width: 1200, height: 630, fit: .cover, position: .attention)
.drawText(.plain(title), placement: .gravity(.southWest, offsetX: 56, offsetY: 48),
layout: .width(900), style: style)
}
let card = try socialCard(from: URL(fileURLWithPath: "scene.png"), title: "Keeping the light: a year at Pharos Point")
try await card.webp(quality: 82).write(to: URL(fileURLWithPath: "card.webp"))
try await card.jpeg(quality: 85).write(to: URL(fileURLWithPath: "card.jpg")) // fallback for crawlers
// Variation: the same recipe from a phone photo, which needs autoOrient.
try await socialCard(from: URL(fileURLWithPath: "phone.jpg"), title: "From a phone, upright")
.webp(quality: 82).write(to: URL(fileURLWithPath: "card-from-phone.webp"))
  • Пейзаж, обрізаний до 1200 на 630, із заголовком Keeping the light, a year at Pharos Point білим у лівому нижньому куті.
    card.webpWEBP · 1200 × 630 · 26 KB
  • Та сама картка як JPEG для краулерів, що не читають WebP.
    card.jpg (запасний)JPEG · 1200 × 630 · 62 KB
  • Картка, зроблена з фото з телефона, що лежало боком: вертикальна, з коротшим заголовком.
    з фото з телефонаWEBP · 1200 × 630 · 21 KB
  1. autoOrient() робить фото з телефона вертикальним до того, як щось його виміряє, тож та сама функція працює для будь-якого завантаження (чому).
  2. resize(width: 1200, height: 630, fit: .cover, position: .attention) заповнює картку точно й обрізає до цікавої частини: маяк лишається в кадрі, навіть позацентровий (позиція).
  3. drawText(…) розміщує заголовок через .gravity(.southWest, offsetX:, offsetY:), тож він лишається за 56 px від лівого й 48 px від нижнього краю за будь-якого розміру картки. layout: .width(900) переносить довгі заголовки; тінь робить білий текст читабельним на будь-якому небі (текст).
  4. webp(quality: 82) для вебу й JPEG як запасний для краулерів.
  • Довші заголовки: .width(900) переносить за 900 px; зменште fontSize або використайте .fit(width: 900, height: 200), щоб гарантувати, що текст вміщується в блок.
  • Інші співвідношення сторін (1:1, 1,91:1): змінюйте лише рамку resize.
  • Фото з темним морем і яскравим небом: лишіть тінь або накладіть затемнювальний шар .multiply під текстом (режими змішування).
  • Власні шрифти: TextStyle(fontFile:), коли на хості не встановлено ваш шрифт.