gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1 (Operator)
Name
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1 — Create a rectangle parallel to the coordinate axes.
Signature
void GenRectangle1(HObject* Rectangle, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)
void HRegion::HRegion(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)
void HRegion::HRegion(double Row1, double Column1, double Row2, double Column2)
void HRegion::GenRectangle1(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)
void HRegion::GenRectangle1(double Row1, double Column1, double Row2, double Column2)
static void HOperatorSet.GenRectangle1(out HObject rectangle, HTuple row1, HTuple column1, HTuple row2, HTuple column2)
public HRegion(HTuple row1, HTuple column1, HTuple row2, HTuple column2)
public HRegion(double row1, double column1, double row2, double column2)
void HRegion.GenRectangle1(HTuple row1, HTuple column1, HTuple row2, HTuple column2)
void HRegion.GenRectangle1(double row1, double column1, double row2, double column2)
def gen_rectangle1(row_1: MaybeSequence[Union[int, float]], column_1: MaybeSequence[Union[int, float]], row_2: MaybeSequence[Union[int, float]], column_2: MaybeSequence[Union[int, float]]) -> HObject
Description
The operator gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1 generates one or more rectangles parallel
to the coordinate axes which are described by the upper left corner
(Row1Row1Row1row1row_1, Column1Column1Column1column1column_1) and the lower right corner
(Row2Row2Row2row2row_2, Column2Column2Column2column2column_2).
More than one region can be created by passing a tuple of corner points.
The coordinate system runs from (0,0) (upper left corner) to
(Width-1,Height-1). See get_systemget_systemGetSystemGetSystemget_system
and reset_obj_dbreset_obj_dbResetObjDbResetObjDbreset_obj_db in this context.
Parameter Broadcasting
This operator supports parameter broadcasting.
This means that each parameter can be given as a tuple of length
1 or 'N'"N""N""N""N".
Parameters with tuple length 1 will be repeated internally
such that the number of created items is always 'N'"N""N""N""N".
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
RectangleRectangleRectanglerectanglerectangle (output_object) region(-array) → objectHRegionHObjectHObjectHobject *
Created rectangle.
Row1Row1Row1row1row_1 (input_control) rectangle.origin.y(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Line of upper left corner point.
Default:
30.0
Suggested values:
0.0, 10.0, 20.0, 50.0, 100.0, 200.0
Value range:
Row1
Row1
Row1
row1
row_1
(lin)
Minimum increment:
1.0
Recommended increment:
10.0
Column1Column1Column1column1column_1 (input_control) rectangle.origin.x(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column of upper left corner point.
Default:
20.0
Suggested values:
0.0, 10.0, 20.0, 50.0, 100.0, 200.0
Value range:
Column1
Column1
Column1
column1
column_1
(lin)
Minimum increment:
1.0
Recommended increment:
10.0
Row2Row2Row2row2row_2 (input_control) rectangle.corner.y(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Line of lower right corner point.
Default:
100.0
Suggested values:
10.0, 20.0, 50.0, 100.0, 200.0, 300.0, 400.0, 500.0, 511.0
Value range:
Row2
Row2
Row2
row2
row_2
(lin)
Minimum increment:
1.0
Recommended increment:
10.0
Restriction:
Row2 >= Row1
Column2Column2Column2column2column_2 (input_control) rectangle.corner.x(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column of lower right corner point.
Default:
200.0
Suggested values:
10.0, 20.0, 50.0, 100.0, 200.0, 300.0, 400.0, 500.0, 511.0
Value range:
Column2
Column2
Column2
column2
column_2
(lin)
Minimum increment:
1.0
Recommended increment:
10.0
Restriction:
Column2 >= Column1
Example (HDevelop)
* Contrast improvement in a rectangular region of interest
dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
read_image(Image,'mreut')
dev_display (Image)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
gen_rectangle1(Rectangle,Row1,Column1,Row2,Column2)
reduce_domain(Image,Rectangle,Mask)
emphasize(Mask,Emphasize,9,9,1.0)
dev_display (Emphasize)
Result
If the parameter values are correct, the operator gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1
returns the value 2 (
H_MSG_TRUE)
.
Otherwise an exception is raised.
The clipping according to the current image format is set via the
operator set_system('clip_region',<'true'/'false'>)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)set_system("clip_region",<"true"/"false">).
Possible Successors
paint_regionpaint_regionPaintRegionPaintRegionpaint_region,
reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain
Alternatives
gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2gen_rectangle2,
gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygongen_region_polygon,
fill_upfill_upFillUpFillUpfill_up,
gen_region_runsgen_region_runsGenRegionRunsGenRegionRunsgen_region_runs,
gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsgen_region_points,
gen_region_linegen_region_lineGenRegionLineGenRegionLinegen_region_line
See also
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1draw_rectangle1,
reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain,
smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1
Module
Foundation