Plane3D
The Plane3D function allows you to create a fixtured 3D plane in the point cloud.
It returns a Plane3D structure containing the settings of the fixtured 3D plane.
Plane3D Inputs
The Plane3D function has the following syntax:
Plane3D(PointCloud,Fixture3D,ExternalFixture,Plane3D,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. |
||||||||||||
Plane3D |
Specifies the offset and the angle of the plane to use. It is offset from the Fixture3D origin in the following format with the following arguments: {X, Y, Z, Tilt, TiltDirection}
|
||||||||||||
Show |
Selects the type of graphics to overlay on the image.
|
Plane3D Outputs
Returns |
A Plane3D data structure containing the constructed 3D plane, 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.
|
Plane3D 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(Plane3D) | Returns the X-axis coordinate of the 3D plane's center point. |
GetY(Plane3D) | Returns the Y-axis coordinate of the 3D plane's center point. |
GetZ(Plane3D) | Returns the Z-axis coordinate of the 3D plane's center point. |
GetTiltDirection(Plane3D) | Returns the constructed 3D plane's direction of tilt (in degrees) from the rotated Fixture3D X-axis about the Fixture3D Z-axis. |
GetTilt(Plane3D) | Returns the tilt angle of the constructed 3D plane (in degrees) on the Fixture3D Z-axis. |