get_points_ellipse

Herror ::get_points_ellipse ( const HTuple &Angle, const HTuple &Row, const HTuple &Column, const HTuple &Phi, const HTuple &Radius1, const HTuple &Radius2, double *RowPoint, double *ColPoint ) Herror ::get_points_ellipse ( const HTuple &Angle, const HTuple &Row, const HTuple &Column, const HTuple &Phi, const HTuple &Radius1, const HTuple &Radius2, HTuple *RowPoint, HTuple *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) `->` HTuple.double
Angles corresponding to the resulting points [rad].
Default value: 0
Restriction: `(Angle >= 0) && (Angle <= 6.283185307)`

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

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

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

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

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

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

`ColPoint` (output_control)	point.column(-array) `->` (HTuple.) double *
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 H_MSG_TRUE if all parameter values are correct. If necessary, an exception is raised.

Possible Predecessors

::fit_ellipse_contour_xld, ::draw_ellipse, ::gen_ellipse_contour_xld

See also

::gen_ellipse_contour_xld

Module

Basic operators