Trait opencv::prelude::OCRTesseract

pub trait OCRTesseract: BaseOCR {
    pub fn as_raw_OCRTesseract(&self) -> *const c_void;
    pub fn as_raw_mut_OCRTesseract(&mut self) -> *mut c_void;

    pub fn run_multiple(
        &mut self, 
        image: &mut Mat, 
        output_text: &mut String, 
        component_rects: &mut Vector<Rect>, 
        component_texts: &mut Vector<String>, 
        component_confidences: &mut Vector<f32>, 
        component_level: i32
    ) -> Result<()> { ... }
    pub fn run_multiple_mask(
        &mut self, 
        image: &mut Mat, 
        mask: &mut Mat, 
        output_text: &mut String, 
        component_rects: &mut Vector<Rect>, 
        component_texts: &mut Vector<String>, 
        component_confidences: &mut Vector<f32>, 
        component_level: i32
    ) -> Result<()> { ... }
    pub fn run(
        &mut self, 
        image: &dyn ToInputArray, 
        min_confidence: i32, 
        component_level: i32
    ) -> Result<String> { ... }
    pub fn run_mask(
        &mut self, 
        image: &dyn ToInputArray, 
        mask: &dyn ToInputArray, 
        min_confidence: i32, 
        component_level: i32
    ) -> Result<String> { ... }
    pub fn set_white_list(&mut self, char_whitelist: &str) -> Result<()> { ... }
}

OCRTesseract class provides an interface with the tesseract-ocr API (v3.02.02) in C++.

Notice that it is compiled only when tesseract-ocr is correctly installed.

Note:

• (C++) An example of OCRTesseract recognition combined with scene text detection can be found at the end_to_end_recognition demo: https://github.com/opencv/opencv_contrib/blob/master/modules/text/samples/end_to_end_recognition.cpp
• (C++) Another example of OCRTesseract recognition combined with scene text detection can be found at the webcam_demo: https://github.com/opencv/opencv_contrib/blob/master/modules/text/samples/webcam_demo.cpp

Required methods

pub fn as_raw_OCRTesseract(&self) -> *const c_void

pub fn as_raw_mut_OCRTesseract(&mut self) -> *mut c_void

Loading content...

Provided methods

pub fn run_multiple(
    &mut self,
    image: &mut Mat,
    output_text: &mut String,
    component_rects: &mut Vector<Rect>,
    component_texts: &mut Vector<String>,
    component_confidences: &mut Vector<f32>,
    component_level: i32
) -> Result<()>

Recognize text using the tesseract-ocr API.

Takes image on input and returns recognized text in the output_text parameter. Optionally provides also the Rects for individual text elements found (e.g. words), and the list of those text elements with their confidence values.

Parameters

• image: Input image CV_8UC1 or CV_8UC3
• output_text: Output text of the tesseract-ocr.
• component_rects: If provided the method will output a list of Rects for the individual text elements found (e.g. words or text lines).
• component_texts: If provided the method will output a list of text strings for the recognition of individual text elements found (e.g. words or text lines).
• component_confidences: If provided the method will output a list of confidence values for the recognition of individual text elements found (e.g. words or text lines).
• component_level: OCR_LEVEL_WORD (by default), or OCR_LEVEL_TEXTLINE.

C++ default parameters

• component_rects: NULL
• component_texts: NULL
• component_confidences: NULL
• component_level: 0

pub fn run_multiple_mask(
    &mut self,
    image: &mut Mat,
    mask: &mut Mat,
    output_text: &mut String,
    component_rects: &mut Vector<Rect>,
    component_texts: &mut Vector<String>,
    component_confidences: &mut Vector<f32>,
    component_level: i32
) -> Result<()>

C++ default parameters

• component_rects: NULL
• component_texts: NULL
• component_confidences: NULL
• component_level: 0

pub fn run(
    &mut self,
    image: &dyn ToInputArray,
    min_confidence: i32,
    component_level: i32
) -> Result<String>

C++ default parameters

• component_level: 0

pub fn run_mask(
    &mut self,
    image: &dyn ToInputArray,
    mask: &dyn ToInputArray,
    min_confidence: i32,
    component_level: i32
) -> Result<String>

C++ default parameters

• component_level: 0

pub fn set_white_list(&mut self, char_whitelist: &str) -> Result<()>

Loading content...

Implementations

impl<'_> dyn OCRTesseract + '_

pub fn create(
    datapath: &str,
    language: &str,
    char_whitelist: &str,
    oem: i32,
    psmode: i32
) -> Result<Ptr<dyn OCRTesseract>>

Creates an instance of the OCRTesseract class. Initializes Tesseract.

Parameters

• datapath: the name of the parent directory of tessdata ended with "/", or NULL to use the system's default directory.
• language: an ISO 639-3 code or NULL will default to "eng".
• char_whitelist: specifies the list of characters used for recognition. NULL defaults to "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ".
• oem: tesseract-ocr offers different OCR Engine Modes (OEM), by default tesseract::OEM_DEFAULT is used. See the tesseract-ocr API documentation for other possible values.
• psmode: tesseract-ocr offers different Page Segmentation Modes (PSM) tesseract::PSM_AUTO (fully automatic layout analysis) is used. See the tesseract-ocr API documentation for other possible values.

C++ default parameters

• datapath: NULL
• language: NULL
• char_whitelist: NULL
• oem: OEM_DEFAULT
• psmode: PSM_AUTO

Implementors

impl OCRTesseract for PtrOfOCRTesseract

pub fn as_raw_OCRTesseract(&self) -> *const c_void

pub fn as_raw_mut_OCRTesseract(&mut self) -> *mut c_void

Loading content...