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
{
// Changes mesh:
// Fills all holes first, then:
// fixes undercuts via prolonging widest points down
// Requires to update RenderObject after using
// upDirection is in mesh space
// voxelSize -  size of voxel in mesh rasterization, precision grows with lower voxelSize
// bottomExtension - this parameter specifies how long should bottom prolongation be, if (bottomExtension <= 0) bottomExtension = 2*voxelSize
//   if mesh is not closed this is used to prolong hole and make bottom
//
// if voxelSize == 0.0f it will be counted automaticly
[[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 );
 
// Changes mesh:
// Fills all holes first, then:
// fixes undercuts (in selected area) via prolonging widest points down
// Requires to update RenderObject after using
// upDirection is in mesh space
// voxelSize -  size of voxel in mesh rasterization, precision grows with lower voxelSize
// bottomExtension - this parameter specifies how long should bottom prolongation be, if (bottomExtension <= 0) bottomExtension = 2*voxelSize
//   if mesh is not closed this is used to prolong hole and make bottom
//
// if voxelSize == 0.0f it will be counted automaticly
[[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 );
 
// Input - undercut faces, insertion direction
// Output - metric value
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
{
    // Hint direction which will be improved
    Vector3f hintDirection;
    // Radial step given in radians look improveDirection comment
    float baseAngleStep{5.0f*PI_F / 180.0f};
    // Maximum radial line given in radians look improveDirection comment
    float maxBaseAngle{30.0f*PI_F / 180.0f};
    // Polar angle step
    float polarAngleStep{20.0f*PI_F / 180.0f};
};
 
struct DistMapImproveDirectionParameters : ImproveDirectionParameters
{
    // Resolution of distance map, lower it is, faster score works
    Vector2i distanceMapResolution{100,100};
};
 
// Parallel finds best of several directions defined by ImproveDirectionParameters struct
[[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 );
}
}