ExternalizeInlineImages

Optimización de documentos, tratamiento de imágenes, rendimiento

Descripción

Busca imágenes en línea idénticas en el contenido seleccionado y sustituye sus definiciones BI a EI repetidas por referencias a un Image XObject compartido

Sintaxis

Delphi

Function TPDFlib.ExternalizeInlineImages(Const PageRange: WideString= ''; MinimumOccurrences: Integer= 2): Integer;

Parámetros

PageRangeUn intervalo de páginas basado en uno, como 1,3,5-7, o una cadena vacía para todas las páginas; se omiten los números de página duplicados
MinimumOccurrencesEl número mínimo de apariciones exactas necesarias para la promoción, que debe ser al menos 2

Valores devueltos

El número de apariciones de imágenes en línea sustituidas, o 0 cuando ningún grupo cumple los requisitos, el intervalo no es válido, el mínimo es inferior a 2 o la operación se cancela antes de la aplicación

Observaciones

La agrupación incluye dimensiones, profundidad, indicadores, espacio de color, filtros, parámetros, matriz de descodificación y carga, con índice SHA-256 y comparación exacta

Se admiten imágenes directas DeviceGray, DeviceRGB y DeviceCMYK, así como máscaras de plantilla; los espacios de color complejos o con nombre y las entradas desconocidas de diccionarios en línea permanecen sin cambios

Se conservan los filtros y parámetros de descodificación existentes; una carga útil sin filtrar solo se comprime con Flate cuando la representación comprimida es menor

Un grupo solo se promueve cuando una estimación conservadora que incluye el Image XObject, los recursos de página y las instrucciones de sustitución es menor que los tramos insertados originales

La operación notifica el progreso, responde a Abort en límites de página, restaura la página seleccionada y es idempotente

La cancelación durante la recopilación no realiza cambios; la cancelación durante la aplicación conserva las páginas ya completadas

Ejemplo

ReplacedImages:= PDF.ExternalizeInlineImages('1-200', 3);
Writeln(ReplacedImages);

Véase también

OptimizeImages, RecompressStreams, NormalizeContentStreams