# PlotArc3D

The PlotArc3D function allows you to draw an arc in the point cloud by specifying three points in the 3D space (acting as its start, mid- and end points, respectively).

It returns a Plot structure containing the settings of the plotted arc.

Inputs

The PlotArc3D function has the following syntax:

PlotBox3D(PointCloud,StartPoint3D,ExternalPoint0,MidPoint3D,ExternalPoint1,EndPoint3D,ExternalPoint2,Name,LineDrawingThickness,Color,Transparency,Show)

Parameter | Description
PointCloud | Reference to a cell containing a point cloud. The default value is $A$0.
Start Point3D | Specifies the offset of the 3D point to use as the arc's starting point. It is offset from the PointCloud origin in the following format with the following arguments: {X, Y, Z}
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.
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 of the spreadsheet to be used as the first point of the arc. Set to 0 (OFF) to use the function's internal Point3D structure instead.
Mid Point3D | Specifies the offset of the 3D point to use as the arc's midpoint. It is offset from the PointCloud origin in the following format with the following arguments: {X, Y, Z}
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.
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 of the spreadsheet to be used as the midpoint of the arc. Set to 0 (OFF) to use the function's internal Point3D structure instead.
End Point3D | Specifies the offset of the 3D point to use as the arc's end point. It is offset from the PointCloud origin in the following format with the following arguments: {X, Y, Z}
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.
Note: This parameter is available only if External Point 2 is set to 0.
External Point 2 | Specifies a reference to a Point3D structure defined in another cell of the spreadsheet to be used as the end point of the arc. Set to 0 (OFF) to use the function's internal Point3D structure instead.
Name | The label of the plotted structure. The configured string appears next to the structure.
Line Drawing Thickness | Specifies the thickness of the plotted arc's lines. The default value is 5.
Color | Specifies the color of the plotted graphic. Default: 0x32CD32, LimeGreen; max: 0xFFFFFF. Configure different colors by providing the hexadecimal color code in the formula bar or selecting a color from the color picker on the tool property sheet.
Transparency | Specifies the transparency of the drawn arc. 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.

Outputs

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