Constructs a point group from a point cloud.
Input Arguments
0 |
Collection Object Name |
Cloud Name |
The name of the point cloud to use as the source. |
1 |
Collection Object Name |
Point Group Name |
The name of the point group into which to place the resulting points. |
2 |
String |
Point Prefix |
A prefix applied to each point name. |
3 |
Integer |
Starting Point Number |
The index at which to start numbering the result- ing points. |
4 |
Double |
Point Offset |
The planar/radial offset to assign to each resulting point. |
5 |
Boolean |
Sub-Sampling? |
Specify whether to sub-sample the point cloud when creating the points. |
6 |
Double |
Sub-Sampling Distance |
If sub-sampling is enabled, indicates the mini- mum distance between the resulting points. |
7 |
Boolean |
Show Progress? |
Specify whether a progress bar should be dis- played while calculating results. |
Return Arguments
None.
Returned Status
SUCCESS |
The point group was created successfully. |
FAILURE |
The point cloud was not found. |
Remarks
If a resulting point group already exists, the specified points are added to the group. If any of the resulting point names already exists in the specified group, then they are sequenced to have a unique name.
Sub-sampling will ensure that each point in the resulting group is approximately, but no less than, the specified sub- sampling distance apart.