convert_pose_typeT_convert_pose_typeConvertPoseTypeConvertPoseType (Operator)

Name

convert_pose_typeT_convert_pose_typeConvertPoseTypeConvertPoseType — Change the representation type of a 3D pose.

Signature

convert_pose_type( : : PoseIn, OrderOfTransform, OrderOfRotation, ViewOfTransform : PoseOut)

Herror T_convert_pose_type(const Htuple PoseIn, const Htuple OrderOfTransform, const Htuple OrderOfRotation, const Htuple ViewOfTransform, Htuple* PoseOut)

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)

static void HOperatorSet.ConvertPoseType(HTuple poseIn, HTuple orderOfTransform, HTuple orderOfRotation, HTuple viewOfTransform, out HTuple poseOut)

HPose HPose.ConvertPoseType(string orderOfTransform, string orderOfRotation, string viewOfTransform)

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

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