Vai al contenuto principale
Questo oggetto fornisce le funzionalità per configurare i parametri di esportazione del testo riconosciuto in formato PDF (PDF/A) tramite le funzioni di esportazione di ABBYY FineReader Engine. Un puntatore a questo oggetto viene passato ai metodi di esportazione come parametro di input e influisce quindi sui risultati dell’esportazione. Tutte le proprietà di un oggetto di questo tipo appena creato sono impostate su valori predefiniti adeguati. Si consiglia di configurare i parametri nel seguente ordine:
  1. Impostare innanzitutto la proprietà Scenario. Questa proprietà ottimizza l’esportazione in base ad alcuni parametri: qualità, dimensione del file e/o velocità di esportazione. Quando si seleziona il valore di questa proprietà, le proprietà dell’oggetto PDFExportParams e dei relativi sottooggetti vengono impostate sui valori appropriati per l’attività selezionata.
Le impostazioni delle proprietà possono variare a seconda dei dati di input.
  1. Successivamente, è possibile personalizzare i parametri aggiuntivi in modo che si adattino al meglio alla propria attività. Per ulteriori dettagli, vedere Ottimizzazione dei parametri di esportazione.
Le proprietà dell’oggetto PDFExportParams hanno priorità rispetto alle proprietà dei relativi sottooggetti. Ciò significa che, se si modifica il valore di una proprietà dell’oggetto PDFExportParams, i valori delle proprietà dei relativi sottooggetti possono essere sovrascritti automaticamente. Al contrario, se si modifica il valore di una proprietà di un sottooggetto, i valori delle proprietà di PDFExportParams non cambiano mai.
L’oggetto PDFExportParams è un oggetto persistente. Ciò significa che lo stato corrente dell’oggetto può essere scritto in un archivio permanente. In seguito, l’oggetto può essere ricreato leggendo il suo stato dall’archivio permanente. I seguenti metodi consentono di mantenere la persistenza dell’oggetto: Linux: SaveToFile e LoadFromFile Windows: SaveToFile, LoadFromFile, SaveToMemory e LoadFromMemory.

Proprietà

,di sola lettura

Restituisce l’oggetto Engine.

Specifica lo scenario di esportazione nel formato PDF (PDF/A), che ottimizza l’esportazione in base ad alcuni parametri: qualità, dimensione del file e/o velocità di esportazione.

Se si modifica il valore di questa proprietà, leFontEmbeddingMode,TextAndBackgroundColorMode,WriteXmpMetadata,WriteTaggedPDFproprietà del sottooggetto PDFExportFeatures e leColorPictureFormats,GrayPictureFormats,BwPictureFormatsproprietà del sottooggetto PDFPictureCompressionParams vengono reimpostate ai valori predefiniti.

Il valore predefinito è PES_Balanced.

Si noti che, a seconda dello scenario selezionato, alcune impostazioni interne di esportazione possono variare. Ciò influirà sul valore delle seguenti proprietà di PDFExportParams:

Specifica il formato di esportazione: 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.

Il valore di questa proprietà influisce sulle impostazioni disponibili durante l’esportazione. Se il valore di questa proprietà non è PCM_None (viene eseguita l’esportazione nel formato PDF/A):

  • proprietà del sottooggetto PDFEncryptionInfo non può essere impostata su TRUE
  • proprietà del sottooggetto PDFExportFeatures può essere impostata solo su PVN_Auto o PVN_Version14 per PDF/A-1a, PDF/A-1b
  • Se il formato è PDF/A-1a, PDF/A-2a o PDF/A-3a, laproprietà del sottooggetto PDFExportFeatures non può essere impostata su TSPV_No (il file è sempre taggato)
  • proprietà del sottooggetto PDFExportFeatures non può essere impostata su TSPV_No
  • proprietà del sottooggetto PDFExportFeatures non può essere impostata su FEM_DontEmbed
  • proprietà del sottooggetto PDFPictureCompressionParams non può essere impostata su CPF_J2K (solo per PDF/A-1a, PDF/A-1b) o CPF_LZW
  • proprietà del sottooggetto PDFPictureCompressionParams non può essere impostata su GPF_J2K (solo per PDF/A-1a, PDF/A-1b) o GPF_LZW
  • proprietà del sottooggetto PDFExportFeatures non può essere impostata su TRUE per PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-2u.

Se questi requisiti non vengono soddisfatti, viene restituito un errore.

Per impostazione predefinita, il valore è PCM_None, il che indica che verrà eseguita l’esportazione in PDF.

Specifica la modalità di esportazione del testo riconosciuto nel formato PDF (PDF/A). I valori possibili sono: solo testo e immagini, testo sopra l’immagine della pagina, testo sotto l’immagine della pagina, solo immagine della pagina, solo testo.

