tesseract_bin 1.0.0

data/vendor/tesseract-2.04/textord/topitch.h

@@ -0,0 +1,195 @@
+/**********************************************************************
+ * File:        topitch.h  (Formerly to_pitch.h)
+ * Description: Code to determine fixed pitchness and the pitch if fixed.
+ * Author:		Ray Smith
+ * Created:		Tue Aug 24 16:57:29 BST 1993
+ *
+ * (C) Copyright 1993, Hewlett-Packard Ltd.
+ ** Licensed under the Apache License, Version 2.0 (the "License");
+ ** you may not use this file except in compliance with the License.
+ ** You may obtain a copy of the License at
+ ** http://www.apache.org/licenses/LICENSE-2.0
+ ** Unless required by applicable law or agreed to in writing, software
+ ** distributed under the License is distributed on an "AS IS" BASIS,
+ ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ** See the License for the specific language governing permissions and
+ ** limitations under the License.
+ *
+ **********************************************************************/
+
+#ifndef           TOPITCH_H
+#define           TOPITCH_H
+
+#include          "blobbox.h"
+#include          "notdll.h"
+
+extern BOOL_VAR_H (textord_debug_pitch_test, FALSE,
+"Debug on fixed pitch test");
+extern BOOL_VAR_H (textord_debug_pitch_metric, FALSE,
+"Write full metric stuff");
+extern BOOL_VAR_H (textord_show_row_cuts, FALSE, "Draw row-level cuts");
+extern BOOL_VAR_H (textord_show_page_cuts, FALSE, "Draw page-level cuts");
+extern BOOL_VAR_H (textord_pitch_cheat, FALSE,
+"Use correct answer for fixed/prop");
+extern BOOL_VAR_H (textord_blockndoc_fixed, TRUE,
+"Attempt whole doc/block fixed pitch");
+extern BOOL_VAR_H (textord_fast_pitch_test, FALSE,
+"Do even faster pitch algorithm");
+extern double_VAR_H (textord_projection_scale, 0.125,
+"Ding rate for mid-cuts");
+extern double_VAR_H (textord_balance_factor, 2.0,
+"Ding rate for unbalanced char cells");
+extern double_VAR_H (textord_repch_width_variance, 0.2,
+"Max width change of gap/blob");
+void compute_fixed_pitch(                             //determine pitch
+                         ICOORD page_tr,              //top right
+                         TO_BLOCK_LIST *port_blocks,  //input list
+                         float gradient,              //page skew
+                         FCOORD rotation,             //for drawing
+                         BOOL8 testing_on             //correct orientation
+                        );
+void fix_row_pitch(                        //get some value
+                   TO_ROW *bad_row,        //row to fix
+                   TO_BLOCK *bad_block,    //block of bad_row
+                   TO_BLOCK_LIST *blocks,  //blocks to scan
+                   inT32 row_target,       //number of row
+                   inT32 block_target      //number of block
+                  );
+void compute_block_pitch(                    //process each block
+                         TO_BLOCK *block,    //input list
+                         FCOORD rotation,    //for drawing
+                         inT32 block_index,  //block number
+                         BOOL8 testing_on    //correct orientation
+                        );
+BOOL8 compute_rows_pitch(                    //find line stats
+                         TO_BLOCK *block,    //block to do
+                         inT32 block_index,  //block number
+                         BOOL8 testing_on    //correct orientation
+                        );
+BOOL8 try_doc_fixed(                             //determine pitch
+                    ICOORD page_tr,              //top right
+                    TO_BLOCK_LIST *port_blocks,  //input list
+                    float gradient               //page skew
+                   );
+BOOL8 try_block_fixed(                   //find line stats
+                      TO_BLOCK *block,   //block to do
+                      inT32 block_index  //block number
+                     );
+BOOL8 try_rows_fixed(                    //find line stats
+                     TO_BLOCK *block,    //block to do
+                     inT32 block_index,  //block number
+                     BOOL8 testing_on    //correct orientation
+                    );
+void print_block_counts(                   //find line stats
+                        TO_BLOCK *block,   //block to do
+                        inT32 block_index  //block number
+                       );
+void count_block_votes(                   //find line stats
+                       TO_BLOCK *block,   //block to do
+                       inT32 &def_fixed,  //add to counts
+                       inT32 &def_prop,
+                       inT32 &maybe_fixed,
+                       inT32 &maybe_prop,
+                       inT32 &corr_fixed,
+                       inT32 &corr_prop,
+                       inT32 &dunno);
+BOOL8 row_pitch_stats(                  //find line stats
+                      TO_ROW *row,      //current row
+                      inT32 maxwidth,   //of spaces
+                      BOOL8 testing_on  //correct orientation
+                     );
+BOOL8 find_row_pitch(                    //find lines
+                     TO_ROW *row,        //row to do
+                     inT32 maxwidth,     //max permitted space
+                     inT32 dm_gap,       //ignorable gaps
+                     TO_BLOCK *block,    //block of row
+                     inT32 block_index,  //block_number
+                     inT32 row_index,    //number of row
+                     BOOL8 testing_on    //correct orientation
+                    );
+BOOL8 fixed_pitch_row(                   //find lines
+                      TO_ROW *row,       //row to do
+                      inT32 block_index  //block_number
+                     );
+BOOL8 count_pitch_stats(                       //find lines
+                        TO_ROW *row,           //row to do
+                        STATS *gap_stats,      //blob gaps
+                        STATS *pitch_stats,    //centre-centre stats
+                        float initial_pitch,   //guess at pitch
+                        float min_space,       //estimate space size
+                        BOOL8 ignore_outsize,  //discard big objects
+                        BOOL8 split_outsize,   //split big objects
+                        inT32 dm_gap           //ignorable gaps
+                       );
+float tune_row_pitch(                             //find fp cells
+                     TO_ROW *row,                 //row to do
+                     STATS *projection,           //vertical projection
+                     inT16 projection_left,       //edge of projection
+                     inT16 projection_right,      //edge of projection
+                     float space_size,            //size of blank
+                     float &initial_pitch,        //guess at pitch
+                     float &best_sp_sd,           //space sd
+                     inT16 &best_mid_cuts,        //no of cheap cuts
+                     ICOORDELT_LIST *best_cells,  //row cells
+                     BOOL8 testing_on             //inidividual words
+                    );
+float tune_row_pitch2(                             //find fp cells
+                      TO_ROW *row,                 //row to do
+                      STATS *projection,           //vertical projection
+                      inT16 projection_left,       //edge of projection
+                      inT16 projection_right,      //edge of projection
+                      float space_size,            //size of blank
+                      float &initial_pitch,        //guess at pitch
+                      float &best_sp_sd,           //space sd
+                      inT16 &best_mid_cuts,        //no of cheap cuts
+                      ICOORDELT_LIST *best_cells,  //row cells
+                      BOOL8 testing_on             //inidividual words
+                     );
+float compute_pitch_sd (         //find fp cells
+TO_ROW * row,                    //row to do
+STATS * projection,              //vertical projection
+inT16 projection_left,           //edge
+inT16 projection_right,          //edge
+float space_size,                //size of blank
+float initial_pitch,             //guess at pitch
+float &sp_sd,                    //space sd
+inT16 & mid_cuts,                //no of free cuts
+ICOORDELT_LIST * row_cells,      //list of chop pts
+BOOL8 testing_on,                //inidividual words
+inT16 start = 0,                 //start of good range
+inT16 end = 0                    //end of good range
+);
+float compute_pitch_sd2 (        //find fp cells
+TO_ROW * row,                    //row to do
+STATS * projection,              //vertical projection
+inT16 projection_left,           //edge
+inT16 projection_right,          //edge
+float initial_pitch,             //guess at pitch
+inT16 & occupation,              //no of occupied cells
+inT16 & mid_cuts,                //no of free cuts
+ICOORDELT_LIST * row_cells,      //list of chop pts
+BOOL8 testing_on,                //inidividual words
+inT16 start = 0,                 //start of good range
+inT16 end = 0                    //end of good range
+);
+void print_pitch_sd(                        //find fp cells
+                    TO_ROW *row,            //row to do
+                    STATS *projection,      //vertical projection
+                    inT16 projection_left,  //edges //size of blank
+                    inT16 projection_right,
+                    float space_size,
+                    float initial_pitch     //guess at pitch
+                   );
+int sort_floats2(                   //qsort function
+                 const void *arg1,  //ptrs to floats
+                 const void *arg2);
+void find_repeated_chars(                  //search for equal chars
+                         TO_BLOCK *block,  //block to search
+                         BOOL8 testing_on  //dbug mode
+                        );
+void plot_fp_word(                  //draw block of words
+                  TO_BLOCK *block,  //block to draw
+                  float pitch,      //pitch to draw with
+                  float nonspace    //for space threshold
+                 );
+#endif