Operator Reference

HALCON Operator Reference / Regions / Features

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1inner_rectangle1 (Operator)

inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1inner_rectangle1 — Largest inner rectangle of a region.

Signature

inner_rectangle1(Regions : : : Row1, Column1, Row2, Column2)

Herror inner_rectangle1(const Hobject Regions, Hlong* Row1, Hlong* Column1, Hlong* Row2, Hlong* Column2)

Herror T_inner_rectangle1(const Hobject Regions, Htuple* Row1, Htuple* Column1, Htuple* Row2, Htuple* Column2)

void InnerRectangle1(const HObject& Regions, HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2)

void HRegion::InnerRectangle1(HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2) const

void HRegion::InnerRectangle1(Hlong* Row1, Hlong* Column1, Hlong* Row2, Hlong* Column2) const

static void HOperatorSet.InnerRectangle1(HObject regions, out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2)

void HRegion.InnerRectangle1(out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2)

void HRegion.InnerRectangle1(out int row1, out int column1, out int row2, out int column2)

def inner_rectangle1(regions: HObject) -> Tuple[Sequence[int], Sequence[int], Sequence[int], Sequence[int]]

def inner_rectangle1_s(regions: HObject) -> Tuple[int, int, int, int]

Description

The operator inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1inner_rectangle1 determines the largest axis-parallel rectangle that fits into a region. The rectangle is described by the coordinates of the corner pixels (Row1Row1Row1row1row_1, Column1Column1Column1column1column_1, Row2Row2Row2row2row_2, Column2Column2Column2column2column_2).

In the documentation of this chapter (Regions / Features), you can find an image illustrating regions which vary in the width and height of their inner rectangle.

If more than one region is passed in RegionsRegionsRegionsregionsregions the results are stored in tuples, the index of a value in the tuple corresponding to the index of the input region. For empty regions all parameters have the value 0 if no other behavior was set (see set_systemset_systemSetSystemSetSystemset_system).

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.
• Automatically parallelized on internal data level.

Parameters

RegionsRegionsRegionsregionsregions (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Region to be examined.

Row1Row1Row1row1row_1 (output_control)  rectangle.origin.y(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinate of the upper left corner point.

Column1Column1Column1column1column_1 (output_control)  rectangle.origin.x(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinate of the upper left corner point.

Row2Row2Row2row2row_2 (output_control)  rectangle.corner.y(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinate of the lower right corner point.

Column2Column2Column2column2column_2 (output_control)  rectangle.corner.x(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinate of the lower right corner point.

Result

The operator inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1inner_rectangle1 returns the value 2 ( H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). The behavior in case of empty region (the region is the empty set) is set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionconnection

Possible Successors

disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1disp_rectangle1, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1

Alternatives

inner_circleinner_circleInnerCircleInnerCircleinner_circle

See also

smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1, select_shapeselect_shapeSelectShapeSelectShapeselect_shape

Module

Foundation

---

ClassesClasses | | Operators