CGAL 6.2 - 2D Arrangements: OverlayTraits Concept Reference

CGAL 6.2 - 2D Arrangements

Loading...
Searching...
No Matches
List of all members
OverlayTraits Concept Reference
Reference Manual » Concepts » Geometry Traits Concepts

## Definition

A model for the `OverlayTraits` should be able to operate on records (namely, vertices, halfedges and faces) of two input DCEL classes, named `Dcel_A` and `Dcel_B`, and construct the records of an output DCEL class, referred to as `Dcel_R`.

Models for the concept are used by the global `overlay()` function to maintain the auxiliary data stored with the DCEL records of the resulting overlaid arrangement, based on the contents of the input records.

Has models
  `CGAL::Arr_default_overlay_traits<Arrangement>`
  `CGAL::Arr_face_overlay_traits<Arr1,Arr2,ResArr,OvlFaceData>`

See also
  `overlay`

## Types
typedef unspecified_type | Vertex_handle_A
| a constant handle a vertex in `Dcel_A`.
typedef unspecified_type | Halfedge_handle_A
| a constant handle to a halfedge in `Dcel_A`.
typedef unspecified_type | Face_handle_A
| a constant handle to a face `Dcel_A`.
typedef unspecified_type | Vertex_handle_B
| a constant handle to a vertex in `Dcel_B`.
typedef unspecified_type | Halfedge_handle_B
| a constant handle to a halfedge in `Dcel_B`.
typedef unspecified_type | Face_handle_B
| a constant handle to a face in `Dcel_B`.
typedef unspecified_type | Vertex_handle_R
| a handle to a vertex in `Dcel_R`.
typedef unspecified_type | Halfedge_handle_R
| a handle to a halfedge in `Dcel_R`.
typedef unspecified_type | Face_handle_R
| a handle to a faces in `Dcel_R`.

## Vertex Creation
Whenever a vertex in the overlaid arrangement is created, one of the following functions is called in order to attach the appropriate auxiliary data to this vertex:
void | create_vertex (Vertex_handle_A v1, Vertex_handle_B v2, Vertex_handle_R v) const
| constructs the vertex `v` induced by the coinciding vertices `v1` and `v2`.
void | create_vertex (Vertex_handle_A v1, Halfedge_handle_B e2, Vertex_handle_R v) const
| constructs the vertex `v` induced by the vertex `v1` that lies on the halfedge `e2`.
void | create_vertex (Vertex_handle_A v1, Face_handle_B f2, Vertex_handle_R v) const
| constructs the vertex `v` induced by the vertex `v1` that lies inside the face `f2`.
void | create_vertex (Halfedge_handle_A e1, Vertex_handle_B v2, Vertex_handle_R v) const
| constructs the vertex `v` induced by the vertex `v2` that lies on the halfedge `e1`.
void | create_vertex (Face_handle_A f1, Vertex_handle_B v2, Vertex_handle_R v) const
| constructs the vertex `v` induced by the vertex `v2` that lies inside the face `f1`.
void | create_vertex (Halfedge_handle_A e1, Halfedge_handle_B e2, Vertex_handle_R v) const
| constructs the vertex `v` induced by the intersection of the halfedges `e1` and `e2`.

## Edge Creation
Whenever an edge in the overlaid arrangement is created, one of the following functions is called in order to attach the appropriate auxiliary data to this vertex. Note that an edge is created after both its end-vertices are created, (and the corresponding `create_vertex()` methods were invoked). In all cases, the edge is represented by a halfedge `e` directed in lexicographic decreasing order (from right to left). The `create_edge()` method should attach auxiliary data to the twin halfedge (namely to `e->twin()`) as well:
void | create_edge (Halfedge_handle_A e1, Halfedge_handle_B e2, Halfedge_handle_R e) const
| constructs the halfedge `e` induced by an overlap between the halfedges `e1` and `e2`.
void | create_edge (Halfedge_handle_A e1, Face_handle_B f2, Halfedge_handle_R e) const
| constructs the halfedge `e` induced by the halfedge `e1` that lies inside the face `f2`.
void | create_edge (Face_handle_A f1, Halfedge_handle_B e2, Halfedge_handle_R e) const
| constructs the halfedge `e` induced by the halfedge `e2` that lies inside the face `f1`.

## Face Creation
The following function is invoked whenever a new face is created. It is guaranteed that all halfedges along the face boundary have already been created and have their auxiliary data fields attached to them:
void | create_face (Face_handle_A f1, Face_handle_B f2, Face_handle_R f) const
| constructs the face `f` induced by the an overlap between the faces `f1` and `f2`.