Zum Hauptinhalt springen
Dieses Objekt bietet Funktionen zum Anpassen der Parameter für den Export von erkanntem Text in das PDF-Format (PDF/A) mithilfe der Exportfunktionen von ABBYY FineReader Engine. Ein Zeiger auf dieses Objekt wird als Eingabeparameter an die Exportmethoden übergeben und beeinflusst damit die Exportergebnisse. Alle Eigenschaften eines neu erstellten Objekts dieses Typs sind auf sinnvolle Standardwerte gesetzt. Wir empfehlen, die Parameter in der folgenden Reihenfolge anzupassen:
  1. Legen Sie zuerst die Eigenschaft Scenario fest. Diese Eigenschaft optimiert den Export in Bezug auf bestimmte Parameter: Qualität, Dateigröße und/oder Exportgeschwindigkeit. Wenn Sie den Wert dieser Eigenschaft auswählen, werden die Eigenschaften des PDFExportParams-Objekts und seiner Unterobjekte auf die für die gewählte Aufgabe geeigneten Werte gesetzt.
Die Einstellungen der Eigenschaften können je nach Eingabedaten variieren.
  1. Danach können Sie die zusätzlichen Parameter so anpassen, dass sie optimal zu Ihrer Aufgabe passen. Weitere Informationen finden Sie unter Exportparameter anpassen.
Die Eigenschaften des PDFExportParams-Objekts haben Vorrang vor den Eigenschaften seiner Unterobjekte. Das bedeutet: Wenn Sie den Wert einer Eigenschaft des PDFExportParams-Objekts ändern, können die Werte der Eigenschaften seiner Unterobjekte automatisch überschrieben werden. Umgekehrt gilt: Wenn Sie den Wert einer Eigenschaft eines Unterobjekts ändern, ändern sich die Werte der PDFExportParams-Eigenschaften nie.
Das PDFExportParams-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in persistentem Speicher gespeichert werden kann. Später kann das Objekt neu erstellt werden, indem sein Zustand aus dem persistenten Speicher gelesen wird. Die folgenden Methoden ermöglichen die Persistenz des Objekts: Linux: SaveToFile und LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory und LoadFromMemory.

​
Eigenschaften

,read-only

Returns the Engine object.

Specifies the scenario of export to PDF (PDF/A) format, which optimizes export for some parameters: quality, size of the file, and/or speed of export.

If you change the value of this property, theFontEmbeddingMode,TextAndBackgroundColorMode,WriteXmpMetadata,WriteTaggedPDFproperties of the PDFExportFeatures subobject andColorPictureFormats,GrayPictureFormats,BwPictureFormatsproperties of the PDFPictureCompressionParams subobject are set to their default values.

The default value is PES_Balanced.

Bitte beachten Sie, dass sich je nach gewähltem Szenario einige interne Exporteinstellungen ändern können. Dies wirkt sich auf den Wert der folgenden PDFExportParams-Eigenschaften aus:

Specifies the format of export: PDF, PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-2u, PDF/A-3a, PDF/A-3b, or PDF/A-3u.

The value of this property affects the settings that can be used during export. If the value of this property is not PCM_None (export to PDF/A format is performed):

  • property of the PDFEncryptionInfo subobject cannot be set to TRUE
  • property of the PDFExportFeatures subobject can be set only to PVN_Auto or PVN_Version14 for PDF/A-1a, PDF/A-1b
  • If the format is PDF/A-1a, PDF/A-2a, or PDF/A-3a, theproperty of the PDFExportFeatures subobject cannot be set to TSPV_No (the file is always tagged)
  • property of the PDFExportFeatures subobject cannot be set to TSPV_No
  • property of the PDFExportFeatures subobject cannot be set to FEM_DontEmbed
  • property of the PDFPictureCompressionParams subobject cannot be set to CPF_J2K (for PDF/A-1a, PDF/A-1b only) or CPF_LZW
  • property of the PDFPictureCompressionParams subobject cannot be set to GPF_J2K (for PDF/A-1a, PDF/A-1b only) or GPF_LZW
  • property of the PDFExportFeatures subobject cannot be set to TRUE for PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-2u.

If these requirements are not met, an error is returned.

By default, the value is PCM_None, which means that export to PDF should be performed.

Specifies the mode of export of recognized text into PDF (PDF/A) format. It may be: text and pictures only, text over the page image, text under the page image, page image only, text only.

