AddImageJBIG2FromFileEx
Imágenes
Descripción
Carga un archivo de mapa de bits, lo convierte en datos de imagen monocromáticos y lo almacena como un `Image XObject` JBIG2 utilizando parámetros de opción nombrados
Sintaxis
Delphi
Function TPDFlib.AddImageJBIG2FromFileEx(Const FileName: WideString; Interpolate, SymbolExtract, UseExternalEncoder, SkipBlackDots, BlackDotSize, LossyLevel: Integer): Integer;Parámetros
| FileName | El archivo de mapa de bits a codificar |
|---|---|
| Interpolate | Escribe la bandera de interpolación de imagen cuando no es cero |
| SymbolExtract | Solicita la extracción del diccionario de símbolos cuando el motor del codificador activo lo admita |
| UseExternalEncoder | Prefiere el motor de codificador JBIG2 externo cuando esté disponible |
| SkipBlackDots | Habilita la limpieza de puntos negros aislados antes de la codificación cuando no es cero |
| BlackDotSize | Tamaño máximo del grupo de píxeles negros aislados eliminado durante la limpieza |
| LossyLevel | Sugerencia de agresividad de limpieza de 0 a 9 para entrada monocromática escaneada |
Valores devueltos
Devuelve el nuevo ImageID, o 0 cuando el archivo no se puede leer o codificar
Observaciones
La función asigna los parámetros nombrados a la misma ruta de codificación utilizada por AddImageJBIG2FromFile, lo que conserva la compatibilidad con las máscaras de bits de opción existentes
Registro de backends JBIG2
Tanto el codificador detrás de la familia AddImageJBIG2* como el decodificador usado para imágenes JBIG2 en documentos importados son intercambiables. La unidad PDFlibJBIG2Enc expone la superficie de registro como funciones independientes:
RegisterJBIG2EncoderBackend | Instala un TJBIG2EncodeCallback que recibe las líneas de barrido, la anchura, la altura y un registro TJBIG2EncodeOptions, y devuelve los datos de imagen comprimidos y los datos opcionales de segmento global; atiende la solicitud UseExternalEncoder hecha mediante la opción de abajo |
|---|---|
RegisterJBIG2DecoderBackend | Instala el TJBIG2DecodeCallback principal, que recibe los bytes de los datos de imagen y globales y rellena un registro TJBIG2DecodeResult |
RegisterJBIG2ExternalDecoderBackend | Registra el backend de decodificación externo (el decodificador C jbig2dec en Win64). Cuando está registrado y el conmutador de preferencia externa está activado (el valor predeterminado), la ruta de carga /JBIG2Decode pasa por él y el decodificador principal queda como respaldo |
ClearJBIG2Backends | Elimina todos los callbacks de codificación y decodificación registrados |
IsJBIG2EncoderBackendAvailable / IsJBIG2DecoderBackendAvailable / IsJBIG2ExternalDecoderBackendAvailable | Indican si el callback correspondiente está registrado actualmente |
SetPreferExternalJBIG2Decoder / GetPreferExternalJBIG2Decoder | Conmutador global que selecciona el decodificador externo frente al decodificador Pascal integrado cuando ambos están disponibles; el valor predeterminado es True, establezca False para forzar el respaldo nativo |
DefaultJBIG2EncodeOptions | Devuelve un registro TJBIG2EncodeOptions inicializado con los valores predeterminados de los que parten las llamadas AddImageJBIG2* (sin pérdida, diccionario de símbolos activado, segmentos globales desactivados, codificador externo preferido) |
ClearJBIG2DecodeResult | Libera la memoria de líneas de barrido que posee un registro TJBIG2DecodeResult y restablece sus campos |