ClassesClasses | | Operators

gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2 (Operator)

Name

gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2 — Create a rectangle of any orientation.

Signature

gen_rectangle2( : Rectangle : Row, Column, Phi, Length1, Length2 : )

Herror gen_rectangle2(Hobject* Rectangle, double Row, double Column, double Phi, double Length1, double Length2)

Herror T_gen_rectangle2(Hobject* Rectangle, const Htuple Row, const Htuple Column, const Htuple Phi, const Htuple Length1, const Htuple Length2)

void GenRectangle2(HObject* Rectangle, const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Length1, const HTuple& Length2)

void HRegion::GenRectangle2(const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Length1, const HTuple& Length2)

void HRegion::GenRectangle2(double Row, double Column, double Phi, double Length1, double Length2)

static void HOperatorSet.GenRectangle2(out HObject rectangle, HTuple row, HTuple column, HTuple phi, HTuple length1, HTuple length2)

void HRegion.GenRectangle2(HTuple row, HTuple column, HTuple phi, HTuple length1, HTuple length2)

void HRegion.GenRectangle2(double row, double column, double phi, double length1, double length2)

Description

The operator gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2 generates one or more rectangles with the center (RowRowRowRowrow, ColumnColumnColumnColumncolumn) , the orientation PhiPhiPhiPhiphi and the half edge lengths Length1Length1Length1Length1length1 and Length2Length2Length2Length2length2. The orientation is given in arc measure and indicates the angle between the horizontal axis and Length1Length1Length1Length1length1 (mathematically positive). 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. More than one region can be created by passing one tuple of corner points.

Attention

The gray values of the output objects are undefined. For speed reasons, the resulting region may contain additional pixels at the border and some individual pixels at the border may be missing. This may lead to an inconsistency between the operators smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2 and gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2.

Execution Information

Parameters

RectangleRectangleRectangleRectanglerectangle (output_object)  region(-array) objectHRegionHRegionHobject *

Created rectangle.

RowRowRowRowrow (input_control)  rectangle2.center.y(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Line index of the center.

Default value: 300.0

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

Typical range of values: Row Row Row Row row (lin)

Minimum increment: 1.0

Recommended increment: 10.0

ColumnColumnColumnColumncolumn (input_control)  rectangle2.center.x(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column index of the center.

Default value: 200.0

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

Typical range of values: Column Column Column Column column (lin)

Minimum increment: 1.0

Recommended increment: 10.0

PhiPhiPhiPhiphi (input_control)  rectangle2.angle.rad(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Angle of longitudinal axis to the horizontal (in radians).

Default value: 0.0

Suggested values: -1.178097, -0.785398, -0.392699, 0.0, 0.392699, 0.785398, 1.178097

Typical range of values: -1.178097 ≤ Phi Phi Phi Phi phi ≤ 1.178097 (lin)

Restriction: - pi / 2 < Phi && Phi <= pi / 2

Length1Length1Length1Length1length1 (input_control)  rectangle2.hwidth(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Half width.

Default value: 100.0

Suggested values: 3.0, 5.0, 10.0, 15.0, 20.0, 50.0, 100.0, 200.0, 300.0, 500.0

Typical range of values: Length1 Length1 Length1 Length1 length1 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Length2Length2Length2Length2length2 (input_control)  rectangle2.hheight(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Half height.

Default value: 20.0

Suggested values: 1.0, 2.0, 3.0, 5.0, 10.0, 15.0, 20.0, 50.0, 100.0, 200.0

Typical range of values: Length2 Length2 Length2 Length2 length2 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Result

If the parameter values are correct the operator gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2 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_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1, gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilledGenRegionPolygonFilled, gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints, fill_upfill_upFillUpFillUpFillUp

See also

draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2, gen_ellipsegen_ellipseGenEllipseGenEllipseGenEllipse

Module

Foundation


ClassesClasses | | Operators