PMPCorefinementVisitor Concept Reference

Definition

The concept PMPCorefinementVisitor defines the requirements for the visitor used in corefinement-related functions to track the creation of new faces and new edges.

Refines:

CopyConstructible

Has Models:

CGAL::Polygon_mesh_processing::Corefinement::Default_visitor.

Public Types
typedef unspecified_type	Triangle_mesh
	Mesh type.
typedef unspecified_type	face_descriptor
	Face descriptor type.
typedef unspecified_type	halfedge_descriptor
	Halfedge descriptor type.

Functions used by corefine() when faces are split
void	before_subface_creations (face_descriptor f_split, Triangle_mesh &tm)
	called before the triangulation of f_split in tm. More...
void	after_subface_creations (Triangle_mesh &tm)
	called when the triangulation of a face in tm is finished.
void	before_subface_created (Triangle_mesh &tm)
	called before creating a new triangle face in tm to triangulate the face passed to before_subface_creations().
void	after_subface_created (face_descriptor f_new, Triangle_mesh &tm)
	called after creating a new triangle face f_new in tm to triangulate the face passed to before_subface_creations(). More...

Functions used by corefine() when edges are split or created
void	before_edge_split (halfedge_descriptor h, TriangleMesh &tm)
	called before the edge of h in tm is split. More...
void	edge_split (halfedge_descriptor hnew, TriangleMesh &tm)
	called when a new split is done. The target of hnew is a new split vertex. There is only one call per edge.
void	after_edge_split ()
	called when the split of the halfedge h passed at the later call to before_edge_split() is finished.
void	add_retriangulation_edge (halfedge_descriptor h, TriangleMesh &tm)
	called when a new edge has been added to triangulate a face. More...

Functions used by Boolean operations functions using corefinement.
These functions are not needed if you only call corefine().
void	before_face_copy (face_descriptor f_src, const Triangle_mesh &tm_src, Triangle_mesh &tm_tgt)
	called before importing the face f_src of tm_src in tm_tgt
void	after_face_copy (face_descriptor f_src, const Triangle_mesh &tm_src, face_descriptor f_tgt, Triangle_mesh &tm_tgt)
	called after importing the face f_src of tm_src in tm_tgt. More...
void	before_edge_copy (halfedge_descriptor h_src/, const TriangleMesh &tm_src, TriangleMesh &tm_tgt)
	called before importing the edge of h_src of tm_src in tm_tgt. There is one call per edge.
void	after_edge_copy (halfedge_descriptor h_src, const TriangleMesh &tm_src, halfedge_descriptor h_tgt, TriangleMesh &tm_tgt)
	called after importing the edge of h_src of tm_src in tm_tgt. More...
void	before_edge_duplicated (halfedge_descriptor h, TriangleMesh &tm)
	called before a patch boundary edge is duplicated to disconnect patches of tm (When an in-place operation and an out-of-place are both requested). More...
void	after_edge_duplicated (halfedge_descriptor h_src, halfedge_descriptor h_new, TriangleMesh &tm)
	called when the edge of h_src has been duplicated into h_new in tm (When an in-place operation and an out-of-place are both requested). More...
void	intersection_edge_copy (halfedge_descriptor h_src1, const TriangleMesh &tm_src1, halfedge_descriptor h_src2, const TriangleMesh &tm_src2, halfedge_descriptor h_tgt, TriangleMesh &tm_tgt)
	called when an intersection edge (represented in input meshes tm_src1 and tm_src2 by h_src1 and h_src2, respectively) is imported in tm_tgt as h_tgt. More...

Member Function Documentation

add_retriangulation_edge()

void PMPCorefinementVisitor::add_retriangulation_edge	(	halfedge_descriptor	h,
		TriangleMesh &	tm
	)

called when a new edge has been added to triangulate a face.

The face triangulated is f_split in the last call to before_subface_creations(f_split, tm). There is only one call per edge.

after_edge_copy()

void PMPCorefinementVisitor::after_edge_copy	(	halfedge_descriptor	h_src,
		const TriangleMesh &	tm_src,
		halfedge_descriptor	h_tgt,
		TriangleMesh &	tm_tgt
	)

called after importing the edge of h_src of tm_src in tm_tgt.

The corresponding new halfedge is h_tgt. There is only one call per edge.

after_edge_duplicated()

void PMPCorefinementVisitor::after_edge_duplicated	(	halfedge_descriptor	h_src,
		halfedge_descriptor	h_new,
		TriangleMesh &	tm
	)

called when the edge of h_src has been duplicated into h_new in tm (When an in-place operation and an out-of-place are both requested).

after_face_copy()

void PMPCorefinementVisitor::after_face_copy	(	face_descriptor	f_src,
		const Triangle_mesh &	tm_src,
		face_descriptor	f_tgt,
		Triangle_mesh &	tm_tgt
	)

called after importing the face f_src of tm_src in tm_tgt.

The new face is f_tgt. Note that the call is placed just after a call to add_face() so the halfedge pointer is not set yet.

after_subface_created()

void PMPCorefinementVisitor::after_subface_created	(	face_descriptor	f_new,
		Triangle_mesh &	tm
	)

called after creating a new triangle face f_new in tm to triangulate the face passed to before_subface_creations().

Note that the call is placed just after a call to add_face() so the halfedge pointer is not set yet.

before_edge_duplicated()

void PMPCorefinementVisitor::before_edge_duplicated	(	halfedge_descriptor	h,
		TriangleMesh &	tm
	)

called before a patch boundary edge is duplicated to disconnect patches of tm (When an in-place operation and an out-of-place are both requested).

before_edge_split()

void PMPCorefinementVisitor::before_edge_split	(	halfedge_descriptor	h,
		TriangleMesh &	tm
	)

called before the edge of h in tm is split.

Each subsequent call to edge_split() until the call to after_edge_split() will correspond to the split of that edge. If edge_split(h_i, tm) is called for i=1 to n, h_1, h_2, ... ,h_n, h is the sequence of halfedges representing the edge split (with the same initial orientation). There is only one call per edge.

before_subface_creations()

void PMPCorefinementVisitor::before_subface_creations	(	face_descriptor	f_split,
		Triangle_mesh &	tm
	)

called before the triangulation of f_split in tm.

Note that f_split will be one of the faces of the triangulation. Each subsequent call to before_subface_created()/after_subface_created() will correspond to the creation of a new face of the triangulation of f_split.

intersection_edge_copy()

void PMPCorefinementVisitor::intersection_edge_copy	(	halfedge_descriptor	h_src1,
		const TriangleMesh &	tm_src1,
		halfedge_descriptor	h_src2,
		const TriangleMesh &	tm_src2,
		halfedge_descriptor	h_tgt,
		TriangleMesh &	tm_tgt
	)

called when an intersection edge (represented in input meshes tm_src1 and tm_src2 by h_src1 and h_src2, respectively) is imported in tm_tgt as h_tgt.

There is only one call per edge. (Called only when an out-of-place operation is requested)