CGAL 5.3 - dD Triangulations
TriangulationDSFullCell Concept Reference

Definition

The concept TriangulationDSFullCell describes the requirements for the full cell class of a CGAL::Triangulation_data_structure. It refines the concept TriangulationDataStructure::FullCell.

Since the CGAL::Triangulation_data_structure is the class which defines the handle types, the full cell base class has to be somehow parameterized by the triangulation data structure. But since the CGAL::Triangulation_data_structure itself is parameterized by the cell and vertex base classes, there is a cycle in the definition of these classes. In order to break the cycle, the base classes for cells and vertices which are plugged in to instantiate a Triangulation_data_structure use a void as triangulation data structure parameter. Then, the CGAL::Triangulation_data_structure uses a rebind mechanism (similar to the one specified in std::allocator) in order to plug itself as parameter in the full cell and vertex base classes. This mechanism requires that the base class provides a templated nested class Rebind_TDS that itself provides the subtype Rebind_TDS::Other which is the rebound version of the base class. This rebound base class is the class that the CGAL::Triangulation_data_structure actually uses as a base class for the class of CGAL::Triangulation_data_structure::Vertex.

Refines:
TriangulationDataStructure::FullCell
Has Models:

CGAL::Triangulation_ds_full_cell<TriangulationDataStructure_, DSFullCellStoragePolicy>

CGAL::Triangulation_full_cell<TriangulationTraits_, Data, TriangulationDSFullCell_>

See also
TriangulationDSVertex
TriangulationDSFace
TriangulationDataStructure
TriangulationDataStructure::FullCell

Types

typedef unspecified_type Triangulation_data_structure
 The Triangulation_data_structure in which the TriangulationDSFullCell is defined/used. More...
 
template<typename TDS2 >
using Rebind_TDS = unspecified_type
 This nested template class has to define a type Rebind_TDS<TDS2>::Other which is the rebound vertex, that is, the one that will be actually used by Triangulation_data_structure. More...
 

Creation

If you want to create a full cell as part of a TriangulationDataStructure, you would rather want to call the new_full_cell() from the latter concept, as it is not possible to incorporate an existing external full cell into a triangulation.

 TriangulationDSFullCell (int dmax)
 Sets the maximum possible dimension of the full cell.
 
 TriangulationDSFullCell (const TriangulationDSFullCell &fc)
 Copy constructor.
 

Memory Management

These member functions are required by Triangulation_data_structure because it uses Compact_container to store its cells.

See the documentation of Compact_container for the exact requirements.

void * for_compact_container () const
 
void for_compact_container (void *p)
 

Member Typedef Documentation

◆ Rebind_TDS

template<typename TDS2 >
using TriangulationDSFullCell::Rebind_TDS = unspecified_type

This nested template class has to define a type Rebind_TDS<TDS2>::Other which is the rebound vertex, that is, the one that will be actually used by Triangulation_data_structure.

The Rebind_TDS<TDS2>::Other type will be the real base class of Triangulation_data_structure::Full_cell.

Note
It can be implemented using a nested template class.

◆ Triangulation_data_structure

The Triangulation_data_structure in which the TriangulationDSFullCell is defined/used.

Must be a model of the TriangulationDataStructure concept.