PDF-звіт
Мета. Односторінковий звіт A4, текст якого лишається виділюваним і придатним до пошуку, з обрізаннями фото, підготовленими Hokusai. Вхідні дані: scene.png. Потрібно: Hokusai 2.2.2 із продуктом HokusaiPDF та Pango 1.44+.
// A two-page report: raster images prepared by Hokusai, laid out as a vector document.let ink = Color(red: 0.1, green: 0.14, blue: 0.3)let source = try Hokusai(url: URL(fileURLWithPath: "scene.png"))
var page = try VectorPage(size: .a4()) .rectangle(VectorRect(x: 0, y: 0, width: 595.276, height: 90), fill: .color(ink)) .text("Field report", at: VectorPoint(x: 40, y: 28), style: VectorTextStyle(size: 30, weight: .bold, color: .white))for (index, position) in [ResizePosition.center, .east, .attention].enumerated() { let photo = try source.resize(width: 480, height: 480, fit: .cover, position: position) page = try page.image(photo, frame: VectorRect(x: 40 + Double(index) * 180, y: 120, width: 170, height: 170), fit: .cover)}page = try page.text(.markup("Three crops of the same <b>1600 × 1000</b> original: centre, east and attention."), at: VectorPoint(x: 40, y: 310), width: 515, style: VectorTextStyle(size: 12, lineSpacing: 1.3))
let info = try await VectorDocument(page, metadata: PDFDocumentMetadata(title: "Field report")) .write(to: URL(fileURLWithPath: "field-report.pdf"))print("report →", info.pageCount, "page,", info.byteCount, "bytes")
field-report.pdfPDF · 595 × 842 · 352 KB
Як це працює
Section titled “Як це працює”- Компонування векторне (
HokusaiPDF): смуга шапки — це прямокутник, заголовок і підпис — справжній текст (підпис використовує розмітку Pango для жирної частини). Виділіть заголовок у переглядачі PDF, щоб переконатися. - Зображення — це конвеєри Hokusai: три обрізання
resize(…, fit: .cover, position: …)одного джерела, вбудовані як растри за розміром рамки. Сторінки малюються по одній, тож пам’ять — як для однієї сторінки. - Координати — пункти від лівого верхнього кута; A4 книжкова — 595,276 × 841,89 пт.
- Результат: 1 сторінка, 360 320 байтів.
Варіації
Section titled “Варіації”- Растровий PDF зображення (скан, діаграма):
image.pdf(pageSize: .a4(), margins: .all(36), background: .white)(Растровий PDF); текст тоді — це пікселі. - Більше сторінок:
VectorDocument(pages: [...]). - Відтворюваний вивід: задайте
PDFDocumentMetadata.creationDate, інакше Cairo запише поточний час. - Обкладинка з градієнтом:
.background(.linearGradient(from:to:angle:))(Векторні документи).