Start Method of the BatchProcessor Object
This method prepares the Batch Processor for work. The method invokes asynchronous recognition processes, specifies the source of images and processing settings.
Note: The BatchProcessor object cannot be reused. Repeated calls to the Start method will cause errors.
Syntax
HRESULT Start( IImageSource* ImageSource, IAsyncProcessingCallback* ProcessingCallback, IPrepareImageMode* OpeningParams, IPageProcessingParams* ProcessingParams, IPageSplittingParams* PageSplittingParams );
Parameters
- ImageSource
- [in] Specifies the image source which should be used with the processor. The variable refers to the object which implements the IImageSource interface.
- ProcessingCallback
- [in] Refers to the IAsyncProcessingCallback interface of the user-implemented object which is used to manage processing. This parameter may be 0.
- Note: The callback will be used only with image files. If you add the images via the IImageSource::GetNextImageDocument method, you will not be able to manage the work of the BatchProcessor object with this interface.
- OpeningParams
- [in] Refers to the PrepareImageMode object which specifies how an image will be preprocessed during opening. This parameter may be 0. In this case, image preprocessing is performed with default parameters, or, if a profile has been loaded, the parameters set by this profile are used.
- ProcessingParams
- [in] Refers to the PageProcessingParams object that stores parameters of analysis, recognition, and page synthesis. This parameter may be 0. In this case, the page is analyzed and recognized with default parameters, or, if a profile has been loaded, the parameters set by this profile are used.
- Note: If you work with ImageDocument these parameters will be reset to default.
- PageSplittingParams
- [in] Refers to the PageSplittingParams object that stores parameters of page splitting. This parameter may be 0. In this case, no page split is done, or, if a profile has been loaded, the parameters set by this profile are used.
- Note: Page splitting is currently not supported in Batch Processor.
Return values
This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.
Remarks
This method does not work if the Engine object is loaded as an out-of-process server.
See also
7/3/2024 8:50:25 AM