LoadCustomDocument Метод

Загружает PDF из любого TStream с поддержкой позиционирования через блочный ридер PDFium, работающий по запросу, поэтому многогигабайтные документы и источники на удалённых ресурсах или в базе данных не требуют предварительной копии в памяти

LoadCustomDocument — потоковый аналог буферизованных перегрузок LoadDocument. Он опирается на точку входа PDFium FPDF_LoadCustomDocument через вспомогательный класс TPdfStreamAdapter, появившийся в v1.8.0. PDFium извлекает блоки из AStream только по мере необходимости, поэтому поток не копируется в память: TFileStream поверх PDF на 4 ГБ, TStream поверх HTTP или поток BLOB из базы данных становятся пригодны к работе без предварительного размещения всего содержимого в RAM

AStream должен поддерживать позиционирование. Его время жизни должно простираться до закрытия документа (вызовите UnloadDocument или верните Active в False). Передайте AOwnsStream = True, чтобы отдать владение потоком этому TPdf — тогда адаптер освободит AStream при выполнении UnloadDocument. Передайте False, если вызывающая сторона хочет сохранить поток живым после закрытия документа

LoadCustomDocument намеренно сделан отдельным методом (а не ещё одной перегрузкой LoadDocument), чтобы вызывающий код, передающий подкласс TMemoryStream, не смог случайно привязаться к буферизованной перегрузке LoadDocument(TMemoryStream, Boolean) — форма аргументов в Pascal совпадает, но семантика совершенно разная (буферизация против чтения по запросу)

Перегрузка с политикой применяет то же совместимое, строгое или восстановительное поведение и ограниченный аудит xref, что задокументированы в LoadDocument. Аудит использует позиционные чтения и восстанавливает курсор источника, прежде чем PDFium продолжит доступ по запросу

TPdfLoadOptions несёт Mode, AuditByteLimit, MaxIssues, MaxXrefSections, MaxXrefEntries, MaxObjectNumber, ValidateObjectOffsets и RequireFinalEndOfFileMarker, а также классовую функцию Default

• При открытии зашифрованных документов задайте Password до вызова LoadCustomDocument
• TPdf ничего не предполагает о AStream — это может быть TFileStream, TMemoryStream или любой подкласс TStream, честно реализующий Seek и Read
• PDFium читает небольшие порции многократно, поэтому очень медленные потоки (сетевые ресурсы, удалённые файлы) выльются в заметно более медленные операции над страницами, чем буферизованный LoadDocument по тем же данным — выбирайте исходя из баланса между давлением на память и задержкой
• Закрытие или освобождение потока ДО того, как TPdf его отпустит, порождает неопределённое поведение на уровне PDFium. При сомнениях передавайте владение через AOwnsStream = True

LoadDocument, Active, Password, FileName