Растровий PDF
pdf(pageSize:margins:anchor:background:maxEffectiveDPI:metadata:) — це кодувальник растрового документа. Виконані пікселі вбудовуються як зображення на одній сторінці Cairo. Текст, намальований у конвеєрі, вже став пікселями, тож він не виділюється, а вхідний PDF, який растеризують і записують знову, втрачає векторний вміст, посилання та структуру. Для тексту, що лишається текстом, використовуйте векторні документи.
| Параметр | Тип | За замовчуванням | Примітки |
|---|---|---|---|
pageSize |
PDFPageSize |
.image() |
.image(dpi:) (типово 72), .a4(_ orientation), .letter(_ orientation), .points(width:height:). |
margins |
PDFMargins |
.none |
Пункти: PDFMargins(top:leading:bottom:trailing:) або .all(_). |
anchor |
Gravity |
.center |
Де в межах полів розташований вписаний растр. |
background |
Color? |
nil |
Заливає сторінку за растром. nil лишає сторінку незафарбованою, а прозорі пікселі лишаються прозорими; для друку використовуйте .white. |
maxEffectiveDPI |
Double? |
nil |
Якщо ефективна роздільність растру на сторінці перевищує це значення, його зменшують (Lanczos) перед вбудовуванням. Типово вимкнено: Hokusai ніколи не ресемплює через те, що сторінка має фізичний розмір. |
metadata |
PDFDocumentMetadata? |
nil |
title, author, subject, keywords, creator, creationDate, modificationDate. Нічого не копіюється з EXIF, XMP чи IPTC зображення. |
let image = try Hokusai(url: URL(fileURLWithPath: "scene.png")).resize(width: 800)
func describe(_ name: String, _ info: OutputInfo) { let page = info.pdf.map { "\($0.pageCount) page, \(Int($0.pageWidth.rounded())) × \(Int($0.pageHeight.rounded())) pt" } ?? "?" print(name, "→", page, info.byteCount, "bytes")}
// Page sized from the raster: 800 px at 72 dpi is 800 pt; at 150 dpi it is 384 pt.describe("image", try await image.pdf().write(to: URL(fileURLWithPath: "image.pdf")))describe("image-150dpi", try await image.pdf(pageSize: .image(dpi: 150)).write(to: URL(fileURLWithPath: "image-150dpi.pdf")))
// Fixed paper: the raster is fitted inside the margins and anchored (centred by default).describe("a4", try await image.pdf(pageSize: .a4(), margins: .all(36), background: .white) .write(to: URL(fileURLWithPath: "a4.pdf")))describe("letter-landscape", try await image.pdf(pageSize: .letter(.landscape), margins: .all(24), anchor: .north, background: Color(red: 0.97, green: 0.95, blue: 0.9), metadata: PDFDocumentMetadata(title: "Pharos Point", author: "Docs")) .write(to: URL(fileURLWithPath: "letter-landscape.pdf")))
.image()PDF · 800 × 500 · 184 KB 
.a4(), поля 36PDF · 595 × 842 · 184 KB 
.letter(.landscape), .northPDF · 792 × 612 · 185 KB
Програма вивела факти про сторінку з OutputInfo.pdf:
| Виклик | Сторінка (пункти) | Розмір файлу |
|---|---|---|
pdf() для 800 px |
800 × 500 (72 dpi) | 188 866 байтів |
pdf(pageSize: .image(dpi: 150)) |
384 × 240 | 188 866 байтів |
pdf(pageSize: .a4(), margins: .all(36), background: .white) |
595 × 842 | 188 921 байт |
pdf(pageSize: .letter(.landscape), …) |
792 × 612 | 188 933 байти |
Розмір сторінки змінює сторінку, а не вбудований растр: розмір файлу майже не змінюється. Фіксований розмір паперу не має роздільності; ефективний DPI растру випливає з його розміру в пікселях і площі, в яку його розміщено. Змініть розмір зображення до потрібної роздільності перед pdf() (для 150 dpi на A4 це приблизно 1240 px завширшки) або задайте maxEffectiveDPI.
Вивід і помилки
Section titled “Вивід і помилки”write(to:) записує файл безпосередньо в міру того, як його створює Cairo; data() збирає байти того самого запису. OutputInfo.pdf повідомляє pageCount, pageWidth і pageHeight.
| Виклик | Результат |
|---|---|
.image(dpi: 0) |
invalidOption(name: "pageSize.dpi", …"must be a finite value greater than zero") |
| Хибні поле, межа DPI чи розмір сторінки | invalidOption, викидається під час виклику pdf |
| Підтримка PDF-виводу | PDF-вивід використовує Cairo і не залежить від підтримки PDF-входу; capabilities().outputFormats показує, що може записувати ця збірка |