tesseract::DENORM Class Reference

#include <normalis.h>

Public Member Functions
	DENORM ()
	DENORM (const DENORM &)
DENORM &	operator= (const DENORM &)
	~DENORM ()
void	SetupNormalization (const BLOCK *block, const FCOORD *rotation, const DENORM *predecessor, float x_origin, float y_origin, float x_scale, float y_scale, float final_xshift, float final_yshift)
void	SetupNonLinear (const DENORM *predecessor, const TBOX &box, float target_width, float target_height, float final_xshift, float final_yshift, const std::vector< std::vector< int > > &x_coords, const std::vector< std::vector< int > > &y_coords)
void	LocalNormTransform (const TPOINT &pt, TPOINT *transformed) const
void	LocalNormTransform (const FCOORD &pt, FCOORD *transformed) const
void	NormTransform (const DENORM *first_norm, const TPOINT &pt, TPOINT *transformed) const
void	NormTransform (const DENORM *first_norm, const FCOORD &pt, FCOORD *transformed) const
void	LocalDenormTransform (const TPOINT &pt, TPOINT *original) const
void	LocalDenormTransform (const FCOORD &pt, FCOORD *original) const
void	DenormTransform (const DENORM *last_denorm, const TPOINT &pt, TPOINT *original) const
void	DenormTransform (const DENORM *last_denorm, const FCOORD &pt, FCOORD *original) const
void	LocalNormBlob (TBLOB *blob) const
void	XHeightRange (int unichar_id, const UNICHARSET &unicharset, const TBOX &bbox, float *min_xht, float *max_xht, float *yshift) const
void	Print () const
Image	pix () const
void	set_pix (Image pix)
bool	inverse () const
void	set_inverse (bool value)
const DENORM *	RootDenorm () const
const DENORM *	predecessor () const
float	x_scale () const
float	y_scale () const
const BLOCK *	block () const
void	set_block (const BLOCK *block)

Detailed Description

Definition at line 52 of file normalis.h.

Constructor & Destructor Documentation

DENORM() [1/2]

tesseract::DENORM::DENORM

(

)

Definition at line 39 of file normalis.cpp.

               {
  Init();
}

DENORM() [2/2]

tesseract::DENORM::DENORM

(

const DENORM &

src

)

Definition at line 43 of file normalis.cpp.

                                {
  rotation_ = nullptr;
  x_map_ = nullptr;
  y_map_ = nullptr;
  *this = src;
}

~DENORM()

tesseract::DENORM::~DENORM

(

)

Definition at line 70 of file normalis.cpp.

                {
  Clear();
}

Member Function Documentation

block()

const BLOCK * tesseract::DENORM::block ( ) const

inline

Definition at line 265 of file normalis.h.

                             {
    return block_;
  }

DenormTransform() [1/2]

void tesseract::DENORM::DenormTransform	(	const DENORM *	last_denorm,
		const FCOORD &	pt,
		FCOORD *	original
	)		const

Definition at line 408 of file normalis.cpp.

                                                                                                {
  LocalDenormTransform(pt, original);
  if (last_denorm != this) {
    if (predecessor_ != nullptr) {
      predecessor_->DenormTransform(last_denorm, *original, original);
    } else if (block_ != nullptr) {
      original->rotate(block_->re_rotation());
    }
  }
}

DenormTransform() [2/2]

void tesseract::DENORM::DenormTransform	(	const DENORM *	last_denorm,
		const TPOINT &	pt,
		TPOINT *	original
	)		const

Definition at line 401 of file normalis.cpp.

                                                                                                {
  FCOORD src_pt(pt.x, pt.y);
  FCOORD float_result;
  DenormTransform(last_denorm, src_pt, &float_result);
  original->x = IntCastRounded(float_result.x());
  original->y = IntCastRounded(float_result.y());
}

inverse()

bool tesseract::DENORM::inverse ( ) const

inline

Definition at line 243 of file normalis.h.

                       {
    return inverse_;
  }

LocalDenormTransform() [1/2]

void tesseract::DENORM::LocalDenormTransform	(	const FCOORD &	pt,
		FCOORD *	original
	)		const

Definition at line 370 of file normalis.cpp.

                                                                          {
  FCOORD rotated(pt.x() - final_xshift_, pt.y() - final_yshift_);
  if (x_map_ != nullptr && y_map_ != nullptr) {
    auto pos = std::upper_bound(x_map_->begin(), x_map_->end(), rotated.x());
    if (pos > x_map_->begin()) {
      --pos;
    }
    auto x = pos - x_map_->begin();
    original->set_x(x + x_origin_);
    pos = std::upper_bound(y_map_->begin(), y_map_->end(), rotated.y());
    if (pos > y_map_->begin()) {
      --pos;
    }
    auto y = pos - y_map_->begin();
    original->set_y(y + y_origin_);
  } else {
    if (rotation_ != nullptr) {
      FCOORD inverse_rotation(rotation_->x(), -rotation_->y());
      rotated.rotate(inverse_rotation);
    }
    original->set_x(rotated.x() / x_scale_ + x_origin_);
    float y_scale = y_scale_;
    original->set_y(rotated.y() / y_scale + y_origin_);
  }
}

