PUT_MARKER

Utility/SetupUsed to set the marker position and orientation in conjunction with MARKER_READ.

Use

This function can be called by MARKER_READ.

Format

CALL PUT_MARKER(ID, R, ANGLE_TYPE, ANGLE, ERRFLG)

Attributes

ID
[integer]
The identifier of the corresponding Reference_Marker element.
R
[double precision]
This array defines the X, Y and Z location of the marker. This array must be of size 3.
ANGLE_TYPE
[integer]
This specifies the type of angle being passed in the ANGLE argument. Regardless of the type of angle passed, MotionSolve converts these internally to obtain the direction cosine matrix.
ANGLE_TYPE ANGLE
0 Direction Cosine Matrix
1 Euler angles
2 Yaw, Pitch, Roll (YPR)
3 Euler parameters
ANGLE
[double precision]
An array containing angles that set the orientation of the marker.
ANGLE_TYPE ANGLE Size of ANGLE array
0 Specify the X, Z direction cosine columns. Y direction cosine is computed internally using a cross product between X, Z 6
1 Specify Euler angles (Body 3-1-3) 3
2 Specify YPR angles (Body 3-2-1) 3
3 Specify Euler parameters 4

Output

ERRFLG
[logical]
A logical flag that represents the success of the PUT_MARKER function call. This is checked by MARKER_READ.

Example

For an example of PUT_MARKER, please refer to <install_path>\hwsolvers\motionsolve\usersub.