gen_ellipsegen_ellipseGenEllipseGenEllipsegen_ellipse (Operator)

Name

gen_ellipsegen_ellipseGenEllipseGenEllipsegen_ellipse — Create an ellipse.

Signature

gen_ellipse( : Ellipse : Row, Column, Phi, Radius1, Radius2 : )

Description

The operator gen_ellipsegen_ellipseGenEllipseGenEllipseGenEllipsegen_ellipse generates one or more ellipses with the center (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn), the orientation PhiPhiPhiPhiphiphi and the half-radii (half axes) Radius1Radius1Radius1Radius1radius1radius_1 and Radius2Radius2Radius2Radius2radius2radius_2. The angle is indicated in arc measure according to the x axis in mathematically positive direction. More than one region can be created by passing tuples of parameter values.

The center must be located within the image coordinates. The coordinate system runs from (0,0) (upper left corner) to (Width-1,Height-1). See get_systemget_systemGetSystemGetSystemGetSystemget_system and reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDbreset_obj_db in this context. If the ellipse reaches beyond the edge of the image it is clipped to the current image format according to the value of the system flag 'clip_region'"clip_region""clip_region""clip_region""clip_region""clip_region" (set_systemset_systemSetSystemSetSystemSetSystemset_system).

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

EllipseEllipseEllipseEllipseellipseellipse (output_object) region(-array) → object

Created ellipse(s).

RowRowRowRowrowrow (input_control) ellipse.center.y(-array) → (real / integer)

Line index of center.

Default value: 200.0

Suggested values: 0.0, 10.0, 20.0, 50.0, 100.0, 256.0, 300.0, 400.0

Typical range of values: 1.0 ≤ Row Row Row Row row row ≤ 1024.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

ColumnColumnColumnColumncolumncolumn (input_control) ellipse.center.x(-array) → (real / integer)

Column index of center.

Default value: 200.0

Suggested values: 0.0, 10.0, 20.0, 50.0, 100.0, 256.0, 300.0, 400.0

Typical range of values: 1.0 ≤ Column Column Column Column column column ≤ 1024.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

PhiPhiPhiPhiphiphi (input_control) ellipse.angle.rad(-array) → (real / integer)

Orientation of the longer radius (Radius1).

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 phi ≤ 1.178097 (lin)

Radius1Radius1Radius1Radius1radius1radius_1 (input_control) ellipse.radius1(-array) → (real / integer)

Longer radius.

Default value: 100.0

Suggested values: 2.0, 5.0, 10.0, 20.0, 50.0, 100.0, 256.0, 300.0, 400.0

Typical range of values: 1.0 ≤ Radius1 Radius1 Radius1 Radius1 radius1 radius_1 ≤ 1024.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: Radius1 > 0

Radius2Radius2Radius2Radius2radius2radius_2 (input_control) ellipse.radius2(-array) → (real / integer)

Shorter radius.

Default value: 60.0

Suggested values: 1.0, 2.0, 4.0, 5.0, 10.0, 20.0, 50.0, 100.0, 256.0, 300.0, 400.0

Typical range of values: 1.0 ≤ Radius2 Radius2 Radius2 Radius2 radius2 radius_2 ≤ 1024.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: Radius2 > 0 && Radius2 <= Radius1

Example (HDevelop)

read_image (Image, 'fabrik')
gen_ellipse (Ellipse, 200, 200, rad(10), 160, 90)
reduce_domain (Image, Ellipse, ImageReduced)
dev_clear_window ()
dev_display (ImageReduced)