| /****************************************************************************** |
| * |
| * File: blkocc.h (Formerly blockocc.h) |
| * Description: Block Occupancy routines |
| * Author: Chris Newton |
| * Created: Fri Nov 8 |
| * Modified: |
| * Language: C++ |
| * Package: N/A |
| * Status: Experimental (Do Not Distribute) |
| * |
| * (c) Copyright 1991, Hewlett-Packard Company. |
| ** 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 BLKOCC_H |
| #define BLKOCC_H |
| |
| #include "varable.h" |
| #include "polyblob.h" |
| #include "elst.h" |
| #include "notdll.h" |
| #include "notdll.h" |
| |
| /*************************************************************************** |
| CLASS REGION_OCC |
| |
| The class REGION_OCC defines a section of outline which exists entirely |
| within a single region. The only data held is the min and max x limits of |
| the outline within the region. |
| |
| REGION_OCCs are held on lists, one list for each region. The lists are |
| built in sorted order of min x. Overlapping REGION_OCCs are not permitted on |
| a single list. An overlapping region to be added causes the existing region |
| to be extended. This extension may result in the following REGION_OCC on the |
| list overlapping the ammended one. In this case the ammended REGION_OCC is |
| further extended to include the range of the following one, so that the |
| following one can be deleted. |
| |
| ****************************************************************************/ |
| |
| class REGION_OCC:public ELIST_LINK |
| { |
| public: |
| float min_x; //Lowest x in region |
| float max_x; //Highest x in region |
| inT16 region_type; //Type of crossing |
| |
| REGION_OCC() { |
| }; //constructor used |
| //only in COPIER etc |
| REGION_OCC( //constructor |
| float min, |
| float max, |
| inT16 region) { |
| min_x = min; |
| max_x = max; |
| region_type = region; |
| } |
| }; |
| |
| ELISTIZEH (REGION_OCC) |
| #define RANGE_IN_BAND( band_max, band_min, range_max, range_min ) \ |
| ( ((range_min) >= (band_min)) && ((range_max) < (band_max)) ) ? TRUE : FALSE |
| /************************************************************************ |
| Adapted from the following procedure so that it can be used in the bands |
| class in an include file... |
| |
| BOOL8 range_in_band[ |
| range within band? |
| inT16 band_max, |
| inT16 band_min, |
| inT16 range_max, |
| inT16 range_min] |
| { |
| if ( (range_min >= band_min) && (range_max < band_max) ) |
| return TRUE; |
| else |
| return FALSE; |
| } |
| ***********************************************************************/ |
| #define RANGE_OVERLAPS_BAND( band_max, band_min, range_max, range_min ) \ |
| ( ((range_max) >= (band_min)) && ((range_min) < (band_max)) ) ? TRUE : FALSE |
| /************************************************************************ |
| Adapted from the following procedure so that it can be used in the bands |
| class in an include file... |
| |
| BOOL8 range_overlaps_band[ |
| range crosses band? |
| inT16 band_max, |
| inT16 band_min, |
| inT16 range_max, |
| inT16 range_min] |
| { |
| if ( (range_max >= band_min) && (range_min < band_max) ) |
| return TRUE; |
| else |
| return FALSE; |
| } |
| ***********************************************************************/ |
| /********************************************************************** |
| Bands |
| ----- |
| |
| BAND 4 |
| -------------------------------- |
| BAND 3 |
| -------------------------------- |
| |
| BAND 2 |
| |
| -------------------------------- |
| |
| BAND 1 |
| |
| Band 0 is the dot band |
| |
| Each band has an error margin above and below. An outline is not considered to |
| have significantly changed bands until it has moved out of the error margin. |
| *************************************************************************/ |
| class BAND |
| { |
| public: |
| inT16 max_max; //upper max |
| inT16 max; //nominal max |
| inT16 min_max; //lower max |
| inT16 max_min; //upper min |
| inT16 min; //nominal min |
| inT16 min_min; //lower min |
| |
| BAND() { |
| } // constructor |
| |
| void set( // initialise a band |
| inT16 new_max_max, // upper max |
| inT16 new_max, // new nominal max |
| inT16 new_min_max, // new lower max |
| inT16 new_max_min, // new upper min |
| inT16 new_min, // new nominal min |
| inT16 new_min_min) { // new lower min |
| max_max = new_max_max; |
| max = new_max; |
| min_max = new_min_max; |
| max_min = new_max_min; |
| min = new_min; |
| min_min = new_min_min; |
| } |
| |
| BOOL8 in_minimal( //in minimal limits? |
| float y) { //y value |
| if ((y >= max_min) && (y < min_max)) |
| return TRUE; |
| else |
| return FALSE; |
| } |
| |
| BOOL8 in_nominal( //in nominal limits? |
| float y) { //y value |
| if ((y >= min) && (y < max)) |
| return TRUE; |
| else |
| return FALSE; |
| } |
| |
| BOOL8 in_maximal( //in maximal limits? |
| float y) { //y value |
| if ((y >= min_min) && (y < max_max)) |
| return TRUE; |
| else |
| return FALSE; |
| } |
| |
| //overlaps min limits? |
| BOOL8 range_overlaps_minimal(float y1, //one range limit |
| float y2) { //other range limit |
| if (y1 > y2) |
| return RANGE_OVERLAPS_BAND (min_max, max_min, y1, y2); |
| else |
| return RANGE_OVERLAPS_BAND (min_max, max_min, y2, y1); |
| } |
| |
| //overlaps nom limits? |
| BOOL8 range_overlaps_nominal(float y1, //one range limit |
| float y2) { //other range limit |
| if (y1 > y2) |
| return RANGE_OVERLAPS_BAND (max, min, y1, y2); |
| else |
| return RANGE_OVERLAPS_BAND (max, min, y2, y1); |
| } |
| |
| //overlaps max limits? |
| BOOL8 range_overlaps_maximal(float y1, //one range limit |
| float y2) { //other range limit |
| if (y1 > y2) |
| return RANGE_OVERLAPS_BAND (max_max, min_min, y1, y2); |
| else |
| return RANGE_OVERLAPS_BAND (max_max, min_min, y2, y1); |
| } |
| |
| BOOL8 range_in_minimal( //within min limits? |
| float y1, //one range limit |
| float y2) { //other range limit |
| if (y1 > y2) |
| return RANGE_IN_BAND (min_max, max_min, y1, y2); |
| else |
| return RANGE_IN_BAND (min_max, max_min, y2, y1); |
| } |
| |
| BOOL8 range_in_nominal( //within nom limits? |
| float y1, //one range limit |
| float y2) { //other range limit |
| if (y1 > y2) |
| return RANGE_IN_BAND (max, min, y1, y2); |
| else |
| return RANGE_IN_BAND (max, min, y2, y1); |
| } |
| |
| BOOL8 range_in_maximal( //within max limits? |
| float y1, //one range limit |
| float y2) { //other range limit |
| if (y1 > y2) |
| return RANGE_IN_BAND (max_max, min_min, y1, y2); |
| else |
| return RANGE_IN_BAND (max_max, min_min, y2, y1); |
| } |
| }; |
| |
| /* Standard positions */ |
| |
| #define MAX_NUM_BANDS 5 |
| #define UNDEFINED_BAND 99 |
| #define NO_LOWER_LIMIT -9999 |
| #define NO_UPPER_LIMIT 9999 |
| |
| #define DOT_BAND 0 |
| |
| /* Special occupancy code emitted for the 0 region at the end of a word */ |
| |
| #define END_OF_WERD_CODE 255 |
| |
| extern BOOL_VAR_H (blockocc_show_result, FALSE, "Show intermediate results"); |
| extern INT_VAR_H (blockocc_desc_height, 0, |
| "Descender height after normalisation"); |
| extern INT_VAR_H (blockocc_asc_height, 255, |
| "Ascender height after normalisation"); |
| extern INT_VAR_H (blockocc_band_count, 4, "Number of bands used"); |
| extern double_VAR_H (textord_underline_threshold, 0.9, |
| "Fraction of width occupied"); |
| BOOL8 test_underline( //look for underlines |
| BOOL8 testing_on, //drawing blob |
| PBLOB *blob, //blob to test |
| float baseline, //coords of baseline |
| float xheight //height of line |
| ); |
| BOOL8 test_underline( //look for underlines |
| BOOL8 testing_on, //drawing blob |
| C_BLOB *blob, //blob to test |
| inT16 baseline, //coords of baseline |
| inT16 xheight //height of line |
| ); |
| //project outlines |
| void horizontal_cblob_projection(C_BLOB *blob, //blob to project |
| STATS *stats //output |
| ); |
| void horizontal_coutline_projection( //project outlines |
| C_OUTLINE *outline, //outline to project |
| STATS *stats //output |
| ); |
| void set_bands( //init from varibles |
| float baseline, //top of bottom band |
| float xheight //height of split band |
| ); |
| void block_occ (PBLOB * blob, //blob to do |
| float occs[] //output histogram |
| ); |
| //blob to do |
| void find_transitions(PBLOB *blob, REGION_OCC_LIST *region_occ_list); |
| void record_region( //add region on list |
| inT16 band, |
| float new_min, |
| float new_max, |
| inT16 region_type, |
| REGION_OCC_LIST *region_occ_list); |
| inT16 find_containing_maximal_band( //find range's band |
| float y1, |
| float y2, |
| BOOL8 *doubly_contained); |
| void find_significant_line(POLYPT_IT it, inT16 *band); |
| inT16 find_overlapping_minimal_band( //find range's band |
| float y1, |
| float y2); |
| inT16 find_region_type(inT16 entry_band, |
| inT16 current_band, |
| inT16 exit_band, |
| float entry_x, |
| float exit_x); |
| void find_trans_point(POLYPT_IT *pt_it, |
| inT16 current_band, |
| inT16 next_band, |
| FCOORD *transition_pt); |
| void next_region(POLYPT_IT *start_pt_it, |
| inT16 start_band, |
| inT16 *to_band, |
| float *min_x, |
| float *max_x, |
| inT16 *increment, |
| FCOORD *exit_pt); |
| inT16 find_band( // find POINT's band |
| float y); |
| void compress_region_list( // join open regions |
| REGION_OCC_LIST *region_occ_list); |
| void find_fbox(OUTLINE_IT *out_it, |
| float *min_x, |
| float *min_y, |
| float *max_x, |
| float *max_y); |
| void maintain_limits(float *min_x, float *max_x, float x); |
| #endif |
