FC_AnyNormalUnitVector3D

 

FC_AnyNormalUnitVector3D - General Information

Overview

Type:

Function

Available as of:

V1.0.3.0

Versions:

Current version

Task

Calculation of a unit vector which is orthogonal relative to a given vector in the 3-dimensional space.

Description

In the 3-dimensional space, there is an infinite number of unit vectors which are orthogonal relative to a given vector different from zero. This function calculates such a vector. Using the function FC_CrossProduct, an orthogonal tripod can then be constructed from these two vectors.

Interface

Input

Data type

Description

i_stV

ST_Vector3D

Vector in relation to which an orthogonal unit vector is to be calculated.

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

Unit vector which is orthogonal in relation to the vector i_stV.

Diagnostic Messages

q_etDiag

q_etDiagExt

Enumeration value

Description

OK

Ok

0

Ok

Ok

Enumeration name:

Ok

Enumeration value:

0

Description:

Ok

The unit vector has been determined successfully.