# ProfileFixtureFromTwoPoints3D

The ProfileFixtureFromTwoPoints3D 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 using two Point3D 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, and 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 ProfileFixtureFromTwoPoints3D requires a Profile3D structure and two Point3D structures as input.

The ProfileFixtureFromTwoPoints3D 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 ProfileFixtureFromTwoPoints3D function has the following syntax:

ProfileFixtureFromTwoPoints3D(ExternalProfile, Xp0, Zp0, ExternalPoint0, Xp1, Zp1, ExternalPoint1, Show)

See the table for a description of the available parameters.

Parameter | Description
External Profile | Specifies the Profile3D structure to use.
Profile Point 0 | Specifies the coordinates for the first profile point:
Xp0 | X-axis coordinate value for the profile point in the profile coordinate space.
Zp0 | Z-axis coordinate value for the profile point in the profile coordinate space.
Note: This parameter is available only if External Point 0 is set to 0.
External Point 0 | Specifies a reference to a Point3D structure defined in another cell. The function uses the Point3D structure as the first profile point. Set to 0 (OFF) to manually define the Point3D coordinates instead.
Profile Point 1 | Specifies the coordinates for the second profile point:
Xp1 | X-axis coordinate value for the profile point in the profile coordinate space.
Zp1 | Z-axis coordinate value for the profile point in the profile coordinate space.
Note: This parameter is available only if External Point 1 is set to 0.
External Point 1 | Specifies a reference to a Point3D structure defined in another cell. The function uses the Point3D structure as the second profile point. Set to 0 (OFF) to manually define the Point3D 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 ProfileFixtureFromTwoPoints3D 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
❒ProfileFixtureFromTwoPoints3D | GetX(ProfileFixtureFromTwoLines3D) | GetZ(ProfileFixtureFromTwoPoints3D) | GetAngle(ProfileFixtureFromTwoPoints3D)

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.