FC_PoseMatrixVector3DMultiplication - General Information

Overview

Type:

Function

Available as of:

V1.0.0.0

Versions:

Current version

This chapter provides information on:

Description

Given an input matrix pose and a 3D vector, the function applies the transformation described by the pose matrix to the vector. The resulting vector is then returned.

NOTE: There is no internal verification about i_stPoseMatrix being a valid pose matrix.
NOTE: The multiplication between the elements is handled internally.

Interface

Input

Data type

Description

i_stPoseMatrix

SE_MATH.ST_Matrix4D

A 4D matrix describing a Cartesian pose.

i_stVector

SE_MATH.ST_Vector3D

A 3D vector.

Output

Data type

Description

q_xError

BOOL

If this output is set to TRUE, an error has been detected. For details, refer to q_etResult and q_etResultMsg.

q_etResult

ET_Result

Provides diagnostic and status information.

If q_xError = FALSE, then q_etResult provides status information.

If q_xError = TRUE, then q_etResult provides diagnostic/error information.

The enumeration ET_Result contains the possible values of the POU operation results.

q_sResultMsg

STRING[80]

Provides additional information about the current status of the POU.

Return Value

Data type

Description

SE_MATH.ST_Vector3D

The function returns the result of the multiplication between a 4D pose matrix and a 3D vector.

Diagnostic Messages

q_xError

q_etResult

Enumeration value

Description

FALSE

Ok

0

Success

Ok

Enumeration name:

Ok

Enumeration value:

0

Description:

Success