# LineFromProfile3D

The LineFromProfile3D function is used to construct a line segment from two 3D Cross-Section Functions Profile3D input points. The constructed line segment is returned as a Line3D structure.

Inputs

The LineFromProfile3D function has the following syntax:

LineFromProfile3D(ExternalProfile,Xp0,Zp0,Xp1,Zp1,Show)

See the table for a description of the available parameters.

Parameter | Description
External Profile | Specifies a reference to a Profile3D defined in another cell.
Xp0 | X offset from the Profile origin, in real-world units.
Zp0 | Z offset from the Profile origin, in real-world units.
Xp1 | X offset from the Profile origin, in real-world units.
Zp1 | Z offset from the Profile origin, in real-world units.
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 Line3D data structure as the projected 3D line, 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.
| X0 | Y0 | Z0 | X1 | Y1 | Z1
❒Line3D | GetX(Line3D, 0) | GetY(Line3D, 0) | GetZ(Line3D, 0) | GetX(Line3D, 1) | GetY(Line3D, 1) | GetZ(Line3D, 1)

Vision Data Access functions

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

Function | Description
GetX(Line3D, index) | Returns the X-axis coordinate of the 3D line point specified with the index. An index value of 0 indicates the first endpoint of the line, while a value of 1 indicates its second endpoint.
GetY(Line3D, index) | Returns the Y-axis coordinate of the 3D line point specified with the index. An index value of 0 indicates the first endpoint of the line, while a value of 1 indicates its second endpoint.
GetZ(Line3D, index) | Returns the Z-axis coordinate of the 3D line point specified with the index. An index value of 0 indicates the first endpoint of the line, while a value of 1 indicates its second endpoint.