# ProfileFixtureFromPoint3D

The ProfileFixtureFromPoint3D 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 a Point3D structure 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 ProfileFixtureFromPoint3D function requires a Profile3D structure and a Point3D structure as input.

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

ProfileFixtureFromPoint3D(ExternalProfile, Xp, Zp, ExternalPoint, Show)

See the table for a description of the available parameters.

Parameter | Description
External Profile | Specifies the Profile3D structure to use.
Profile Point | Specifies the coordinates for the profile point to use as a fixture:
Xp | X-axis coordinate value for the profile point in the profile coordinate space.
Zp | Z-axis coordinate value for the profile point in the profile coordinate space.
Note: This parameter is available only if External Point is set to 0.
External Point | Specifies a reference to a Point3D structure defined in another cell. 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 ProfileFixtureFromPoint3D 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
❒ProfileFixtureFromPoint3D | GetX(ProfileFixtureFromPoint3D) | GetZ(ProfileFixtureFromPoint3D) | GetAngle(ProfileFixtureFromPoint3D)

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.