read_pose

read_pose ( : : PoseFile : Pose )

Read a 3D pose from a text file.

read_pose is used to read the 3D pose Pose from a text file with the name PoseFile.

A pose describes a rigid 3D transformation, i.e., a transformation consisting of an arbitrary translation and rotation, with 6 parameters, three for the translation, three for the rotation. With a seventh parameter different pose types can be indicated (see create_pose).

A suitable file can be generated by the operator write_pose and looks like the following:

  # 3D POSE PARAMETERS: rotation and translation

  # Used representation type:
  f 0

  # Rotation angles [deg] or Rodriguez-vector:
  r -17.8134 1.83816 0.288092

  # Translational vector (x y z [m]):
  t 0.280164 0.150644 1.7554

Parameters

`PoseFile` (input_control)	filename `->` string
File name of the exterior camera parameters.
Default value: 'campose.dat'
List of values: 'campose.dat', 'campose.initial', 'campose.final'

`Pose` (output_control)	pose-array `->` real / integer
3D pose.
Number of elements: 7

Result

read_pose returns 2 (H_MSG_TRUE) if all parameter values are correct and the file has been read successfully. If necessary an exception handling is raised.

Parallelization Information

read_pose is reentrant and processed without parallelization.

Possible Predecessors

read_cam_par

Possible Successors

pose_to_hom_mat3d, camera_calibration, disp_caltab, sim_caltab

Module

Foundation