inner_rectangle1InnerRectangle1InnerRectangle1inner_rectangle1inner_rectangle1

HALCON ScriptCpp++.NETPythonC

Short description

inner_rectangle1InnerRectangle1InnerRectangle1inner_rectangle1inner_rectangle1 — Largest inner rectangle of a region.

Signature

inner_rectangle1( region Regions, out rectangle.origin.y Row1, out rectangle.origin.x Column1, out rectangle.corner.y Row2, out rectangle.corner.x Column2 )void InnerRectangle1( const HObject& Regions, HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2 )static void HOperatorSet.InnerRectangle1( HObject regions, out HTuple row1, out HTuple column1, out HTuple row2, out HTuple 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]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 HRegion::InnerRectangle1( HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2 ) const

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

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 )

Description

The operator inner_rectangle1InnerRectangle1 determines the largest axis-parallel rectangle that fits into a region. The rectangle is described by the coordinates of the corner pixels (Row1row1row_1, Column1column1column_1, Row2row2row_2, Column2column2column_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 Regionsregionsregions 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_systemSetSystem).

Execution information

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

Regionsregionsregions (input_object) region(-array) → objectHObjectHRegionHObjectHobject

Region to be examined.

Row1row1row_1 (output_control) rectangle.origin.y(-array) → (integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Row coordinate of the upper left corner point.

Column1column1column_1 (output_control) rectangle.origin.x(-array) → (integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Column coordinate of the upper left corner point.

Row2row2row_2 (output_control) rectangle.corner.y(-array) → (integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Row coordinate of the lower right corner point.

Column2column2column_2 (output_control) rectangle.corner.x(-array) → (integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Column coordinate of the lower right corner point.

Result

The operator inner_rectangle1InnerRectangle1 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>). The behavior in case of empty region (the region is the empty set) is set via set_system('no_object_result',<Result>). If necessary an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

thresholdThreshold, regiongrowingRegiongrowing, connectionConnection

Possible successors

disp_rectangle1DispRectangle1, gen_rectangle1GenRectangle1

Alternatives

inner_circleInnerCircle

See also

smallest_rectangle1SmallestRectangle1, select_shapeSelectShape

Module

Foundation