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

merge image + features examples description in the user manual

This commit is contained in:
Jane Tournois 2023-01-23 11:44:56 +01:00
parent f8cfa30070
commit 4fb0be26a9
1 changed files with 14 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
Mesh_3/doc/Mesh_3/Mesh_3.txt
View File

@ -735,25 +735,6 @@ Surface of the output mesh generated with a very small `facet_distance`
without the weights (left, 25563 vertices) and with the weights (right, 19936 vertices). without the weights (left, 25563 vertices) and with the weights (right, 19936 vertices).
\cgalFigureEnd \cgalFigureEnd
\subsubsection Mesh_3DomainsFrom3DImagesWithFeatures Domains From Segmented 3D Images, with Feature Detection
The example \ref Mesh_3/mesh_3D_image_with_detection_of_features.cpp shows how to use
the feature detection functors `CGAL::Mesh_3::Detect_features_in_image` and
`CGAL::Mesh_3::Detect_features_on_image_bbox`, in order to get a quality discretization
of the curves lying at the intersection of three or more subdomains (including the outside).
The original feature detection algorithm was described in \cgalCite{cgal:hssz-gmcabonbc-97},
along with a list of possible voxel configurations. The detection implemented in \cgal
generalizes this description and computes a graph of polyline features at the Intersection
of three or more subdomains.
\cgalExample{Mesh_3/mesh_3D_image_with_detection_of_features.cpp}
\cgalFigureBegin{figure_detectFeaturesInImage, detect_features_in_image.jpg}
Surface of the output mesh generated from a labeled image without (left)
and with (right) feature detection and protection.
\cgalFigureEnd
\subsubsection Mesh_3DomainsFrom3DImagesWithCustomInitialization Domains From 3D Images, with a Custom Initialization \subsubsection Mesh_3DomainsFrom3DImagesWithCustomInitialization Domains From 3D Images, with a Custom Initialization
The example \ref Mesh_3/mesh_3D_image_with_custom_initialization.cpp is a modification The example \ref Mesh_3/mesh_3D_image_with_custom_initialization.cpp is a modification
@ -942,21 +923,26 @@ The first modification is the type of the mesh domain. Instead of being
`Mesh_domain_with_polyline_features_3` templated by a `Mesh_domain_with_polyline_features_3` templated by a
`Labeled_mesh_domain_3`. `Labeled_mesh_domain_3`.
\snippet Mesh_3/mesh_3D_image_with_detection_of_features.cpp Domain definition \snippet Mesh_3/mesh_3D_image_with_features.cpp Domain definition
Then, in the function `%main()`, creation of `%domain` is done Then, in the function `%main()`, creation of `%domain` is done
with an additional argument, a dedicated functor with an additional argument: a dedicated functor
that computes the 1D-features, that are added to the domain. that computes the 1D features, that are added to the domain.
\snippet Mesh_3/mesh_3D_image_with_detection_of_features.cpp Domain creation \snippet Mesh_3/mesh_3D_image_with_detection_of_features.cpp Domain creation
The functor `%Detect_features_in_image` is defined in its own header file. The functor `CGAL::Detect_features_in_image` is defined in its own header file.
It computes the 1D-features that correspond to the intersection of the bounding box of the It computes the 1D features that correspond to the intersections of the bounding box of the
image with the surfaces defined by the image, and the polylines that lie at image with the surfaces defined by the image, and polylines that lie at
the intersection of 3 or more subdomains. the intersection of three or more subdomains (including the outside).
It then constructs a graph of these polyline features. The named constructor
adds this feature graph to the domain for later feature protection.
The original feature detection algorithm was described in \cgalCite{cgal:hssz-gmcabonbc-97},
along with a list of possible voxel configurations. The detection implemented in \cgal
generalizes this description.
The example \ref Mesh_3/mesh_3D_image_with_features.cpp show how, The example \ref Mesh_3/mesh_3D_image_with_features.cpp shows how
at the same time, more input polylines can be added as 1D-features to the mesh domain. user-specified input polylines can further be added as 1D features to the mesh domain.
\snippet Mesh_3/mesh_3D_image_with_features.cpp Domain creation \snippet Mesh_3/mesh_3D_image_with_features.cpp Domain creation