songsenand
/
cgal
mirror of https://github.com/CGAL/cgal
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update documentation for CGAL-3.4: remove any occurrence of "polyhedral 

[surfaces]" and "piecewise [smooth surfaces]"
This commit is contained in:
Laurent Rineau 2008-10-17 12:35:23 +00:00
parent d69d9d61ee
commit c0d16dd488
5 changed files with 66 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

97
Surface_mesher/doc_tex/Surface_mesher/main.tex
View File

@ -53,11 +53,14 @@ The meshing algorithm is based on the notion of the restricted
Delaunay triangulation. Basically the algorithm computes a set of
sample points on the surface, and extract an interpolating
surface mesh from the three dimensional triangulation of these
sample points. It also interpolates a 1D mesh of the 1D curves of the
surface, if any. Points are iteratively added to the sample,
sample points.
%It also interpolates a 1D mesh of the 1D curves of the
%surface, if any.
Points are iteratively added to the sample,
as in a Delaunay refinement process, until some size and shape
criteria on the elements of the surface mesh and the 1D mesh are
satisfied.
criteria on the elements of the surface mesh
%and the 1D mesh
are satisfied.
The size and shape criteria guide the behavior of
@ -206,47 +209,47 @@ to include at least one point on each connected component of the surface
to be meshed.
\section{The Surface Mesh Generator Interface for Piecewise Smooth
Surfaces\label{SurfaceMesher_piecewise_section_interface}}
% \section{The Surface Mesh Generator Interface for Piecewise Smooth
% Surfaces\label{SurfaceMesher_piecewise_section_interface}}
The meshing process for piecewise smooth surfaces is launched in a way
similar to the smooth case. There are also two overloaded versions of a
meshing function:
% The meshing process for piecewise smooth surfaces is launched in a way
% similar to the smooth case. There are also two overloaded versions of a
% meshing function:
\ccGlobalFunction{template <class SurfaceMeshC2T3,
class Surface,
class FacetsCriteria,
class EdgesCriteria,
class Tag >
void make_piecewise_smooth_surface_mesh(SurfaceMeshC2T3& c2t3,
Surface surface,
FacetsCriteria facets_criteria,
EdgesCriteria edges_criteria
Tag ) ;}
% \ccGlobalFunction{template <class SurfaceMeshC2T3,
% class Surface,
% class FacetsCriteria,
% class EdgesCriteria,
% class Tag >
% void make_piecewise_smooth_surface_mesh(SurfaceMeshC2T3& c2t3,
% Surface surface,
% FacetsCriteria facets_criteria,
% EdgesCriteria edges_criteria
% Tag ) ;}
\ccGlobalFunction{template <class SurfaceMeshC2T3,
class SurfaceMeshTraits,
class FacetsCriteria,
class EdgesCriteria,
class Tag >
void make_piecewise_smooth_surface_mesh(SurfaceMeshC2T3& c2t3,
SurfaceMeshTraits::Surface_3 surface,
SurfaceMeshTraits traits,
FacetsCriteria facets_criteria,
EdgesCriteria edges_criteria
Tag );}
% \ccGlobalFunction{template <class SurfaceMeshC2T3,
% class SurfaceMeshTraits,
% class FacetsCriteria,
% class EdgesCriteria,
% class Tag >
% void make_piecewise_smooth_surface_mesh(SurfaceMeshC2T3& c2t3,
% SurfaceMeshTraits::Surface_3 surface,
% SurfaceMeshTraits traits,
% FacetsCriteria facets_criteria,
% EdgesCriteria edges_criteria
% Tag );}
Every parameters has the same meaning than in the smooth case. The template
parameter \ccc{SurfaceMeshTraits} has to be a model of the concept
\ccc{PiecewiseSmoothSurfaceMeshTraits_3}, which refines the concept
\ccc{SurfaceMeshTraits_3} by adding the methods needed to compute the
intersections between a triangle and the set of 1D curves of the piecewise
smooth surface \ccc{surface}.
% Every parameters has the same meaning than in the smooth case. The template
% parameter \ccc{SurfaceMeshTraits} has to be a model of the concept
% \ccc{PiecewiseSmoothSurfaceMeshTraits_3}, which refines the concept
% \ccc{SurfaceMeshTraits_3} by adding the methods needed to compute the
% intersections between a triangle and the set of 1D curves of the piecewise
% smooth surface \ccc{surface}.
The parameter \ccc{edges_criteria} gives the size criteria on the edges of
the 1D mesh interpolating the 1D curves.
% The parameter \ccc{edges_criteria} gives the size criteria on the edges of
% the 1D mesh interpolating the 1D curves.
\def\ccLongParamLayout{\ccFalse}
@ -326,17 +329,17 @@ resulting mesh is the introducing picture of this chapter.
\ccIncludeExampleCode{Surface_mesher/mesh_a_3d_gray_image.cpp}
\subsection{Remeshing a polyhedral surface}
In this example, the surface is a polyhedral surface, that represents a
piecewise smooth surface. The 1D curves of that surfaces are the union o
the border edges (if any) and the edges at which the dihedral angle is
smaller than 120~degrees. The polyhedral surface is given by an OFF file.
% \subsection{Remeshing a polyhedral surface}
% In this example, the surface is a polyhedral surface, that represents a
% piecewise smooth surface. The 1D curves of that surfaces are the union o
% the border edges (if any) and the edges at which the dihedral angle is
% smaller than 120~degrees. The polyhedral surface is given by an OFF file.
The criteria on the facets of the surface mesh are given by the same class
than in the smooth case. Some extra criteria on the edges of the 1D mesh
are given.
% The criteria on the facets of the surface mesh are given by the same class
% than in the smooth case. Some extra criteria on the edges of the 1D mesh
% are given.
\ccIncludeExampleCode{Surface_mesher/polyhedron_remesher.cpp}
% \ccIncludeExampleCode{Surface_mesher/polyhedron_remesher.cpp}
\section{Meshing Criteria, Guarantees and Variations\label{SurfaceMesher_section_criteria}}
\label{SurfaceMesher_section_variations}

