ClassesClasses | | Operators

gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1 (Operator)

Name

gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1 — Create a rectangle parallel to the coordinate axes.

Signature

gen_rectangle1( : Rectangle : Row1, Column1, Row2, Column2 : )

Herror gen_rectangle1(Hobject* Rectangle, double Row1, double Column1, double Row2, double Column2)

Herror T_gen_rectangle1(Hobject* Rectangle, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2)

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)

Description

The operator gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1 generates one or more rectangles parallel to the coordinate axes which are described by the upper left corner (Row1Row1Row1Row1row1, Column1Column1Column1Column1column1) and the lower right corner (Row2Row2Row2Row2row2, Column2Column2Column2Column2column2). 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_systemGetSystemGetSystemGetSystem and reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDb in this context.

Execution Information

Parameters

RectangleRectangleRectangleRectanglerectangle (output_object)  region(-array) objectHRegionHRegionHobject *

Created rectangle.

Row1Row1Row1Row1row1 (input_control)  rectangle.origin.y(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Line of upper left corner point.

Default value: 30.0

Suggested values: 0.0, 10.0, 20.0, 50.0, 100.0, 200.0

Typical range of values: Row1 Row1 Row1 Row1 row1 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Column1Column1Column1Column1column1 (input_control)  rectangle.origin.x(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column of upper left corner point.

Default value: 20.0

Suggested values: 0.0, 10.0, 20.0, 50.0, 100.0, 200.0

Typical range of values: Column1 Column1 Column1 Column1 column1 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Row2Row2Row2Row2row2 (input_control)  rectangle.corner.y(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Line of lower right corner point.

Default value: 100.0

Suggested values: 10.0, 20.0, 50.0, 100.0, 200.0, 300.0, 400.0, 500.0, 511.0

Typical range of values: Row2 Row2 Row2 Row2 row2 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: Row2 >= Row1

Column2Column2Column2Column2column2 (input_control)  rectangle.corner.x(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column of lower right corner point.

Default value: 200.0

Suggested values: 10.0, 20.0, 50.0, 100.0, 200.0, 300.0, 400.0, 500.0, 511.0

Typical range of values: Column2 Column2 Column2 Column2 column2 (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)

Example (C)

/* Contrast improvement in a rectangular region of interest */

read_image(&Image,"mreut");
open_window(0,0,-1,-1,"root","visible","",&WindowHandle);
disp_image(Image,WindowHandle);
draw_rectangle1(WindowHandle,&Row1,&Column1,&Row2,&Column2);
gen_rectangle1(&Rect,(double)Row1,(double)Column1,
                     (double)Row2,(double)Column2);
reduce_domain(Image,Rect,&Mask);
emphasize(Mask,&Emphasize,9,9,1.0);
disp_image(Emphasize,WindowHandle);

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)

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)

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_rectangle1GenRectangle1GenRectangle1GenRectangle1 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">)SetSystem("clip_region",<"true"/"false">).

Possible Successors

paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

Alternatives

gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2, gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon, fill_upfill_upFillUpFillUpFillUp, gen_region_runsgen_region_runsGenRegionRunsGenRegionRunsGenRegionRuns, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints, gen_region_linegen_region_lineGenRegionLineGenRegionLineGenRegionLine

See also

draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1

Module

Foundation


ClassesClasses | | Operators