メインコンテンツへスキップ
このオブジェクトは、ABBYY FineReader Engine のエクスポート関数を使用して、認識されたテキストを PDF (PDF/A) 形式でエクスポートする際のパラメーターを調整するための機能を提供します。このオブジェクトへのポインターは、入力パラメーターとしてエクスポート メソッドに渡され、エクスポート結果に影響します。この型の新しく作成されたオブジェクトでは、すべてのプロパティに適切な既定値が設定されています。 パラメーターは、次の順序で調整することをお勧めします。
  1. まず、Scenario プロパティを設定します。このプロパティは、画質、ファイル サイズ、エクスポート速度、またはそれらの組み合わせといった観点で、いくつかのパラメーターを最適化します。このプロパティの値を選択すると、PDFExportParams オブジェクトとそのサブオブジェクトのプロパティは、選択したタスクに適した値に設定されます。
プロパティの設定は、入力データによって異なる場合があります。
  1. その後、タスクに最適になるよう追加のパラメーターをカスタマイズできます。詳細については、エクスポート パラメーターの調整を参照してください。
PDFExportParams オブジェクトのプロパティは、そのサブオブジェクトのプロパティよりも優先されます。つまり、PDFExportParams オブジェクトのいずれかのプロパティの値を変更すると、そのサブオブジェクトのプロパティ値が自動的に上書きされる場合があります。逆に、いずれかのサブオブジェクトのプロパティ値を変更しても、PDFExportParams のプロパティ値が変わることはありません。
PDFExportParams オブジェクトは永続オブジェクトです。つまり、オブジェクトの現在の状態を永続ストレージに書き込むことができます。後で、永続ストレージからオブジェクトの状態を読み取ることで、そのオブジェクトを再作成できます。オブジェクトを永続化するために、次のメソッドが用意されています。 Linux: SaveToFile、および LoadFromFile Windows: SaveToFile、LoadFromFile、SaveToMemory、および LoadFromMemory。

​
プロパティ

,read-only

Engine オブジェクトを返します。

PDF (PDF/A) 形式へのエクスポートシナリオを指定します。品質、ファイルサイズ、エクスポート速度などのパラメーターを最適化します。

このプロパティの値を変更すると、FontEmbeddingMode,TextAndBackgroundColorMode,WriteXmpMetadata,WriteTaggedPDFPDFExportFeatures サブオブジェクトのプロパティ、およびColorPictureFormats,GrayPictureFormats,BwPictureFormatsPDFPictureCompressionParams サブオブジェクトのプロパティがデフォルト値にリセットされます。

デフォルト値は PES_Balanced です。

選択したシナリオによっては、一部の内部エクスポート設定が変更される場合があります。これは、以下の PDFExportParams プロパティの値に影響します。

エクスポート形式を指定します。PDF、PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-2u、PDF/A-3a、PDF/A-3b、または PDF/A-3u を選択できます。

このプロパティの値は、エクスポート時に使用できる設定に影響します。このプロパティの値が PCM_None 以外の場合 (PDF/A 形式へのエクスポートが実行される場合) ：

  • PDFEncryptionInfo サブオブジェクトのプロパティを TRUE に設定できません
  • プロパティ (PDFExportFeatures サブオブジェクト) は、PDF/A-1a、PDF/A-1b の場合、PVN_Auto または PVN_Version14 のみに設定できます
  • 形式が PDF/A-1a、PDF/A-2a、または PDF/A-3a の場合、プロパティ (PDFExportFeatures サブオブジェクト) は TSPV_No に設定できません (ファイルは常にタグ付きになります)
  • プロパティ (PDFExportFeatures サブオブジェクト) は TSPV_No に設定できません
  • プロパティ (PDFExportFeatures サブオブジェクト) は FEM_DontEmbed に設定できません
  • プロパティ (PDFPictureCompressionParams サブオブジェクト) は CPF_J2K (PDF/A-1a、PDF/A-1b のみ) または CPF_LZW に設定できません
  • プロパティ (PDFPictureCompressionParams サブオブジェクト) は GPF_J2K (PDF/A-1a、PDF/A-1b のみ) または GPF_LZW に設定できません
  • プロパティ (PDFExportFeatures サブオブジェクト) は、PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-2u の場合、TRUE に設定できません。

これらの要件が満たされない場合、エラーが返されます。

デフォルト値は PCM_None です。これは、PDF へのエクスポートが実行されることを意味します。