LocalDenormTransform() [2/2]

void tesseract::DENORM::LocalDenormTransform	(	const TPOINT &	pt,
		TPOINT *	original
	)		const

Definition at line 362 of file normalis.cpp.

                                                                          {
  FCOORD src_pt(pt.x, pt.y);
  FCOORD float_result;
  LocalDenormTransform(src_pt, &float_result);
  original->x = IntCastRounded(float_result.x());
  original->y = IntCastRounded(float_result.y());
}

LocalNormBlob()

void tesseract::DENORM::LocalNormBlob

(

TBLOB *

blob

)

const

Definition at line 421 of file normalis.cpp.

                                            {
  ICOORD translation(-IntCastRounded(x_origin_), -IntCastRounded(y_origin_));
  blob->Move(translation);
  if (y_scale_ != 1.0f) {
    blob->Scale(y_scale_);
  }
  if (rotation_ != nullptr) {
    blob->Rotate(*rotation_);
  }
  translation.set_x(IntCastRounded(final_xshift_));
  translation.set_y(IntCastRounded(final_yshift_));
  blob->Move(translation);
}

LocalNormTransform() [1/2]

void tesseract::DENORM::LocalNormTransform	(	const FCOORD &	pt,
		FCOORD *	transformed
	)		const

Definition at line 317 of file normalis.cpp.

                                                                           {
  FCOORD translated(pt.x() - x_origin_, pt.y() - y_origin_);
  if (x_map_ != nullptr && y_map_ != nullptr) {
    int x = ClipToRange(IntCastRounded(translated.x()), 0, static_cast<int>(x_map_->size() - 1));
    translated.set_x((*x_map_)[x]);
    int y = ClipToRange(IntCastRounded(translated.y()), 0, static_cast<int>(y_map_->size() - 1));
    translated.set_y((*y_map_)[y]);
  } else {
    translated.set_x(translated.x() * x_scale_);
    translated.set_y(translated.y() * y_scale_);
    if (rotation_ != nullptr) {
      translated.rotate(*rotation_);
    }
  }
  transformed->set_x(translated.x() + final_xshift_);
  transformed->set_y(translated.y() + final_yshift_);
}

LocalNormTransform() [2/2]

void tesseract::DENORM::LocalNormTransform	(	const TPOINT &	pt,
		TPOINT *	transformed
	)		const

Definition at line 310 of file normalis.cpp.

                                                                           {
  FCOORD src_pt(pt.x, pt.y);
  FCOORD float_result;
  LocalNormTransform(src_pt, &float_result);
  transformed->x = IntCastRounded(float_result.x());
  transformed->y = IntCastRounded(float_result.y());
}

NormTransform() [1/2]

void tesseract::DENORM::NormTransform	(	const DENORM *	first_norm,
		const FCOORD &	pt,
		FCOORD *	transformed
	)		const

Definition at line 347 of file normalis.cpp.

                                                                                                {
  FCOORD src_pt(pt);
  if (first_norm != this) {
    if (predecessor_ != nullptr) {
      predecessor_->NormTransform(first_norm, pt, &src_pt);
    } else if (block_ != nullptr) {
      FCOORD fwd_rotation(block_->re_rotation().x(), -block_->re_rotation().y());
      src_pt.rotate(fwd_rotation);
    }
  }
  LocalNormTransform(src_pt, transformed);
}

NormTransform() [2/2]

void tesseract::DENORM::NormTransform	(	const DENORM *	first_norm,
		const TPOINT &	pt,
		TPOINT *	transformed
	)		const

Definition at line 340 of file normalis.cpp.

                                                                                                {
  FCOORD src_pt(pt.x, pt.y);
  FCOORD float_result;
  NormTransform(first_norm, src_pt, &float_result);
  transformed->x = IntCastRounded(float_result.x());
  transformed->y = IntCastRounded(float_result.y());
}

operator=()

DENORM & tesseract::DENORM::operator=

(

const DENORM &

src

)

Definition at line 50 of file normalis.cpp.

                                           {
  Clear();
  inverse_ = src.inverse_;
  predecessor_ = src.predecessor_;
  pix_ = src.pix_;
  block_ = src.block_;
  if (src.rotation_ == nullptr) {
    rotation_ = nullptr;
  } else {
    rotation_ = new FCOORD(*src.rotation_);
  }
  x_origin_ = src.x_origin_;
  y_origin_ = src.y_origin_;
  x_scale_ = src.x_scale_;
  y_scale_ = src.y_scale_;
  final_xshift_ = src.final_xshift_;
  final_yshift_ = src.final_yshift_;
  return *this;
}

