Circle3D
The Circle3D function allows you to create a fixtured 3D circle in the point cloud.
It returns a Circle3D structure containing the settings of the fixtured 3D circle.
Circle3D Inputs
The Circle3D function has the following syntax:
Circle3D(PointCloud,Fixture3D,ExternalFixture,Circle3D,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}
Note: This parameter is available only if External Fixture is set to 0.
|
||||||||||||
External Fixture |
Specifies a reference to a Fixture3D structure defined in another cell to be used as the function's fixture. Set to 0 (OFF) to use the function's internal fixture instead. |
||||||||||||
Circle3D |
Specifies the dimensions, offset and angle of the function's 3D circle. It is offset from the Fixture3D origin in the following format with the following arguments: {Radius, X, Y, Z, Tilt, TiltDirection}
|
||||||||||||
Show |
Selects the type of graphics to overlay on the image.
|
Circle3D Outputs
Returns |
A Circle3D structure containing the parameters of the configured 3D circle. |
||||||||||||||
Results |
When initially inserted into a cell, the following functions are automatically inserted into the spreadsheet to create a result table.
|
Circle3D Vision Data Access Functions
The following 3D Vision Vision Data Access Functions are automatically inserted into the spreadsheet to create the result table:
Function | Description |
GetRadius(Circle3D) | Returns the radius of the 3D circle. |
GetTilt(Circle3D) | Returns the tilt angle of the 3D circle (in degrees) on the Fixture3D Z-axis as an integer. |
GetTiltDirection(Circle3D) | Returns the 3D circle's direction of tilt (in degrees) from the rotated Fixture3D X-axis about the Fixture3D Z-axis as an integer. |
GetX(Circle3D) | Returns the X-axis coordinate of the 3D circle's center point. |
GetY(Circle3D) | Returns the Y-axis coordinate of the 3D circle's center point. |
GetZ(Circle3D) | Returns the Z-axis coordinate of the 3D circle's center point. |