Pular para o conteúdo principal
Este objeto fornece funcionalidade para ajustar os parâmetros de exportação do texto reconhecido para o formato PDF (PDF/A) por meio das funções de exportação do ABBYY FineReader Engine. Um ponteiro para esse objeto é passado aos métodos de exportação como parâmetro de entrada e, assim, afeta os resultados da exportação. Todas as Properties de um objeto desse tipo recém-criado são definidas com valores padrão adequados. Recomendamos que você ajuste os parâmetros na seguinte ordem:
  1. Primeiro, defina a propriedade Scenario. Essa propriedade otimiza a exportação em relação a alguns parâmetros: qualidade, tamanho do arquivo e/ou velocidade de exportação. Quando você seleciona o valor dessa propriedade, as Properties do objeto PDFExportParams e de seus subobjetos são definidas com valores adequados para a tarefa selecionada.
As configurações das Properties podem variar dependendo dos dados de entrada.
  1. Depois disso, você pode personalizar os parâmetros adicionais para que se adequem melhor à sua tarefa. Consulte Ajuste de parâmetros de exportação para obter detalhes.
As Properties do objeto PDFExportParams têm prioridade sobre as Properties de seus subobjetos. Isso significa que, se você alterar o valor de alguma propriedade do objeto PDFExportParams, os valores das Properties de seus subobjetos poderão ser substituídos automaticamente. Por outro lado, se você alterar o valor de uma propriedade de algum subobjeto, os valores das Properties de PDFExportParams nunca são alterados.
O objeto PDFExportParams é um objeto persistente. Isso significa que o estado atual do objeto pode ser gravado em armazenamento persistente. Mais tarde, o objeto pode ser recriado lendo o estado do objeto a partir do armazenamento persistente. Os métodos a seguir permitem persistir o objeto: Linux: SaveToFile e LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory e LoadFromMemory.

​
Properties

,somente leitura

Retorna o objeto Engine.

Especifica o cenário de exportação para o formato PDF (PDF/A), que otimiza a exportação com base em alguns parâmetros: qualidade, tamanho do arquivo e/ou velocidade de exportação.

Se você alterar o valor desta propriedade, asFontEmbeddingMode,TextAndBackgroundColorMode,WriteXmpMetadata,WriteTaggedPDFpropriedades do subobjeto PDFExportFeatures e asColorPictureFormats,GrayPictureFormats,BwPictureFormatspropriedades do subobjeto PDFPictureCompressionParams serão redefinidas para seus valores padrão.

O valor padrão é PES_Balanced.

Observe que, dependendo do cenário escolhido, algumas configurações internas de exportação podem ser alteradas. Isso afetará o valor das seguintes propriedades de PDFExportParams:

Especifica o formato de exportação: PDF, PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-2u, PDF/A-3a, PDF/A-3b ou PDF/A-3u.

O valor desta propriedade afeta as configurações disponíveis durante a exportação. Se o valor desta propriedade não for PCM_None (ou seja, a exportação para o formato PDF/A é realizada):

  • propriedade do subobjeto PDFEncryptionInfo não pode ser definida como TRUE
  • propriedade do subobjeto PDFExportFeatures pode ser definida apenas como PVN_Auto ou PVN_Version14 para PDF/A-1a, PDF/A-1b
  • Se o formato for PDF/A-1a, PDF/A-2a ou PDF/A-3a, apropriedade do subobjeto PDFExportFeatures não pode ser definida como TSPV_No (o arquivo é sempre marcado com tags)
  • propriedade do subobjeto PDFExportFeatures não pode ser definida como TSPV_No
  • propriedade do subobjeto PDFExportFeatures não pode ser definida como FEM_DontEmbed
  • propriedade do subobjeto PDFPictureCompressionParams não pode ser definida como CPF_J2K (somente para PDF/A-1a, PDF/A-1b) ou CPF_LZW
  • propriedade do subobjeto PDFPictureCompressionParams não pode ser definida como GPF_J2K (somente para PDF/A-1a, PDF/A-1b) ou GPF_LZW
  • propriedade do subobjeto PDFExportFeatures não pode ser definida como TRUE para PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-2u.

Se esses requisitos não forem atendidos, um erro será retornado.

Por padrão, o valor é PCM_None, o que indica que a exportação para PDF deve ser realizada.

Especifica o modo de exportação do texto reconhecido para o formato PDF (PDF/A). Os modos disponíveis são: somente texto e imagens, texto sobre a imagem da página, texto abaixo da imagem da página, somente imagem da página, somente texto.

