ClassesClassesClassesClasses | | | | Operators

get_points_ellipseget_points_ellipseGetPointsEllipseget_points_ellipseGetPointsEllipseGetPointsEllipse (Operator)

Name

get_points_ellipseget_points_ellipseGetPointsEllipseget_points_ellipseGetPointsEllipseGetPointsEllipse — Calculate points on the perimeter of an ellipse.

Signature

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

Herror get_points_ellipse(double Angle, double Row, double Column, double Phi, double Radius1, double Radius2, double* RowPoint, double* ColPoint)

Herror T_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)

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)

void GetPointsEllipse(const HTuple& Angle, const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Radius1, const HTuple& Radius2, HTuple* RowPoint, HTuple* ColPoint)

static void HMisc::GetPointsEllipse(const HTuple& Angle, double Row, double Column, double Phi, double Radius1, double Radius2, HTuple* RowPoint, HTuple* ColPoint)

static void HMisc::GetPointsEllipse(double Angle, double Row, double Column, double Phi, double Radius1, double Radius2, double* RowPoint, double* ColPoint)

void HOperatorSetX.GetPointsEllipse(
[in] VARIANT Angle, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Phi, [in] VARIANT Radius1, [in] VARIANT Radius2, [out] VARIANT* RowPoint, [out] VARIANT* ColPoint)

VARIANT HMiscX.GetPointsEllipse(
[in] VARIANT Angle, [in] double Row, [in] double Column, [in] double Phi, [in] double Radius1, [in] double Radius2, [out] VARIANT* ColPoint)

static void HOperatorSet.GetPointsEllipse(HTuple angle, HTuple row, HTuple column, HTuple phi, HTuple radius1, HTuple radius2, out HTuple rowPoint, out HTuple colPoint)

static void HMisc.GetPointsEllipse(HTuple angle, double row, double column, double phi, double radius1, double radius2, out HTuple rowPoint, out HTuple colPoint)

static void HMisc.GetPointsEllipse(double angle, double row, double column, double phi, double radius1, double radius2, out double rowPoint, out double colPoint)

Description

get_points_ellipseget_points_ellipseGetPointsEllipseget_points_ellipseGetPointsEllipseGetPointsEllipse returns the point (RowPointRowPointRowPointRowPointRowPointrowPoint,ColPointColPointColPointColPointColPointcolPoint) on the specified ellipse corresponding to the angle in AngleAngleAngleAngleAngleangle. With the parameter AngleAngleAngleAngleAngleangle you are setting the eccentric anomaly, which denotes the angle used for the parametric equation (see the figure below) and refers to the main axis of the ellipse. The ellipse itself is characterized by the center (RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn), the orientation of the main axis PhiPhiPhiPhiPhiphi relative to the horizontal axis, the length of the larger (Radius1Radius1Radius1Radius1Radius1radius1) and the smaller half axis (Radius2Radius2Radius2Radius2Radius2radius2). The angles are measured counter clockwise in radiants.

image/svg+xml r2 r1 r2 sin(a) r1 cos(a) a P
The point P with its coordinates RowPointRowPointRowPointRowPointRowPointrowPoint and ColPointColPointColPointColPointColPointcolPoint belongs to the ellipse (orange). It is determined over the angle a and the lengths of the half axis r1 (Radius1Radius1Radius1Radius1Radius1radius1) and r2 (Radius2Radius2Radius2Radius2Radius2radius2). For simplicity of the visualization and angle PhiPhiPhiPhiPhiphi='0'"0""0""0""0""0" was used.

Parallelization

Parameters

AngleAngleAngleAngleAngleangle (input_control)  real(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Angle corresponding to the resulting point [rad].

Default value: 0

Restriction: Angle >= 0 && Angle <= 6.283185307

RowRowRowRowRowrow (input_control)  ellipse.center.y HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Row coordinate of the center of the ellipse.

ColumnColumnColumnColumnColumncolumn (input_control)  ellipse.center.x HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Column coordinate of the center of the ellipse.

PhiPhiPhiPhiPhiphi (input_control)  ellipse.angle.rad HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Orientation of the main axis [rad].

Restriction: Phi >= 0 && Phi <= 6.283185307

Radius1Radius1Radius1Radius1Radius1radius1 (input_control)  ellipse.radius1 HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Length of the larger half axis.

Restriction: Radius1 > 0

Radius2Radius2Radius2Radius2Radius2radius2 (input_control)  ellipse.radius2 HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Length of the smaller half axis.

Restriction: Radius2 >= 0

RowPointRowPointRowPointRowPointRowPointrowPoint (output_control)  point.y(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Row coordinate of the point on the ellipse.

ColPointColPointColPointColPointColPointcolPoint (output_control)  point.x(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Column coordinates of the point on the ellipse.

Example (HDevelop)

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

Result

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

Possible Predecessors

fit_ellipse_contour_xldfit_ellipse_contour_xldFitEllipseContourXldfit_ellipse_contour_xldFitEllipseContourXldFitEllipseContourXld, draw_ellipsedraw_ellipseDrawEllipsedraw_ellipseDrawEllipseDrawEllipse, gen_ellipse_contour_xldgen_ellipse_contour_xldGenEllipseContourXldgen_ellipse_contour_xldGenEllipseContourXldGenEllipseContourXld

See also

gen_ellipse_contour_xldgen_ellipse_contour_xldGenEllipseContourXldgen_ellipse_contour_xldGenEllipseContourXldGenEllipseContourXld

Module

Foundation


ClassesClassesClassesClasses | | | | Operators