Processing a Single Image

This page introduces the capture APIs of the CaptureVisionRouter that designed for processing a single image (or single page file).

Capture(filePath)

Processes a single image or a file containing a single image to derive important information with the file path.

Note: The file should be a single image or a single page image file.

CapturedResult Capture(string filePath, string templateName);

Parameters

[in] filePath: The file path and name that you want to capture data from.

[in] templateName: Specifies a “CaptureVisionTemplate” to use. The following value are available for this parameter:

• One of the EnumPresetTemplate member. This is available only if you have never upload a new template via InitSettings or InitSettingsFromFile.
• A string that represents one of the template name that you have uploaded via InitSettings or InitSettingsFromFile.
• ”” (empty string) to use the default template. The first template will be used if you have uploaded a template file via InitSettingsFromFile or InitSettings.

Return Value

A CapturedResult object which contains the derived information from the image processed.

If an error occurs when processing the image, the CapturedResult object will include error code and error message that describes the reason of the error.

Possible Errors

Capture(fileBytes)

Processes a single image in the memory with the fileBytes.

Note: The file should be a single image or a single page image file.

CapturedResult Capture(byte[] fileBytes, string templateName);

Parameters

[in] fileBytes: The fileBytes of the file in memory.

[in] templateName: Specifies a “CaptureVisionTemplate” to use. The following value are available for this parameter:

• One of the EnumPresetTemplate member. This is available only if you have never upload a new template via InitSettings or InitSettingsFromFile.
• A string that represents one of the template name that you have uploaded via InitSettings or InitSettingsFromFile.
• ”” (empty string) to use the default template. The first template will be used if you have uploaded a template file via InitSettingsFromFile or InitSettings.

Return Value

A CapturedResult object which contains the derived information from the image processed.

If an error occurs when processing the image, the CapturedResult object will include error code and error message that describes the reason of the error.

Possible Errors

Capture(imageData)

Processes a single image with the ImageData.

CapturedResult Capture(ImageData imageData, string templateName);

Parameters

[in] imageData: The ImageData of the image.

[in] templateName: Specifies a “CaptureVisionTemplate” to use. The following value are available for this parameter:

• One of the EnumPresetTemplate member. This is available only if you have never upload a new template via InitSettings or InitSettingsFromFile.
• A string that represents one of the template name that you have uploaded via InitSettings or InitSettingsFromFile.
• ”” (empty string) to use the default template. The first template will be used if you have uploaded a template file via InitSettingsFromFile or InitSettings.

Return Value

A CapturedResult object which contains the derived information from the image processed.

If an error occurs when processing the image, the CapturedResult object will include error code and error message that describes the reason of the error.

Possible Errors