disp_ellipse ( : : CenterRow, CenterCol, Phi, Radius1, Radius2 : )

Displays ellipses.

disp_ellipse displays one or several ellipses in the current output window. An ellipse is described by the center (CenterRow, CenterCol), the orientation Phi (in radians) and the radii of the minor and the major axis (Radius1 and Radius2).

The procedures used to control the display of regions (e.g. set_draw, set_grey, set_draw) can also be used with ellipses. The output window is set with the procedure set_window. Several ellipses can be displayed with one call by using tuple parameters. For the use of colors with several ellipses, see set_color.


Attention

The center of the ellipse must be within the current window.


Parameters

CenterRow (input_control)
ellipse.center.y(-array) -> integer
row index of center.
Default value: 64
Suggested values: 0, 64, 128, 256
Range of values: 0 <= CenterRow <= 511 (lin)
Minimum increment: 1
Recommended increment: 10

CenterCol (input_control)
ellipse.center.x(-array) -> integer
column index of center.
Default value: 64
Suggested values: 0, 64, 128, 256
Range of values: 0 <= CenterCol <= 511 (lin)
Minimum increment: 1
Recommended increment: 10

Phi (input_control)
ellipse.angle.rad(-array) -> real / integer
orientation of the ellipse in radians
Default value: 0.0
Suggested values: 0.0, 0.785398, 1.570796, 3.1415926, 6.283185
Range of values: 0.0 <= Phi <= 6.283185 (lin)
Minimum increment: 0.01
Recommended increment: 0.1

Radius1 (input_control)
ellipse.radius1(-array) -> real / integer
radius of major axis.
Default value: 24.0
Suggested values: 0.0, 64.0, 128.0, 256.0
Range of values: 0.0 <= Radius1 <= 511.0 (lin)
Minimum increment: 1.0
Recommended increment: 10.0

Radius2 (input_control)
ellipse.radius2(-array) -> real / integer
radius of minor axis.
Default value: 14.0
Suggested values: 0.0, 64.0, 128.0, 256.0
Range of values: 0.0 <= Radius2 <= 511.0 (lin)
Minimum increment: 1.0
Recommended increment: 10.0


Example
set_color(::'red':) >
draw_region(:MyRegion::) >
elliptic_axis(MyRegion:::Ra,Rb,Phi) >
area_center(MyRegion:::_,Row,Column) >
disp_ellipse(::Row,Column,Phi,Ra,Rb:).

Result

disp_ellipse returns TRUE, if a window is activated and the parameters are correct. Otherwise an exception is raised.


Possible Predecessors

open_window, set_draw, set_color, set_colored, set_line_width, set_rgb, set_hsi, set_window, elliptic_axis, area_center


Alternatives

disp_circle, disp_region, ellipse, circle


See also

open_window, open_textwindow, set_color, set_rgb, set_hsi, set_draw, set_line_width, set_window



Copyright © 1996-1997 MVTec Software GmbH