# ProfileFixtureFromTwoLines3D

The ProfileFixtureFromTwoLines3D function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. allows you to create profile fixture A fixture is a coordinate location on the image that keeps the tool in the place determined by the fixture. coordinates from the intersection point of two Line3D structures within a profile, tracking acquisition Acquisition is the process or result of the vision system acquiring a new image. translation along the Xp and Zp axes, but not tracking rotation along the Yp-axis.

3D Point Cloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition. | Profile View

The ProfileFixtureFromTwoLines3D requires a Profile3D structure and two Line3D structures as input.

The ProfileFixtureFromTwoLines3D function produces a ProfileFixture3D output, which you can use as an external profile fixture for 3D Profile feature extraction tools to ensure that the tool extracts the same feature from the profile for each acquisition.

Inputs

The ProfileFixtureFromTwoLines3D function has the following syntax:

ProfileFixtureFromTwoLines3D(ExternalProfile, Xp0, Zp0, Xp1, Zp1, ExternalLine0, Xp0, Zp0, Xp1, Zp1, ExternalLine1, Show)

See the table for a description of the available parameters.

Parameter | Description
External Profile | Specifies the Profile3D structure to use.
Profile Line 0 | Specifies the start and end point coordinates for the first profile line to use:
Xp0 | X-axis coordinate value for the start point of the profile line in the profile coordinate space.
Zp0 | Z-axis coordinate value for the start point of the profile line in the profile coordinate space.
Xp1 | X-axis coordinate value for the end point of the profile line in the profile coordinate space.
Zp1 | Z-axis coordinate value for the end point of the profile line in the profile coordinate space.
Note: This parameter is available only if External Line 0 is set to 0.
External Line 0 | Specifies a reference to a Line3D structure defined in another cell. The function uses the Line3D structure as the first profile line. Set to 0 (OFF) to manually define the Line3D coordinates instead.
Profile Line 1 | Specifies the start and end point coordinates for the second profile line to use:
Xp0 | X-axis coordinate value for the start point of the profile line in the profile coordinate space.
Zp0 | Z-axis coordinate value for the start point of the profile line in the profile coordinate space.
Xp1 | X-axis coordinate value for the end point of the profile line in the profile coordinate space.
Zp1 | Z-axis coordinate value for the end point of the profile line in the profile coordinate space.
Note: This parameter is available only if External Line 1 is set to 0.
External Line 1 | Specifies a reference to a Line3D structure defined in another cell. The function uses the Line3D structure as the second profile line. Set to 0 (OFF) to manually define the Line3D coordinates instead.
Show | Selects the type of graphics to overlay on the image.
0 = hide all (default) | All graphics are hidden, except when the cell containing the function is highlighted in the spreadsheet.
1 = result graphics only | The result graphics of the function are displayed at all times.
2 = input and result graphics | The region of interest, the input data and the results are displayed at all times.

Outputs

Returns | A ProfileFixtureFromTwoLines3D data structure containing the profile fixture, or #ERR if any of the input parameters are invalid.
Results | When initially inserted into a cell, the following functions are automatically inserted into the spreadsheet to create a result table:
| Xp | Zp | Angle
❒ProfileFixtureFromTwoLines3D | GetX(ProfileFixtureFromTwoLines3D) | GetZ(ProfileFixtureFromTwoLines3D) | GetAngle(ProfileFixtureFromTwoLines3D)

Vision Data Access functions

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

Function | Description
GetX(ProfileFixture3D,index) | Returns the X-axis coordinate value of the profile fixture.
GetZ(ProfileFixture3D,index) | Returns the Z-axis coordinate value of the profile fixture.
GetAngle(ProfileFixture3D,index) | Returns the in-plane rotation along the Y-axis of the profile fixture.