Соціальна картка
Мета. Перетворити фото й заголовок на зображення 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"))
card.webpWEBP · 1200 × 630 · 26 KB 
card.jpg (запасний)JPEG · 1200 × 630 · 62 KB 
з фото з телефонаWEBP · 1200 × 630 · 21 KB
Як це працює
Section titled “Як це працює”autoOrient()робить фото з телефона вертикальним до того, як щось його виміряє, тож та сама функція працює для будь-якого завантаження (чому).resize(width: 1200, height: 630, fit: .cover, position: .attention)заповнює картку точно й обрізає до цікавої частини: маяк лишається в кадрі, навіть позацентровий (позиція).drawText(…)розміщує заголовок через.gravity(.southWest, offsetX:, offsetY:), тож він лишається за 56 px від лівого й 48 px від нижнього краю за будь-якого розміру картки.layout: .width(900)переносить довгі заголовки; тінь робить білий текст читабельним на будь-якому небі (текст).webp(quality: 82)для вебу й JPEG як запасний для краулерів.
Варіації
Section titled “Варіації”- Довші заголовки:
.width(900)переносить за 900 px; зменштеfontSizeабо використайте.fit(width: 900, height: 200), щоб гарантувати, що текст вміщується в блок. - Інші співвідношення сторін (1:1, 1,91:1): змінюйте лише рамку
resize. - Фото з темним морем і яскравим небом: лишіть тінь або накладіть затемнювальний шар
.multiplyпід текстом (режими змішування). - Власні шрифти:
TextStyle(fontFile:), коли на хості не встановлено ваш шрифт.