mirror of https://github.com/CGAL/cgal
81 lines
2.7 KiB
C++
81 lines
2.7 KiB
C++
// Copyright (c) 2005 INRIA (France).
|
|
// All rights reserved.
|
|
//
|
|
// This file is part of CGAL (www.cgal.org); you may redistribute it under
|
|
// the terms of the Q Public License version 1.0.
|
|
// See the file LICENSE.QPL distributed with CGAL.
|
|
//
|
|
// Licensees holding a valid commercial license may use this file in
|
|
// accordance with the commercial license agreement provided with the software.
|
|
//
|
|
// This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
|
// WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
|
//
|
|
// $URL$
|
|
// $Id$
|
|
//
|
|
//
|
|
// Author(s) : Laurent Saboret, Pierre Alliez, Bruno Levy
|
|
|
|
// We need a doxygen comment about CGAL in order for doxygen to
|
|
// extract the global functions, variables or constants of the namespace
|
|
/// @namespace CGAL
|
|
/// CGAL is a great stuff!
|
|
|
|
|
|
#ifndef CGAL_PARAMETERIZE_H
|
|
#define CGAL_PARAMETERIZE_H
|
|
|
|
#include <CGAL/Mean_value_coordinates_parameterizer_3.h>
|
|
|
|
CGAL_BEGIN_NAMESPACE
|
|
|
|
|
|
/// Compute a 1 to 1 mapping from a triangular 3D surface 'mesh' to 2D circle,
|
|
/// using Floater Mean Value Coordinates algorithm.
|
|
/// 1 to 1 mapping is guaranteed.
|
|
///
|
|
/// The mapping is linear by pieces (linear in each triangle).
|
|
/// The result is the (u,v) pair image of each vertex of the 3D surface.
|
|
///
|
|
/// Preconditions:
|
|
/// - 'mesh' must be a surface with 1 connected component.
|
|
/// - 'mesh' must be a triangular mesh.
|
|
///
|
|
template <class ParameterizationMesh_3>
|
|
typename Parameterizer_traits_3<ParameterizationMesh_3>::Error_code
|
|
parameterize(ParameterizationMesh_3& mesh) ///< 3D mesh, model of ParameterizationMesh_3 concept
|
|
{
|
|
Mean_value_coordinates_parameterizer_3<ParameterizationMesh_3> parameterizer;
|
|
return parameterizer.parameterize(mesh);
|
|
}
|
|
|
|
|
|
/// Compute a 1 to 1 mapping from a triangular 3D surface 'mesh'
|
|
/// to a piece of the 2D space.
|
|
/// The mapping is linear by pieces (linear in each triangle).
|
|
/// The result is the (u,v) pair image of each vertex of the 3D surface.
|
|
///
|
|
/// 1 to 1 mapping may be guaranteed or not, depending of
|
|
/// ParameterizerTraits_3 algorithm chosen.
|
|
///
|
|
/// Preconditions:
|
|
/// - 'mesh' must be a surface with 1 connected component.
|
|
/// - 'mesh' must be a triangular mesh.
|
|
/// - the mesh border must be mapped onto a convex polygon
|
|
/// (for fixed border parameterizations).
|
|
///
|
|
template <class ParameterizationMesh_3, class ParameterizerTraits_3>
|
|
typename Parameterizer_traits_3<ParameterizationMesh_3>::Error_code
|
|
parameterize(ParameterizationMesh_3& mesh, ///< 3D mesh, model of ParameterizationMesh_3
|
|
ParameterizerTraits_3 parameterizer) ///< Parameterization method for 'mesh'
|
|
{
|
|
return parameterizer.parameterize(mesh);
|
|
}
|
|
|
|
|
|
CGAL_END_NAMESPACE
|
|
|
|
#endif //CGAL_PARAMETERIZE_H
|
|
|