C++ Syntax

bool

MKI_CalcArcFrame(

MKI_CONST_POINT_REF f_rCenter,

MKI_CONST_POINT_REF f_rAngle1,

MKI_CONST_POINT_REF f_rAngle2,

bool f_fPositive,

MKI_CONST_MATRIX_REF f_pMatrix,

MKI_RECT_REF f_rFrame );

Calculates the surrounding frame of a circular arc.

Parameters

Center

[MKI_CONST_POINT_REF] Coordinates of the circle's center-point in internal [mm].

Angle1

[MKI_CONST_POINT_REF] Coordinates of the circular arc's radius definition and start-angle definition point in internal [mm].

Angle2

[MKI_CONST_POINT_REF] Coordinates of the circular arc's end-angle definition point in internal [mm].

Positive

[bool] If this value is true, the arc is drawn in positive direction, i.e. counterclockwise. Else it is drawn in negative direction, i.e. clockwise.

Matrix

[MKI_CONST_MATRIX_PTR] Matrix with which the circular arc is to be temporarily multiplied before calculating the surrounding frame. If Matrix is nullptr, no temporary modification is performed.

Frame

[MKI_RECT_REF] Address of a rectangle buffer to receive the calculated surrounding frame. The coordinates are sorted, i.e. x1 <= x2 and y1 <= y2.

Return Value

Returns true if successful. If false is returned, the rectangle pointed to by Frame is not modified.