HOCR_SDK_runAsyncQueue

Included header

#include <HOCR_SDK_COMMON.h>

Description

Asynchronous engine module execution API; results are delivered via a queue returned by this function

HOCR_SDK_runAsyncQueue()

void* HOCR_SDK_runAsyncQueue(void* obj, char* openApiName, char* requestId, int imgWidth, int imgHeight, int colorSpace, char* imgData, char* requestOptionJsonStr)

Parameters

Name	Type	Description
obj	void*	Pointer to 'ArgoEngineApi' object
openApiName	char*	Name of the engine module to use
requestId	char*	Request ID (value to identify the request)
imgWidth	int	Image width
imgHeight	int	Image height
colorSpace	int	Image color type Note: RGB 0, RGBA 1, BGR 2, BGRA 3, YUV 4, GRAY 5
imgData	char*	Image pixel data Note: Raw pixel data (bitmap) array already decoded by an image processing library, etc.
requestOptionJsonStr	char*	JSON string to set options of the engine module obtained via HOCR_SDK_getOpenApiOption

Return value

void *: Queue object to receive the execution result

Pass this object to HOCR_SDK_waitResult to wait for results

After use, you must release the queue object by calling HOCR_SDK_releaseQueue

Examples

• Using the OpenCV library

cv::Mat mat = cv::imread("ocr1.png", cv::IMREAD_COLOR);

std::string openApiName = "TEXT_RECOGNITION";
std::string requestId = "random-string";
char *dataMat = reinterpret_cast<char*>(temp.data);
std::string requestOptionJsonStr = "{}";

void * resultQueue = HOCR_SDK_runAsyncQueue(
  obj,
  openApiName.data(),
  requestId.data(),
  mat.cols,
  mat.rows,
  2, /* RGB 0, RGBA 1, BGR 2, BGRA 3, YUV 4, GRAY 5 */
  dataMat,
  requestOptionJsonStr.data()
);

char *resultJsonStr = nullptr;
int resultSize = HOCR_SDK_waitResult(resultQueue, &resultJsonStr);
std::string resultJson(resultJsonStr, resultSize);

bool isSuccess = HOCR_SDK_releaseQueue(resultQueue);