🔷Configure 3D ROI

Function Description

Configure and adjust three-dimensional ROI. In the operator’s parameter panel, configure ROI position, size, and orientation through direct input of ROI data or through visual drag operations. When the operator runs, it will use the ROI finally configured in the parameters to crop the input point cloud.

Usage Scenarios

Adjust ROI: Configure ROI through input parameters or visual adjustment, rather than upstream inputs, facilitating debugging or template-based configuration.

Input Output

Input

Point Cloud: Input point cloud or point cloud list to be cropped.

ROI3DAdjust input

Output

ROI Cropped Point Cloud: Point cloud list after cropping with the ROI configured in parameters.

3D ROI: ROI configured in parameters.

ROI3DAdjust output

Parameter Description

  • The main difference between this operator and the "Point Cloud ROI" operator is the source of ROI: this operator’s ROI is directly configured by users in parameters, while the "Point Cloud ROI" operator’s ROI comes from upstream Epic Pro software.

  • This operator has two versions:

    • Configure 3D ROI: Processes point clouds without normal information.

    • Configure 3D ROI (with normals): Processes point clouds with normal information.

Both have essentially identical core functions and parameters, differing only in the type of point cloud data they process.

3D ROI

Parameter Description

Used to define the spatial range and pose of ROI, can input data or perform visual adjustment.

Parameter Adjustment

  • Directly input data, or paste data.

  • Click the "eye" button in the upper right corner to open the edit view for visual editing.

ROI3DAdjust 1

Keep Original Size

Parameter Description

Controls whether the output point cloud maintains the original input structure.

Parameter Adjustment

  • Disabled (default): Does not maintain order, i.e., the output point cloud only contains valid points inside (or outside) the ROI, forming an unordered point list.

  • Enabled: Maintains order, i.e., the output point cloud shape is the same as input, with points outside the ROI filled with invalid NaN values. Note that subsequent operators should be able to handle NaN values.

Enable Reverse

Parameter Description

Reverses the filtering logic.

Parameter Adjustment

  • Disabled (default): Keep points inside the ROI, remove points outside the ROI.

  • Enabled: Keep points outside the ROI, remove points inside the ROI.

Merge Output Point Cloud

Parameter Description

When the input contains multiple point clouds, controls whether to merge all filtered results into a single point cloud output.

Parameter Adjustment

  • Disabled (default): If the input is a point cloud list, the output is also a list where each element is the result of the corresponding input point cloud after ROI filtering.

  • Enabled: If the input is a point cloud list, all filtered point clouds (results of each input point cloud after applying ROI) are merged into one large point cloud output.