Topomaker.h

Go to the documentation of this file.

// Copyright Epic Games, Inc. All Rights Reserved.
#pragma once
 
#include "Core/Types.h"
 
#ifdef CADKERNEL_DEV
#include "Topo/TopomakerReport.h"
#endif
 
namespace UE::CADKernel
{
 
class FModel;
class FSession;
class FShell;
class FTopologicalEdge;
class FTopologicalFace;
class FTopologicalVertex;
 
enum class ESewOption : uint8
{
    None = 0x00u,   // No flags.
 
    ForceJoining = 0x01u,
    RemoveThinFaces = 0x02u, 
    RemoveDuplicatedFaces = 0x04u,
 
    All = 0x07u
};
 
ENUM_CLASS_FLAGS(ESewOption);
 
namespace SewOption
{
 
static ESewOption GetFromOptions(bool bGStitchingForceSew, bool bGStitchingRemoveThinFaces, bool bGStitchingRemoveDuplicatedFaces)
{
    ESewOption Option = ESewOption::None;
 
    if (bGStitchingForceSew)
    {
        Option |= ESewOption::ForceJoining;
    }
 
    if (bGStitchingRemoveThinFaces)
    {
        Option |= ESewOption::RemoveThinFaces;
    }
 
    if (bGStitchingRemoveDuplicatedFaces)
    {
        Option |= ESewOption::RemoveDuplicatedFaces;
    }
 
    return Option;
}
 
}
 
namespace TopomakerTools
{
 
void MergeCoincidentVertices(TArray<FTopologicalVertex*>& VerticesToMerge, double Tolerance);
 
}
 
struct FTopomakerOptions
{
    ESewOption SewOptions;
    double Tolerance;
    double ForceJoinFactor;
 
    FTopomakerOptions(ESewOption InSewOptions, double InTolerance, double InForceJoinFactor)
        : SewOptions(InSewOptions)
        , Tolerance(InTolerance)
        , ForceJoinFactor(InForceJoinFactor)
    {}
};
 
 
class CADKERNEL_API FTopomaker
{
 
protected:
 
    FSession& Session;
 
    TArray<FShell*> Shells;
    TArray<TSharedPtr<FTopologicalFace>> Faces;
 
#ifdef CADKERNEL_DEV
    FTopomakerReport Report;
#endif
 
public:
 
    FTopomaker(FSession& InSession, const FTopomakerOptions& InOptions);
    FTopomaker(FSession& InSession, const TArray<TSharedPtr<FShell>>& Shells, const FTopomakerOptions& InOptions);
    FTopomaker(FSession& InSession, const TArray<TSharedPtr<FTopologicalFace>>& Faces, const FTopomakerOptions& InOptions);
 
    void SetTolerance(const FTopomakerOptions Options)
    {
        SewOptions = Options.SewOptions;
        Tolerance = Options.Tolerance;
        ForceJoinFactor = Options.ForceJoinFactor;
 
        SewTolerance = Tolerance * UE_DOUBLE_SQRT_2;
 
        // StartVertex (SV) is linked to TwinStartVertex (TSV), the max distance between vertices is SewTolerance
        // EndVertex (EV) is linked to TwinEndVertex (TEV), the max distance between vertices is SewTolerance
        //
        //           * TSV * TEV
        //     SV *-----------* EV
        // So the max length is 2*SewTolerance
        EdgeLengthTolerance = SewTolerance * 2.;
 
        SewToleranceToForceJoin = Tolerance * ForceJoinFactor;
        LargeEdgeLengthTolerance = SewToleranceToForceJoin * 2.;
 
        ThinFaceWidth = Tolerance * ForceJoinFactor * 0.5;
    }
 
    void Sew();
 
    void SplitIntoConnectedShells();
 
    void OrientShells();
 
    void UnlinkNonManifoldVertex();
 
    void UnlinkFromOther();
 
    void RemoveThinFaces();
 
    void DeleteNonmanifoldLink();
 
#ifdef CADKERNEL_DEV
    void PrintSewReport()
    {
        Report.PrintSewReport();
    }
 
    void PrintRemoveThinFacesReport()
    {
        Report.PrintRemoveThinFacesReport();
    }
#endif
 
private:
 
    void InitFaces();
 
    void EmptyShells();
 
    void RemoveEmptyShells();
 
    void RemoveDuplicatedFaces();
 
    void GetVertices(TArray<FTopologicalVertex*>& Vertices);
 
    void GetBorderVertices(TArray<FTopologicalVertex*>& BorderVertices);
 
    void CheckSelfConnectedEdge(double MaxLengthOfDegeneratedEdge, TArray<FTopologicalVertex*>& OutBorderVertices);
    void RemoveIsolatedEdges(); // Useful ???
 
    void SetSelfConnectedEdgeDegenerated(TArray<FTopologicalVertex*>& Vertices);
 
    void MergeUnconnectedSuccessiveEdges();
 
    void SetToProcessMarkerOfFaces();
    void ResetMarkersOfFaces();
 
private:
 
    ESewOption SewOptions;
 
    double Tolerance;
    double ForceJoinFactor;
 
    double SewTolerance;
    double SewToleranceToForceJoin; // SewTolerance x ForceJoinFactor;
 
    double EdgeLengthTolerance; // 2x SewTolerance
    double LargeEdgeLengthTolerance; // 2x SewToleranceToForceJoin
 
    double ThinFaceWidth;
};
 
} // namespace UE::CADKernel