mmdeploy/csrc/apis/c/text_recognizer.h
lvhan028 36124f6205
Merge sdk (#251)
* check in cmake

* move backend_ops to csrc/backend_ops

* check in preprocess, model, some codebase and their c-apis

* check in CMakeLists.txt

* check in parts of test_csrc

* commit everything else

* add readme

* update core's BUILD_INTERFACE directory

* skip codespell on third_party

* update trt_net and ort_net's CMakeLists

* ignore clion's build directory

* check in pybind11

* add onnx.proto. Remove MMDeploy's dependency on ncnn's source code

* export MMDeployTargets only when MMDEPLOY_BUILD_SDK is ON

* remove useless message

* target include directory is wrong

* change target name from mmdeploy_ppl_net to mmdeploy_pplnn_net

* skip install directory

* update project's cmake

* remove useless code

* set CMAKE_BUILD_TYPE to Release by force if it isn't set by user

* update custom ops CMakeLists

* pass object target's source lists

* fix lint end-of-file

* fix lint: trailing whitespace

* fix codespell hook

* remove bicubic_interpolate to csrc/backend_ops/

* set MMDEPLOY_BUILD_SDK OFF

* change custom ops build command

* add spdlog installation command

* update docs on how to checkout pybind11

* move bicubic_interpolate to backend_ops/tensorrt directory

* remove useless code

* correct cmake

* fix typo

* fix typo

* fix install directory

* correct sdk's readme

* set cub dir when cuda version < 11.0

* change directory where clang-format will apply to

* fix build command

* add .clang-format

* change clang-format style from google to file

* reformat csrc/backend_ops

* format sdk's code

* turn off clang-format for some files

* add -Xcompiler=-fno-gnu-unique

* fix trt topk initialize

* check in config for sdk demo

* update cmake script and csrc's readme

* correct config's path

* add cuda include directory, otherwise compile failed in case of tensorrt8.2

* clang-format onnx2ncnn.cpp

Co-authored-by: zhangli <lzhang329@gmail.com>
Co-authored-by: grimoire <yaoqian@sensetime.com>
2021-12-07 10:57:55 +08:00

81 lines
3.4 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"
typedef struct mm_text_recognize_t {
char* text;
float* score;
int length;
} mm_text_recognize_t;
MM_SDK_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" and 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
*/
MM_SDK_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
*/
MM_SDK_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
*/
MM_SDK_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
*/
MM_SDK_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
*/
MM_SDK_API void mmdeploy_text_recognizer_destroy(mm_handle_t handle);
#endif // MMDEPLOY_SRC_APIS_C_TEXT_RECOGNIZER_H_