# CylinderFromCircle2D

Constructs a 3D cylinder on the point-cloud from a 2D circle. Returns a Cylinder3D structure.

2D input | Cylinder3D output

Inputs

The CylinderFromCircle2D function has the following syntax:

CylinderFromCircle2D(PointCloud,Image,X,Y,Radius,ExternalCircle,AutoComputeZRange,ZCenter,Height,Show)

See the table for a description of the available parameters.

Parameter | Description
PointCloud | Reference to a cell containing a point cloud. The default value is $A$0.
Image | Reference to a cell containing an Image structure. The default value is $A$1.
Circle | Specifies the dimensions of the 2D circle. Double-click on the function name to move the circle on the image. Offsets from fixture origin.
X | Offset on the X-axis.
Y | Offset on the Y-axis.
Radius | Size of the circle.
External Circle | References a Circle2D structure. Set this parameter to 0 (OFF) if you define a new Circle2D structure with the Circle parameter.
Auto Compute Z Range | Computes the Z range using the 3D points within the 2D circle, and updates the values on the property sheet. Can speed up image acquisition.
Z Center | Adjusts the Cylinder3D structure on the Z-axis.
Height | Specifies the height of the Cylinder3D structure in millimeters.
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 Cylinder3D structure containing the parameters of the configured 3D cylinder.
Results | The following functions are automatically inserted into the spreadsheet to create a result table.
| Radius | Length | X | Y | Z | Tilt | Tilt Direction
❒Cylinder3D | GetRadius(Cylinder3D) | GetLength(Cylinder3D) | GetX(Cylinder3D) | GetY(Cylinder3D) | GetZ(Cylinder3D) | GetTilt(Cylinder3D) | GetTiltDirection(Cylinder3D)

Vision Data Access functions

Function | Description
GetRadius(Cylinder3D) | Returns the radius of the created 3D cylinder.
GetLength(Cylinder3D) | Returns the length (or height) of the created 3D cylinder.
GetX(Cylinder3D) | Returns the X-axis coordinate of the center of the 3D cylinder.
GetY(Cylinder3D) | Returns the Y-axis coordinate of the center of the 3D cylinder.
GetZ(Cylinder3D) | Returns the Z-axis coordinate of the center of the 3D cylinder.
GetTilt(Cylinder3D) | Returns the tilt angle of the Cylinder3D structure in degrees on the Z-axis.
GetTiltDirection(Cylinder3D) | Returns the tilt direction angle of the specified Cylinder3D structure in degrees. The angle is measured in the X-Y plane of the original reference coordinate system, and specifies the direction for the projection of the tilted Z-axis onto that plane.