Operator Reference

HALCON Operator Reference / OCR / Segmentation
ClassesClasses | | Operators

text_line_orientationtext_line_orientationTextLineOrientationTextLineOrientationtext_line_orientation (Operator)

text_line_orientationtext_line_orientationTextLineOrientationTextLineOrientationtext_line_orientation — Determines the orientation of a text line or paragraph.

Signature

Herror text_line_orientation(const Hobject Region, const Hobject Image, const Hlong CharHeight, double OrientationFrom, double OrientationTo, double* OrientationAngle)

Herror T_text_line_orientation(const Hobject Region, const Hobject Image, const Htuple CharHeight, const Htuple OrientationFrom, const Htuple OrientationTo, Htuple* OrientationAngle)

void TextLineOrientation(const HObject& Region, const HObject& Image, const HTuple& CharHeight, const HTuple& OrientationFrom, const HTuple& OrientationTo, HTuple* OrientationAngle)

HTuple HRegion::TextLineOrientation(const HImage& Image, Hlong CharHeight, double OrientationFrom, double OrientationTo) const

def text_line_orientation(region: HObject, image: HObject, char_height: int, orientation_from: float, orientation_to: float) -> Sequence[float]

def text_line_orientation_s(region: HObject, image: HObject, char_height: int, orientation_from: float, orientation_to: float) -> float

Description

text_line_orientationtext_line_orientationTextLineOrientationTextLineOrientationtext_line_orientation determines the orientation of a single text line or a paragraph in relation to the horizontal image axis. If the orientation of a single text line should be determined, the range for the OrientationFromOrientationFromOrientationFromorientationFromorientation_from and OrientationToOrientationToOrientationToorientationToorientation_to should be in the interval from -pi/4 to pi/4.

The parameter RegionRegionRegionregionregion specifies the area of the image in which the text lines are located. The RegionRegionRegionregionregion is only used to reduce the working area. To determine the slant, the gray values inside that area are used. The text lines are segmented by the operator text_line_orientationtext_line_orientationTextLineOrientationTextLineOrientationtext_line_orientation itself. If more than one region is passed, the numerical values of the orientation angle are stored in a tuple, the position of a value in the tuple corresponding to the position of the region in the input tuple.

CharHeightCharHeightCharHeightcharHeightchar_height specifies the approximately height of the existing text lines in the region RegionRegionRegionregionregion. It's assumed, that the text lines are darker than the background.

The search area can be restricted by the parameters OrientationFromOrientationFromOrientationFromorientationFromorientation_from and OrientationToOrientationToOrientationToorientationToorientation_to, whereby also the runtime of the operator is influenced.

With the calculated angle OrientationAngleOrientationAngleOrientationAngleorientationAngleorientation_angle and operators like affine_trans_imageaffine_trans_imageAffineTransImageAffineTransImageaffine_trans_image, the region RegionRegionRegionregionregion of the image ImageImageImageimageimage can be rotated such, that the text lines lie horizontally in the image. This may simplify the character segmentation for OCR applications.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Automatically parallelized on tuple level.

Parameters

RegionRegionRegionregionregion (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Area of text lines.

ImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte / uint2)

Input image.

CharHeightCharHeightCharHeightcharHeightchar_height (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of the text lines.

Default: 25

Value range: 1 ≤ CharHeight CharHeight CharHeight charHeight char_height

Restriction: CharHeight >= 1

OrientationFromOrientationFromOrientationFromorientationFromorientation_from (input_control)  angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Minimum rotation of the text lines.

Default: -0.523599

Value range: -3.141593 ≤ OrientationFrom OrientationFrom OrientationFrom orientationFrom orientation_from ≤ 3.141593

Restriction: OrientationFrom <= OrientationTo

OrientationToOrientationToOrientationToorientationToorientation_to (input_control)  angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Maximum rotation of the text lines.

Default: 0.523599

Value range: -3.141593 ≤ OrientationTo OrientationTo OrientationTo orientationTo orientation_to ≤ 3.141593

Restriction: OrientationFrom <= OrientationTo && OrientationTo < OrientationFrom + pi

OrientationAngleOrientationAngleOrientationAngleorientationAngleorientation_angle (output_control)  angle.rad(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Calculated rotation angle of the text lines.

Example (HDevelop)

read_image(Image,'letters')
text_line_orientation(Image,Image,50,rad(-80),rad(80),OrientationAngle)
rotate_image(Image,ImageRotate,-OrientationAngle/rad(180)*180,'constant')

Result

If the input parameters are set correctly, the operator text_line_orientationtext_line_orientationTextLineOrientationTextLineOrientationtext_line_orientation returns the value 2 ( H_MSG_TRUE) . Otherwise an exception will be raised.

Possible Successors

rotate_imagerotate_imageRotateImageRotateImagerotate_image, affine_trans_imageaffine_trans_imageAffineTransImageAffineTransImageaffine_trans_image, affine_trans_image_sizeaffine_trans_image_sizeAffineTransImageSizeAffineTransImageSizeaffine_trans_image_size

Module

Foundation

ClassesClasses | | Operators