VDefToolXYZUVW Statement

Applies To
Vision Calibration

Description
VDefToolXYZUVW calculates tool UVW offset values using three tool definitions.

Usage

VDefToolXYZUVW  ToolNumber1, ToolNumber2, ToolNumber3, ToolType

ToolNumber1

Integer representing a tool number for tool definition 1 (1 to 15).

When ToolType is bar, specify the tool that defines the tip of the bar. When ToolType is plane, specify the tool that defines the center of the plane.

ToolNumber2

Integer representing a tool for tool definition

2 (1 to 15)

.

When ToolType is bar, specify the tool that defines the middle of the bar. When ToolType is plane, specify the tool that defines a position on the plane other than the center of the plane and other than the position defined by tool definition 3.

ToolNumber3

Integer representing a tool number for tool definition

3 (1 to 15)

.

When ToolType is bar, specify the tool that defines the root of the bar. When ToolType is plane, specify the tool that defines a position other than the center of the plane and other than the position defined by tool definition 2.

ToolType

Integer variable representing a tool type.

VISION_DEFTOOL3D_BAR: Type of bar. VISION_DEFTOOL3D_PLANE: Type of plane.

Remarks
VDefToolXYZUVW calculates tool UVW offset values using three tool definitions. The calculated U, V, W tool offset values are set in the specified ToolNumber1. The X, Y, Z offsets for ToolNumber1 are not changed.

• ToolDefType is Bar: The vector connecting ToolNumber2 and 3 is set as the pose of ToolNumber1.
• ToolDefType is Plane: The plane normal consisting of ToolNumber1, 2, and 3 is set as the pose of ToolNumber1.

Example

'Calculate the position offsets of the tool tip marker.
VDefToolXYZ 1, 0, 1, 2, seq01, seq02, 5, 30, 1, 5, 5
'Calculate the position offsets of tool middle marker.
VDefToolXYZ 2, 0, 3, 4, seq03, seq04, 5, 30, 1, 5, 5
'Calculate the position offsets of tool root marker.
VDefToolXYZ 3, 0, 5, 6, seq05, seq06, 5, 30, 1, 5, 5
'Calculate the pose offset of the tool and define tool number 1.
VDefToolXYZUVW 1, 2, 3, VISION_DEFTOOL3D_BAR

See Also
VDefToolXYZ Statement