# Region3DFromRegion2D

The Region3DFromRegion2D function allows you to construct a Region3D structure from a specified two-dimensional Region structure.

To use the Region3DFromRegion2D function:

1. Drag and drop the Region3DFromRegion2D function into the Spreadsheet.

2. In the property sheet that pops up, double-click the External Region parameter to open cell selection. Select the cell containing the Region structure you want the function to use.

3. Check the Auto Compute Z Range checkbox, or manually adjust the Z center offset and height of the Region3D output structure. The acquisition display shows a preview of the Region3D structure.

4. Click OK to finalize the settings.

Input

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. The default value is $A$1.
External Region | Specifies a reference to a Rectangle3D structure defined in another cell. The function uses the referenced cell for constructing the 3D structure.
Auto Compute Z Range | Enables or disables automatic Z range computing for the Region3D structure.
Z Center | Specifies the offset of the Region3D Z-axis center from the point cloud origin, in millimeters.
Height | Specifies the height of the Region3D 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.

Output

A Region3D structure.

Vision Data Access functions

The following Structures 3D FindPatMax3D Vision Data Access functions are automatically inserted into the spreadsheet to create the result table:

Function | Description
GetSizeX(Region3D) | Returns the size of the structure along the X-axis.
GetSizeY(Region3D) | Returns the size of the structure along the Y-axis.
GetSizeZ(Region3D) | Returns the size of the structure along the Z-axis.
GetCurve(Region3D) | Returns the angle-of-curvature value, in clockwise degrees.
GetX(Region3D) | Returns the X-axis coordinate of the specified structure's center point.
GetY(Region3D) | Returns the Y-axis coordinate of the specified structure's center point.
GetZ(Region3D) | Returns the Z-axis coordinate of the specified structure's center point.
GetRotation(Region3D) | Returns the rotation of the Z-axis in degrees, also known as the in-plane rotation.
GetTilt(Region3D) | Returns the tilt angle of the structure in degrees on the Z-axis.
GetTiltDirection(Region3D) | Returns the tilt direction angle of the specified 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.