Rectangle3D
The Rectangle3D function allows you to create a fixtured 2D rectangle in the point cloud. It returns a Rectangle3D structure containing the settings of the fixtured rectangle.
Rectangle3D Inputs
The Rectangle3D function has the following syntax:
Rectangle3D(PointCloud,Fixture3D,ExternalFixture,Rectangle3D,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. |
||||||||||||||||
Rectangle3D |
Specifies the dimensions, offset and angle of the function's 3D rectangle. 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.
|
Rectangle3D Outputs
Returns |
A Rectangle3D structure containing the parameters of the configured rectangle, or #ERR if any parameter has been configured incorrectly. |
||||||||||||||||||
Results |
When initially inserted into a cell, the following functions are automatically inserted into the spreadsheet to create a result table.
|
Rectangle3D Data Access Functions
The following 3D Data Access functions are automatically inserted into the spreadsheet to create the result table:
Function | Description |
GetRotation(Rectangle3D) | Returns the rotation of the Rectangle3D structure (in degrees) about the Fixture3D Z-axis. |
GetSizeX(Rectangle3D) | Returns the X-axis size of the rectangle. |
GetSizeY(Rectangle3D) | Returns the Y-axis size of the rectangle. |
GetTilt(Rectangle3D) | Returns the tilt angle of the Rectangle3D structure (in degrees) on the Fixture3D Z-axis as an integer. |
GetTiltDirection(Rectangle3D) | Returns the Rectangle3D structure's direction of tilt (in degrees) from the rotated Fixture3D X-axis about the Fixture3D Z-axis as an integer |
GetX(Rectangle3D) | Returns the X-axis coordinate of the rectangle's center point. |
GetY(Rectangle3D) | Returns the Y-axis coordinate of the rectangle's center point. |
GetZ(Rectangle3D) | Returns the Z-axis coordinate of the rectangle's center point. |