CGAL 5.3 - 3D Mesh Generation
Parameter Functions

Functions

parameters::internal::Manifold_options CGAL::parameters::manifold ()
 The function parameters::manifold() is used to drive the meshing algorithm for surfaces. More...
 
parameters::internal::Manifold_options CGAL::parameters::non_manifold ()
 The function parameters::non_manifold() is used to drive the meshing algorithm for surfaces. More...
 
parameters::internal::Manifold_options CGAL::parameters::manifold_with_boundary ()
 The function parameters::manifold_with_boundary() is used to drive the meshing algorithm for surfaces. More...
 
parameters::internal::Exude_options CGAL::parameters::exude (double parameters::time_limit=0, double parameters::sliver_bound=0)
 The function parameters::exude() allows the user to trigger a call to exude_mesh_3() in the make_mesh_3() and refine_mesh_3() mesh generation functions. More...
 
parameters::internal::Features_options CGAL::parameters::features ()
 The function parameters::features() provides a value of internal type Features to specify if 0 and 1-dimensional features have to be taken into account. More...
 
parameters::internal::Lloyd_options CGAL::parameters::lloyd (double parameters::time_limit=0, std::size_t parameters::max_iteration_number=0, double parameters::convergence=0.02, double parameters::freeze_bound=0.01, bool parameters::do_freeze=true)
 The function parameters::lloyd() allows the user to trigger a call of lloyd_optimize_mesh_3() in the mesh generation functions make_mesh_3() and refine_mesh_3(). More...
 
parameters::internal::Exude_options CGAL::parameters::no_exude ()
 The function parameters::no_exude() allows the user to tell the mesh generation functions make_mesh_3() and refine_mesh_3() that no exudation must be done. More...
 
parameters::internal::Features_options CGAL::parameters::no_features ()
 The function parameters::no_features() allows the user to prevent the handling of 0 and 1-dimensional features. More...
 
parameters::internal::Lloyd_options CGAL::parameters::no_lloyd ()
 The function parameters::no_lloyd() allows the user to tell the mesh generation functions make_mesh_3() and refine_mesh_3() that no lloyd optimization must be done. More...
 
parameters::internal::Odt_options CGAL::parameters::no_odt ()
 The function parameters::no_odt() allows the user to tell the mesh generation functions make_mesh_3() and refine_mesh_3() that no odt optimization must be done. More...
 
parameters::internal::Perturb_options CGAL::parameters::no_perturb ()
 The function parameters::no_perturb() allows the user to tell mesh generation global functions make_mesh_3() and refine_mesh_3() that no perturbation must be done. More...
 
parameters::internal::Odt_options CGAL::parameters::odt (double parameters::time_limit=0, std::size_t parameters::max_iteration_number=0, double parameters::convergence=0.02, double parameters::freeze_bound=0.01, bool parameters::do_freeze=true)
 The function parameters::odt() allows the user to trigger a call to CGAL::odt_optimize_mesh_3() in CGAL::make_mesh_3() and CGAL::refine_mesh_3() mesh optimization functions. More...
 
parameters::internal::Perturb_options CGAL::parameters::perturb (double parameters::time_limit=0, double parameters::sliver_bound=0)
 The function parameters::perturb() allows the user to trigger a call to perturb_mesh_3() in make_mesh_3() and refine_mesh_3() mesh generation functions. More...
 

Function Documentation

◆ exude()

parameters::internal::Exude_options CGAL::parameters::exude ( double parameters::time_limit  = 0,
double parameters::sliver_bound  = 0 
)

#include <CGAL/refine_mesh_3.h>

The function parameters::exude() allows the user to trigger a call to exude_mesh_3() in the make_mesh_3() and refine_mesh_3() mesh generation functions.

It also allows the user to pass parameters to the optimization function exude_mesh_3() through these mesh generation functions.

Parameters

The parameters are named parameters. They are the same (i.e. they have the same name and the same default values) as the parameters of exude_mesh_3() function. See its manual page for further details.

Example

