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

document FaceGraph triangle primitive to be only for Polyhedron

This commit is contained in:
Sébastien Loriot 2013-06-19 19:28:19 +02:00
parent 9822a1a403
commit d2bf82c8e5
1 changed files with 5 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
AABB_tree/include/CGAL/AABB_FaceGraph_triangle_primitive.h
View File

@ -31,19 +31,16 @@ namespace CGAL {
/*! /*!
* \ingroup PkgAABB_tree * \ingroup PkgAABB_tree
* Primitive type for a facet of a polyhedral surface. * Primitive type for a facet of a polyhedral surface.
* It wraps a `face_descriptor` of a class model of `FaceGraph` to a 3D triangle. * It wraps a handle to a facet of a polyhedron to a 3D triangle.
* The class model of `FaceGraph` from which the primitive is built should not be deleted * The polyhedron from which the primitive is built should not be deleted
* while the AABB tree holding the primitive is in use. * while the AABB tree holding the primitive is in use.
* *
* \cgalModels `AABBPrimitive` if `OneFaceGraphPerTree` is `CGAL::Tag_false`, * \cgalModels `AABBPrimitive` if `OneFaceGraphPerTree` is `CGAL::Tag_false`,
* and `AABBPrimitiveWithSharedData` if `OneFaceGraphPerTree` is `CGAL::Tag_true`. * and `AABBPrimitiveWithSharedData` if `OneFaceGraphPerTree` is `CGAL::Tag_true`.
* *
*\tparam FaceGraph is a model of the face graph concept. *\tparam FaceGraph is a \cgal Polyhedron.
*\tparam OneFaceGraphPerTree is either `CGAL::Tag_true` or `CGAL::Tag_false`. In the former case, *\tparam OneFaceGraphPerTree must be set to `CGAL::Tag_true`.
* we guarantee that all the primitives will be from a common `FaceGraph` and some data * This parameter is useless for the moment and will be useful in an upcoming release of \cgal.
* will be factorized so that the size of the primitive is reduced. In the latter case,
* the primitives can be from different graphs and extra storage is required in the primitives.
* The default is `CGAL::Tag_true`.
*\tparam cache_datum is either `CGAL::Tag_true` or `CGAL::Tag_false`. In the former case, the datum is stored *\tparam cache_datum is either `CGAL::Tag_true` or `CGAL::Tag_false`. In the former case, the datum is stored
* in the primitive, while in the latter it is constructed on the fly to reduce the memory footprint. * in the primitive, while in the latter it is constructed on the fly to reduce the memory footprint.
* The default is `CGAL::Tag_false` (datum is not stored). * The default is `CGAL::Tag_false` (datum is not stored).