> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BatchProcessor-Objekt (IBatchProcessor-Schnittstelle)

> BatchProcessor-Objekt (IBatchProcessor-Schnittstelle) in der ABBYY FineReader Engine API — Dies ist ein Prozessorobjekt, das Eingabebilder in erkannte Seiten (FRPage-Objekte) umwandelt.

<Note>
  Dieses Objekt ist in FRE für Linux und Windows implementiert.
</Note>

Dies ist ein Prozessorobjekt, das Eingabebilder in erkannte Seiten ([FRPage](/de/fine-reader/engine/api-reference/document-related-objects/frpage)-Objekte) umwandelt.

Bei der Initialisierung des Prozessors werden asynchrone Erkennungsprozesse gestartet und konfiguriert. Anschließend bezieht der Prozessor Bilddateien aus einer benutzerdefinierten Bildquelle. Für jede Seite einer Bilddatei wird eine neue Verarbeitungsaufgabe erstellt und an einen der Erkennungsprozesse übergeben. Wenn alle Aufgaben für eine Datei zur Verarbeitung übergeben wurden, aber noch nicht alle Erkennungsprozesse ausgelastet sind, wird die nächste Bilddatei aus der Bildwarteschlange der Quelle entnommen und zur Verarbeitung übergeben. Dies wird so lange fortgesetzt, bis die erste Bildseite konvertiert und an den Benutzer übergeben wurde. Die Seiten werden dem Benutzer in der Reihenfolge zurückgegeben, in der sie aus der Bildquelle entnommen wurden.

Gehen Sie wie folgt vor, um die Verarbeitung mit dem Batch Processor zu organisieren:

1. Implementieren Sie die Schnittstellen [IImageSource](/de/fine-reader/engine/api-reference/batch-processor/iimagesource) und [IFileAdapter](/de/fine-reader/engine/api-reference/batch-processor/ifileadapter), die Zugriff auf die Bildquelle und die darin enthaltenen Dateien bereitstellen.
2. \[optional] Implementieren Sie die Schnittstelle [IAsyncProcessingCallback](/de/fine-reader/engine/api-reference/batch-processor/iasyncprocessingcallback), um die Verarbeitung zu steuern. Mit den Methoden dieser Schnittstelle können Sie Fehler behandeln und/oder die Verarbeitung abbrechen.
3. Rufen Sie die Methode [CreateBatchProcessor](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) des Objekts [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface) auf, um das BatchProcessor-Objekt zu erhalten.
4. Verwenden Sie die Eigenschaft PageFlushingPolicy, um den Modus für die Arbeit mit Dokumentseiten im Speicher festzulegen.
5. Rufen Sie die Methode Start auf, um den Prozessor zu initialisieren und asynchrone Erkennungsprozesse zu starten. In dieser Methode können Sie die Bildquelle und die Verarbeitungseinstellungen angeben.

* Das BatchProcessor-Objekt kann nicht wiederverwendet werden. Wiederholte Aufrufe der Methode Start führen zu Fehlern.
* Erstellen und verwenden Sie nicht mehrere Batch Processors gleichzeitig, da dies zu Verwechslungen bei der Seitenverarbeitung führen kann.

6. Rufen Sie die Methode GetNextProcessedPage in einer Schleife auf, bis die Methode 0 zurückgibt. Das bedeutet, dass sich keine Bilder mehr in der Quelle befinden und alle verarbeiteten Bilder an den Benutzer zurückgegeben wurden.

<Warning>
  Die von der Methode GetNextProcessedPage zurückgegebene Seite existiert bis zum nächsten Aufruf dieser Methode. Wenn Sie diese Seite daher speichern möchten, müssen Sie sie entweder mit den Methoden des Objekts [FRPage](/de/fine-reader/engine/api-reference/document-related-objects/frpage) speichern oder sie mit der Methode [IFRDocument::AddPage](/de/fine-reader/engine/api-reference/document-related-objects/frdocument/addpage-method) zu einem vorhandenen Dokument hinzufügen, BEVOR die Methode GetNextProcessedPage das nächste Mal aufgerufen wird.
</Warning>

<div id="properties">
  ## Eigenschaften