// Mesh generation with an exudation step
C3t3 c3t3 = make_mesh_3<c3t3>(domain,
criteria,
domain,
criteria,
parameters::exude(parameters::time_limit=10));
See also
CGAL::parameters::no_exude()
CGAL::exude_mesh_3()
CGAL::make_mesh_3()
CGAL::refine_mesh_3()
Examples:
Mesh_3/mesh_optimization_lloyd_example.cpp.

◆ features()

parameters::internal::Features_options CGAL::parameters::features ( )

#include <CGAL/refine_mesh_3.h>

The function parameters::features() provides a value of internal type Features to specify if 0 and 1-dimensional features have to be taken into account.

The provided value is a default value that triggers the representation of corners and curves in the mesh when the domain is a model of MeshDomainWithFeatures_3.

Provides a Features_options value such that 0 and 1-dimensional input features are taken into account if domain is a model of the refined concept MeshDomainWithFeatures_3.

See also
CGAL::make_mesh_3()
CGAL::refine_mesh_3()
CGAL::parameters::no_features()

◆ lloyd()

parameters::internal::Lloyd_options CGAL::parameters::lloyd ( double parameters::time_limit  = 0,
std::size_t parameters::max_iteration_number  = 0,
double parameters::convergence  = 0.02,
double parameters::freeze_bound  = 0.01,
bool parameters::do_freeze  = true 
)

#include <CGAL/refine_mesh_3.h>

The function parameters::lloyd() allows the user to trigger a call of lloyd_optimize_mesh_3() in the mesh generation functions make_mesh_3() and refine_mesh_3().

It also allows the user to pass parameters to the optimization function lloyd_optimize_mesh_3() through these mesh generation functions.

Parameters

The parameters are named parameters. They are the same (i.e. they have the same name and the same default values) as the parameters of the lloyd_optimize_mesh_3() function. See its manual page for further details.

Example

// Mesh generation with lloyd optimization step
C3t3 c3t3 = make_mesh_3<c3t3>(domain,
criteria,
domain,
criteria,
parameters::lloyd(parameters::time_limit=10));
See also
CGAL::parameters::no_lloyd()
CGAL::lloyd_optimize_mesh_3()
CGAL::make_mesh_3()
CGAL::refine_mesh_3()
Examples:
Mesh_3/mesh_optimization_lloyd_example.cpp.

◆ manifold()

parameters::internal::Manifold_options CGAL::parameters::manifold ( )

#include <CGAL/refine_mesh_3.h>

The function parameters::manifold() is used to drive the meshing algorithm for surfaces.

It ensures that the surface of the output mesh is a manifold surface without boundaries. The manifold property of the output mesh can be achieved only if the input surface is a manifold. Note that the meshing algorithm provably terminates only if the input sharp edges have been protected, using the feature protection (see Protection of 0 and 1-dimensional Exposed Features).

See also
CGAL::make_mesh_3()
CGAL::refine_mesh_3()
CGAL::parameters::manifold_with_boundary()
CGAL::parameters::non_manifold()
Examples:
Mesh_3/mesh_polyhedral_domain.cpp.

◆ manifold_with_boundary()

parameters::internal::Manifold_options CGAL::parameters::manifold_with_boundary ( )

#include <CGAL/refine_mesh_3.h>

The function parameters::manifold_with_boundary() is used to drive the meshing algorithm for surfaces.

It ensures that the surface of the output mesh is a manifold surface which may have boundaries. The manifold property of the output mesh can be achieved only if the input surface is a manifold. Note that the meshing algorithm provably terminates only if the input sharp edges have been protected, using the feature protection (see Protection of 0 and 1-dimensional Exposed Features).

See also
CGAL::make_mesh_3()
CGAL::refine_mesh_3()
CGAL::parameters::non_manifold()
CGAL::parameters::manifold()

◆ no_exude()

◆ no_features()

parameters::internal::Features_options CGAL::parameters::no_features ( )

#include <CGAL/refine_mesh_3.h>

The function parameters::no_features() allows the user to prevent the handling of 0 and 1-dimensional features.

This is useful when the domain is a model of MeshDomainWithFeatures_3 and the user does not want corners and curves to be accurately represented in the mesh.

Returns a Features_options value that prevents the mesh generator to take into account 0 and 1-dimensional input features.

