1. Epic GamesDeveloper
  3. FMeshSimpleShapeApproximation

FMeshSimpleShapeApproximation

[FMeshSimpleShapeApproximation](API\Plugins\DynamicMesh\ShapeApproximation\FMeshSimpleShapeApproximation) can calculate various "simple" shape approximations for a set of meshes, by fitting various primitives/hulls/etc to each mesh.

API > API/Plugins > API/Plugins/DynamicMesh > API/Plugins/DynamicMesh/ShapeApproximation

References

   
Module DynamicMesh
Header /Engine/Plugins/Runtime/GeometryProcessing/Source/DynamicMesh/Public/ShapeApproximation/MeshSimpleShapeApproximation.h
Include #include "ShapeApproximation/MeshSimpleShapeApproximation.h"

Syntax

class FMeshSimpleShapeApproximation

Remarks

FMeshSimpleShapeApproximation can calculate various "simple" shape approximations for a set of meshes, by fitting various primitives/hulls/etc to each mesh. The assumption is that the input mesh(es) are already partitioned into pieces.

There are various Generate_X() functions which apply different strategies, generally to fit a containing simple shape or hull to the mesh. However in addition to these explicit strategies, input meshes that are very close to approximations of spheres/boxes/capsules (ie basically meshed versions of these primitives) can be identified and used directly, skipping the fitting process.

Variables

  Type Name Description
Public variable bool bDetectBoxes Should boxes be auto-detected
Public variable bool bDetectCapsules Should capsules be auto-detected
Public variable bool bDetectConvexes Should convex be auto-detected
Public variable bool bDetectSpheres Configuration parametersShould spheres be auto-detected
Public variable bool bSimplifyHulls Should hulls be simplified as a post-process
Public variable bool bUseExactComputationForBox  
Public variable double ConvexDecompositionErrorTolerance Error tolerance to guide convex decomposition (in cm); we stop adding new parts if the volume error is below the threshold.
Public variable int32 ConvexDecompositionMaxPieces How many convex pieces to target per mesh when creating convex decompositions.
Public variable double ConvexDecompositionMinPartThickness Minimum part thickness for convex decomposition (in cm); hulls thinner than this will be merged into adjacent hulls, if possible.
Public variable float ConvexDecompositionSearchFactor How much additional decomposition decomposition + merging to do, as a fraction of max pieces.
Public variable double HullSimplifyTolerance Simplification tolerance when simplifying 2D convex hulls, eg for swept/projected hulls
Public variable int32 HullTargetFaceCount Target number of triangles when simplifying 3D convex hulls
Public variable int32 LevelSetGridResolution Level Set Grid resolution along longest axis
Public variable double MinDimension Minimal dimension of fit shapes, eg thickness/radius/etc (currently only enforced in certain cases)
Protected variable TArray< FSourceMeshCache > SourceMeshCaches  
Protected variable TArray< const FDynamicMesh3 * > SourceMeshes  

Functions

  Type Name Description
Protected function void  
Public function void Approximation generators Fit containing axis-aligned boxes to each input mesh and store in ShapeSetOut
Public function void Fit containing approximate-minimum-volume capsules to each input mesh and store in ShapeSetOut
Public function void Calculate multiple 3D Convex Hulls for each input mesh and store in ShapeSetOut.
Public function void Calculate 3D Convex Hulls for each input mesh and store in ShapeSetOut.
Public function void  
Public function void Fit containing minimal-volume spheres to each input mesh and store in ShapeSetOut
Public function void Fit containing axis-aligned box, oriented box, capsule, and sphere to each input mesh, and store the one with smallest volume in ShapeSetOut
Public function void Fit containing minimal-volume oriented boxes to each input mesh and store in ShapeSetOut
Public function void Calculate Projected Convex Hulls for each input mesh and store in ShapeSetOut.
Protected function bool

GetDetectedSimpleShape ( const FSourceMeshCache& Cache,
FSimpleShapeSet3d& ShapeSetOut,
FCriticalSection& ShapeSetLock
)

  
Public function void

InitializeSourceMeshes ( const TArray< const FDynamicMesh3* >& InputMeshSet
)

 Setup/initialization Initialize internal mesh sets.

Classes

  Type Name Description
Protected struct FSourceMeshCache    

Enums

  Type Name Description
Public enum EProjectedHullAxisMode Type/Mode for deciding 3D axis to use in Generate_ProjectedHulls()  

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page