THPDFHeadlessRenderAccess
Запись в HPDFHeadlessRenderAccess возвращается методом THPDFHeadlessDocument.GetRenderAccess(PageIndex) для последовательного доступа «только чтение» к текущему графу документа
Владеющий документ должен оставаться загруженным и неизменным всё время использования; указатели, словари ресурсов и результаты callback заимствуются, и вызывающие не должны освобождать или менять их
| Поле | Контракт |
|---|---|
Context | Непрозрачный указатель документа, передаваемый без изменений в каждый callback |
PageDictionary, PageResources | Разрешённый словарь страницы и унаследованный словарь ресурсов |
Resolve: THPDFHeadlessRenderResolve | Разрешает заимствованный объект через существующие пути xref, object-stream и безопасности |
ReadStream: THPDFHeadlessRenderReadStream | Возвращает декодированные байты с применением переданного максимума до декодирования, ограниченные бюджетом документа |
ReadImageBytes: THPDFHeadlessRenderReadImage | Аутентифицирует и расшифровывает поток изображения, декодирует ограниченные префиксные фильтры и возвращает либо декодированные отсчёты, либо финальную полезную нагрузку JPEG, JPEG 2000, CCITT или JBIG2 вместе с именем терминального фильтра и заимствованным словарём DecodeParms |
FontResolver: THPDFHeadlessRenderFontResolver | Создаёт интерфейс к существующему декодеру шрифтов ресурсов |
RequireExtractionPermission: THPDFHeadlessRenderPermission | Проверяет отмену и аутентифицированное право на извлечение |
RequireOutputPath: THPDFHeadlessRenderOutputPath | Проверяет отмену и отклоняет алиасы источника по каноническому пути и физической идентичности файла, не создавая файл |
CancellationToken | Заимствованный токен отмены документа во владении вызывающего |
MaxDecodedBytes, MaxDepth | Верхние границы, унаследованные от опций документа |
CatalogDictionary: THPDFDictionaryObject одалживает разрешённый catalog для конфигурации optional-content; nil означает, что catalog не передан и структуры optional-content не влияют на видимость
ResolveOptional: THPDFHeadlessRenderResolve разрешает членства в optional-группах и возвращает nil для отсутствующих, удалённых ссылок или ссылок устаревшего поколения; корректные живые объекты сохраняют обычные проверки разбора, object-stream, безопасности, отмены и глубины, а их ошибки пробрасываются
Инициализируйте вручную собранные записи доступа через Default(THPDFHeadlessRenderAccess) до назначения callback; nil ResolveOptional использует обычный резолвер, а nil catalog сохраняет рендеринг без конфигурации optional-content
Выходные рендереры должны вызывать RequireOutputPath(Context, FileName) до создания файла и применять собственные политики staging, публикации и бюджета назначения
Lifetime: IHPDFHeadlessRenderLifetime удерживает аренду времени жизни графа; nil остаётся допустимым для статического рендеринга, а явные состояния просмотрщика требуют действующей аренды и отклоняют истёкший доступ до вызова callback
Представление становится недействительным после закрытия, перезагрузки, изменения или уничтожения владеющего документа