MRFixUndercuts.h

Go to the documentation of this file.

#pragma once
#include "MRVoxelsFwd.h"
 
#include "MRMesh/MRVector3.h"
#include "MRMesh/MRVector2.h"
#include "MRMesh/MRConstants.h"
#include "MRMesh/MRExpected.h"
#include <functional>
 
namespace MR
{
 
namespace FixUndercuts
{
[[deprecated( "Use fix( mesh, params )" )]]
MRVOXELS_API MR_BIND_IGNORE Expected<void> fixUndercuts( Mesh& mesh, const Vector3f& upDirection, float voxelSize = 0.0f, float bottomExtension = 0.0f );
 
[[deprecated( "Use fix( mesh, params )" )]]
MRVOXELS_API MR_BIND_IGNORE Expected<void> fixUndercuts( Mesh& mesh, const FaceBitSet& selectedArea, const Vector3f& upDirection, float voxelSize = 0.0f, float bottomExtension = 0.0f );
 
struct FindParams
{
    Vector3f upDirection;
 
    float wallAngle = 0.0f;
};
 
struct FixParams
{
    FindParams findParameters;
 
    float voxelSize = 0.0f;
 
    float bottomExtension = 0.0f;
 
    const FaceBitSet* region = nullptr;
 
    bool smooth = false;
 
    ProgressCallback cb;
};
 
MRVOXELS_API Expected<void> fix( Mesh& mesh, const FixParams& params );
 
using UndercutMetric = std::function<double( const FaceBitSet&, const FindParams& params )>;
 
[[nodiscard]] MRVOXELS_API UndercutMetric getUndercutAreaMetric( const Mesh& mesh );
 
[[nodiscard]] MRVOXELS_API UndercutMetric getUndercutAreaProjectionMetric( const Mesh& mesh );
 
[[deprecated( "Use find( mesh, params)" )]]
MRVOXELS_API MR_BIND_IGNORE void findUndercuts( const Mesh& mesh, const Vector3f& upDirection, FaceBitSet& outUndercuts );
[[deprecated( "Use find( mesh, params )" )]]
MRVOXELS_API MR_BIND_IGNORE void findUndercuts( const Mesh& mesh, const Vector3f& upDirection, VertBitSet& outUndercuts );
 
[[deprecated( "Use find( mesh, params, metric )" )]]
[[nodiscard]] MRVOXELS_API MR_BIND_IGNORE double findUndercuts( const Mesh& mesh, const Vector3f& upDirection, FaceBitSet& outUndercuts, const UndercutMetric& metric );
 
MRVOXELS_API double find( const Mesh& mesh, const FindParams& params, FaceBitSet& outUndercuts, const UndercutMetric& metric = {} );
MRVOXELS_API void find( const Mesh& mesh, const FindParams& params, VertBitSet& outUndercuts );
 
[[nodiscard]] MRVOXELS_API double scoreUndercuts( const Mesh& mesh, const Vector3f& upDirection, const Vector2i& resolution );
 
struct ImproveDirectionParameters
{
    Vector3f hintDirection;
    float baseAngleStep{5.0f*PI_F / 180.0f};
    float maxBaseAngle{30.0f*PI_F / 180.0f};
    float polarAngleStep{20.0f*PI_F / 180.0f};
};
 
struct DistMapImproveDirectionParameters : ImproveDirectionParameters
{
    Vector2i distanceMapResolution{100,100};
};
 
[[nodiscard]] MRVOXELS_API Vector3f improveDirection( const Mesh& mesh, const ImproveDirectionParameters& params, const UndercutMetric& metric );
[[nodiscard]] MRVOXELS_API Vector3f distMapImproveDirection( const Mesh& mesh, const DistMapImproveDirectionParameters& params );
}
}