pix()

Image tesseract::DENORM::pix ( ) const

inline

Definition at line 237 of file normalis.h.

                    {
    return pix_;
  }

predecessor()

const DENORM * tesseract::DENORM::predecessor ( ) const

inline

Definition at line 255 of file normalis.h.

                                    {
    return predecessor_;
  }

Print()

void tesseract::DENORM::Print

(

)

const

Definition at line 515 of file normalis.cpp.

                         {
  if (pix_ != nullptr) {
    tprintf("Pix dimensions %d x %d x %d\n", pixGetWidth(pix_), pixGetHeight(pix_),
            pixGetDepth(pix_));
  }
  if (inverse_) {
    tprintf("Inverse\n");
  }
  if (block_ && block_->re_rotation().x() != 1.0f) {
    tprintf("Block rotation %g, %g\n", block_->re_rotation().x(), block_->re_rotation().y());
  }
  tprintf("Input Origin = (%g, %g)\n", x_origin_, y_origin_);
  if (x_map_ != nullptr && y_map_ != nullptr) {
    tprintf("x map:\n");
    for (auto x : *x_map_) {
      tprintf("%g ", x);
    }
    tprintf("\ny map:\n");
    for (auto y : *y_map_) {
      tprintf("%g ", y);
    }
    tprintf("\n");
  } else {
    tprintf("Scale = (%g, %g)\n", x_scale_, y_scale_);
    if (rotation_ != nullptr) {
      tprintf("Rotation = (%g, %g)\n", rotation_->x(), rotation_->y());
    }
  }
  tprintf("Final Origin = (%g, %g)\n", final_xshift_, final_xshift_);
  if (predecessor_ != nullptr) {
    tprintf("Predecessor:\n");
    predecessor_->Print();
  }
}

RootDenorm()

const DENORM * tesseract::DENORM::RootDenorm ( ) const

inline

Definition at line 249 of file normalis.h.

                                   {
    if (predecessor_ != nullptr) {
      return predecessor_->RootDenorm();
    }
    return this;
  }

set_block()

void tesseract::DENORM::set_block ( const BLOCK *  block )

inline

Definition at line 268 of file normalis.h.

                                     {
    block_ = block;
  }

set_inverse()

void tesseract::DENORM::set_inverse ( bool  value )

inline

Definition at line 246 of file normalis.h.

                               {
    inverse_ = value;
  }

set_pix()

void tesseract::DENORM::set_pix ( Image  pix )

inline

Definition at line 240 of file normalis.h.

                          {
    pix_ = pix;
  }

SetupNonLinear()

void tesseract::DENORM::SetupNonLinear	(	const DENORM *	predecessor,
		const TBOX &	box,
		float	target_width,
		float	target_height,
		float	final_xshift,
		float	final_yshift,
		const std::vector< std::vector< int > > &	x_coords,
		const std::vector< std::vector< int > > &	y_coords
	)

Definition at line 273 of file normalis.cpp.

                                                                       {
  Clear();
  predecessor_ = predecessor;
  // x_map_ and y_map_ store a mapping from input x and y coordinate to output
  // x and y coordinate, based on scaling to the supplied target_width and
  // target_height.
  x_map_ = new std::vector<float>;
  y_map_ = new std::vector<float>;
  // Set a 2-d image array to the run lengths at each pixel.
  int width = box.width();
  int height = box.height();
  GENERIC_2D_ARRAY<int> minruns(width, height, 0);
  ComputeRunlengthImage(box, x_coords, y_coords, &minruns);
  // Edge density is the sum of the inverses of the run lengths. Compute
  // edge density projection profiles.
  ComputeEdgeDensityProfiles(box, minruns, *x_map_, *y_map_);
  // Convert the edge density profiles to the coordinates by multiplying by
  // the desired size and accumulating.
  (*x_map_)[width] = target_width;
  for (int x = width - 1; x >= 0; --x) {
    (*x_map_)[x] = (*x_map_)[x + 1] - (*x_map_)[x] * target_width;
  }
  (*y_map_)[height] = target_height;
  for (int y = height - 1; y >= 0; --y) {
    (*y_map_)[y] = (*y_map_)[y + 1] - (*y_map_)[y] * target_height;
  }
  x_origin_ = box.left();
  y_origin_ = box.bottom();
  final_xshift_ = final_xshift;
  final_yshift_ = final_yshift;
}

SetupNormalization()

void tesseract::DENORM::SetupNormalization	(	const BLOCK *	block,
		const FCOORD *	rotation,
		const DENORM *	predecessor,
		float	x_origin,
		float	y_origin,
		float	x_scale,
		float	y_scale,
		float	final_xshift,
		float	final_yshift
	)

