Description
GenerateClusterConvexHullsFromLeafHulls (v1)
Generates cluster convex hulls for leafs hulls
Input(s) : ConvexCount - Maximum number of convex to generate for a specific cluster. Will be ignored if error tolerance is used instead 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. bAllowMergingLeafHulls - Also allow the same hull merging process to run on leaf hulls (merging hulls on leaves in the selection) 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 | FGenerateClusterConvexHullsFromLeafHullsDataflowNode |
Parameters
| Name | Description | Permitted Types | Default Value |
|---|---|---|---|
| bPreferExternalCollisionShapes | Whether to prefer available External (imported) collision shapes instead of the computed convex hulls on the Collection | bool | True |
| AllowMerges | Method to determine if the convex hulls from two separate bones can potentially be merged | EAllowConvexMergeMethod | ByProximity |
| 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 |
| 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 | () | |
| ConvexCount | Maximum number of convex to generate for a specific cluster. Will be ignored if error tolerance is used instead | int32 | 2 |
| 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 | () |
| bAllowMergingLeafHulls | Also allow the same hull merging process to run on leaf hulls (merging hulls on leaves in the selection) | bool | False |
| 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 |