MultiProcessingModeEnum

ABBYY FineReader Engine API の MultiProcessingModeEnum — FineReader Engine の並列処理で使用されるマルチプロセッシングモード（Linux および Windows のみ）。

この列挙型は、Linux および Windows 版の FRE に実装されています。

MultiProcessingModeEnum の列挙定数は、複数の CPU コアを使用して複数ページのドキュメントを処理する際の処理モードを指定します。

typedef enum {
 MPM_Sequential,
 MPM_Auto,
 MPM_Parallel
} MultiProcessingModeEnum;

​

要素

名前	説明
MPM_Auto	プロセス数は自動的に決定されます。処理対象が1ページのみの場合、またはシステム内のプロセッサが1つしかない場合は、1つのプロセスが使用されます。それ以外の場合は、並列処理が使用されます。
MPM_Parallel	文書のページは常に並列プロセスで処理されます。
MPM_Sequential	文書のページは1つのプロセスで順次処理されます。

​

備考

並列処理を使用する場合、実際に実行されるプロセスの数は、IMultiProcessingParams::RecognitionProcessesCount プロパティの値に依存します。

IMultiProcessingParams::RecognitionProcessesCount プロパティの値が 0 の場合、プロセスの数は、次の値の最小値に等しくなります：

• 利用可能な CPU コアの数、
  • Windows の場合、これは物理または論理 CPU コアを含み、IMultiProcessingParams::UseOnlyPhysicalCPUCores プロパティの値に依存します
• ライセンスで利用可能な空き CPU コアの数、
• ドキュメント内のページ数。

IMultiProcessingParams::RecognitionProcessesCount プロパティの値が 0 でない場合、プロセスの数は、次の値の最小値に等しくなります：

• RecognitionProcessesCount プロパティの値、
• ライセンスで利用可能な空き CPU コアの数、
• ドキュメント内のページ数。

同じドキュメントを並列プロセスで処理した場合と単一プロセスで処理した場合の結果は異なる場合があります。これは、処理中に使用される情報のすべてが異なるプロセスの間で共有できるわけではないためです。

CPU コアへの分散処理は、次のメソッドで利用可能です：

• FRDocument オブジェクトの AddImageFile、AddImageFileFromMemory、AddImageFileFromStream、AddImageFileWithPassword、AddImageFileWithPasswordCallback、Preprocess、PreprocessPages、Analyze、AnalyzePages、Recognize、RecognizePages、Process、ProcessPages、Export、ExportPages、ExportToMemory メソッド

• Engine オブジェクトの InjectTextLayer、RecognizeImageFile メソッド

​

使用箇所

IMultiProcessingParams::MultiProcessingMode