LoadCustomDocument Método

Carga un PDF desde cualquier TStream que admita Seek mediante el lector de bloques bajo demanda de PDFium, de modo que los documentos de varios GB y las fuentes remotas o respaldadas en bases de datos no necesitan una copia previa en memoria

LoadCustomDocument es la contraparte de streaming de las sobrecargas almacenadas en búfer de LoadDocument. Se apoya en el punto de entrada FPDF_LoadCustomDocument de PDFium a través de la clase auxiliar TPdfStreamAdapter introducida en v1.8.0 PDFium extrae bloques de AStream solo cuando los necesita, de modo que el flujo no se copia en memoria: un TFileStream sobre un PDF de 4 GB, un TStream respaldado en HTTP o un flujo BLOB de base de datos se vuelven todos utilizables sin escalonar antes toda la carga útil en RAM

AStream debe admitir Seek. Su vida útil debe extenderse hasta que el documento se cierre (llame a UnloadDocument o devuelva Active a False). Pase AOwnsStream = True para entregar la propiedad del flujo a este TPdf — el adaptador entonces libera AStream cuando se ejecuta UnloadDocument. Pase False cuando el llamador quiera mantener el flujo vivo después de que el documento se cierre

LoadCustomDocument es intencionadamente un método separado (no otra sobrecarga de LoadDocument) para que los llamadores que pasan una subclase de TMemoryStream no puedan enlazar accidentalmente con la sobrecarga almacenada en búfer LoadDocument(TMemoryStream, Boolean) — la forma de los argumentos Pascal es idéntica pero la semántica es muy diferente (almacenado en búfer frente a bajo demanda)

La sobrecarga con política aplica el mismo comportamiento compatible, estricto o de recuperación y la auditoría acotada de xref documentados por LoadDocument. La auditoría usa lecturas posicionadas y restaura el cursor de la fuente antes de que PDFium continúe su acceso bajo demanda

TPdfLoadOptions transporta Mode, AuditByteLimit, MaxIssues, MaxXrefSections, MaxXrefEntries, MaxObjectNumber, ValidateObjectOffsets y RequireFinalEndOfFileMarker, además de la función de clase Default

• Establezca Password antes de llamar a LoadCustomDocument al abrir documentos cifrados
• El TPdf no supone nada sobre AStream — puede ser un TFileStream, un TMemoryStream o cualquier subclase de TStream que respete Seek y Read
• PDFium lee fragmentos pequeños repetidamente, de modo que los flujos muy lentos (recursos compartidos de red, archivos remotos) se traducirán en operaciones de página notablemente más lentas que un LoadDocument almacenado en búfer sobre los mismos datos — elija según la presión de memoria frente a la latencia
• Cerrar o liberar el flujo ANTES de que el TPdf lo libere produce un comportamiento indefinido a nivel de PDFium. Ante la duda, transfiera la propiedad con AOwnsStream = True

LoadDocument, Active, Password, FileName