get_points_ellipse

get_points_ellipse ( : : Angle, Row, Column, Phi, Radius1, Radius2 : RowPoint, ColPoint )

Points of an ellipse corresponding to specific angles.

get_points_ellipse returns the points (RowPoint,ColPoint) on the specified ellipse corresponding to the angles in Angle, which refer to the main axis of the ellipse. The ellipse itself is characterized by the center (Row, Column), the orientation of the main axis Phi, the length of the larger half axis Radius1, and the length of the smaller half axis Radius2.

Parameters

`Angle` (input_control)	real(-array) `->` real
Angles corresponding to the resulting points [rad].
Default value: 0
Restriction: `(Angle >= 0) && (Angle <= 6.283185307)`

`Row` (input_control)	ellipse.center.y `->` real
Row coordinate of the center of the ellipse.

`Column` (input_control)	ellipse.center.x `->` real
Column coordinate of the center of the ellipse.

`Phi` (input_control)	ellipse.angle.rad `->` real
Orientation of the main axis [rad].
Restriction: `(Phi >= 0) && (Phi <= 6.283185307)`

`Radius1` (input_control)	ellipse.radius1 `->` real
Length of the larger half axis.
Restriction: `Radius1 > 0`

`Radius2` (input_control)	ellipse.radius2 `->` real
Length of the smaller half axis.
Restriction: `Radius2 >= 0`

`RowPoint` (output_control)	point.row(-array) `->` real
Row coordinates of the points on the ellipse.

`ColPoint` (output_control)	point.column(-array) `->` real
Column coordinates of the points on the ellipse.

Example

draw_ellipse(WindowHandle,Row,Column,Phi,Radius1,Radius2) 
get_points_ellipse([0,3.14],Row,Column,Phi,Radius1,Radius2,RowPoint,ColPoint)

Result

get_points_ellipse returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.

Parallelization Information

get_points_ellipse is reentrant and processed without parallelization.

Possible Predecessors

fit_ellipse_contour_xld, draw_ellipse, gen_ellipse_contour_xld

See also

gen_ellipse_contour_xld

Module

Basic operators