Definition at line 99 of file normalis.cpp.

                                                    {
  Clear();
  block_ = block;
  if (rotation == nullptr) {
    rotation_ = nullptr;
  } else {
    rotation_ = new FCOORD(*rotation);
  }
  predecessor_ = predecessor;
  x_origin_ = x_origin;
  y_origin_ = y_origin;
  x_scale_ = x_scale;
  y_scale_ = y_scale;
  final_xshift_ = final_xshift;
  final_yshift_ = final_yshift;
}

x_scale()

float tesseract::DENORM::x_scale ( ) const

inline

Definition at line 259 of file normalis.h.

                        {
    return x_scale_;
  }

XHeightRange()

void tesseract::DENORM::XHeightRange	(	int	unichar_id,
		const UNICHARSET &	unicharset,
		const TBOX &	bbox,
		float *	min_xht,
		float *	max_xht,
		float *	yshift
	)		const

Definition at line 439 of file normalis.cpp.

                                                                               {
  // Default return -- accept anything.
  *yshift = 0.0f;
  *min_xht = 0.0f;
  *max_xht = FLT_MAX;
 
  if (!unicharset.top_bottom_useful()) {
    return;
  }
 
  // Clip the top and bottom to the limit of normalized feature space.
  int top = ClipToRange<int>(bbox.top(), 0, kBlnCellHeight - 1);
  int bottom = ClipToRange<int>(bbox.bottom(), 0, kBlnCellHeight - 1);
  // A tolerance of yscale corresponds to 1 pixel in the image.
  double tolerance = y_scale();
  // If the script doesn't have upper and lower-case characters, widen the
  // tolerance to allow sloppy baseline/x-height estimates.
  if (!unicharset.script_has_upper_lower()) {
    tolerance = y_scale() * kSloppyTolerance;
  }
 
  int min_bottom, max_bottom, min_top, max_top;
  unicharset.get_top_bottom(unichar_id, &min_bottom, &max_bottom, &min_top, &max_top);
 
  // Calculate the scale factor we'll use to get to image y-pixels
  double midx = (bbox.left() + bbox.right()) / 2.0;
  double ydiff = (bbox.top() - bbox.bottom()) + 2.0;
  FCOORD mid_bot(midx, bbox.bottom()), tmid_bot;
  FCOORD mid_high(midx, bbox.bottom() + ydiff), tmid_high;
  DenormTransform(nullptr, mid_bot, &tmid_bot);
  DenormTransform(nullptr, mid_high, &tmid_high);
 
  // bln_y_measure * yscale = image_y_measure
  double yscale = tmid_high.pt_to_pt_dist(tmid_bot) / ydiff;
 
  // Calculate y-shift
  int bln_yshift = 0, bottom_shift = 0, top_shift = 0;
  if (bottom < min_bottom - tolerance) {
    bottom_shift = bottom - min_bottom;
  } else if (bottom > max_bottom + tolerance) {
    bottom_shift = bottom - max_bottom;
  }
  if (top < min_top - tolerance) {
    top_shift = top - min_top;
  } else if (top > max_top + tolerance) {
    top_shift = top - max_top;
  }
  if ((top_shift >= 0 && bottom_shift > 0) || (top_shift < 0 && bottom_shift < 0)) {
    bln_yshift = (top_shift + bottom_shift) / 2;
  }
  *yshift = bln_yshift * yscale;
 
  // To help very high cap/xheight ratio fonts accept the correct x-height,
  // and to allow the large caps in small caps to accept the xheight of the
  // small caps, add kBlnBaselineOffset to chars with a maximum max, and have
  // a top already at a significantly high position.
  if (max_top == kBlnCellHeight - 1 && top > kBlnCellHeight - kBlnBaselineOffset / 2) {
    max_top += kBlnBaselineOffset;
  }
  top -= bln_yshift;
  int height = top - kBlnBaselineOffset;
  double min_height = min_top - kBlnBaselineOffset - tolerance;
  double max_height = max_top - kBlnBaselineOffset + tolerance;
 
  // We shouldn't try calculations if the characters are very short (for example
  // for punctuation).
  if (min_height > kBlnXHeight / 8 && height > 0) {
    float result = height * kBlnXHeight * yscale / min_height;
    *max_xht = result + kFinalPixelTolerance;
    result = height * kBlnXHeight * yscale / max_height;
    *min_xht = result - kFinalPixelTolerance;
  }
}

y_scale()

float tesseract::DENORM::y_scale ( ) const

inline

Definition at line 262 of file normalis.h.

                        {
    return y_scale_;
  }

---

The documentation for this class was generated from the following files:

• /media/home/debian/src/github/tesseract-ocr/tesseract/src/ccstruct/normalis.h
• /media/home/debian/src/github/tesseract-ocr/tesseract/src/ccstruct/normalis.cpp