</div>

| Name               | Typ                                                                                                                                                                                                                  | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application        | [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface), [nur lesbar](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Gibt das Engine-Objekt zurück.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| PageFlushingPolicy | [PageFlushingPolicyEnum](/de/fine-reader/engine/api-reference/enumerations/pageflushingpolicyenum)                                                                                                                   | Gibt an, ob die Objekte [ImageDocument](/de/fine-reader/engine/api-reference/image-related-objects/imagedocument) und [Layout](/de/fine-reader/engine/api-reference/layout-related-objects/layout) für die entsprechenden Seiten entladen und auf der Festplatte gespeichert werden sollen, wenn keine Verweise mehr auf diese Objekte vorhanden sind. <Note> Unter Linux werden die ImageDocument- und Layout-Objekte für nicht verwendete Seiten nicht auf der Festplatte gespeichert, wenn diese Eigenschaft auf PFP\_KeepInMemory gesetzt ist. </Note> <Note> Verwenden Sie unter Windows zum Entladen und Speichern der ImageDocument- und Layout-Objekte für einzelne Seiten des Dokuments auf der Festplatte die Methode [IFRPage::Flush](/de/fine-reader/engine/api-reference/document-related-objects/frpage/flush-method) für die entsprechenden Seiten. </Note> Standardmäßig ist diese Eigenschaft auf PFP\_Auto gesetzt. |

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                                    | Beschreibung                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [GetNextProcessedPage](/de/fine-reader/engine/api-reference/batch-processor/batchprocessor/getnextprocessedpage-method) | Führt die Verarbeitung im Hintergrund fort, bis das nächste erkannte Bild verfügbar ist.                                                                                           |
| [ProcessPageAsync](/de/fine-reader/engine/api-reference/batch-processor/batchprocessor/processpageasync-method)         | Ermöglicht es Ihnen, die Verarbeitung einer Seite mit anderen Parametern zu wiederholen. Die Seite kann an den Anfang oder das Ende der Verarbeitungswarteschlange gesetzt werden. |
| [Start](/de/fine-reader/engine/api-reference/batch-processor/batchprocessor/start-method)                               | Bereitet den Batch Processor für die Verarbeitung vor. Die Methode startet asynchrone Erkennungsprozesse und legt die Bildquelle sowie die Verarbeitungseinstellungen fest.        |

<div id="output-parameter">
  ## Ausgabeparameter
</div>

Dieses Objekt ist der Ausgabeparameter der Methode [CreateBatchProcessor](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) des [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface)-Objekts.

<div id="samples">
  ## Beispiele
</div>

<Accordion title="C#-Code">
  ```csharp theme={null}
  // Batch Processor erstellen
  FREngine.IBatchProcessor batchProcessor = engine.CreateBatchProcessor();
  FREngine.IFRDocument document = engine.CreateFRDocument();
  // Prozessor initialisieren
  FREngine.IImageSource imageSource = new CImageSource; // die Klasse wird vom Benutzer implementiert
  batchProcessor.PageFlushingPolicy = FREngine.PageFlushingPolicyEnum.PFP_KeepInMemory;
  batchProcessor.Start( imageSource, null, null, null );
  // Verarbeitung starten
  while( true ) {
   FREngine.IFRPage page = batchProcessor.GetNextProcessedPage();
   if( page == null ) {
    break; // es sind keine weiteren Seiten vorhanden, Verarbeitung beendet
   }
   // etwas mit der Seite machen
   ...
   document.AddPage( page );
  }
  ```
</Accordion>

Dieses Objekt wird in den folgenden Codebeispielen verwendet: [BatchProcessing](/de/fine-reader/engine/guided-tour/samples#batchprocessing) und in den Demo-Tools: [BatchProcessingRecognition](/de/fine-reader/engine/guided-tour/samples#batchprocessingrecognition).

<div id="see-also">
  ## Siehe auch
</div>

[Parallelverarbeitung mit ABBYY FineReader Engine](/de/fine-reader/engine/guided-tour/advanced-techniques/parallel-processing)

[IImageSource](/de/fine-reader/engine/api-reference/batch-processor/iimagesource)