Fixture3D

The Fixture3D function allows you to set up fixturing coordinates that can be used by other 3D Vision Tools.

It returns a Fixture3D structure containing the configured fixture coordinates.

The Fixture3D function has the following syntax:

Fixture3D(PointCloud,Fixture3D,Show)

Parameter Description

PointCloud

Reference to a cell containing a point cloud. The default value is $A$0.
Fixture3D

Specifies the point cloud coordinate system in which the 3D fixture is defined. It is offset from the PointCloud origin in the following format with the following arguments:

{X, Y, Z, Rotation, Tilt, TiltDirection}

X Offset on the X-axis from the PointCloud origin.
Y Offset on the Y-axis from the PointCloud origin.
Z Offset on the Z-axis from the PointCloud origin.
Rotation Specifies the in-plane rotation in degrees around the PointCloud Z-axis. The value range is -180 to 180. The tool normalizes external references with values outside the allowed range to the allowed range.
Tilt Specifies the tilt angle in degrees from the PointCloud Z-axis after rotation. The value range is 0-180. External references with values outside the allowed range result in an error.
Tilt Direction Specifies the direction of tilt in degrees from the rotated PointCloud X-axis of the tool, around the PointCloud Z-axis of the tool. The value range is -180 to 180. The tool normalizes external references with values outside the allowed range to the allowed range.
Note: The Fixture3D parameter is only available if you set External Fixture to 0.
Show

Selects the type of graphics to overlay on the image.

0 = hide all (default)

All graphics will be hidden, except when the cell containing the function is highlighted in the spreadsheet.

2 = input graphics only

The input data will be displayed at all times.

Returns

A Fixture3D structure containing the parameters of the configured fixture coordinates, or #ERR if any parameter has been configured incorrectly.

Results

When initially inserted into a cell, the following functions are automatically inserted into the spreadsheet to create a result table.

  X Y Z Rotation Tilt TiltDirection
❒Fixture3D GetX(Fixture3D) GetY(Fixture3D) GetZ(Fixture3D) GetRotation(Fixture3D) GetTilt(Fixture3D) GetTiltDirection(Fixture3D)

The following Structures 3D Vision Data Access functions are automatically inserted into the spreadsheet to create the result table:

Function Description
GetRotation(Fixture3D) Returns the rotation of the Z-axis in degrees, also known as the in-plane rotation.
GetTilt(Fixture3D) Returns the tilt angle of the Fixture3D structure in degrees on the Z-axis.
GetTiltDirection(Fixture3D) Returns the tilt direction angle of the specified Fixture3D structure in degrees. The angle is measured in the X-Y plane of the original reference coordinate system, and specifies the direction for the projection of the tilted Z-axis onto that plane.
GetX(Fixture3D) Returns the X-axis coordinate of the fixture's center point.
GetY(Fixture3D) Returns the Y-axis coordinate of the fixture's center point.
GetZ(Fixture3D) Returns the Z-axis coordinate of the fixture's center point.