Saltar al contenido principal
Este objeto permite ajustar los parámetros de exportación del texto reconocido al formato PDF (PDF/A) mediante las funciones de exportación de ABBYY FineReader Engine. Se pasa un puntero a este objeto a los métodos de exportación como parámetro de entrada y, por lo tanto, afecta a los resultados de la exportación. Todas las propiedades de un objeto recién creado de este tipo se establecen en valores predeterminados adecuados. Recomendamos ajustar los parámetros en el siguiente orden:
  1. Establezca primero la propiedad Scenario. Esta propiedad optimiza la exportación en función de algunos parámetros: calidad, tamaño del archivo y/o velocidad de exportación. Cuando selecciona el valor de esta propiedad, las propiedades del objeto PDFExportParams y de sus subobjetos se establecen con valores adecuados para la tarea seleccionada.
La configuración de las propiedades puede variar según los datos de entrada.
  1. Después, puede personalizar los parámetros adicionales para que se adapten lo mejor posible a su tarea. Consulte Ajuste de parámetros de exportación para obtener más información.
Las propiedades del objeto PDFExportParams tienen prioridad sobre las propiedades de sus subobjetos. Esto significa que, si cambia el valor de alguna propiedad del objeto PDFExportParams, los valores de las propiedades de sus subobjetos pueden sobrescribirse automáticamente. Por el contrario, si cambia el valor de una propiedad de algún subobjeto, los valores de las propiedades de PDFExportParams nunca cambian.
El objeto PDFExportParams es un objeto persistente. Esto significa que el estado actual del objeto puede escribirse en un almacenamiento persistente. Más adelante, el objeto puede volver a crearse leyendo su estado desde el almacenamiento persistente. Los siguientes métodos proporcionan persistencia al objeto: Linux: SaveToFile y LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory y LoadFromMemory.

​
Propiedades

,de solo lectura

Devuelve el objeto Engine.

Especifica el escenario de exportación al formato PDF (PDF/A), que optimiza la exportación en función de ciertos parámetros: calidad, tamaño del archivo y/o velocidad de exportación.

Si cambia el valor de esta propiedad, lasFontEmbeddingMode,TextAndBackgroundColorMode,WriteXmpMetadata,WriteTaggedPDFpropiedades del subobjeto PDFExportFeatures y lasColorPictureFormats,GrayPictureFormats,BwPictureFormatspropiedades del subobjeto PDFPictureCompressionParams se restablecen a sus valores predeterminados.

El valor predeterminado es PES_Balanced.

Tenga en cuenta que, según el escenario seleccionado, algunos ajustes internos de exportación pueden cambiar. Esto afectará el valor de las siguientes propiedades de PDFExportParams:

Especifica el formato de exportación: PDF, PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-2u, PDF/A-3a, PDF/A-3b o PDF/A-3u.

El valor de esta propiedad afecta los ajustes disponibles durante la exportación. Si el valor de esta propiedad no es PCM_None (es decir, se realiza la exportación al formato PDF/A):

  • la propiedad del subobjeto PDFEncryptionInfo no puede establecerse en TRUE
  • la propiedad del subobjeto PDFExportFeatures solo se puede establecer en PVN_Auto o PVN_Version14 para PDF/A-1a y PDF/A-1b
  • Si el formato es PDF/A-1a, PDF/A-2a o PDF/A-3a, lapropiedad del subobjeto PDFExportFeatures no se puede establecer en TSPV_No (el archivo siempre incluye etiquetas)
  • la propiedad del subobjeto PDFExportFeatures no se puede establecer en TSPV_No
  • la propiedad del subobjeto PDFExportFeatures no se puede establecer en FEM_DontEmbed
  • la propiedad del subobjeto PDFPictureCompressionParams no se puede establecer en CPF_J2K (solo para PDF/A-1a y PDF/A-1b) ni en CPF_LZW
  • la propiedad del subobjeto PDFPictureCompressionParams no se puede establecer en GPF_J2K (solo para PDF/A-1a y PDF/A-1b) ni en GPF_LZW
  • la propiedad del subobjeto PDFExportFeatures no se puede establecer en TRUE para PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b y PDF/A-2u.

Si no se cumplen estos requisitos, se devuelve un error.

De forma predeterminada, el valor es PCM_None, lo que significa que se debe realizar la exportación a PDF.

Especifica el modo de exportación del texto reconocido al formato PDF (PDF/A). Puede ser: solo texto e imágenes, texto sobre la imagen de la página, texto debajo de la imagen de la página, solo la imagen de la página o solo texto.

