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

LCC doc, ok for concepts.

This commit is contained in:
Guillaume Damiand 2013-03-01 14:29:38 +01:00
parent 2a04b964cd
commit f38df827b6
3 changed files with 131 additions and 125 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
Linear_cell_complex/doc/Linear_cell_complex/Concepts/CellAttributeWithPoint.h
View File

@ -8,7 +8,7 @@ concept, to represent a cell attribute containing a point.
\cgalRefines `CellAttribute` \cgalRefines `CellAttribute`
\cgalHasModel `CGAL::Cell_attribute_with_point<LCC,Info_,Tag,OnMerge,OnSplit>` \cgalHasModel \ref CGAL::Cell_attribute_with_point "CGAL::Cell_attribute_with_point<LCC,Info_,Tag,OnMerge,OnSplit>"
\sa `LinearCellComplexItems` \sa `LinearCellComplexItems`
@ -25,6 +25,11 @@ Type of the used point.
*/ */
typedef Hidden_type Point; typedef Hidden_type Point;
/*!
Type of the information, defined in the `CellAttribute` concept.
*/
typedef CellAttribute::Info Info;
/// @} /// @}
/// \name Creation /// \name Creation
@ -36,19 +41,19 @@ Default constructor.
CellAttributeWithPoint(); CellAttributeWithPoint();
/*! /*!
Constructor initializing the point of `cawp` by the Constructor initializing the point of this attribute by the
copy contructor `Point(apoint)`. copy contructor \ref Point "Point"`(apoint)`.
*/ */
CellAttributeWithPoint(const Point&apoint); CellAttributeWithPoint(const Point&apoint);
/*! /*!
Constructor initializing the point of `cawp` by the Constructor initializing the point of this attribute by the
copy contructor `Point(apoint)` and initializing the copy contructor \ref Point "Point"`(apoint)` and initializing the
information of `cawp` by the information of this attribute by the
copy contructor `Info(info)`. copy contructor \ref Info "Info"`(info)`.
Defined only if `Info` is different from `void`. Defined only if `Info` is different from `void`.
*/ */
CellAttributeWithPoint(const Point&apoint, const Info& info); CellAttributeWithPoint(const Point&apoint, const Info& info);
/// @} /// @}
@ -56,12 +61,12 @@ CellAttributeWithPoint(const Point&apoint, const Info& info);
/// @{ /// @{
/*! /*!
Returns the point of `cawp`. Returns the point of this attribute.
*/ */
Point& point(); Point& point();
/*! /*!
Returns the point of `cawp`, when `cawp` is const. Returns the point of this attribute, when this is const.
*/ */
const Point& point() const; const Point& point() const;

4
Linear_cell_complex/doc/Linear_cell_complex/Concepts/LinearCellComplexItems.h
View File

@ -10,10 +10,10 @@ models of the `CellAttributeWithPoint` concept.
\cgalRefines `CombinatorialMapItems` \cgalRefines `CombinatorialMapItems`
\cgalRequires The first type in `Attributes` must be a model of the \cgalRequires The first type in \ref CombinatorialMapItems::Dart_wrapper "Attributes" must be a model of the
`CellAttributeWithPoint` concept. `CellAttributeWithPoint` concept.
\cgalHasModel `CGAL::Linear_cell_complex_min_items<d>` \cgalHasModel \ref CGAL::Linear_cell_complex_min_items "CGAL::Linear_cell_complex_min_items<d>"
\sa `CGAL::Linear_cell_complex<d,d2,LCCTraits,Items,Alloc>` \sa `CGAL::Linear_cell_complex<d,d2,LCCTraits,Items,Alloc>`
\sa `CellAttributeWithPoint` \sa `CellAttributeWithPoint`

43
Linear_cell_complex/doc/Linear_cell_complex/Concepts/LinearCellComplexTraits.h
View File