認識されたテキストを PDF (PDF/A) 形式にエクスポートするモードを指定します。使用可能なモードは、テキストと画像のみ、ページ画像の上にテキスト、ページ画像の下にテキスト、ページ画像のみ、テキストのみです。

このプロパティが PEM_TextOnly の場合、PDFPictureCompressionParamsサブオブジェクトの BwPictureFormats、ColorPictureFormats、および GrayPictureFormats プロパティの値は無視されます。

このプロパティのデフォルト値は PEM_ImageOnText です。

出力 PDF (PDF/A) ファイルに対してを使用するモードを指定します。

このプロパティの値は、白黒 PDF へのエクスポート時には無視されます。

このプロパティのデフォルト値は MRC_Auto です。

,read-only

追加のエクスポートパラメーター (暗号化情報、PDF バージョンなど) を指定します。

出力 PDF (PDF/A) ファイルのカラーを維持するか、グレースケールまたは白黒で保存するかを指定します。カラーを保存する必要がなく、出力ファイルのサイズを削減したい場合は、カラードキュメントに対してこのプロパティを PCM_ForceToGray に設定すると便利です。

CorrectColorDepth プロパティが TRUE に設定されている場合、ABBYY FineReader Engine はドキュメントの色深度をさらに補正できます。たとえば、Colority を PCM_ForceToGray に設定し、CorrectColorDepth が TRUE の場合、FineReader Engine はカラー画像をグレースケールに変換し、グレースケール画像の色深度を検出して、必要に応じて一部の画像を白黒に変換します。

このプロパティのデフォルト値は PCM_KeepColority です。

このプロパティをTRUEに設定すると、ABBYY FineReader Engineはドキュメントの色深度を補正します。FALSEに設定した場合、ABBYY FineReader EngineはColorityプロパティで定義された色でドキュメントを保存します。

このプロパティのデフォルト値はTRUEです。

出力PDFファイルに添付されたユーザー定義画像のコレクションを返します。このコレクションに画像を追加するには、PDFPicturesオブジェクトのAddNewメソッドを使用し、PDFPictureオブジェクトのメソッドでページ上の画像位置を設定します。

,read-only

MRCパラメーターを含む、PDF (PDF/A) ファイルへの画像書き込みパラメーターを指定します。これらのパラメーターにより、選択したエクスポートシナリオで定義されたパラメーターをリセットできます。

画像の解像度をdpiで指定します。このプロパティの値の解釈方法は、ResolutionTypeプロパティで指定します。

指定する解像度は、元の解像度を超えることはできません。

このプロパティのデフォルト値は300 dpiです。

Resolutionプロパティで指定した画像解像度の値をどのように使用するかを定義します。次のいずれかの方法で使用できます：

  • 絶対解像度として使用 (すべての画像に適用) 、
  • 目標解像度として使用 (元の解像度が目標値を上回る場合にのみ適用可能。プログラムが目標解像度に最も近い最適なdpi値を選択します) 、
  • または値を無視する (元の解像度がそのまま使用されます) 。

このプロパティのデフォルト値はPRT_Desiredです。

​
メソッド

名前説明
CopyFrom現在のオブジェクトのプロパティを、別のオブジェクトの対応するプロパティの値で初期化します。
LoadFromFileディスク上のファイルからオブジェクトの内容を復元します。
LoadFromMemory <Note> : Windows のみ。 </Note>グローバル メモリからオブジェクトの内容を復元します。
SaveToFileオブジェクトの内容をディスク上のファイルに保存します。
SaveToMemory <Note> : Windows のみ。 </Note>オブジェクトの内容をグローバル メモリに保存します。
PDFExportParams オブジェクト図

​
出力パラメーター

このオブジェクトは、Engine オブジェクトの CreatePDFExportParams メソッドからの出力パラメーターです。

​
入力パラメーター

このオブジェクトは、次のメソッドに入力パラメーターとして渡されます。

​
サンプル

FREngine.IEngine engine;
FREngine.IFRDocument frDocument;
// 文書は認識および合成済みであるものとします
// エクスポート用のパラメーターを調整します
FREngine.IPDFExportParams pdfParams = Engine.CreatePDFExportParams();
pdfParams.Scenario = FREngine.PDFExportScenarioEnum.PES_Balanced;
// 指定したパラメーターを使用して結果を保存します
frDocument.Export( "D:\\Demo.pdf", FREngine.FileExportFormatEnum.FEF_PDF, pdfParams );
このオブジェクトは、以下のコードサンプルで使用されています。

​
関連項目

エクスポート パラメーターの調整 プロファイルの操作 プロパティの操作 ZUGFeRD準拠の電子請求書