# PlotFixture3D

The PlotFixture3D function allows you to draw a 3D fixture.

It returns a Plot structure containing the settings of the drawn 3D fixture.

# PlotFixture3D Inputs

The PlotFixture3D function has the following syntax:

PlotFixture3D(PointCloud,Fixture3D,ExternalFixture,Name,Color,Transparency,Show)

Parameter | Description
PointCloud | Reference to a cell containing a point cloud. The default value is $A$0.
Fixture3D | Specifies the point cloud coordinate system in which the 3D fixture is defined. It is offset from the PointCloud origin in the following format with the following arguments: {X, Y, Z, Rotation, Tilt, TiltDirection}
X | Offset on the X-axis from the PointCloud origin.
Y | Offset on the Y-axis from the PointCloud origin.
Z | Offset on the Z-axis from the PointCloud origin.
Rotation | Specifies the in-plane rotation in degrees around the PointCloud Z-axis. The value range is -180 to 180. The tool normalizes external references with values outside the allowed range to the allowed range.
Tilt | Specifies the tilt angle in degrees from the PointCloud Z-axis after rotation. The value range is 0-180. External references with values outside the allowed range result in an error.
Tilt Direction | Specifies the direction of tilt in degrees from the rotated PointCloud X-axis of the tool, around the PointCloud Z-axis of the tool. The value range is -180 to 180. The tool normalizes external references with values outside the allowed range to the allowed range.
Note: The Fixture3D parameter is only available if you set External Fixture to 0.
External Fixture | Specifies a reference to a Fixture3D structure defined in another cell. The function uses the referenced cell as the fixture of the function. Set to 0 (OFF) to use the internal fixture of the function instead.
Name | The label of the plotted structure. The configured string appears next to the structure.
Color | Specifies the color of the fixture's name (configured with the Name parameter).
Transparency | Specifies the transparency of the fixture's label (configured with the Name parameter). The value range of the property is 0 – 100 (from no transparency to complete transparency), and the default value is 0 (meaning no transparency).
Show | Selects the display mode.
0 (Unchecked) = Off | The structure will be hidden, except when the cell containing the function is highlighted in the spreadsheet.
1 (Checked) = On (default) | The structure will be displayed at all times.

# PlotFixture3D Outputs

Returns | A Plot structure that allows you to modify the plotted Fixture3D structure.
Results | When inserted into a cell, a ❒Plot structure is created, containing the settings of the 3D fixture drawn in the point cloud when the job is Online.