1. Epic GamesDeveloper
  3. FMeshBevel

FMeshBevel

[FMeshBevel](API\Plugins\DynamicMesh\Operations\FMeshBevel) applies a "Bevel" operation to edges of a [FDynamicMesh3](API\Runtime\GeometryCore\DynamicMesh\FDynamicMesh3).

API > API/Plugins > API/Plugins/DynamicMesh > API/Plugins/DynamicMesh/Operations

References

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

Syntax

class FMeshBevel

Remarks

FMeshBevel applies a "Bevel" operation to edges of a FDynamicMesh3. Bevel is not strictly well-defined, there are a wide range of possible cases to handle and currently only some are supported. See this website for a discussion of many interesting cases (most are not currently supported): https://wiki.blender.org/wiki/User:Howardt/Bevel

The bevel operation is applied in-place to the input mesh. The bevel is mesh-topological, ie implemented by un-stitching mesh edges and inserting new triangles, rather than via booleans/etc.

Currently supports:

  • Bevel an isolated closed loop of edges, that edge-loop becomes a quad-strip (simplest case)
  • Bevel a set of open edge spans that may meet a T-junctions
  • if incoming-span-valence at a vertex is >= 3, vertex is replaced by a polygon
  • if incoming-span-valence at a vertex is 1, bevel is "terminated" by expanding the vertex into an edge (this is the messiest case)
  • vertex-on-boundary is a special case that is simpler
  • edge spans are replaced by quad-strips

Currently does not support:

  • Beveling an isolated vertex
  • partial bevels of a GroupTopology Edge
  • multiple-segment bevel (eg to do rounds/etc)
  • ???

Generally this FMeshBevel is intended to be applied to group-boundary "edges" in a FGroupTopology. However the FGroupTopology is currently only used in the initial setup, so other methods could be used to construct the bevel topology.

Currently "updating" the bevel shape, once the topology is known, is not supported, but could be implemented relatively easily, as all the relevant information is already tracked and stored.

Variables

  Type Name Description
Protected variable TArray< FBevelEdge > Edges  
Public variable double InsetDistance Inputs Distance that bevel edges/vertices are inset from their initial position.
Protected variable TArray< FBevelLoop > Loops  
Public variable EMaterialIDMode MaterialIDMode Which MaterialID assignment mode to use
Protected variable TMap< int32, int32 > MeshEdgePairs  
Public variable TArray< int32 > NewTriangles Outputs list of all new triangles created by the operation
Public variable int32 NumSubdivisions Number of subdivisions inserted in each bevel strip
Public variable FProgressCancel * Progress Set this member to support progress/cancel in the computations below
Public variable FGeometryResult ResultInfo Status of the operation, warnings/errors may be returned here
Public variable double RoundWeight "Roundness" of the bevel profile.
Public variable int32 SetConstantMaterialID Constant MaterialID used for various MaterialIDMode settings
Protected variable TMap< int32, int32 > VertexIDToIndexMap  
Protected variable TArray< FBevelVertex > Vertices  

Functions

  Type Name Description
Protected function void

AddBevelEdgeLoop ( const FDynamicMesh3& Mesh,
const FEdgeLoop& Loop
)

  
Protected function void

AddBevelGroupEdge ( const FDynamicMesh3& Mesh,
const FGroupTopology& Topology,
int32 GroupEdgeID
)

 Setup phase: register Edges (spans) and (isolated) Loops that need to be beveled and precompute/store any mesh topology that must be tracked across the operation Required BevelVertex's are added by AddBevelGroupEdge() Once edges are configured, BuildVertexSets() is called to precompute the vertex topological information
Protected function void  
Protected function void  
Protected function void  
Protected function void  
Protected function void  
Protected function void  
Protected function void  
Protected function void  
Protected function void  
Protected function void  
Public function bool

Apply ( FDynamicMesh3& Mesh,
FDynamicMeshChangeTracker* ChangeTracker
)

 Apply the bevel operation to the mesh, and optionally track changes
Protected function void  
Protected function void  
Protected function void  
Protected function void

BuildVertexSets ( const FDynamicMesh3& Mesh
)

  
Protected function void  
Protected function void  
Protected function void  
Protected function void Meshing phase - append quad-strips between unlinked edge spans/loops, polygons at junction vertices where required, and triangles at terminator vertices Meshing functions for chamfer bevel, ie no subdivisions
Protected function void Meshing functions for multi-segment bevel with optional round profile
Protected function void

DisplaceVertices ( FDynamicMesh3& Mesh,
double Distance
)

  
Protected function void  
Protected function FBevelVertex *

GetBevelVertexFromVertexID ( int32 VertexID,
int32* IndexOut
)

  
Public function void

InitializeFromGroupTopology ( const FDynamicMesh3& Mesh,
const FGroupTopology& Topology
)

 Initialize the bevel with all edges of the given GroupTopology
Public function void

InitializeFromGroupTopologyEdges ( const FDynamicMesh3& Mesh,
const FGroupTopology& Topology,
const TArray< int32 >& GroupEdges
)

 Initialize the bevel with the specified edges of a GroupTopology
Public function bool

InitializeFromGroupTopologyFaces ( const FDynamicMesh3& Mesh,
const FGroupTopology& Topology,
const TArray< int32 >& GroupFaces
)

 Initialize the bevel with the specified faces of a GroupTopology
Public function void

InitializeFromTriangleEdges ( const FDynamicMesh3& Mesh,
TConstArrayView< int32 > TriangleEdges
)

 Initialize the bevel with the specified mesh triangle edges
Public function void

InitializeFromTriangleEdges ( const FDynamicMesh3& Mesh,
TConstArrayView< int32 > TriangleEdges,
TFunctionRef< bool(int32)> IsCornerVertex
)

 Initialize the bevel with the specified mesh triangle edges
Public function bool

InitializeFromTriangleSet ( const FDynamicMesh3& Mesh,
const TArray< int32 >& Triangles
)

 Initialize the bevel with border loops of the selected triangles.
Protected function Const FInterpCurveVector

MakeArcSplineCurve ( const FVector3d& PosA,
FVector3d& NormalA,
const FVector3d& PosB,
FVector3d& NormalB
)

  
Protected function void  
Protected function void

UnlinkBevelLoop ( FDynamicMesh3& Mesh,
FBevelLoop& BevelLoop,
FDynamicMeshChangeTracker* ChangeTracker
)

  
Protected function void Unlink phase - disconnect triangles along bevel edges/loops, and at vertices.
Protected function void  
Protected function void  
Protected function void  
Protected function void  

Classes

  Type Name Description
Public struct FBevelEdge FBevelEdge is the accumulated data for an open span of mesh-edges, which possibly meets up with other bevel-edges at the vertices on either end of the span.  
Public struct FBevelLoop Current Bevel computation strategy is basically to fully precompute all the necessary info for the entire bevel, then "unlink" all the edges and vertices, and then stitch it all back together.  
Public struct FBevelVertex A FBevelVertex repesents/stores the accumulated data at a "bevel vertex", which is the mesh vertex at the end of a FBevelEdge.  
Public struct FBevelVertex_InteriorVertex    
Public struct FOneRingWedge A FOneRingWedge represents a sequential set of connected triangles around a vertex, ie a subset of an ordered triangle one-ring.  

Enums

  Type Name Description
Public enum EBevelVertexType A FBevelVertex can have various types, depending on the topology of the bevel edge graph and input mesh  
Public enum EMaterialIDMode Options for MaterialID assignment on the new triangles generated for the bevel  

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page