IF_CarrierConfiguration - SetProductOffset (Method)

Overview

Type:

Method

Available as of:

V1.0.0.0

Task

Setting the offset vector for the product center point.

Description

With the method SetProductOffset, you can specify the offset vector from the center point of the carrier to the center point of the product.
NOTE: If you install a tool for transporting a product on your carrier, the center point of the carrier is still the reference point for defining the product offset. (For more information on the tool settings, refer to the methods SetToolDimensions and SetToolOffset.)

Top view

Side view

  • The crossing red lines indicate the center of the carrier in X and Y direction.

  • The green box symbolizes the product to be transported by the carrier.

  • The red line indicates the height of the carrier in Z direction.

  • The green box symbolizes the product to be transported by the carrier.

For more information on the coordinate system of the carrier, refer to Carrier Coordinate System.

The product offset is used for calculating the rear offset and the front offset of the carrier based on the ToolDimensions and the ToolOffset as well as the ProductDimensions and the ProductOffset.

For more details on the properties lrRearOffset and lrFrontOffset, refer to the interface IF_CarrierFeedbackConfiguration.

Inputs

Input

Data type

Description

i_stProductOffset

PDL.ST_Vector3D

Specifies the center point of the product in relation to the center point of the carrier.

Outputs

Output

Data type

Description

q_xError

BOOL

Indicates TRUE if an error has been detected. For details, refer to q_etResult and q_sResultMsg.

q_etResult

ET_Result

Provides diagnostic and status information as a numeric value.
If q_xError = FALSE, q_etResult provides status information.
If q_xError = TRUE, q_etResult provides diagnostic/error information.

q_sResultMsg

STRING [255]

Provides additional diagnostic and status information as a text message.