# ProfileFixtureFromTwoPoints3D

The ProfileFixtureFromTwoPoints3D function allows you to create profile fixture coordinates using two Point3D structures within a profile, tracking acquisition translation along the Xp and Zp axes, and rotation along the Yp-axis.

3D Point Cloud | 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.

## ProfileFixtureFromTwoPoints3D 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.

## ProfileFixtureFromTwoPoints3D 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)

## ProfileFixtureFromTwoPoints3D Vision Data Access functions

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

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