FC_RotationAboutLine

 

FC_RotationAboutLine - General Information

Overview

Type:

Function

Available as of:

V1.0.3.0

Versions:

Current version

Task

Rotation of a point about a straight line in the 3-dimensional space.

Description

The point i_stP is rotated by an angle of i_lrAngle in its orthogonal plane of the straight line i_stLine. The angle of rotation is in this case interpreted in the mathematically positive direction (clockwise) around a vector along the straight line, with the orientation of point 2 of the straight line of point 1.

Interface

Input

Data type

Description

i_stP

ST_Vector3D

Point to be rotated

i_stLine

ST_Line3D

Straight line about which the point i_stP is to be rotated

i_lrAngle

LREAL

The angle by which the point is to be rotated

Output

Data type

Description

q_etDiag

GD.ET_Diag

General library-independent statement on the diagnostic.

A value not equal to ET_Diag.Ok corresponds to an diagnostic message.

q_etDiagExt

ET_DiagExt

POU-specific output on the diagnostic.

q_etDiag = ET_Diag.Ok -> Status message

q_etDiag <> ET_Diag.Ok -> Diagnostic message

Return Value

Data type

Description

ST_Vector3D

Coordinates of the mapped point

Diagnostic Messages

q_etDiag

q_etDiagExt

Enumeration value

Description

OK

Ok

0

Ok

Ok

Enumeration name:

Ok

Enumeration value:

0

Description:

Ok

The coordinates of the mapped point have been calculated successfully.