@ -4,10 +4,10 @@
\cgalConcept \cgalConcept
Required types and functors for the `LinearCellComplexTraits` concept. This Required types and functors for the `LinearCellComplexTraits` concept. This
geometric traits concept is used in the `Linear_cell_complex` geometric traits concept is used in the \ref CGAL::Linear_cell_complex "Linear_cell_complex"
class. class.
\cgalHasModel `CGAL::Linear_cell_complex_traits<d,K>` \cgalHasModel \ref CGAL::Linear_cell_complex_traits "CGAL::Linear_cell_complex_traits<d,K>"
\sa `CGAL::Linear_cell_complex<d,d2,LCCTraits,Items,Alloc>` \sa `CGAL::Linear_cell_complex<d,d2,LCCTraits,Items,Alloc>`
@ -19,8 +19,7 @@ public:
/// \name Constants /// \name Constants
/// @{ /// @{
/*! /*! The ambient dimension (must be > 1).
The ambient dimension, must be \f$ >\f$1.
*/ */
static unsigned int ambient_dimension; static unsigned int ambient_dimension;
@ -50,43 +49,45 @@ typedef Hidden_type Vector;
/// @{ /// @{
/*! /*!
Functor that provides `Point operator() (const Point& p, const Vector& v)`, Functor that provides \ref LinearCellComplexTraits::Point "Point " `operator() (const` \ref Point " Point"`& p, const` \ref LinearCellComplexTraits::Vector " Vector"` & v)`,
which constructs the translation of point `p` by vector `v`, and which constructs the translation of point `p` by vector `v`, and
`Point operator() (const CGAL::Origin&, const Vector& v)`, \ref LinearCellComplexTraits::Point "Point " `operator() (const CGAL::Origin&, const ` \ref LinearCellComplexTraits::Vector " Vector"& v)`,
which constructs the translation of a point at the origin by vector `v` which constructs the translation of a point at the origin by vector `v`
(used in `Linear_cell_complex::barycenter`). (used in \ref CGAL::Linear_cell_complex::barycenter "Linear_cell_complex::barycenter").
*/ */
typedef Hidden_type Construct_translated_point; typedef Hidden_type Construct_translated_point;
/*! /*!
Functor that provides `Vector operator() (const Point& p1, const Point& p2)` Functor that provides \ref LinearCellComplexTraits::Vector " Vector " `operator() (const ` \ref Point "Point"`& p1, const ` \ref Point " Point"`& p2)`
which constructs a vector as the difference of points `p2-p1`, and which constructs a vector as the difference of points `p2-p1`, and
`Vector operator() (const CGAL::Origin&, const Point& p)` \ref LinearCellComplexTraits::Vector " Vector " `operator() (const CGAL::Origin&, const ` \ref Point " Point"`& p)`
which constructs a vector as the difference of point `p` and a point at the origin which constructs a vector as the difference of point `p` and a point at the origin
(used in `Linear_cell_complex::barycenter` and `CGAL::import_from_plane_graph`). (used in \ref CGAL::Linear_cell_complex::barycenter "Linear_cell_complex::barycenter"
and `CGAL::import_from_plane_graph`).
*/ */
typedef Hidden_type Construct_vector; typedef Hidden_type Construct_vector;
/*! /*!
Functor that provides `Vector operator() (const Vector& v1, const Vector& v2)` Functor that provides \ref LinearCellComplexTraits::Vector " Vector " `operator() (const` \ref LinearCellComplexTraits::Vector " Vector"`& v1, const` \ref LinearCellComplexTraits::Vector " Vector"`& v2)`
which constructs a vector as the sum of vectors `v1+v2` which constructs a vector as the sum of vectors `v1+v2`
(used in `Linear_cell_complex::barycenter`, `CGAL::compute_normal_of_cell_0` (used in \ref CGAL::Linear_cell_complex::barycenter "Linear_cell_complex::barycenter",
`CGAL::compute_normal_of_cell_0`
and `CGAL::compute_normal_of_cell_2`). and `CGAL::compute_normal_of_cell_2`).
*/ */
typedef Hidden_type Construct_sum_of_vectors; typedef Hidden_type Construct_sum_of_vectors;
/*! /*!
Functor that provides `Vector operator() (const Vector& v, FT scale)` Functor that provides \ref LinearCellComplexTraits::Vector " Vector " `operator() (const` \ref LinearCellComplexTraits::Vector " Vector"`& v, ` \ref LinearCellComplexTraits::FT "FT" `scale)`
which constructs a vector equal to vector `v` scaled by `scale` factor which constructs a vector equal to vector `v` scaled by `scale` factor
(used in `Linear_cell_complex::barycenter` , `CGAL::compute_normal_of_cell_0` (used in \ref CGAL::Linear_cell_complex::barycenter "Linear_cell_complex::barycenter",
and `CGAL::compute_normal_of_cell_2`). `CGAL::compute_normal_of_cell_0` and `CGAL::compute_normal_of_cell_2`).
*/ */
typedef Hidden_type Construct_scaled_vector; typedef Hidden_type Construct_scaled_vector;
/*! /*!
Functor that provides `Point operator() (const Point& p1, const Point& p2)` Functor that provides \ref LinearCellComplexTraits::Point "Point " `operator() (const ` \ref Point "Point"`& p1, const ` \ref Point "Point"`& p2)`
which constructs the midpoint of points `p1` and `p2` which constructs the midpoint of points `p1` and `p2`
(used in `Linear_cell_complex::barycenter`). (used in \ref CGAL::Linear_cell_complex::barycenter "Linear_cell_complex::barycenter").
*/ */
typedef Hidden_type Construct_midpoint; typedef Hidden_type Construct_midpoint;
@ -97,12 +98,12 @@ typedef Hidden_type Construct_midpoint;
/// @{ /// @{
/*! /*!
a model of `Direction_2`. a model of \ref Kernel::Direction_2 "Direction_2".
*/ */
typedef Hidden_type Direction_2; typedef Hidden_type Direction_2;
/*! /*!
a model of `ConstructDirection_2` (used in `CGAL::import_from_plane_graph`). a model of \ref Kernel::ConstructDirection_2 "ConstructDirection_2" (used in `CGAL::import_from_plane_graph`).
*/ */
typedef Hidden_type Construct_direction_2; typedef Hidden_type Construct_direction_2;
@ -113,12 +114,12 @@ typedef Hidden_type Construct_direction_2;
/// @{ /// @{
/*! /*!
a model of `ConstructNormal_3` (used in `CGAL::compute_normal_of_cell_2`). a model of \ref Kernel::ConstructNormal_3 "ConstructNormal_3" (used in `CGAL::compute_normal_of_cell_2`).
*/ */
typedef Hidden_type Construct_normal_3; typedef Hidden_type Construct_normal_3;
/*! /*!
a model of `Collinear_3` (used in `CGAL::compute_normal_of_cell_2`). a model of \ref Kernel::Collinear_3 "Collinear_3" (used in `CGAL::compute_normal_of_cell_2`).
*/ */
typedef Hidden_type Collinear_3; typedef Hidden_type Collinear_3;