Se questa proprietà è PEM_TextOnly, i valori delle proprietà BwPictureFormats, ColorPictureFormats e GrayPictureFormats del sottooggettoPDFPictureCompressionParamsvengono ignorati.

Per impostazione predefinita, questa proprietà è PEM_ImageOnText.

Specifica la modalità di utilizzo diper il file PDF (PDF/A) di output.

Il valore di questa proprietà viene ignorato durante l’esportazione in PDF in bianco e nero.

Per impostazione predefinita, il valore di questa proprietà è MRC_Auto.

,read-only

Specifica i parametri di esportazione aggiuntivi: informazioni sulla crittografia, versione PDF, ecc.

Consente di mantenere il colore del file PDF (PDF/A) di output o di salvarlo in scala di grigi o in bianco e nero. Può essere utile impostare questa proprietà su PCM_ForceToGray per i documenti a colori, se non è necessario conservarne i colori e si desidera ridurre le dimensioni dei file di output.

Se la proprietà CorrectColorDepth è impostata su TRUE, ABBYY FineReader Engine può correggere ulteriormente la profondità colore del documento. Ad esempio, se si imposta Colority su PCM_ForceToGray e CorrectColorDepth è TRUE, FineReader Engine convertirà le immagini a colori in scala di grigi, rileverà quindi la profondità colore delle immagini in scala di grigi e, se necessario, convertirà alcune immagini in bianco e nero.

Il valore predefinito di questa proprietà è PCM_KeepColority.

Questa proprietà impostata su TRUE consente ad ABBYY FineReader Engine di correggere la profondità del colore del documento. Se si imposta la proprietà su FALSE, ABBYY FineReader Engine salverà i colori del documento come definito nella proprietà Colority.

Per impostazione predefinita, il valore di questa proprietà è TRUE.

Restituisce la raccolta delle immagini definite dall’utente allegate al file PDF di output. Per aggiungere un’immagine a questa raccolta, utilizzare il metododell’oggettoe impostare la posizione dell’immagine nella pagina tramite i metodi dell’oggetto.

,read-only

Specifica i parametri per la scrittura di immagini in file PDF (PDF/A), inclusi i parametri MRC. Questi parametri consentono di reimpostare i parametri definiti nello scenario di esportazione selezionato.

Specifica la risoluzione dell’immagine in dpi. La proprietà ResolutionType specifica come deve essere interpretato il valore di questa proprietà.

La risoluzione specificata non può essere superiore alla risoluzione originale.

Il valore predefinito della proprietà è 300 dpi.

Definisce come utilizzare il valore della risoluzione dell’immagine specificato nella proprietà Resolution. Può essere usato:

  • come risoluzione assoluta (applicata a tutte le immagini),
  • come risoluzione desiderata (utilizzabile solo se la risoluzione originale è superiore a quella desiderata; il programma seleziona il valore dpi ottimale più vicino alla risoluzione desiderata),
  • oppure il valore viene ignorato (e viene utilizzata la risoluzione originale).

Per impostazione predefinita, il valore di questa proprietà è PRT_Desired.

Metodi

NomeDescrizione
CopyFromInizializza le proprietà dell’oggetto corrente con i valori delle proprietà corrispondenti di un altro oggetto.
LoadFromFileRipristina il contenuto dell’oggetto da un file su disco.
LoadFromMemory <Nota> : Solo Windows. </Nota>Ripristina il contenuto dell’oggetto dalla memoria globale.
SaveToFileSalva il contenuto dell’oggetto in un file su disco.
SaveToMemory <Nota> : Solo Windows. </Nota>Salva il contenuto dell’oggetto nella memoria globale.
PDFExportParams Diagramma degli oggetti

Parametro di output

Questo oggetto è il parametro di output del metodo CreatePDFExportParams dell’oggetto Engine.

Parametro di input

Questo oggetto viene passato come parametro di input ai metodi seguenti:

Esempi

FREngine.IEngine engine;
FREngine.IFRDocument frDocument;
// Si presume che il documento sia stato riconosciuto e sintetizzato
// Configurare i parametri di esportazione
FREngine.IPDFExportParams pdfParams = Engine.CreatePDFExportParams();
pdfParams.Scenario = FREngine.PDFExportScenarioEnum.PES_Balanced;
// Salvare i risultati utilizzando i parametri specificati
frDocument.Export( "D:\\Demo.pdf", FREngine.FileExportFormatEnum.FEF_PDF, pdfParams );
L’oggetto viene utilizzato nei seguenti esempi di codice:

Vedi anche

Ottimizzazione dei parametri di esportazione Lavorare con i profili Lavorare con le proprietà Fatture elettroniche conformi a ZUGFeRD