qM3C2Tools.h

Go to the documentation of this file.

// ----------------------------------------------------------------------------
// -                        CloudViewer: www.cloudViewer.org                  -
// ----------------------------------------------------------------------------
// Copyright (c) 2018-2024 www.cloudViewer.org
// SPDX-License-Identifier: MIT
// ----------------------------------------------------------------------------
 
#pragma once
 
// CV_CORE_LIB
#include <DgmOctree.h>
#include <GenericIndexedCloud.h>
#include <GenericProgressCallback.h>
 
class ccGenericPointCloud;
class NormsIndexesTableType;
class ccScalarField;
class ccPointCloud;
class ecvMainAppInterface;
 
class qM3C2Normals {
public:
 
    enum ComputationMode {
        DEFAULT_MODE = 0,  // compute normals on core points
        USE_CLOUD1_NORMALS = 1,
        MULTI_SCALE_MODE = 2,
        VERT_MODE = 3,
        HORIZ_MODE = 4,
        USE_CORE_POINTS_NORMALS = 5,
    };
 
 
    static bool ComputeCorePointsNormals(
            cloudViewer::GenericIndexedCloud* corePoints,
            NormsIndexesTableType* corePointsNormals,
            ccGenericPointCloud* sourceCloud,
            const std::vector<PointCoordinateType>& sortedRadii,
            bool& invalidNormals,
            int maxThreadCount = 0,
            ccScalarField* normalScale = nullptr,
            cloudViewer::GenericProgressCallback* progressCb = nullptr,
            cloudViewer::DgmOctree* inputOctree = nullptr);
 
    static bool UpdateNormalOrientationsWithCloud(
            cloudViewer::GenericIndexedCloud* normCloud,
            NormsIndexesTableType& normsCodes,
            cloudViewer::GenericIndexedCloud* orientationCloud,
            int maxThreadCount = 0,
            cloudViewer::GenericProgressCallback* progressCb = nullptr);
 
    static void MakeNormalsHorizontal(NormsIndexesTableType& normsCodes);
};
 
class qM3C2Tools {
public:
 
    static void ComputeStatistics(cloudViewer::DgmOctree::NeighboursSet& set,
                                  bool useMedian,
                                  double& meanOrMedian,
                                  double& stdDevOrIQR);
 
    struct GuessedParams {
        int preferredDimension = -1;
        double normScale = 0.0;
        double projScale = 0.0;
        double projDepth = 0.0;
    };
 
    static bool GuessBestParams(ccPointCloud* cloud1,
                                ccPointCloud* cloud2,
                                unsigned minPoints4Stats,
                                GuessedParams& params,
                                bool fastMode,
                                ecvMainAppInterface* app = nullptr,
                                unsigned probingCount = 1000);
};