mirror/tesseract
1
0
Fork 0
mirror of https://github.com/tesseract-ocr/tesseract.git synced 2024-11-24 02:59:07 +08:00
Code Issues Actions 10 Packages Projects Releases Wiki Activity

doxygen ccmain/cube_control.cpp

Browse Source
This commit is contained in:
Jim O'Regan 2015-07-20 12:52:59 +01:00
parent 9bcbe16fc8
commit aa9a9711ad
1 changed files with 33 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

66
ccmain/cube_control.cpp
View File

@ -21,24 +21,24 @@
namespace tesseract { namespace tesseract {
/********************************************************************** /**
* convert_prob_to_tess_certainty * @name convert_prob_to_tess_certainty
* *
* Normalize a probability in the range [0.0, 1.0] to a tesseract * Normalize a probability in the range [0.0, 1.0] to a tesseract
* certainty in the range [-20.0, 0.0] * certainty in the range [-20.0, 0.0]
**********************************************************************/ */
static float convert_prob_to_tess_certainty(float prob) { static float convert_prob_to_tess_certainty(float prob) {
return (prob - 1.0) * 20.0; return (prob - 1.0) * 20.0;
} }
/********************************************************************** /**
* char_box_to_tbox * @name char_box_to_tbox
* *
* Create a TBOX from a character bounding box. If nonzero, the * Create a TBOX from a character bounding box. If nonzero, the
* x_offset accounts for any additional padding of the word box that * x_offset accounts for any additional padding of the word box that
* should be taken into account. * should be taken into account.
* *
**********************************************************************/ */
TBOX char_box_to_tbox(Box* char_box, TBOX word_box, int x_offset) { TBOX char_box_to_tbox(Box* char_box, TBOX word_box, int x_offset) {
l_int32 left; l_int32 left;
l_int32 top; l_int32 top;
@ -55,13 +55,13 @@ TBOX char_box_to_tbox(Box* char_box, TBOX word_box, int x_offset) {
return TBOX(left, bottom, right, top); return TBOX(left, bottom, right, top);
} }
/********************************************************************** /**
* extract_cube_state * @name extract_cube_state
* *
* Extract CharSamp objects and character bounding boxes from the * Extract CharSamp objects and character bounding boxes from the
* CubeObject's state. The caller should free both structres. * CubeObject's state. The caller should free both structres.
* *
**********************************************************************/ */
bool Tesseract::extract_cube_state(CubeObject* cube_obj, bool Tesseract::extract_cube_state(CubeObject* cube_obj,
int* num_chars, int* num_chars,
Boxa** char_boxes, Boxa** char_boxes,
@ -104,15 +104,15 @@ bool Tesseract::extract_cube_state(CubeObject* cube_obj,
return true; return true;
} }
/********************************************************************** /**
* create_cube_box_word * @name create_cube_box_word
* *
* Fill the given BoxWord with boxes from character bounding * Fill the given BoxWord with boxes from character bounding
* boxes. The char_boxes have local coordinates w.r.t. the * boxes. The char_boxes have local coordinates w.r.t. the
* word bounding box, i.e., the left-most character bbox of each word * word bounding box, i.e., the left-most character bbox of each word
* has (0,0) left-top coord, but the BoxWord must be defined in page * has (0,0) left-top coord, but the BoxWord must be defined in page
* coordinates. * coordinates.
**********************************************************************/ */
bool Tesseract::create_cube_box_word(Boxa *char_boxes, bool Tesseract::create_cube_box_word(Boxa *char_boxes,
int num_chars, int num_chars,
TBOX word_box, TBOX word_box,
@ -144,13 +144,13 @@ bool Tesseract::create_cube_box_word(Boxa *char_boxes,
return true; return true;
} }
/********************************************************************** /**
* init_cube_objects * @name init_cube_objects
* *
* Instantiates Tesseract object's CubeRecoContext and TesseractCubeCombiner. * Instantiates Tesseract object's CubeRecoContext and TesseractCubeCombiner.
* Returns false if cube context could not be created or if load_combiner is * Returns false if cube context could not be created or if load_combiner is
* true, but the combiner could not be loaded. * true, but the combiner could not be loaded.
**********************************************************************/ */
bool Tesseract::init_cube_objects(bool load_combiner, bool Tesseract::init_cube_objects(bool load_combiner,
TessdataManager *tessdata_manager) { TessdataManager *tessdata_manager) {
ASSERT_HOST(cube_cntxt_ == NULL); ASSERT_HOST(cube_cntxt_ == NULL);
@ -184,12 +184,12 @@ bool Tesseract::init_cube_objects(bool load_combiner,
return true; return true;
} }
/********************************************************************** /**
* run_cube_combiner * @name run_cube_combiner
* *
* Iterates through tesseract's results and calls cube on each word, * Iterates through tesseract's results and calls cube on each word,
* combining the results with the existing tesseract result. * combining the results with the existing tesseract result.
**********************************************************************/ */
void Tesseract::run_cube_combiner(PAGE_RES *page_res) { void Tesseract::run_cube_combiner(PAGE_RES *page_res) {
if (page_res == NULL || tess_cube_combiner_ == NULL) if (page_res == NULL || tess_cube_combiner_ == NULL)
return; return;
@ -226,23 +226,23 @@ void Tesseract::run_cube_combiner(PAGE_RES *page_res) {
} }
} }
/********************************************************************** /**
* cube_word_pass1 * @name cube_word_pass1
* *
* Recognizes a single word using (only) cube. Compatible with * Recognizes a single word using (only) cube. Compatible with
* Tesseract's classify_word_pass1/classify_word_pass2. * Tesseract's classify_word_pass1/classify_word_pass2.
**********************************************************************/ */
void Tesseract::cube_word_pass1(BLOCK* block, ROW *row, WERD_RES *word) { void Tesseract::cube_word_pass1(BLOCK* block, ROW *row, WERD_RES *word) {
CubeObject *cube_obj = cube_recognize_word(block, word); CubeObject *cube_obj = cube_recognize_word(block, word);
delete cube_obj; delete cube_obj;
} }
/********************************************************************** /**
* cube_recognize_word * @name cube_recognize_word
* *
* Cube recognizer to recognize a single word as with classify_word_pass1 * Cube recognizer to recognize a single word as with classify_word_pass1
* but also returns the cube object in case the combiner is needed. * but also returns the cube object in case the combiner is needed.
**********************************************************************/ */
CubeObject* Tesseract::cube_recognize_word(BLOCK* block, WERD_RES* word) { CubeObject* Tesseract::cube_recognize_word(BLOCK* block, WERD_RES* word) {
if (!cube_binary_ || !cube_cntxt_) { if (!cube_binary_ || !cube_cntxt_) {
if (cube_debug_level > 0 && !cube_binary_) if (cube_debug_level > 0 && !cube_binary_)
@ -274,12 +274,12 @@ CubeObject* Tesseract::cube_recognize_word(BLOCK* block, WERD_RES* word) {
return cube_obj; return cube_obj;
} }
/********************************************************************** /**
* cube_combine_word * @name cube_combine_word
* *
* Combines the cube and tesseract results for a single word, leaving the * Combines the cube and tesseract results for a single word, leaving the
* result in tess_word. * result in tess_word.
**********************************************************************/ */
void Tesseract::cube_combine_word(CubeObject* cube_obj, WERD_RES* cube_word, void Tesseract::cube_combine_word(CubeObject* cube_obj, WERD_RES* cube_word,
WERD_RES* tess_word) { WERD_RES* tess_word) {
float combiner_prob = tess_cube_combiner_->CombineResults(tess_word, float combiner_prob = tess_cube_combiner_->CombineResults(tess_word,
@ -317,12 +317,12 @@ void Tesseract::cube_combine_word(CubeObject* cube_obj, WERD_RES* cube_word,
tess_word->ConsumeWordResults(cube_word); tess_word->ConsumeWordResults(cube_word);
} }
/********************************************************************** /**
* cube_recognize * @name cube_recognize
* *
* Call cube on the current word, and write the result to word. * Call cube on the current word, and write the result to word.
* Sets up a fake result and returns false if something goes wrong. * Sets up a fake result and returns false if something goes wrong.
**********************************************************************/ */
bool Tesseract::cube_recognize(CubeObject *cube_obj, BLOCK* block, bool Tesseract::cube_recognize(CubeObject *cube_obj, BLOCK* block,
WERD_RES *word) { WERD_RES *word) {
// Run cube // Run cube
@ -404,12 +404,12 @@ bool Tesseract::cube_recognize(CubeObject *cube_obj, BLOCK* block,
return true; return true;
} }
/********************************************************************** /**
* fill_werd_res * @name fill_werd_res
* *
* Fill Tesseract's word result fields with cube's. * Fill Tesseract's word result fields with cube's.
* *
**********************************************************************/ */
void Tesseract::fill_werd_res(const BoxWord& cube_box_word, void Tesseract::fill_werd_res(const BoxWord& cube_box_word,
const char* cube_best_str, const char* cube_best_str,
WERD_RES* tess_werd_res) { WERD_RES* tess_werd_res) {