convert_pose_typeT_convert_pose_typeConvertPoseTypeConvertPoseTypeconvert_pose_type (Operator)
Name
convert_pose_typeT_convert_pose_typeConvertPoseTypeConvertPoseTypeconvert_pose_type — 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_typeConvertPoseTypeConvertPoseTypeConvertPoseTypeconvert_pose_type converts the 3D pose PoseInPoseInPoseInPoseInposeInpose_in into
a 3D pose PoseOutPoseOutPoseOutPoseOutposeOutpose_out with a different representation type. See
create_posecreate_poseCreatePoseCreatePoseCreatePosecreate_pose for details about 3D poses, their representation
types, and the meaning of the parameters OrderOfTransformOrderOfTransformOrderOfTransformOrderOfTransformorderOfTransformorder_of_transform,
OrderOfRotationOrderOfRotationOrderOfRotationOrderOfRotationorderOfRotationorder_of_rotation, and ViewOfTransformViewOfTransformViewOfTransformViewOfTransformviewOfTransformview_of_transform.
Note that convert_pose_typeconvert_pose_typeConvertPoseTypeConvertPoseTypeConvertPoseTypeconvert_pose_type 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
PoseInPoseInPoseInPoseInposeInpose_in (input_control) pose → HPose, HTupleSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Original 3D pose.
Number of elements: 7
OrderOfTransformOrderOfTransformOrderOfTransformOrderOfTransformorderOfTransformorder_of_transform (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Order of rotation and translation.
Default value:
'Rp+T'
"Rp+T"
"Rp+T"
"Rp+T"
"Rp+T"
"Rp+T"
Suggested values: 'Rp+T'"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)""R(p-T)"
OrderOfRotationOrderOfRotationOrderOfRotationOrderOfRotationorderOfRotationorder_of_rotation (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Meaning of the rotation values.
Default value:
'gba'
"gba"
"gba"
"gba"
"gba"
"gba"
Suggested values: 'gba'"gba""gba""gba""gba""gba", 'abg'"abg""abg""abg""abg""abg", 'rodriguez'"rodriguez""rodriguez""rodriguez""rodriguez""rodriguez"
ViewOfTransformViewOfTransformViewOfTransformViewOfTransformviewOfTransformview_of_transform (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
View of transformation.
Default value:
'point'
"point"
"point"
"point"
"point"
"point"
Suggested values: 'point'"point""point""point""point""point", 'coordinate_system'"coordinate_system""coordinate_system""coordinate_system""coordinate_system""coordinate_system"
PoseOutPoseOutPoseOutPoseOutposeOutpose_out (output_control) pose → HPose, HTupleSequence[Union[int, float]]HTupleHtuple (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 (C++)
HTuple Pose, Pose2;
// Define a pose.
create_pose (0.1, 0.l, 0.l, 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_typeConvertPoseTypeConvertPoseTypeConvertPoseTypeconvert_pose_type returns TRUE if all parameter values are
correct. If necessary, an exception is raised.
Possible Predecessors
create_posecreate_poseCreatePoseCreatePoseCreatePosecreate_pose,
hom_mat3d_to_posehom_mat3d_to_poseHomMat3dToPoseHomMat3dToPoseHomMat3dToPosehom_mat3d_to_pose,
camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibrationcamera_calibration,
hand_eye_calibrationhand_eye_calibrationHandEyeCalibrationHandEyeCalibrationHandEyeCalibrationhand_eye_calibration
Possible Successors
write_posewrite_poseWritePoseWritePoseWritePosewrite_pose
See also
create_posecreate_poseCreatePoseCreatePoseCreatePosecreate_pose,
get_pose_typeget_pose_typeGetPoseTypeGetPoseTypeGetPoseTypeget_pose_type,
write_posewrite_poseWritePoseWritePoseWritePosewrite_pose,
read_poseread_poseReadPoseReadPoseReadPoseread_pose
Module
Foundation