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

Растровий 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")))
  • Сторінка розміру зображення: 800 на 500 пунктів, заповнена пейзажем.
    .image()PDF · 800 × 500 · 184 KB
  • Книжкова сторінка A4 з пейзажем по центру в межах білих полів 36 пунктів.
    .a4(), поля 36PDF · 595 × 842 · 184 KB
  • Альбомна сторінка US Letter кольору паперу з пейзажем, прив’язаним угорі.
    .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.

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 показує, що може записувати ця збірка