9
Surface_mesher/doc_tex/Surface_mesher_ref/SurfaceMeshFacetsCriteria_3.tex
View File

@ -22,10 +22,11 @@ The concept \ccRefName\ describes the type which
handles those criteria.
It corresponds to the requirements for the template parameter
\ccc{FacetsCriteria} of the surface mesher function
\ccc{make_surface_mesh<SurfaceMeshC2T3,Surface,FacetsCriteria,Tag>} and the
piecewise smooth mesher
function \ccc{make_piecewise_smooth_surface_mesh<SurfaceMeshC2T3,Surface,
FacetsCriteria,EdgesCriteria,Tag>}.
\ccc{make_surface_mesh<SurfaceMeshC2T3,Surface,FacetsCriteria,Tag>}
%and the piecewise smooth mesher
%function \ccc{make_piecewise_smooth_surface_mesh<SurfaceMeshC2T3,Surface,
% FacetsCriteria,EdgesCriteria,Tag>}
.
Typically the meshing criteria are a set
of elementary criteria, each of which

6
Surface_mesher/doc_tex/Surface_mesher_ref/Surface_mesh_complex_2_in_triangulation_3.tex
View File

@ -39,9 +39,9 @@ of the concept \ccc{SurfaceMeshVertexBase_3} and
respectively.)
Additionally, if \ccc{Edge_info} is not \ccc{void}, \ccRefName\ is a model
of the concept \ccc{PiecewiseSmoothSurfaceMeshComplex_2InTriangulation_3}, if
\ccc{Edge_info} has data members required by that concept.
%Additionally, if \ccc{Edge_info} is not \ccc{void}, \ccRefName\ is a model
%of the concept \ccc{PiecewiseSmoothSurfaceMeshComplex_2InTriangulation_3}, if
%\ccc{Edge_info} has data members required by that concept.
\ccInclude{CGAL/Surface_mesh_complex_2_in_triangulation_3.h}

12
Surface_mesher/doc_tex/Surface_mesher_ref/intro.tex
View File

