Опциональные document handler'ы

THPDFDocumentHandlerRegistry выбирает заменяемые handler'ы сначала по инспектированному содержимому и лишь затем по слабым подсказкам расширения или MIME, после чего конвертирует выбранный источник в один неизменяемый PDF cache, общий для экспорта и рендеринга

Встроенные опциональные handler'ы

• XPS и OpenXPS сохраняют размеры фиксированных страниц и визуальный порядок, конвертируют сокращённую геометрию Path — самозакрывающуюся или с property-элементами — в нативные PDF-векторы, сохраняют сплошные заливки из атрибутов и property-элементов, shading pattern многостоповых LinearGradientBrush и эллиптических RadialGradientBrush, а также заливают пути через package-ресурсы ImageBrush с JPEG, PNG, TIFF или JPEG XR при TileMode=None
• Заливки изображениями в XPS поддерживают абсолютное или RelativeToBoundingBox отображение Viewbox и Viewport, tile-режимы None, Tile, FlipX, FlipY и FlipXY, нативный clipping путей и размещений, конечные шестипараметровые атрибуты Transform или элементы MatrixTransform в ImageBrush.Transform, прозрачность кистей и путей, альфу PNG soft mask, DPI изображений и кэширование package-ресурсов
• Path.OpacityMask в XPS поддерживает сплошные маски, многостоповые линейные или эллиптические радиальные градиенты и маски PNG ImageBrush, включая повторяющиеся и отражённые ячейки изображения; однородная альфа сворачивается в существующие графические состояния, а переменная альфа использует ограниченные нативные transparency group DeviceGray, которые шарят shading pattern и soft mask stream изображений
• Canvas Opacity и Canvas.OpacityMask в XPS компонуют перекрывающихся потомков один раз через изолированные Form XObject DeviceRGB вместо ослабления каждого ребёнка по отдельности; однородная альфа маски сворачивается в состояние группы, переменная градиентная или PNG-альфа переиспользует нативные soft mask ресурсы, а вложенные группы сохраняют трансформированные clipping, владение ресурсами и ограниченные link annotation в пределах 4 096 групп и 16 MiB захваченного содержимого на группу
• VisualBrush в XPS рекурсивно конвертирует inline- или ресурсные визуалы Canvas, Path и Glyphs, разрешает вложенные и удалённые области ResourceDictionary, отображает абсолютный Viewbox в абсолютный или относительный Viewport и переиспользует один ограниченный PDF Form XObject при прямых, tiled и отражённых размещениях
• Canvas.Clip в XPS принимает ограниченную сокращённую геометрию, локальные или удалённые значения PathGeometry из StaticResource и прямые property-элементы со структурными фигурами — линиями, Bézier, квадратичными кривыми или дугами, — трансформациями геометрии, пустой геометрией и правилами заливки EvenOdd или NonZero; вложенные clipping становятся нативными PDF-путями W* или W, прямоугольники навигации пересекаются с активными трансформированными границами clip, разбор ограничен 100 000 числовых значений, а некорректные или вырожденные clip безопасно отказывают до отрисовки дочерних визуалов
• Glyphs в XPS принимает не более 65 536 строгих соответствий Indices, сохраняет прогрессию кластеров «один ко многим» и «многие к одному», явные advances в сотых долях em, горизонтальные и вертикальные смещения, обратную прогрессию при нечётном BidiLevel, сплошные заливки из атрибутов или property-элементов, прозрачность, извлечение Unicode и диагностику некорректного ввода с безопасным отказом; простые run используют нативные PDF-массивы TJ, а большие mapping-буферы растут с амортизированно линейной стоимостью
• Ресурсы FontUri в package поддерживают программы TrueType и OpenType, фрагменты членов TTC и обфусцированные по GUID шрифты XPS; точные glyph ID, run из cmap, кластеры, advances, смещения, RTL-начала, переиспользование font-ресурсов, права на встраивание, опциональный subsetting и карты извлечения ToUnicode остаются нативными данными шрифтов PDF без подмены через GDI
• FixedPage.NavigateUri в XPS на трансформированных визуалах Path и Glyphs становится нативной link annotation PDF с границами, выведенными из геометрии или метрик; ссылки HTTP, HTTPS и mail остаются URI-действиями, а package-относительные страницы и percent-декодированные фрагменты LinkTarget становятся GoTo-действиями вперёд или назад, когда доступны все страницы
• FixedPage.NavigateUri на Canvas становится унаследованной целью каждого дочернего визуала Path, Glyphs или вложенного Canvas, пока потомок не задаст собственный URI; scoped-цели восстанавливаются после вложенных переопределений, следуют геометрии и трансформации каждого визуала, остаются ограниченными активными Canvas clip, переживают изолированный захват opacity-групп и подавляются внутри переиспользуемых VisualBrush Forms
• Навигация ограничена 65 536 ссылками и 8 192 символами на URI, проверяется на отмену при публикации, подавляется во время повторно используемого захвата VisualBrush и отклоняется при управляющих символах, небезопасных схемах, отсутствующих целях или несовпадении путей и фрагментов
• Нестандартный RelativeTransform, неразрешённые matrix-ресурсы, spread градиента Repeat или Reflect, интерполяция вне sRGB, красящие кисти с переменной альфой, преобразование цвета, обводки изображениями, относительные viewbox у VisualBrush, имитация стилей, глифы с боковым набором и продвинутые свойства stroke остаются явными диагностиками
• EPUB разрешает container.xml, manifest и порядок spine, затем использует ограниченный HTML5 paged-media importer с доступом к package-ресурсам только через callback
• CBZ распознаёт поддерживаемые записи изображений, применяет детерминированный естественный порядок имён файлов и создаёт по странице на изображение с настроенным image DPI

