read_poseT_read_poseReadPoseReadPose (Operator)
Name
read_poseT_read_poseReadPoseReadPose
— Read a 3D pose from a text file.
Signature
Description
read_poseread_poseReadPoseReadPoseReadPose
is used to read the 3D pose PosePosePosePosepose
from
a text file with the name PoseFilePoseFilePoseFilePoseFileposeFile
.
The default HALCON file extension for the 3D pose is 'dat'.
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_posecreate_poseCreatePoseCreatePoseCreatePose
).
A suitable file can be generated by the operator write_posewrite_poseWritePoseWritePoseWritePose
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
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
PoseFilePoseFilePoseFilePoseFileposeFile
(input_control) filename.read →
HTupleHTupleHtuple (string) (string) (HString) (char*)
File name of the external camera parameters.
Default value:
'campose.dat'
"campose.dat"
"campose.dat"
"campose.dat"
"campose.dat"
Suggested values: 'campose.dat'"campose.dat""campose.dat""campose.dat""campose.dat", 'campose_initial.dat'"campose_initial.dat""campose_initial.dat""campose_initial.dat""campose_initial.dat", 'campose_final.dat'"campose_final.dat""campose_final.dat""campose_final.dat""campose_final.dat"
File extension: .dat
PosePosePosePosepose
(output_control) pose →
HPose, HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
3D pose.
Number of elements: 7
Result
read_poseread_poseReadPoseReadPoseReadPose
returns 2 (H_MSG_TRUE) if all parameter values are
correct and the file has been read successfully. If necessary an
exception is raised.
Possible Predecessors
read_cam_parread_cam_parReadCamParReadCamParReadCamPar
Possible Successors
pose_to_hom_mat3dpose_to_hom_mat3dPoseToHomMat3dPoseToHomMat3dPoseToHomMat3d
,
camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibration
,
disp_caltabdisp_caltabDispCaltabDispCaltabDispCaltab
,
sim_caltabsim_caltabSimCaltabSimCaltabSimCaltab
See also
create_posecreate_poseCreatePoseCreatePoseCreatePose
,
find_marks_and_posefind_marks_and_poseFindMarksAndPoseFindMarksAndPoseFindMarksAndPose
,
camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibration
,
disp_caltabdisp_caltabDispCaltabDispCaltabDispCaltab
,
sim_caltabsim_caltabSimCaltabSimCaltabSimCaltab
,
write_posewrite_poseWritePoseWritePoseWritePose
,
pose_to_hom_mat3dpose_to_hom_mat3dPoseToHomMat3dPoseToHomMat3dPoseToHomMat3d
,
hom_mat3d_to_posehom_mat3d_to_poseHomMat3dToPoseHomMat3dToPoseHomMat3dToPose
Module
Foundation