CGAL::LSCM_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d>

Definition

The class LSCM_parameterizer_3 implements the Least Squares Conformal Maps (LSCM) parameterization [LPRM02].

This is a conformal parameterization, i.e. it attempts to preserve angles.

This is a free border parameterization. No need to map the surface's border onto a convex polygon (only two pinned vertices are needed to ensure a unique solution), but one-to-one mapping is NOT guaranteed.

#include <CGAL/LSCM_parameterizer_3.h>

Is Model for the Concepts

Model of the ParameterizerTraits_3 concept.

Design Pattern

LSCM_parameterizer_3<ParameterizationMesh_3, ...> class is a Strategy [GHJV95]: it implements a strategy of surface parameterization for models of ParameterizationMesh_3.

Parameters

The full template declaration is:

template<
class ParameterizationMesh_3,
class BorderParameterizer_3 = Two_vertices_parameterizer_3<ParameterizationMesh_3>,
class SparseLinearAlgebraTraits_d = OpenNL::SymmetricLinearSolverTraits<typename ParameterizationMesh_3::NT>>
class LSCM_parameterizer_3;

Types

LSCM_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d>::Border_param
Export BorderParameterizer_3 template parameter.

LSCM_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d>::Sparse_LA
Export SparseLinearAlgebraTraits_d template parameter.

Creation

LSCM_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d> param ( Border_param border_param = Border_param(),
Sparse_LA sparse_la = Sparse_LA());
Constructor.

Parameters:
border_param
Object that maps the surface's border to 2D space
sparse_la
Traits object to access a sparse linear system

Operations

Parameterizer_traits_3<Adaptor>::Error_code
param.parameterize ( Adaptor& mesh)
Compute a one-to-one 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. Preconditions:
  • 'mesh' must be a surface with one connected component.
  • 'mesh' must be a triangular mesh.
Parameterizer_traits_3<Adaptor>::Error_code
param.check_parameterize_preconditions ( Adaptor& mesh)
Check parameterize() preconditions:
  • 'mesh' must be a surface with one connected component.
  • 'mesh' must be a triangular mesh.
void param.initialize_system_from_mesh_border ( LeastSquaresSolver& solver, Adaptor mesh)
Initialize A X = B linear system after (at least two) border vertices are parameterized. Preconditions:
  • vertices must be indexed.
  • X and B must be allocated and empty.
  • (at least two) border vertices must be parameterized.
void
param.project_triangle ( Point_3 p0,
Point_3 p1,
Point_3 p2,
Point_2& z0,
Point_2& z1,
Point_2& z2)
Utility for setup_triangle_relations(): Computes the coordinates of the vertices of a triangle in a local 2D orthonormal basis of the triangle's plane.
Parameterizer_traits_3<Adaptor>::Error_code
param.setup_triangle_relations ( LeastSquaresSolver& solver,
Adaptor mesh,
Facet_const_handle facet)
Create two lines in the linear system per triangle (one for u, one for v). Preconditions:
  • vertices must be indexed.
void param.set_mesh_uv_from_system ( Adaptor& mesh, LeastSquaresSolver solver)
Copy X coordinates into the (u,v) pair of each vertex.
Parameterizer_traits_3<Adaptor>::Error_code
param.check_parameterize_postconditions ( Adaptor mesh, LeastSquaresSolver solver)
Check parameterize() postconditions:
  • 3D -> 2D mapping is one-to-one.
bool param.is_one_to_one_mapping ( Adaptor mesh, LeastSquaresSolver solver)
Check if 3D -> 2D mapping is one-to-one.
Border_param& param.get_border_parameterizer () Get the object that maps the surface's border onto a 2D space.
Sparse_LA& param.get_linear_algebra_traits ()
Get the sparse linear algebra (traits object to access the linear system).

See Also

CGAL::Parameterizer_traits_3<ParameterizationMesh_3>
CGAL::Fixed_border_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d>
CGAL::Barycentric_mapping_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d>
CGAL::Discrete_authalic_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d>
CGAL::Discrete_conformal_map_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d>
CGAL::Mean_value_coordinates_parameterizer_3<ParameterizationMesh_3, BorderParameterizer_3, SparseLinearAlgebraTraits_d>