3D Bounding Box

Operator Function

For the selected point cloud, choose the type of bounding box to output, calculate and output the bounding box information.

Parameter Introduction

Input Parameters

Parameter	Range	Default Value	Description	Illustration
Input Image	0-8	0	IM number for image input

Calculation Parameters

Parameter	Range	Default Value	Description	Illustration
Use Region Parameters	true/false	false	If enabled, use Region as input; if disabled, use Input Image as input
Region	2D Window/2D Circular Window/2D Polygon Window/Box/Cylindrical Box/Rotated Box/Point Set (binding only)	Box	Manually select appropriate ROI region Can bind to select existing ROI region
Bounding Box Type	Axis-Aligned Bounding Box/Oriented Bounding Box	Axis-Aligned Bounding Box	Set the type of output bounding box. Axis-aligned bounding box is a cuboid with length, width, and height parallel to the three axes of the 3D coordinate system. Oriented bounding box is the minimum bounding cuboid of the point cloud.

Result Display

Parameter	Range	Default Value	Description	Illustration
Bounding Box	true/false	false	Display bounding box on 2D image

Output Parameters

Name	Type	Range	Description
Result	bool	true/false	true for success false for failure
Warning	bool	true/false	true indicates a warning false indicates no warning
Message	string		Output success, error, or warning messages. Empty if no error or warning.
Time	float		Operator execution time, unit: ms
bounding_box	group[]/orientedbox[]		Output bounding box. Axis-aligned bounding box outputs an array composed of length, width, height (length>width), start point, and end point of the box. Oriented bounding box outputs orientedbox[] type.

Tip

For more detailed explanations of parameter types, please refer to Type Definitions

Exception Troubleshooting

No.	Exception Information	Corresponding Parameter	Solution
1	Input region type is {0}, invalid region type	Region Type	Region input type must be one of: 2D Window/2D Circular Window/2D Polygon Window/Box/Cylindrical Box/Rotated Box/Point Set
2	Region is empty		1. Check if selection is empty 2. Check if point set is empty
3	Input point cloud is empty		Confirm if IM contains valid points. If no valid points, load point cloud or switch to IM with valid points
4	Input bounding box type is {0}, invalid bounding box type	Index	Confirm bounding box type is one of: Axis-Aligned Bounding Box/Oriented Bounding Box
5	Input polygon vertex count is less than 3, cannot form polygon		Add 2D polygon window vertices so that vertex count is at least three

Example Introduction

Engineering Design

1. Select the Load Point Cloud tool to load the required 3D point cloud image to IM0;

2. Select the 3D Bounding Box tool.

Tool Usage

3. Select the input image for the operation. The image number must match the IM number where the image is located in the project.

4. Either disable "Use Region Parameters" or enable region and select region type as Box, move the box to the position to be measured, enclosing the point cloud to be tested.

Usage Tips

1. Use the ROI controller on the image window to drag or scale the box;
2. Directly modify the box's start or end point coordinates in the calculation parameters to adjust the box position and size

5. Set the parameters.

6. Check the content you want to display in the result display section.

7. Click Test to check if the image window and parameters meet expectations.

8. If there are no issues, click Save. Run the operator in the run list, and then view the running results in the corresponding IM.

Axis-Aligned Bounding Box

Oriented Bounding Box