If this property is PEM_TextOnly, the values of the BwPictureFormats , ColorPictureFormats , and GrayPictureFormats properties of thePDFPictureCompressionParamssubobject are ignored.

This property is PEM_ImageOnText by default.

Specifies the mode of usingfor output PDF (PDF/A) file.

The value of this property is ignored during export to black-and-white PDF.

By default, the value of this property is MRC_Auto.

,read-only

Specifies the additional export parameters: encryption information, PDF version, etc.

Allows you to keep color of the output PDF (PDF/A) file or save it in gray or black-and-white. It may be useful to set this property to PCM_ForceToGray for color documents, if you do not need to save their colors and want to reduce the size of output files.

Wenn die Eigenschaft CorrectColorDepth auf TRUE gesetzt ist, kann ABBYY FineReader Engine die Farbtiefe des Dokuments zusätzlich korrigieren. Wenn Sie beispielsweise Colority auf PCM_ForceToGray setzen und CorrectColorDepth TRUE ist, wandelt FineReader Engine die Farbbilder in Graustufen um, erkennt anschließend die Farbtiefe der Graustufenbilder und ändert bei Bedarf einige Bilder in Schwarzweiß.

The default value for this property is PCM_KeepColority.

Wenn diese Eigenschaft auf TRUE gesetzt ist, korrigiert ABBYY FineReader Engine die Farbtiefe des Dokuments. Wenn Sie die Eigenschaft auf FALSE setzen, speichert ABBYY FineReader Engine die Farben des Dokuments gemäß der Colority-Eigenschaft.

Standardmäßig ist der Wert dieser Eigenschaft TRUE.

Gibt die Sammlung der benutzerdefinierten Bilder zurück, die der ausgegebenen PDF-Datei beigefügt sind. Um ein Bild zu dieser Sammlung hinzuzufügen, verwenden Sie die-Methode des-Objekts und legen Sie die Bildposition auf einer Seite mithilfe der Methoden des-Objekts fest.

,nur lesbar

Legt die Parameter für das Schreiben von Bildern in PDF- (PDF/A-)Dateien fest, einschließlich MRC-Parameter. Mit diesen Parametern können Sie die im gewählten Exportszenario definierten Parameter zurücksetzen.

Legt die Bildauflösung in dpi fest. Die ResolutionType-Eigenschaft gibt an, wie der Wert dieser Eigenschaft interpretiert werden muss.

Die angegebene Auflösung darf nicht höher sein als die ursprüngliche Auflösung.

Der Standardwert dieser Eigenschaft beträgt 300 dpi.

Legt fest, wie der Wert der in der Resolution-Eigenschaft angegebenen Bildauflösung verwendet wird. Mögliche Verwendungen:

  • als absolute Auflösung (wird für alle Bilder verwendet),
  • als gewünschte Auflösung (nur anwendbar, wenn die ursprüngliche Auflösung über der gewünschten liegt; das Programm wählt den optimalen dpi-Wert, der der gewünschten Auflösung am nächsten kommt),
  • oder der Wert wird ignoriert (und die ursprüngliche Auflösung wird verwendet).

Standardmäßig ist der Wert dieser Eigenschaft PRT_Desired.

​
Methoden

NameBeschreibung
CopyFromInitialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts.
LoadFromFileStellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory <Hinweis> : Nur unter Windows. </Hinweis>Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.
SaveToFileSpeichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory <Hinweis> : Nur unter Windows. </Hinweis>Speichert den Inhalt des Objekts im globalen Speicher.
PDFExportParams Objektdiagramm

​
Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der Methode CreatePDFExportParams des Objekts Engine.

​
Eingabeparameter

Dieses Objekt wird als Eingabeparameter für die folgenden Methoden übergeben:

​
Beispiele

FREngine.IEngine engine;
FREngine.IFRDocument frDocument;
// Wir gehen davon aus, dass das Dokument erkannt und synthetisiert wurde
// Parameter für den Export anpassen
FREngine.IPDFExportParams pdfParams = Engine.CreatePDFExportParams();
pdfParams.Scenario = FREngine.PDFExportScenarioEnum.PES_Balanced;
// Ergebnisse mit den angegebenen Parametern speichern
frDocument.Export( "D:\\Demo.pdf", FREngine.FileExportFormatEnum.FEF_PDF, pdfParams );
Das Objekt wird in den folgenden Codebeispielen verwendet:

​
Siehe auch

Exportparameter anpassen Arbeiten mit Profilen Arbeiten mit Eigenschaften ZUGFeRD-konforme elektronische Rechnungen