2007-03-08 04:03:40 +08:00
|
|
|
/**********************************************************************
|
|
|
|
* File: stepblob.h (Formerly cblob.h)
|
|
|
|
* Description: Code for C_BLOB class.
|
2018-07-01 00:28:24 +08:00
|
|
|
* Author: Ray Smith
|
|
|
|
* Created: Tue Oct 08 10:41:13 BST 1991
|
2007-03-08 04:03:40 +08:00
|
|
|
*
|
|
|
|
* (C) Copyright 1991, 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.
|
|
|
|
*
|
|
|
|
**********************************************************************/
|
|
|
|
|
2018-07-01 00:28:24 +08:00
|
|
|
#ifndef STEPBLOB_H
|
|
|
|
#define STEPBLOB_H
|
2007-03-08 04:03:40 +08:00
|
|
|
|
2018-07-07 18:00:25 +08:00
|
|
|
#include "coutln.h" // for C_OUTLINE_LIST, C_OUTLINE
|
|
|
|
#include "elst.h" // for ELIST_ITERATOR, ELISTIZEH, ELIST_LINK
|
|
|
|
#include "points.h" // for FCOORD, ICOORD (ptr only)
|
|
|
|
#include "rect.h" // for TBOX
|
|
|
|
#include "scrollview.h" // for ScrollView, ScrollView::Color
|
2007-03-08 04:03:40 +08:00
|
|
|
|
2020-12-26 05:55:30 +08:00
|
|
|
#include <cstdint> // for int32_t, int16_t
|
2018-07-07 18:00:25 +08:00
|
|
|
|
2010-11-24 02:34:14 +08:00
|
|
|
struct Pix;
|
2018-07-07 18:00:25 +08:00
|
|
|
|
2020-12-26 05:55:30 +08:00
|
|
|
namespace tesseract {
|
|
|
|
|
|
|
|
class C_BLOB;
|
|
|
|
class DENORM;
|
|
|
|
|
2013-09-23 23:21:37 +08:00
|
|
|
ELISTIZEH(C_BLOB)
|
2010-11-24 02:34:14 +08:00
|
|
|
|
2020-12-31 21:31:10 +08:00
|
|
|
class TESS_API C_BLOB : public ELIST_LINK
|
2007-03-08 04:03:40 +08:00
|
|
|
{
|
|
|
|
public:
|
2018-05-21 07:36:56 +08:00
|
|
|
C_BLOB() = default;
|
2009-07-11 10:14:57 +08:00
|
|
|
explicit C_BLOB(C_OUTLINE_LIST *outline_list);
|
2010-11-24 02:34:14 +08:00
|
|
|
// Simpler constructor to build a blob from a single outline that has
|
|
|
|
// already been fully initialized.
|
|
|
|
explicit C_BLOB(C_OUTLINE* outline);
|
2009-07-11 10:14:57 +08:00
|
|
|
|
2013-09-23 23:21:37 +08:00
|
|
|
// Builds a set of one or more blobs from a list of outlines.
|
|
|
|
// Input: one outline on outline_list contains all the others, but the
|
|
|
|
// nesting and order are undefined.
|
|
|
|
// If good_blob is true, the blob is added to good_blobs_it, unless
|
|
|
|
// an illegal (generation-skipping) parent-child relationship is found.
|
|
|
|
// If so, the parent blob goes to bad_blobs_it, and the immediate children
|
|
|
|
// are promoted to the top level, recursively being sent to good_blobs_it.
|
|
|
|
// If good_blob is false, all created blobs will go to the bad_blobs_it.
|
|
|
|
// Output: outline_list is empty. One or more blobs are added to
|
|
|
|
// good_blobs_it and/or bad_blobs_it.
|
|
|
|
static void ConstructBlobsFromOutlines(bool good_blob,
|
|
|
|
C_OUTLINE_LIST* outline_list,
|
|
|
|
C_BLOB_IT* good_blobs_it,
|
|
|
|
C_BLOB_IT* bad_blobs_it);
|
|
|
|
|
|
|
|
// Sets the COUT_INVERSE flag appropriately on the outlines and their
|
|
|
|
// children recursively, reversing the outlines if needed so that
|
|
|
|
// everything has an anticlockwise top-level.
|
|
|
|
void CheckInverseFlagAndDirection();
|
|
|
|
|
2009-07-11 10:14:57 +08:00
|
|
|
// Build and return a fake blob containing a single fake outline with no
|
|
|
|
// steps.
|
|
|
|
static C_BLOB* FakeBlob(const TBOX& box);
|
2007-03-08 04:03:40 +08:00
|
|
|
|
|
|
|
C_OUTLINE_LIST *out_list() { //get outline list
|
|
|
|
return &outlines;
|
|
|
|
}
|
|
|
|
|
2014-08-12 07:23:06 +08:00
|
|
|
TBOX bounding_box() const; // compute bounding box
|
Use POSIX data types and macros (#878)
* api: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccmain: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccstruct: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* classify: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* cutil: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* dict: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* textord: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* training: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* wordrec: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccutil: Replace Tesseract data types by POSIX data types
Now all Tesseract data types which are no longer needed can be removed
from ccutil/host.h.
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccmain: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccstruct: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* classify: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* dict: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* lstm: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* textord: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* wordrec: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccutil: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Remove the macros which are now unused from ccutil/host.h.
Remove also the obsolete history comments.
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* Fix build error caused by ambiguous ClipToRange
Error message vom Appveyor CI:
C:\projects\tesseract\ccstruct\coutln.cpp(818): error C2672: 'ClipToRange': no matching overloaded function found [C:\projects\tesseract\build\libtesseract.vcxproj]
C:\projects\tesseract\ccstruct\coutln.cpp(818): error C2782: 'T ClipToRange(const T &,const T &,const T &)': template parameter 'T' is ambiguous [C:\projects\tesseract\build\libtesseract.vcxproj]
c:\projects\tesseract\ccutil\helpers.h(122): note: see declaration of 'ClipToRange'
C:\projects\tesseract\ccstruct\coutln.cpp(818): note: could be 'char'
C:\projects\tesseract\ccstruct\coutln.cpp(818): note: or 'int'
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* unittest: Replace Tesseract's MAX_INT8 by POSIX INT8_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* arch: Replace Tesseract's MAX_INT8 by POSIX INT8_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
2018-03-14 04:36:30 +08:00
|
|
|
int32_t area(); //compute area
|
|
|
|
int32_t perimeter(); // Total perimeter of outlines and 1st level children.
|
|
|
|
int32_t outer_area(); //compute area
|
|
|
|
int32_t count_transitions( //count maxima
|
|
|
|
int32_t threshold); //size threshold
|
2007-03-08 04:03:40 +08:00
|
|
|
|
2009-07-11 10:14:57 +08:00
|
|
|
void move(const ICOORD vec); // repostion blob by vector
|
|
|
|
void rotate(const FCOORD& rotation); // Rotate by given vector.
|
2007-03-08 04:03:40 +08:00
|
|
|
|
2013-09-23 23:21:37 +08:00
|
|
|
// Adds sub-pixel resolution EdgeOffsets for the outlines using greyscale
|
2016-12-13 00:20:05 +08:00
|
|
|
// if the supplied pix is 8-bit or the binary edges if nullptr.
|
2013-09-23 23:21:37 +08:00
|
|
|
void ComputeEdgeOffsets(int threshold, Pix* pix);
|
|
|
|
|
|
|
|
// Estimates and returns the baseline position based on the shape of the
|
|
|
|
// outlines.
|
Use POSIX data types and macros (#878)
* api: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccmain: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccstruct: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* classify: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* cutil: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* dict: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* textord: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* training: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* wordrec: Replace Tesseract data types by POSIX data types
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccutil: Replace Tesseract data types by POSIX data types
Now all Tesseract data types which are no longer needed can be removed
from ccutil/host.h.
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccmain: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccstruct: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* classify: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* dict: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* lstm: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* textord: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* wordrec: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* ccutil: Replace Tesseract's MIN_*INT, MAX_*INT* by POSIX *INT*_MIN, *INT*_MAX
Remove the macros which are now unused from ccutil/host.h.
Remove also the obsolete history comments.
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* Fix build error caused by ambiguous ClipToRange
Error message vom Appveyor CI:
C:\projects\tesseract\ccstruct\coutln.cpp(818): error C2672: 'ClipToRange': no matching overloaded function found [C:\projects\tesseract\build\libtesseract.vcxproj]
C:\projects\tesseract\ccstruct\coutln.cpp(818): error C2782: 'T ClipToRange(const T &,const T &,const T &)': template parameter 'T' is ambiguous [C:\projects\tesseract\build\libtesseract.vcxproj]
c:\projects\tesseract\ccutil\helpers.h(122): note: see declaration of 'ClipToRange'
C:\projects\tesseract\ccstruct\coutln.cpp(818): note: could be 'char'
C:\projects\tesseract\ccstruct\coutln.cpp(818): note: or 'int'
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* unittest: Replace Tesseract's MAX_INT8 by POSIX INT8_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
* arch: Replace Tesseract's MAX_INT8 by POSIX INT8_MAX
Signed-off-by: Stefan Weil <sw@weilnetz.de>
2018-03-14 04:36:30 +08:00
|
|
|
int16_t EstimateBaselinePosition();
|
2013-09-23 23:21:37 +08:00
|
|
|
|
2010-11-24 02:34:14 +08:00
|
|
|
// Returns a Pix rendering of the blob. pixDestroy after use.
|
|
|
|
Pix* render();
|
2012-02-02 11:06:39 +08:00
|
|
|
// Returns a Pix rendering of the outline of the blob. (no fill).
|
|
|
|
// pixDestroy after use.
|
|
|
|
Pix* render_outline();
|
2010-11-24 02:34:14 +08:00
|
|
|
|
2012-09-22 08:59:31 +08:00
|
|
|
#ifndef GRAPHICS_DISABLED
|
2007-03-08 04:03:40 +08:00
|
|
|
void plot( //draw one
|
2008-02-01 08:36:18 +08:00
|
|
|
ScrollView* window, //window to draw in
|
|
|
|
ScrollView::Color blob_colour, //for outer bits
|
|
|
|
ScrollView::Color child_colour); //for holes
|
2013-09-23 23:21:37 +08:00
|
|
|
// Draws the blob in the given colour, and child_colour, normalized
|
|
|
|
// using the given denorm, making use of sub-pixel accurate information
|
|
|
|
// if available.
|
|
|
|
void plot_normed(const DENORM& denorm,
|
|
|
|
ScrollView::Color blob_colour,
|
|
|
|
ScrollView::Color child_colour,
|
|
|
|
ScrollView* window);
|
2020-07-09 03:51:57 +08:00
|
|
|
#endif // !GRAPHICS_DISABLED
|
2007-03-08 04:03:40 +08:00
|
|
|
|
2008-12-31 02:15:44 +08:00
|
|
|
C_BLOB& operator= (const C_BLOB & source) {
|
|
|
|
if (!outlines.empty ())
|
|
|
|
outlines.clear();
|
|
|
|
outlines.deep_copy(&source.outlines, &C_OUTLINE::deep_copy);
|
2007-03-08 04:03:40 +08:00
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
2008-12-31 02:15:44 +08:00
|
|
|
static C_BLOB* deep_copy(const C_BLOB* src) {
|
2019-03-26 14:55:08 +08:00
|
|
|
auto* blob = new C_BLOB;
|
2008-12-31 02:15:44 +08:00
|
|
|
*blob = *src;
|
|
|
|
return blob;
|
|
|
|
}
|
|
|
|
|
2014-08-12 07:23:06 +08:00
|
|
|
static int SortByXMiddle(const void *v1, const void *v2) {
|
2017-07-15 00:30:14 +08:00
|
|
|
const C_BLOB* blob1 = *static_cast<const C_BLOB* const*>(v1);
|
|
|
|
const C_BLOB* blob2 = *static_cast<const C_BLOB* const*>(v2);
|
2014-08-12 07:23:06 +08:00
|
|
|
return blob1->bounding_box().x_middle() -
|
|
|
|
blob2->bounding_box().x_middle();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2007-03-08 04:03:40 +08:00
|
|
|
private:
|
|
|
|
C_OUTLINE_LIST outlines; //master elements
|
|
|
|
};
|
|
|
|
|
2020-12-26 05:55:30 +08:00
|
|
|
} // namespace tesseract
|
|
|
|
|
2007-03-08 04:03:40 +08:00
|
|
|
#endif
|