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