convert_pose_typeT_convert_pose_typeConvertPoseTypeConvertPoseType (Operator)
Name
convert_pose_typeT_convert_pose_typeConvertPoseTypeConvertPoseType — Change the representation type of a 3D pose.
Signature
void ConvertPoseType(const HTuple& PoseIn, const HTuple& OrderOfTransform, const HTuple& OrderOfRotation, const HTuple& ViewOfTransform, HTuple* PoseOut)
HPose HPose::ConvertPoseType(const HString& OrderOfTransform, const HString& OrderOfRotation, const HString& ViewOfTransform) const
HPose HPose::ConvertPoseType(const char* OrderOfTransform, const char* OrderOfRotation, const char* ViewOfTransform) const
HPose HPose::ConvertPoseType(const wchar_t* OrderOfTransform, const wchar_t* OrderOfRotation, const wchar_t* ViewOfTransform) const
(Windows only)
Description
convert_pose_typeconvert_pose_typeConvertPoseTypeConvertPoseTypeConvertPoseType converts the 3D pose PoseInPoseInPoseInPoseInposeIn into
a 3D pose PoseOutPoseOutPoseOutPoseOutposeOut with a different representation type. See
create_posecreate_poseCreatePoseCreatePoseCreatePose for details about 3D poses, their representation
types, and the meaning of the parameters OrderOfTransformOrderOfTransformOrderOfTransformOrderOfTransformorderOfTransform,
OrderOfRotationOrderOfRotationOrderOfRotationOrderOfRotationorderOfRotation, and ViewOfTransformViewOfTransformViewOfTransformViewOfTransformviewOfTransform.
Note that convert_pose_typeconvert_pose_typeConvertPoseTypeConvertPoseTypeConvertPoseType only changes the representation of a 3D
pose, but not the rigid transformation described by the pose.
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
PoseInPoseInPoseInPoseInposeIn (input_control) pose → HPose, HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Original 3D pose.
Number of elements: 7
OrderOfTransformOrderOfTransformOrderOfTransformOrderOfTransformorderOfTransform (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Order of rotation and translation.
Default value:
'Rp+T'
"Rp+T"
"Rp+T"
"Rp+T"
"Rp+T"
Suggested values: 'Rp+T'"Rp+T""Rp+T""Rp+T""Rp+T", 'R(p-T)'"R(p-T)""R(p-T)""R(p-T)""R(p-T)"
OrderOfRotationOrderOfRotationOrderOfRotationOrderOfRotationorderOfRotation (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Meaning of the rotation values.
Default value:
'gba'
"gba"
"gba"
"gba"
"gba"
Suggested values: 'gba'"gba""gba""gba""gba", 'abg'"abg""abg""abg""abg", 'rodriguez'"rodriguez""rodriguez""rodriguez""rodriguez"
ViewOfTransformViewOfTransformViewOfTransformViewOfTransformviewOfTransform (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
View of transformation.
Default value:
'point'
"point"
"point"
"point"
"point"
Suggested values: 'point'"point""point""point""point", 'coordinate_system'"coordinate_system""coordinate_system""coordinate_system""coordinate_system"
PoseOutPoseOutPoseOutPoseOutposeOut (output_control) pose → HPose, HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
3D transformation.
Number of elements: 7
Example (HDevelop)
* Define a pose.
create_pose (0.1, 0.1, 0.1, 90, 90, 90, 'Rp+T', 'gba', 'point', Pose)
* Convert pose to a pose with desired semantic.
convert_pose_type (Pose, 'Rp+T', 'abg', 'point', Pose2)
Example (HDevelop)
* Define a pose.
create_pose (0.1, 0.1, 0.1, 90, 90, 90, 'Rp+T', 'gba', 'point', Pose)
* Convert pose to a pose with desired semantic.
convert_pose_type (Pose, 'Rp+T', 'abg', 'point', Pose2)
Example (HDevelop)
* Define a pose.
create_pose (0.1, 0.1, 0.1, 90, 90, 90, 'Rp+T', 'gba', 'point', Pose)
* Convert pose to a pose with desired semantic.
convert_pose_type (Pose, 'Rp+T', 'abg', 'point', Pose2)
Example (HDevelop)
* Define a pose.
create_pose (0.1, 0.1, 0.1, 90, 90, 90, 'Rp+T', 'gba', 'point', Pose)
* Convert pose to a pose with desired semantic.
convert_pose_type (Pose, 'Rp+T', 'abg', 'point', Pose2)
Example (HDevelop)
* Define a pose.
create_pose (0.1, 0.1, 0.1, 90, 90, 90, 'Rp+T', 'gba', 'point', Pose)
* Convert pose to a pose with desired semantic.
convert_pose_type (Pose, 'Rp+T', 'abg', 'point', Pose2)
Result
convert_pose_typeconvert_pose_typeConvertPoseTypeConvertPoseTypeConvertPoseType returns 2 (H_MSG_TRUE) if all parameter values are
correct. If necessary, an exception is raised.
Possible Predecessors
create_posecreate_poseCreatePoseCreatePoseCreatePose,
hom_mat3d_to_posehom_mat3d_to_poseHomMat3dToPoseHomMat3dToPoseHomMat3dToPose,
camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibration,
hand_eye_calibrationhand_eye_calibrationHandEyeCalibrationHandEyeCalibrationHandEyeCalibration
Possible Successors
write_posewrite_poseWritePoseWritePoseWritePose
See also
create_posecreate_poseCreatePoseCreatePoseCreatePose,
get_pose_typeget_pose_typeGetPoseTypeGetPoseTypeGetPoseType,
write_posewrite_poseWritePoseWritePoseWritePose,
read_poseread_poseReadPoseReadPoseReadPose
Module
Foundation