@ -44,11 +44,11 @@ of the output mesh while avoiding an over-refinement of the mesh.
\subsection*{Concepts}
\ccRefConceptPage{SurfaceMeshComplex_2InTriangulation_3}\\
\ccRefConceptPage{PiecewiseSmoothSurfaceMeshComplex_2InTriangulation_3}\\
%\ccRefConceptPage{PiecewiseSmoothSurfaceMeshComplex_2InTriangulation_3}\\
\ccRefConceptPage{SurfaceMeshTraits_3} \\
\ccRefConceptPage{PiecewiseSmoothSurfaceMeshTraits_3} \\
%\ccRefConceptPage{PiecewiseSmoothSurfaceMeshTraits_3} \\
\ccRefConceptPage{SurfaceMeshFacetsCriteria_3} \\
\ccRefConceptPage{PiecewiseSmoothSurfaceMeshEdgesCriteria_3} \\
%\ccRefConceptPage{PiecewiseSmoothSurfaceMeshEdgesCriteria_3} \\
\ccRefConceptPage{SurfaceMeshCellBase_3} \\
\ccRefConceptPage{SurfaceMeshVertexBase_3} \\
\ccRefConceptPage{SurfaceMeshTriangulation_3} \\
@ -61,11 +61,11 @@ of the output mesh while avoiding an over-refinement of the mesh.
\ccRefIdfierPage{CGAL::Surface_mesh_vertex_base_3<Gt,Vb>} \\
\ccRefIdfierPage{CGAL::Surface_mesh_cell_base_3<Gt,Cb>} \\
\ccRefIdfierPage{CGAL::Surface_mesh_default_criteria_3<Tr>} \\
\ccRefIdfierPage{CGAL::Piecewise_smooth_surface_mesh_default_edges_criteria_3<Tr>} \\
%\ccRefIdfierPage{CGAL::Piecewise_smooth_surface_mesh_default_edges_criteria_3<Tr>} \\
\ccRefIdfierPage{CGAL::Surface_mesh_default_triangulation_3} \\
\ccRefIdfierPage{CGAL::Surface_mesh_traits_generator_3<Surface>} \\
\ccRefIdfierPage{CGAL::Implicit_surface_3<Traits, Function>} \\
\ccRefIdfierPage{CGAL::Polyhedral_surface_3<Traits>} \\
%\ccRefIdfierPage{CGAL::Polyhedral_surface_3<Traits>} \\
\ccRefIdfierPage{CGAL::Gray_level_image_3<FT, Point>}
\subsection*{Tag Classes}
@ -76,7 +76,7 @@ of the output mesh while avoiding an over-refinement of the mesh.
\subsection*{Function Templates}
\ccRefIdfierPage{CGAL::make_surface_mesh} \\
\ccRefIdfierPage{CGAL::make_piecewise_smooth_surface_mesh}
%\ccRefIdfierPage{CGAL::make_piecewise_smooth_surface_mesh}
%\subsection*{Enums}

4
Surface_mesher/doc_tex/Surface_mesher_ref/main.tex
View File

@ -10,10 +10,10 @@
\input{Surface_mesher_ref/Gray_level_image_3.tex}
\input{Surface_mesher_ref/ImplicitFunction.tex}
\input{Surface_mesher_ref/Implicit_surface_3.tex}
\input{Surface_mesher_ref/Polyhedral_surface_3.tex}
%\input{Surface_mesher_ref/Polyhedral_surface_3.tex}
\input{Surface_mesher_ref/ImplicitSurfaceTraits_3.tex}
\input{Surface_mesher_ref/make_surface_mesh.tex}
\input{Surface_mesher_ref/make_piecewise_smooth_surface_mesh.tex}
%\input{Surface_mesher_ref/make_piecewise_smooth_surface_mesh.tex}
\input{Surface_mesher_ref/Manifold_tag.tex}
\input{Surface_mesher_ref/Manifold_with_boundary_tag.tex}
\input{Surface_mesher_ref/Non_manifold_tag.tex}