See also
CGAL::make_mesh_3()
CGAL::refine_mesh_3()
CGAL::parameters::features()
Examples:
Mesh_3/mesh_two_implicit_spheres_with_balls.cpp.

◆ no_lloyd()

parameters::internal::Lloyd_options CGAL::parameters::no_lloyd ( )

#include <CGAL/refine_mesh_3.h>

The function parameters::no_lloyd() allows the user to tell the mesh generation functions make_mesh_3() and refine_mesh_3() that no lloyd optimization must be done.

Example

// Mesh generation without lloyd optimization
C3t3 c3t3 = make_mesh_3<c3t3>(domain,
criteria,
See also
CGAL::parameters::lloyd()
CGAL::lloyd_optimize_mesh_3()
CGAL::make_mesh_3()
CGAL::refine_mesh_3()

◆ no_odt()

parameters::internal::Odt_options CGAL::parameters::no_odt ( )

#include <CGAL/refine_mesh_3.h>

The function parameters::no_odt() allows the user to tell the mesh generation functions make_mesh_3() and refine_mesh_3() that no odt optimization must be done.

Example

// Mesh generation without odt optimization
C3t3 c3t3 = make_mesh_3<c3t3>(domain,
criteria,
See also
CGAL::parameters::odt()
CGAL::odt_optimize_mesh_3()
CGAL::make_mesh_3()
CGAL::refine_mesh_3()

◆ no_perturb()

◆ non_manifold()

parameters::internal::Manifold_options CGAL::parameters::non_manifold ( )

#include <CGAL/refine_mesh_3.h>

The function parameters::non_manifold() is used to drive the meshing algorithm for surfaces.

It does not ensure that the surface of the output mesh is a manifold surface. The manifold property of the output mesh might nevertheless result from an appropriate choice of meshing criteria.

See also
CGAL::make_mesh_3()
CGAL::refine_mesh_3()
CGAL::parameters::manifold_with_boundary()
CGAL::parameters::manifold()

◆ odt()

parameters::internal::Odt_options CGAL::parameters::odt ( double parameters::time_limit  = 0,
std::size_t parameters::max_iteration_number  = 0,
double parameters::convergence  = 0.02,
double parameters::freeze_bound  = 0.01,
bool parameters::do_freeze  = true 
)

#include <CGAL/refine_mesh_3.h>

The function parameters::odt() allows the user to trigger a call to CGAL::odt_optimize_mesh_3() in CGAL::make_mesh_3() and CGAL::refine_mesh_3() mesh optimization functions.

It also allows the user to pass parameters to the optimization function odt_optimize_mesh_3() through these mesh generation functions.

Parameters

The parameters are named parameters. They are the same (i.e. they have the same name and the same default values) as the parameters of odt_optimize_mesh_3() function. See its manual page for further details.

Example

// Mesh generation with odt optimization step
C3t3 c3t3 = make_mesh_3<c3t3>(domain,
criteria,
domain,
criteria,
parameters::odt(parameters::time_limit=10));
See also
CGAL::parameters::no_odt()
CGAL::odt_optimize_mesh_3()
CGAL::make_mesh_3()
CGAL::refine_mesh_3()

◆ perturb()

parameters::internal::Perturb_options CGAL::parameters::perturb ( double parameters::time_limit  = 0,
double parameters::sliver_bound  = 0 
)

#include <CGAL/refine_mesh_3.h>

The function parameters::perturb() allows the user to trigger a call to perturb_mesh_3() in make_mesh_3() and refine_mesh_3() mesh generation functions.

It also allows the user to pass parameters to the optimization function perturb_mesh_3() through these mesh generation functions.

Parameters

The parameters are named parameters. They are the same (i.e. they have the same name and the same default values) as the parameters of perturb_mesh_3() function. See its manual page for further details.

Example

// Mesh generation with a perturbation step
C3t3 c3t3 = make_mesh_3<c3t3>(domain,
criteria,
domain,
criteria,
parameters::perturb(parameters::time_limit=10));
See also
CGAL::parameters::no_perturb()
CGAL::perturb_mesh_3()
CGAL::make_mesh_3()
CGAL::refine_mesh_3()
Examples:
Mesh_3/mesh_optimization_example.cpp.