HandleWeightOperation.hpp

#pragma once
 
#include <Core/Animation/HandleWeight.hpp>
#include <Core/CoreMacros.hpp>
#include <Core/RaCore.hpp>
#include <Eigen/SparseCore>
#include <vector>
 
namespace Ra {
namespace Core {
namespace Animation {
 
/*
 * Return the WeightMatrix extracted from the MeshWeight vector, for a handle with handle_size
 * transforms
 */
RA_CORE_API WeightMatrix extractWeightMatrix( const MeshWeight& weight, const uint handle_size );
 
/*
 * Return the MeshWeight from the given WeightMatrix.
 */
RA_CORE_API MeshWeight extractMeshWeight( Eigen::Ref<const WeightMatrix> matrix );
 
/*
 * Return the WeightMatrix holding the partition of unity property.
 * This is obtained by normalizing each row by its l1-norm, assuming:
 *       weights( i, j ) >= 0
 *       lpNorm1( weights.row( i ) ) > 0
 */
RA_CORE_API WeightMatrix partitionOfUnity( Eigen::Ref<const WeightMatrix> weights );
 
/*
 * Return the index of the weight that influence the most the position of vertex at vertexId.
 */
RA_CORE_API uint getMaxWeightIndex( Eigen::Ref<const WeightMatrix> weights, const uint vertexID );
 
/*
 * Return the vector containing the index of the handle influencing the most a vertex.
 */
RA_CORE_API void getMaxWeightIndex( Eigen::Ref<const WeightMatrix> weights,
                                    std::vector<uint>& handleID );
 
/*
 * Call Math::checkInvalidNumbers and checkNoWeightVertex on the input matrix
 */
RA_CORE_API bool checkWeightMatrix( Eigen::Ref<const WeightMatrix> matrix,
                                    const bool FAIL_ON_ASSERT = false,
                                    const bool MT             = false );
 
RA_CORE_API bool checkNoWeightVertex( Eigen::Ref<const WeightMatrix> matrix,
                                      const bool FAIL_ON_ASSERT = false,
                                      const bool MT             = false );
 
RA_CORE_API bool normalizeWeights( Eigen::Ref<WeightMatrix> matrix, const bool MT = false );
 
} // namespace Animation
} // Namespace Core
} // Namespace Ra