Si esta propiedad es PEM_TextOnly, se omiten los valores de las propiedades BwPictureFormats, ColorPictureFormats y GrayPictureFormats del subobjetoPDFPictureCompressionParams.

De forma predeterminada, esta propiedad es PEM_ImageOnText.

Especifica el modo de uso depara el archivo PDF (PDF/A) de salida.

El valor de esta propiedad se ignora durante la exportación a PDF en blanco y negro.

De forma predeterminada, el valor de esta propiedad es MRC_Auto.

,de solo lectura

Especifica los parámetros de exportación adicionales: información de cifrado, versión de PDF, etc.

Permite conservar el color del archivo PDF (PDF/A) de salida o guardarlo en gris o en blanco y negro. Puede ser útil establecer esta propiedad en PCM_ForceToGray para documentos en color si no necesita conservar sus colores y desea reducir el tamaño de los archivos de salida.

Si la propiedad CorrectColorDepth se establece en TRUE, ABBYY FineReader Engine también puede corregir la profundidad de color del documento. Por ejemplo, si establece Colority en PCM_ForceToGray y CorrectColorDepth es TRUE, FineReader Engine cambiará las imágenes en color a gris; después detectará la profundidad de color de las imágenes en gris y, si es necesario, convertirá algunas imágenes a blanco y negro.

El valor predeterminado de esta propiedad es PCM_KeepColority.

Si esta propiedad se establece en TRUE, ABBYY FineReader Engine corregirá la profundidad de color del documento. Si se establece en FALSE, ABBYY FineReader Engine guardará los colores del documento tal como se definen en la propiedad Colority.

De forma predeterminada, el valor de esta propiedad es TRUE.

Devuelve la colección de imágenes definidas por el usuario adjuntas al archivo PDF de salida. Para agregar una imagen a esta colección, utilice el métododel objetoy establezca la posición de la imagen en una página mediante los métodos del objeto.

,de solo lectura

Especifica los parámetros para escribir imágenes en archivos PDF (PDF/A), incluidos los parámetros MRC. Estos parámetros permiten restablecer los parámetros definidos en el escenario de exportación seleccionado.

Especifica la resolución de la imagen en ppp. La propiedad ResolutionType especifica cómo debe interpretarse el valor de esta propiedad.

La resolución especificada no puede ser superior a la resolución original.

El valor predeterminado de la propiedad es 300 ppp.

Define cómo se utiliza el valor de resolución de imagen especificado en la propiedad Resolution. Puede emplearse:

  • como resolución absoluta (aplicada a todas las imágenes),
  • como resolución deseada (solo puede utilizarse si la resolución original es superior a la deseada; el programa selecciona el valor de ppp óptimo más cercano a la resolución deseada),
  • o bien el valor se ignora (y se utiliza la resolución original).

De forma predeterminada, el valor de esta propiedad es PRT_Desired.

​
Métodos

NombreDescripción
CopyFromInicializa las propiedades del objeto actual con los valores de propiedades similares de otro objeto.
LoadFromFileRestaura el contenido del objeto desde un archivo del disco.
LoadFromMemory <Note> : Solo Windows. </Note>Restaura el contenido del objeto desde la memoria global.
SaveToFileGuarda el contenido del objeto en un archivo del disco.
SaveToMemory <Note> : Solo Windows. </Note>Guarda el contenido del objeto en la memoria global.
PDFExportParams Diagrama de objetos

​
Parámetro de salida

Este objeto es el parámetro de salida del método CreatePDFExportParams del objeto Engine.

​
Parámetro de entrada

Este objeto se pasa como parámetro de entrada a los métodos siguientes:

​
Ejemplos

FREngine.IEngine engine;
FREngine.IFRDocument frDocument;
// Suponemos que el documento ya se ha reconocido y sintetizado
// Ajustar los parámetros de exportación
FREngine.IPDFExportParams pdfParams = Engine.CreatePDFExportParams();
pdfParams.Scenario = FREngine.PDFExportScenarioEnum.PES_Balanced;
// Guardar los resultados con los parámetros especificados
frDocument.Export( "D:\\Demo.pdf", FREngine.FileExportFormatEnum.FEF_PDF, pdfParams );
El objeto se usa en los siguientes ejemplos de código:

​
Consulte también

Ajuste de parámetros de exportación Uso de perfiles Uso de Propiedades Facturas electrónicas conformes con ZUGFeRD