Mario Botsch, Daniel Sieger, Philipp Moeller, and Andreas Fabri
The surface mesh class provided by this package is an implementation of the halfedge data structure allowing to represent polyhedral surfaces. It is an alternative to the packages
Halfedge Data Structures and
3D Polyhedral Surface. The main differences are that it is indexed based and not pointer based, and that the mechanism for adding information to vertices, halfedges, edges, and faces is much simpler and can be used at runtime and not at compile time.
Classes
Draw a Surface Mesh
|
class | CGAL::Surface_mesh< P > |
| This class is a data structure that can be used as halfedge data structure or polyhedral surface. It is an alternative to the classes HalfedgeDS and Polyhedron_3 defined in the packages Halfedge Data Structures and 3D Polyhedral Surface. The main difference is that it is indexed based and not pointer based, and that the mechanism for adding information to vertices, halfedges, edges, and faces is much simpler and done at runtime and not at compile time. When elements are removed, they are only marked as removed, and a garbage collection function must be called to really remove them. More...
|
|
|
template<typename P > |
bool | CGAL::write_off (std::ostream &os, const Surface_mesh< P > &sm) |
|
template<typename P > |
bool | CGAL::read_off (std::istream &is, Surface_mesh< P > &sm) |
|
template<typename P > |
Surface_mesh< P > & | operator+= (Surface_mesh< P > &sm, const Surface_mesh< P > &other) |
|
template<typename P , typename NamedParameters > |
bool | write_off (std::ostream &os, const Surface_mesh< P > &sm, const NamedParameters &np) |
|
template<typename P > |
std::ostream & | operator<< (std::ostream &os, const Surface_mesh< P > &sm) |
|
template<typename P , typename NamedParameters > |
bool | read_off (std::istream &is, Surface_mesh< P > &sm, NamedParameters np) |
|
template<typename P > |
std::istream & | operator>> (std::istream &is, Surface_mesh< P > &sm) |
|
◆ operator+=()
Inserts other
into sm
. Shifts the indices of vertices of other
by sm.number_of_vertices() + sm.number_of_removed_vertices()
and analoguously for halfedges, edges, and faces. Copies entries of all property maps which have the same name in sm
and other
. that is, property maps which are only in other
are ignored. Also copies elements which are marked as removed, and concatenates the freelists of sm
and other
.
◆ operator
template<typename P >
std::ostream & operator<< |
( |
std::ostream & |
os, |
|
|
const Surface_mesh< P > & |
sm |
|
) |
| |
|
related |
◆ operator>>()
template<typename P >
std::istream & operator>> |
( |
std::istream & |
is, |
|
|
Surface_mesh< P > & |
sm |
|
) |
| |
|
related |
◆ read_off()
template<typename P , typename NamedParameters >
bool read_off |
( |
std::istream & |
is, |
|
|
Surface_mesh< P > & |
sm, |
|
|
NamedParameters |
np |
|
) |
| |
|
related |
Extracts the surface mesh from an input stream in Ascii OFF, COFF, NOFF, CNOFF format and appends it to the surface mesh sm
. The operator reads the point property as well as "v:normal", "v:color", and "f:color". Vertex texture coordinates are ignored. If an alternative vertex_point map is given through np
, then it will be used instead of the default one.
- Precondition
operator>>(std::istream&,const P&)
must be defined.
-
The data in the stream must represent a two-manifold. If this is not the case the
failbit
of is
is set and the mesh cleared.
◆ write_off()
template<typename P , typename NamedParameters >
bool write_off |
( |
std::ostream & |
os, |
|
|
const Surface_mesh< P > & |
sm, |
|
|
const NamedParameters & |
np |
|
) |
| |
|
related |
Inserts the surface mesh in an output stream in Ascii OFF format. Only the point property is inserted in the stream. If an alternative vertex_point map is given through np
, then it will be used instead of the default one.
- Precondition
operator<<(std::ostream&,const P&)
must be defined.
- Note
- The
precision()
of the output stream might not be sufficient depending on the data to be written.