Бюджеты и изоляция сбоев

Одна проверенная проходка по центральному каталогу ZIP поддерживает лимиты на записи, сжатые и распакованные байты, размер отдельной записи, дубликаты путей, небезопасные пути и коэффициент сжатия до конвертации

Записи классического PKZIP ZipCrypto могут запрашивать учётные данные через ArchivePasswordCallback: callback получает имя источника, имя записи и номер попытки, начиная с единицы, а MaxPasswordAttempts ограничивает повторы диапазоном от 1 до 16

Учётные данные и частично декодированные байты записи остаются в памяти и стираются между попытками, отмена проверяется до и после каждого callback, а отсутствие callback, отклонённые учётные данные, исчерпанные повторы или неподдерживаемое шифрование приводят к безопасному отказу

ZipCrypto — устаревшая парольная защита, а не современная аутентифицированная encryption, и соглашения о байтах не-ASCII паролей могут различаться у разных производителей ZIP

Записям, защищённым паролем, нужен Delphi 12 или новее, чей System.Zip открывает hook расшифровки; собранные с более ранней версией Delphi, обработчики всё ещё читают незашифрованные записи, но отклоняют зашифрованные как неподдерживаемые до вызова ArchivePasswordCallback

Записи, чьи размеры или смещения требуют полей ZIP64, требуют Delphi 11 или новее; более ранние версии Delphi отклоняют их как неподдерживаемые

Лимиты на ресурсы, reflow, страницы, пиксели, DPI, вывод и отмену действуют на протяжении всей конвертации и рендеринга, а при неудачной публикации вывода восстанавливается seekable целевой stream

Регистрация и использование

var
  Registry: THPDFDocumentHandlerRegistry;
  Options: THPDFDocumentHandlerOptions;
  Handled: IHPDFHandledDocument;
  Info: THPDFDocumentHandlerInfo;
begin
  Registry:= THPDFDocumentHandlerRegistry.Create;
  try
    Registry.RegisterStandardHandlers;
    Options:= THPDFDocumentHandlerOptions.Default;
    Options.ArchivePasswordCallback:= SupplyArchivePassword;
    if Registry.OpenFromFile('book.epub', '', Options, Handled, Info) then
      Handled.WritePDF(OutputStream, Options, Info);
  finally
    Registry.Free;
  end;
end;

Связанные API

• THPDFDocumentHandlerRegistry
• IHPDFDocumentHandler
• IHPDFHandledDocument
• THPDFDocumentHandlerOptions
• Импорт HTML5 paged media