Se esta propriedade for PEM_TextOnly, os valores das propriedades BwPictureFormats , ColorPictureFormats e GrayPictureFormats doPDFPictureCompressionParamssubobjeto serão ignorados.

Por padrão, esta propriedade é PEM_ImageOnText.

Especifica o modo de uso depara o arquivo PDF (PDF/A) de saída.

O valor desta propriedade é ignorado durante a exportação para PDF em preto e branco.

Por padrão, o valor desta propriedade é MRC_Auto.

,read-only

Especifica os parâmetros adicionais de exportação: informações de criptografia, versão do PDF, etc.

Permite manter a cor do arquivo PDF (PDF/A) de saída ou salvá-lo em tons de cinza ou preto e branco. Pode ser útil definir esta propriedade como PCM_ForceToGray para documentos coloridos, caso não seja necessário preservar as cores e se deseje reduzir o tamanho dos arquivos de saída.

Se a propriedade CorrectColorDepth estiver definida como TRUE, o ABBYY FineReader Engine poderá corrigir adicionalmente a profundidade de cor do documento. Por exemplo, se Colority for definido como PCM_ForceToGray e CorrectColorDepth for TRUE, o FineReader Engine converterá as imagens coloridas para tons de cinza, detectará a profundidade de cor das imagens em cinza e, se necessário, converterá algumas imagens para preto e branco.

O valor padrão desta propriedade é PCM_KeepColority.

Esta propriedade definida como TRUE permite que o ABBYY FineReader Engine corrija a profundidade de cor do documento. Se você definir a propriedade como FALSE, o ABBYY FineReader Engine salvará as cores do documento conforme definido na propriedade Colority.

Por padrão, o valor desta propriedade é TRUE.

Retorna a coleção de imagens definidas pelo usuário anexadas ao arquivo PDF de saída. Para adicionar uma imagem a esta coleção, use ométodo doobjeto e defina a posição da imagem na página pelos métodos doobjeto.

,read-only

Especifica os parâmetros de gravação de imagens em arquivos PDF (PDF/A), incluindo parâmetros MRC. Esses parâmetros permitem redefinir os parâmetros definidos no cenário de exportação escolhido.

Especifica a resolução da imagem em dpi. A propriedade ResolutionType especifica como o valor desta propriedade deve ser interpretado.

A resolução especificada não pode ser superior à resolução original.

O valor padrão da propriedade é 300 dpi.

Define como usar o valor da resolução de imagem especificado na propriedade Resolution. Ele pode ser usado:

  • como resolução absoluta (aplicada a todas as imagens),
  • como resolução desejada (aplicável somente se a resolução original for superior à desejada; o programa seleciona o valor de dpi ideal mais próximo da resolução desejada),
  • ou o valor é ignorado (e a resolução original é utilizada).

Por padrão, o valor desta propriedade é PRT_Desired.

​
Métodos

NomeDescrição
CopyFromInicializa as Properties do objeto atual com os valores de Properties semelhantes de outro objeto.
LoadFromFileRestaura o conteúdo do objeto de um arquivo no disco.
LoadFromMemory <Note> : Somente no Windows. </Note>Restaura o conteúdo do objeto da memória global.
SaveToFileSalva o conteúdo do objeto em um arquivo no disco.
SaveToMemory <Note> : Somente no Windows. </Note>Salva o conteúdo do objeto na memória global.
PDFExportParams Diagrama de objetos

​
Parâmetro de saída

Este objeto é o parâmetro de saída do método CreatePDFExportParams do objeto Engine.

​
Parâmetro de entrada

Este objeto é usado como parâmetro de entrada nos seguintes métodos:

​
Exemplos

FREngine.IEngine engine;
FREngine.IFRDocument frDocument;
// Presumimos que o documento já foi reconhecido e sintetizado
// Ajustar os parâmetros de exportação
FREngine.IPDFExportParams pdfParams = Engine.CreatePDFExportParams();
pdfParams.Scenario = FREngine.PDFExportScenarioEnum.PES_Balanced;
// Salvar os resultados usando os parâmetros especificados
frDocument.Export( "D:\\Demo.pdf", FREngine.FileExportFormatEnum.FEF_PDF, pdfParams );
O objeto é usado nos exemplos de código a seguir:

​
Veja também

Ajuste de parâmetros de exportação Trabalhando com perfis Trabalhando com Properties Faturas eletrônicas em conformidade com o ZUGFeRD