MRMarchingCubes.h

Go to the documentation of this file.

#pragma once
 
#include "MRMeshFwd.h"
#include "MRAffineXf3.h"
#include "MRVoxelsVolume.h"
#include "MRProgressCallback.h"
#include "MRSignDetectionMode.h"
#include "MRExpected.h"
#include <climits>
 
namespace MR
{
 
// Callback type for positioning marching cubes vertices
// args: position0, position1, value0, value1, iso
using VoxelPointPositioner = std::function<Vector3f( const Vector3f&, const Vector3f&, float, float, float )>;
 
struct MarchingCubesParams
{
    Vector3f origin;
 
    ProgressCallback cb;
 
    float iso{ 0.0f };
 
    bool lessInside{ false };
 
    Vector<VoxelId, FaceId>* outVoxelPerFaceMap{ nullptr };
 
    VoxelPointPositioner positioner = {};
 
    int maxVertices = INT_MAX;
 
    enum class CachingMode
    {
        Automatic,
        None,
        Normal,
    } cachingMode = CachingMode::Automatic;
 
    std::function<void()> freeVolume;
};
 
// makes Mesh from SimpleVolume with given settings using Marching Cubes algorithm
MRMESH_API Expected<Mesh> marchingCubes( const SimpleVolume& volume, const MarchingCubesParams& params = {} );
MRMESH_API Expected<TriMesh> marchingCubesAsTriMesh( const SimpleVolume& volume, const MarchingCubesParams& params = {} );
 
#ifndef MRMESH_NO_OPENVDB
// makes Mesh from VdbVolume with given settings using Marching Cubes algorithm
MRMESH_API Expected<Mesh> marchingCubes( const VdbVolume& volume, const MarchingCubesParams& params = {} );
MRMESH_API Expected<TriMesh> marchingCubesAsTriMesh( const VdbVolume& volume, const MarchingCubesParams& params = {} );
#endif
 
// makes Mesh from FunctionVolume with given settings using Marching Cubes algorithm
MRMESH_API Expected<Mesh> marchingCubes( const FunctionVolume& volume, const MarchingCubesParams& params = {} );
MRMESH_API Expected<TriMesh> marchingCubesAsTriMesh( const FunctionVolume& volume, const MarchingCubesParams& params = {} );
 
} //namespace MR