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.