Document Handlers opcionales

THPDFDocumentHandlerRegistry selecciona handlers reemplazables por el contenido inspeccionado antes que las pistas débiles de extensión o MIME, y luego convierte el source elegido en una única caché PDF inmutable compartida por exportación y render

Handlers opcionales integrados

• XPS y OpenXPS conservan las dimensiones de página fijas y el orden visual, convierten geometría Path abreviada self-closing o con propiedades a vectores PDF nativos, preservan solid brushes de atributos y property-elements, shading patterns LinearGradientBrush de multi-stop y RadialGradientBrush elípticos, y rellenan paths a través de recursos ImageBrush JPEG, PNG, TIFF o JPEG XR del paquete con TileMode=None
• Los image fills de XPS soportan mapeo Viewbox y Viewport absoluto o RelativeToBoundingBox, modos de tile None, Tile, FlipX, FlipY y FlipXY, clipping nativo de paths y de colocaciones, atributos Transform finitos de seis parámetros o elementos MatrixTransform de ImageBrush.Transform, opacidad de brush y path, alpha de soft-mask PNG, DPI de imagen y caching de recursos del paquete
• El Path.OpacityMask de XPS soporta máscaras sólidas, de gradiente linear multi-stop o radial elíptico, y de ImageBrush PNG, incluidas celdas de imagen repetidas y reflejadas; el alpha uniforme se pliega en los graphics states existentes mientras que el alpha variable usa grupos de transparencia DeviceGray nativos acotados que comparten shading patterns y streams de soft-mask de imagen
• El Opacity de Canvas y el Canvas.OpacityMask de XPS componen los descendientes solapados una sola vez mediante Form XObjects DeviceRGB aislados, en lugar de atenuar cada hijo de forma independiente; el alpha uniforme de la máscara se pliega en el estado del grupo, el alpha variable de gradiente o de imagen PNG reutiliza recursos soft-mask nativos, y los grupos anidados conservan clips transformados, propiedad de recursos y link annotations acotadas dentro de límites de 4,096 grupos y 16 MiB de contenido capturado por grupo
• El VisualBrush de XPS convierte recursivamente visuals Canvas, Path y Glyphs inline o respaldados por recursos, resuelve scopes de ResourceDictionary anidados y remotos, mapea una Viewbox absoluta a un Viewport absoluto o relativo, y reutiliza un único Form XObject PDF acotado entre colocaciones directas, con tile y reflejadas
• El Canvas.Clip de XPS acepta geometría abreviada acotada, valores PathGeometry de StaticResource locales o remotos, y property elements directos con figures estructuradas de línea, Bézier, cuadráticas o de arco, transforms de geometría, geometría vacía y fill rules EvenOdd o NonZero; los clips anidados se vuelven paths PDF nativos W* o W, los rectángulos de navegación se intersectan con los bounds de clip transformados activos, el parseo se limita a 100,000 valores numéricos, y los clips malformados o singulares fallan de forma cerrada antes de pintar los visuals hijos
• El Glyphs de XPS acepta como máximo 65,536 mapeos estrictos de Indices, conserva la progresión de clusters uno-a-muchos y muchos-a-uno, advances explícitos en centésimas de em, offsets horizontales y verticales, progresión inversa de BidiLevel impar, rellenos sólidos de atributos o property-elements, opacidad, extracción Unicode y diagnósticos fail-closed de entrada malformada; los runs simples usan arrays PDF nativos TJ y los buffers de mapeo grandes crecen con costo linear amortizado
• Los recursos FontUri del paquete soportan programas TrueType y OpenType, fragmentos de miembros TTC y fuentes ofuscadas con GUID de XPS; los glyph IDs exactos, los runs derivados del cmap, los clusters, advances, offsets, orígenes RTL, la reutilización de font-resources, los permisos de embedding, el subsetting opcional y los mapas de extracción ToUnicode permanecen como datos de fuente PDF nativos sin sustitución GDI
• El FixedPage.NavigateUri de XPS en visuals Path y Glyphs transformados se convierte en una link annotation PDF nativa con bounds derivados de la geometría o de las métricas; los links HTTP, HTTPS y de correo permanecen como acciones URI, mientras que las páginas relativas al paquete y los fragmentos LinkTarget con percent-decoding se convierten en acciones GoTo hacia adelante o hacia atrás después de que todas las páginas estén disponibles
• El FixedPage.NavigateUri de un Canvas se convierte en el target heredado de cada visual descendiente Path, Glyphs o Canvas anidado hasta que un descendiente aporta su propio URI; los targets con scope se restauran después de overrides anidados, siguen la geometría y el transform de cada visual, permanecen limitados por los clips de Canvas activos, sobreviven a la captura aislada de grupos de opacidad y quedan suprimidos dentro de Forms VisualBrush reutilizables
• La navegación se limita a 65,536 links con 8,192 caracteres por URI, se comprueba la cancelación durante la publicación, se suprime durante la captura de VisualBrush reutilizables, y se rechaza ante caracteres de control, esquemas inseguros, targets ausentes o mismatches de ruta y fragmento
• El RelativeTransform no estándar, los recursos de matriz sin resolver, el spread de gradiente Repeat o Reflect, la interpolación no sRGB, los paint brushes de alpha variable, la conversión de color, los strokes de imagen, los viewboxes relativos de VisualBrush, la simulación de estilos, los glyphs laterales y las propiedades de stroke avanzadas permanecen como diagnósticos explícitos
• EPUB resuelve el orden de container.xml, manifest y spine, y luego usa el importador HTML5 paged-media acotado con recursos del paquete solo por callback
• CBZ reconoce las entradas de imagen soportadas, aplica el orden natural determinista de nombres de archivo y crea una página por imagen al DPI de imagen configurado

Presupuestos y aislamiento de fallos

Un único escaneo validado del central-directory ZIP aplica los límites de entradas, bytes comprimidos, bytes expandidos, por entrada, rutas duplicadas, rutas inseguras y ratio de compresión antes de la conversión

Las entradas ZipCrypto clásicas de PKZIP pueden solicitar credenciales mediante ArchivePasswordCallback; el callback recibe el nombre del source, el nombre de la entrada y el número de intento de base uno, mientras que MaxPasswordAttempts acota los reintentos de 1 a 16

Las credenciales y los bytes de entrada parcialmente decodificados permanecen en memoria y se limpian entre intentos, la cancelación se comprueba antes y después de cada callback, y los callbacks ausentes, las credenciales rechazadas, los reintentos agotados o la encriptación no soportada fallan de forma cerrada

ZipCrypto es protección por contraseña legacy, no encriptación autenticada moderna, y las convenciones de bytes de contraseñas no ASCII pueden variar entre producers de ZIP

Las entradas protegidas por contraseña requieren Delphi 12 o posterior, cuyo System.Zip expone el hook de desencriptación; compilados con una versión anterior de Delphi, los handlers siguen leyendo entradas sin encriptar pero rechazan las encriptadas como no soportadas antes de que se llame a ArchivePasswordCallback

Las entradas cuyos tamaños u offsets requieren campos ZIP64 necesitan Delphi 11 o posterior; las versiones anteriores de Delphi las rechazan como no soportadas

Los límites de recursos, reflow, páginas, píxeles, DPI, salida y cancelación permanecen activos durante toda la conversión y el render, mientras que la publicación fallida de la salida restaura un destination stream con seek

Registro y uso

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;

APIs relacionadas

• THPDFDocumentHandlerRegistry
• IHPDFDocumentHandler
• IHPDFHandledDocument
• THPDFDocumentHandlerOptions
• HTML5 Paged-Media Import