1
0
mirror of https://github.com/open-mmlab/mmdeploy.git synced 2025-01-14 08:09:43 +08:00
mmdeploy/csrc/apis/c/text_recognizer.h
lzhangzz 640aa03538
Support Windows ()
* minor changes

* support windows

* fix GCC build

* fix lint

* reformat

* fix Windows build

* fix GCC build

* search backend ops for onnxruntime

* fix lint

* fix lint

* code clean-up

* code clean-up

* fix clang build

* fix trt support

* fix cmake for ncnn

* fix cmake for openvino

* fix SDK Python API

* handle ops for other backends (ncnn, trt)

* handle SDK Python API library location

* robustify linkage

* fix cuda

* minor fix for openvino & ncnn

* use CMAKE_CUDA_ARCHITECTURES if set

* fix cuda preprocessor

* fix misc

* fix pplnn & pplcv, drop support for pplcv<0.6.0

* robustify cmake

* update build.md ()

* build dynamic modules as module library & fix demo (partially)

* fix candidate path for mmdeploy_python

* move "enable CUDA" to cmake config for demo

* refine demo cmake

* add comment

* fix ubuntu build

* revert docs/en/build.md

* fix C API

* fix lint

* Windows build doc ()

* check in docs related to mmdeploy build on windows

* update build guide on windows platform

* update build guide on windows platform

* make path of thirdparty libraries consistent

* make path consistency

* correct build command for custom ops

* correct build command for sdk

* update sdk build instructions

* update doc

* correct build command

* fix lint

* correct build command and fix lint

Co-authored-by: lvhan <lvhan@pjlab.org>

* trailing whitespace ()

* minor fix

* fix sr sdk model

* fix type deduction

* fix cudaFree after driver shutting down

* update ppl.cv installation warning ()

* fix device allocator threshold & fix lint

* update doc ()

* update ppl.cv installation warning

* missing 'git clone'

Co-authored-by: chenxin <chenxin2@sensetime.com>
Co-authored-by: zhangli <zhangli@sensetime.com>
Co-authored-by: lvhan028 <lvhan_028@163.com>
Co-authored-by: lvhan <lvhan@pjlab.org>
2022-02-24 20:08:44 +08:00

100 lines
4.0 KiB
C

// Copyright (c) OpenMMLab. All rights reserved.
/**
* @file text_recognizer.h
* @brief Interface to MMOCR text recognition task
*/
#ifndef MMDEPLOY_SRC_APIS_C_TEXT_RECOGNIZER_H_
#define MMDEPLOY_SRC_APIS_C_TEXT_RECOGNIZER_H_
#include "common.h"
#include "text_detector.h"
#ifdef __cplusplus
extern "C" {
#endif
typedef struct mm_text_recognize_t {
char* text;
float* score;
int length;
} mm_text_recognize_t;
/**
* @brief Create a text recognizer instance
* @param[in] model an instance of mmocr text recognition model created by
* \ref mmdeploy_model_create_by_path or \ref mmdeploy_model_create in \ref model.h
* @param[in] device_name name of device, such as "cpu", "cuda", etc.
* @param[in] device_id id of device.
* @param[out] handle handle of the created text recognizer, which must be destroyed
* by \ref mmdeploy_text_recognizer_destroy
* @return status code of the operation
*/
MMDEPLOY_API int mmdeploy_text_recognizer_create(mm_model_t model, const char* device_name,
int device_id, mm_handle_t* handle);
/**
* @brief Create a text recognizer instance
* @param[in] model_path path to text recognition model
* @param[in] device_name name of device, such as "cpu", "cuda", etc.
* @param[in] device_id id of device.
* @param[out] handle handle of the created text recognizer, which must be destroyed
* by \ref mmdeploy_text_recognizer_destroy
* @return status code of the operation
*/
MMDEPLOY_API int mmdeploy_text_recognizer_create_by_path(const char* model_path,
const char* device_name, int device_id,
mm_handle_t* handle);
/**
* @brief Apply text recognizer to a batch of text images
* @param[in] handle text recognizer's handle created by \ref
* mmdeploy_text_recognizer_create_by_path
* @param[in] images a batch of text images
* @param[in] count number of images in the batch
* @param[out] results a linear buffer contains the recognized text, must be release
* by \ref mmdeploy_text_recognizer_release_result
* @return status code of the operation
*/
MMDEPLOY_API int mmdeploy_text_recognizer_apply(mm_handle_t handle, const mm_mat_t* images,
int count, mm_text_recognize_t** results);
/**
* @brief Apply text recognizer to a batch of images supplied with text bboxes
* @param[in] handle text recognizer's handle created by \ref
* mmdeploy_text_recognizer_create_by_path
* @param[in] images a batch of text images
* @param[in] image_count number of images in the batch
* @param[in] bboxes bounding boxes detected by text detector
* @param[in] bbox_count number of bboxes of each \p images, must be same length as \p images
* @param[out] results a linear buffer contains the recognized text, which has the same length as \p
* bboxes, must be release by \ref mmdeploy_text_recognizer_release_result
* @return status code of the operation
*/
MMDEPLOY_API int mmdeploy_text_recognizer_apply_bbox(mm_handle_t handle, const mm_mat_t* images,
int image_count,
const mm_text_detect_t* bboxes,
const int* bbox_count,
mm_text_recognize_t** results);
/** @brief Release result buffer returned by \ref mmdeploy_text_recognizer_apply or \ref
* mmdeploy_text_recognizer_apply_bbox
* @param[in] results result buffer by text recognizer
* @param[in] count length of \p result
*/
MMDEPLOY_API void mmdeploy_text_recognizer_release_result(mm_text_recognize_t* results, int count);
/**
* @brief destroy text recognizer
* @param[in] handle handle of text recognizer created by \ref
* mmdeploy_text_recognizer_create_by_path or \ref mmdeploy_text_recognizer_create
*/
MMDEPLOY_API void mmdeploy_text_recognizer_destroy(mm_handle_t handle);
#ifdef __cplusplus
}
#endif
#endif // MMDEPLOY_SRC_APIS_C_TEXT_RECOGNIZER_H_