Description
MergeConvexHulls (v1)
Merge convex hulls on transforms with multiple hulls
Input(s) : MaxConvexCount - Maximum number of convex to generate per transform. Ignored if < 0. ErrorTolerance - Error tolerance to use to decide to merge leaf convex together. This is in centimeters and represents the side of a cube, the volume of which will be used as threshold to know if the volume of the generated convex is too large compared to the sum of the volume of the leaf convex OptionalSelectionFilter - Optional transform selection to compute cluster hulls on -- if not provided, all cluster hulls will be computed. bProtectNegativeSpace - Whether to use a sphere cover to define negative space that should not be covered by convex hulls TargetNumSamples - Approximate number of spheres to consider when covering negative space. Only applicable with the Uniform Sample Method or if Require Search Sample Coverage is disabled. MinSampleSpacing - Minimum desired spacing between spheres; if > 0, will attempt not to place sphere centers closer than this NegativeSpaceTolerance - Amount of space to leave between convex hulls and protected negative space MinRadius - Spheres smaller than this are not included in the negative space
Output(s): SphereCovering - A representation of the negative space protected by the 'protect negative space' option. If negative space is not protected, this will contain zero spheres.
Information
| Module | GeometryCollectionNodes |
| Category | GeometryCollection|Utilities |
| Type | FMergeConvexHullsDataflowNode |
Parameters
| Name | Description | Permitted Types | Default Value |
|---|---|---|---|
| MergeProximityFilter | Filter to optionally only consider spatially close convex hulls for merges | EConvexHullProximityFilter | None |
| MergeProximityDistanceThreshold | If applying a convex hull proximity filter, the distance threshold to use for determining that two convex hulls are close enough to merge | float | 0.100000 |
| bComputeNegativeSpacePerBone | Whether to compute separate negative space for each bone. Otherwise, a single negative space will be computed once and re-used for all bones. | bool | False |
| SampleMethod | Method to use to find and sample negative space | ENegativeSpaceSampleMethodDataflowEnum | Uniform |
| bRequireSearchSampleCoverage | Whether to require that all candidate locations identified by Voxel Search are covered by negative space samples, up to the specified Min Sample Spacing. Only applies to Voxel Search. | bool | False |
| bOnlyConnectedToHull | When performing Voxel Search, only look for negative space that is connected out to the convex hull. This removes inaccessable internal negative space from consideration. Only applies to Voxel Search. | bool | False |
| DebugDrawRenderSettings | FDataflowNodeDebugDrawSettings | (RenderType=Wireframe,bTranslucent=True,Color=(R=0.000000,G=1.000000,B=0.000000,A=1.000000),LineWidthMultiplier=2.000000) | |
| bRandomizeColor | Randomize color per convex hull | bool | True |
| ColorRandomSeed | Random seed | int32 | 0 |
| SphereCoveringDebugDrawRenderSettings | FDataflowNodeSphereCoveringDebugDrawSettings | (bDisplaySphereCovering=False,RenderType=Wireframe,bTranslucent=True,LineWidthMultiplier=0.250000,ColorMethod=Single,Color=(R=1.000000,G=0.000000,B=0.000000,A=1.000000),ColorRandomSeed=0,ColorA=(R=1.000000,G=0.000000,B=0.000000,A=1.000000),ColorB=(R=0.000000,G=0.000000,B=1.000000,A=1.000000)) |
Inputs
| Name | Description | Permitted Types | Default Value |
|---|---|---|---|
| Collection | FManagedArrayCollection | () | |
| MaxConvexCount | Maximum number of convex to generate per transform. Ignored if < 0. | int32 | -1 |
| ErrorTolerance | Error tolerance to use to decide to merge leaf convex together. This is in centimeters and represents the side of a cube, the volume of which will be used as threshold to know if the volume of the generated convex is too large compared to the sum of the volume of the leaf convex | double | 0.000000 |
| OptionalSelectionFilter | Optional transform selection to compute cluster hulls on -- if not provided, all cluster hulls will be computed. | FDataflowTransformSelection | () |
| bProtectNegativeSpace | Whether to use a sphere cover to define negative space that should not be covered by convex hulls | bool | False |
| TargetNumSamples | Approximate number of spheres to consider when covering negative space. Only applicable with the Uniform Sample Method or if Require Search Sample Coverage is disabled. | int32 | 50 |
| MinSampleSpacing | Minimum desired spacing between spheres; if > 0, will attempt not to place sphere centers closer than this | double | 1.000000 |
| NegativeSpaceTolerance | Amount of space to leave between convex hulls and protected negative space | double | 2.000000 |
| MinRadius | Spheres smaller than this are not included in the negative space | double | 10.000000 |
Outputs
| Name | Description | Permitted Types | Default Value |
|---|---|---|---|
| Collection | FManagedArrayCollection | ||
| SphereCovering | A representation of the negative space protected by the 'protect negative space' option. If negative space is not protected, this will contain zero spheres. | FDataflowSphereCovering |