inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1 (Operator)
Name
inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1
— Largest inner rectangle of a region.
Signature
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)
Description
The operator inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1InnerRectangle1
determines the largest
axis-parallel rectangle that fits into a region. The rectangle is
described by the coordinates of the corner pixels (Row1Row1Row1Row1row1
,
Column1Column1Column1Column1column1
, Row2Row2Row2Row2row2
, Column2Column2Column2Column2column2
).
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_systemSetSystemSetSystemSetSystem
).
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
RegionsRegionsRegionsRegionsregions
(input_object) region(-array) →
objectHRegionHRegionHobject
Region to be examined.
Row1Row1Row1Row1row1
(output_control) rectangle.origin.y(-array) →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Row coordinate of the upper left corner point.
Column1Column1Column1Column1column1
(output_control) rectangle.origin.x(-array) →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column coordinate of the upper left corner point.
Row2Row2Row2Row2row2
(output_control) rectangle.corner.y(-array) →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Row coordinate of the lower right corner point.
Column2Column2Column2Column2column2
(output_control) rectangle.corner.x(-array) →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column coordinate of the lower right corner point.
Result
The operator inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1InnerRectangle1
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>)SetSystem("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>)SetSystem("no_object_result",<Result>)
. If necessary an
exception is raised.
Possible Predecessors
thresholdthresholdThresholdThresholdThreshold
,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing
,
connectionconnectionConnectionConnectionConnection
Possible Successors
disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1DispRectangle1
,
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1
Alternatives
inner_circleinner_circleInnerCircleInnerCircleInnerCircle
See also
smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1
,
select_shapeselect_shapeSelectShapeSelectShapeSelectShape
Module
Foundation