PUT_MARKER

Subroutine Type

Utility/Setup

Definition

Used to set the marker position and orientation in conjunction with MARKER_READ.

Use

This function can be called by MARKER_READ.

Calling Syntax

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

Input Arguments

[integer]ID

The identifier of the corresponding Reference_Marker element.

[double precision]R

This array defines the X, Y and Z location of the marker. This array must be of size 3.

[integer] ANGLE_TYPE

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

[double precision] ANGLE

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 Values

[logical] ERRFLG

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.