SurfaceMesh Class Reference

A halfedge data structure for polygonal meshes.

#include <pmp/SurfaceMesh.h>

Inherited by SurfaceMeshGL.

Classes
class	EdgeContainer
	helper class for iterating through all edges using range-based for-loops. More...
class	EdgeIterator
	this class iterates linearly over all edges More...
class	FaceAroundVertexCirculator
	this class circulates through all incident faces of a vertex. More...
class	FaceContainer
	helper class for iterating through all faces using range-based for-loops. More...
class	FaceIterator
	this class iterates linearly over all faces More...
class	HalfedgeAroundFaceCirculator
	this class circulates through all halfedges of a face. More...
class	HalfedgeAroundVertexCirculator
	this class circulates through all outgoing halfedges of a vertex. More...
class	HalfedgeContainer
	helper class for iterating through all halfedges using range-based for-loops. More...
class	HalfedgeIterator
	this class iterates linearly over all halfedges More...
class	VertexAroundFaceCirculator
	this class circulates through the vertices of a face. More...
class	VertexAroundVertexCirculator
	this class circulates through all one-ring neighbors of a vertex. More...
class	VertexContainer
	helper class for iterating through all vertices using range-based for-loops. More...
class	VertexIterator
	An iterator class to iterate linearly over all vertices. More...

Public Member Functions
Construction, destruction, assignment
	SurfaceMesh ()
	default constructor
virtual	~SurfaceMesh ()
	destructor
	SurfaceMesh (const SurfaceMesh &rhs)
	copy constructor: copies rhs to *this. More...
SurfaceMesh &	operator= (const SurfaceMesh &rhs)
	assign rhs to *this. performs a deep copy of all properties.
SurfaceMesh &	assign (const SurfaceMesh &rhs)
	assign rhs to *this. does not copy custom properties.
File IO
void	read (const std::string &filename, const IOFlags &flags=IOFlags())
	Read mesh from file filename controlled by flags. More...
void	write (const std::string &filename, const IOFlags &flags=IOFlags()) const
	Write mesh to file filename controlled by flags. More...
Add new elements by hand
Vertex	add_vertex (const Point &p)
	add a new vertex with position p
Face	add_face (const std::vector< Vertex > &vertices)
	Add a new face with vertex list vertices. More...
Face	add_triangle (Vertex v0, Vertex v1, Vertex v2)
	add a new triangle connecting vertices v0, v1, v2 More...
Face	add_quad (Vertex v0, Vertex v1, Vertex v2, Vertex v3)
	add a new quad connecting vertices v0, v1, v2, v3 More...
Memory Management
size_t	vertices_size () const
	returns number of (deleted and valid) vertices in the mesh
size_t	halfedges_size () const
	returns number of (deleted and valid) halfedges in the mesh
size_t	edges_size () const
	returns number of (deleted and valid) edges in the mesh
size_t	faces_size () const
	returns number of (deleted and valid) faces in the mesh
size_t	n_vertices () const
	returns number of vertices in the mesh
size_t	n_halfedges () const
	returns number of halfedge in the mesh
size_t	n_edges () const
	returns number of edges in the mesh
size_t	n_faces () const
	returns number of faces in the mesh
bool	is_empty () const
	returns true if the mesh is empty, i.e., has no vertices
virtual void	clear ()
	clear mesh: remove all vertices, edges, faces
void	free_memory ()
	remove unused memory from vectors
void	reserve (size_t nvertices, size_t nedges, size_t nfaces)
	reserve memory (mainly used in file readers)
void	garbage_collection ()
	remove deleted elements
bool	is_deleted (Vertex v) const
	returns whether vertex v is deleted More...
bool	is_deleted (Halfedge h) const
	returns whether halfedge h is deleted More...
bool	is_deleted (Edge e) const
	returns whether edge e is deleted More...
bool	is_deleted (Face f) const
	returns whether face f is deleted More...
bool	is_valid (Vertex v) const
	return whether vertex v is valid, i.e. More...
bool	is_valid (Halfedge h) const
	return whether halfedge h is valid, i.e. More...
bool	is_valid (Edge e) const
	return whether edge e is valid, i.e. the index is stores it within the array bounds.
bool	is_valid (Face f) const
	returns whether the face f is valid.
Low-level connectivity
Halfedge	halfedge (Vertex v) const
	returns an outgoing halfedge of vertex v. More...
void	set_halfedge (Vertex v, Halfedge h)
	set the outgoing halfedge of vertex v to h
bool	is_boundary (Vertex v) const
	returns whether v is a boundary vertex
bool	is_isolated (Vertex v) const
	returns whether v is isolated, i.e., not incident to any edge
bool	is_manifold (Vertex v) const
	returns whether v is a manifold vertex (not incident to several patches)
Vertex	to_vertex (Halfedge h) const
	returns the vertex the halfedge h points to
Vertex	from_vertex (Halfedge h) const
	returns the vertex the halfedge h emanates from
void	set_vertex (Halfedge h, Vertex v)
	sets the vertex the halfedge h points to to v
Face	face (Halfedge h) const
	returns the face incident to halfedge h
void	set_face (Halfedge h, Face f)
	sets the incident face to halfedge h to f
Halfedge	next_halfedge (Halfedge h) const
	returns the next halfedge within the incident face
void	set_next_halfedge (Halfedge h, Halfedge nh)
	sets the next halfedge of h within the face to nh
void	set_prev_halfedge (Halfedge h, Halfedge ph)
	sets the previous halfedge of h and the next halfedge of ph to nh
Halfedge	prev_halfedge (Halfedge h) const
	returns the previous halfedge within the incident face
Halfedge	opposite_halfedge (Halfedge h) const
	returns the opposite halfedge of h
Halfedge	ccw_rotated_halfedge (Halfedge h) const
	returns the halfedge that is rotated counter-clockwise around the start vertex of h. More...
Halfedge	cw_rotated_halfedge (Halfedge h) const
	returns the halfedge that is rotated clockwise around the start vertex of h. More...
Edge	edge (Halfedge h) const
	return the edge that contains halfedge h as one of its two halfedges.
bool	is_boundary (Halfedge h) const
	returns whether h is a boundary halfege, i.e., if its face does not exist.
Halfedge	halfedge (Edge e, unsigned int i) const
	returns the i'th halfedge of edge e. i has to be 0 or 1.
Vertex	vertex (Edge e, unsigned int i) const
	returns the i'th vertex of edge e. i has to be 0 or 1.
Face	face (Edge e, unsigned int i) const
	returns the face incident to the i'th halfedge of edge e. i has to be 0 or 1.
bool	is_boundary (Edge e) const
	returns whether e is a boundary edge, i.e., if one of its halfedges is a boundary halfedge.
Halfedge	halfedge (Face f) const
	returns a halfedge of face f
void	set_halfedge (Face f, Halfedge h)
	sets the halfedge of face f to h
bool	is_boundary (Face f) const
	returns whether f is a boundary face, i.e., it one of its edges is a boundary edge.
Property handling
template<class T >
ObjectProperty< T >	add_object_property (const std::string &name, const T t=T())
	add a object property of type T with name name and default value t. More...
template<class T >
ObjectProperty< T >	get_object_property (const std::string &name) const
	get the object property named name of type T. More...
template<class T >
ObjectProperty< T >	object_property (const std::string &name, const T t=T())
	if a object property of type T with name name exists, it is returned. More...
template<class T >
void	remove_object_property (ObjectProperty< T > &p)
	remove the object property p
const std::type_info &	get_object_propertyType (const std::string &name)
	get the type_info T of face property named name. More...
std::vector< std::string >	object_properties () const
	returns the names of all face properties
template<class T >
VertexProperty< T >	add_vertex_property (const std::string &name, const T t=T())
	add a vertex property of type T with name name and default value t. More...
template<class T >
VertexProperty< T >	get_vertex_property (const std::string &name) const
	get the vertex property named name of type T. More...
template<class T >
VertexProperty< T >	vertex_property (const std::string &name, const T t=T())
	if a vertex property of type T with name name exists, it is returned. More...
template<class T >
void	remove_vertex_property (VertexProperty< T > &p)
	remove the vertex property p
bool	has_vertex_property (const std::string &name) const
	does the mesh have a vertex property with name name?
template<class T >
HalfedgeProperty< T >	add_halfedge_property (const std::string &name, const T t=T())
	add a halfedge property of type T with name name and default value t. More...
template<class T >
EdgeProperty< T >	add_edge_property (const std::string &name, const T t=T())
	add a edge property of type T with name name and default value t. More...
template<class T >
HalfedgeProperty< T >	get_halfedge_property (const std::string &name) const
	get the halfedge property named name of type T. More...
template<class T >
EdgeProperty< T >	get_edge_property (const std::string &name) const
	get the edge property named name of type T. More...
template<class T >
HalfedgeProperty< T >	halfedge_property (const std::string &name, const T t=T())
	if a halfedge property of type T with name name exists, it is returned. More...
template<class T >
EdgeProperty< T >	edge_property (const std::string &name, const T t=T())
	if an edge property of type T with name name exists, it is returned. More...
template<class T >
void	remove_halfedge_property (HalfedgeProperty< T > &p)
	remove the halfedge property p
bool	has_halfedge_property (const std::string &name) const
	does the mesh have a halfedge property with name name?
template<class T >
void	remove_edge_property (EdgeProperty< T > &p)
	remove the edge property p
bool	has_edge_property (const std::string &name) const
	does the mesh have an edge property with name name?
const std::type_info &	get_halfedge_property_type (const std::string &name)
	get the type_info T of halfedge property named name. More...
const std::type_info &	get_vertex_property_type (const std::string &name)
	get the type_info T of vertex property named name. More...
const std::type_info &	get_edge_property_type (const std::string &name)
	get the type_info T of edge property named name. More...
std::vector< std::string >	vertex_properties () const
	returns the names of all vertex properties
std::vector< std::string >	halfedge_properties () const
	returns the names of all halfedge properties
std::vector< std::string >	edge_properties () const
	returns the names of all edge properties
template<class T >
FaceProperty< T >	add_face_property (const std::string &name, const T t=T())
	add a face property of type T with name name and default value t. More...
template<class T >
FaceProperty< T >	get_face_property (const std::string &name) const
	get the face property named name of type T. More...
template<class T >
FaceProperty< T >	face_property (const std::string &name, const T t=T())
	if a face property of type T with name name exists, it is returned. More...
template<class T >
void	remove_face_property (FaceProperty< T > &p)
	remove the face property p
bool	has_face_property (const std::string &name) const
	does the mesh have a face property with name name?
const std::type_info &	get_face_property_type (const std::string &name)
	get the type_info T of face property named name . More...
std::vector< std::string >	face_properties () const
	returns the names of all face properties
void	property_stats () const
	prints the names of all properties
Iterators and circulators
VertexIterator	vertices_begin () const
	returns start iterator for vertices
VertexIterator	vertices_end () const
	returns end iterator for vertices
VertexContainer	vertices () const
	returns vertex container for C++11 range-based for-loops
HalfedgeIterator	halfedges_begin () const
	returns start iterator for halfedges
HalfedgeIterator	halfedges_end () const
	returns end iterator for halfedges
HalfedgeContainer	halfedges () const
	returns halfedge container for C++11 range-based for-loops
EdgeIterator	edges_begin () const
	returns start iterator for edges
EdgeIterator	edges_end () const
	returns end iterator for edges
EdgeContainer	edges () const
	returns edge container for C++11 range-based for-loops
VertexAroundVertexCirculator	vertices (Vertex v) const
	returns circulator for vertices around vertex v
HalfedgeAroundVertexCirculator	halfedges (Vertex v) const
	returns circulator for outgoing halfedges around vertex v
FaceIterator	faces_begin () const
	returns start iterator for faces
FaceIterator	faces_end () const
	returns end iterator for faces
FaceContainer	faces () const
	returns face container for C++11 range-based for-loops
FaceAroundVertexCirculator	faces (Vertex v) const
	returns circulator for faces around vertex v
VertexAroundFaceCirculator	vertices (Face f) const
	returns circulator for vertices of face f
HalfedgeAroundFaceCirculator	halfedges (Face f) const
	returns circulator for halfedges of face f
Higher-level Topological Operations
Halfedge	insert_vertex (Edge e, const Point &p)
	Subdivide the edge e = (v0,v1) by splitting it into the two edge (v0,p) and (p,v1). More...
Halfedge	insert_vertex (Edge e, Vertex v)
	Subdivide the edge e = (v0,v1) by splitting it into the two edge (v0,v) and (v,v1). More...
Halfedge	insert_vertex (Halfedge h0, Vertex v)
	Subdivide the halfedge h = (v0,v1) by splitting it into the two halfedges (v0,v) and (v,v1). More...
Halfedge	find_halfedge (Vertex start, Vertex end) const
	find the halfedge from start to end
Edge	find_edge (Vertex a, Vertex b) const
	find the edge (a,b)
bool	is_triangle_mesh () const
	returns whether the mesh a triangle mesh. More...
bool	is_quad_mesh () const
	returns whether the mesh a quad mesh. More...
bool	is_collapse_ok (Halfedge v0v1)
	returns whether collapsing the halfedge v0v1 is topologically legal. More...
void	collapse (Halfedge h)
	Collapse the halfedge h by moving its start vertex into its target vertex. More...
bool	is_removal_ok (Edge e)
	returns whether removing the edge e is topologically legal.
bool	remove_edge (Edge e)
	Remove edge and merge its two incident faces into one. More...
Vertex	split (Face f, const Point &p)
	Split the face f by first adding point p to the mesh and then inserting edges between p and the vertices of f. More...
void	split (Face f, Vertex v)
	Split the face f by inserting edges between v and the vertices of f. More...
Halfedge	split (Edge e, const Point &p)
	Split the edge e by first adding point p to the mesh and then connecting it to the two vertices of the adjacent triangles that are opposite to edge e. More...
Halfedge	split (Edge e, Vertex v)
	Split the edge e by connecting vertex v it to the two vertices of the adjacent triangles that are opposite to edge e. More...
Halfedge	insert_edge (Halfedge h0, Halfedge h1)
	insert edge between the to-vertices v0 of h0 and v1 of h1. More...
bool	is_flip_ok (Edge e) const
	Check whether flipping edge e is topologically. More...
void	flip (Edge e)
	Flip the edge e . More...
size_t	valence (Vertex v) const
	returns the valence (number of incident edges or neighboring vertices) of vertex v.
size_t	valence (Face f) const
	returns the valence of face f (its number of vertices)
void	delete_vertex (Vertex v)
	deletes the vertex v from the mesh
void	delete_edge (Edge e)
	deletes the edge e from the mesh
void	delete_face (Face f)
	deletes the face f from the mesh
Geometry-related Functions
const Point &	position (Vertex v) const
	position of a vertex (read only)
Point &	position (Vertex v)
	position of a vertex
std::vector< Point > &	positions ()
BoundingBox	bounds () const
	compute the bounding box of the object
Scalar	edge_length (Edge e) const
	compute the length of edge e.
Allocate new elements
Vertex	new_vertex ()
	Allocate a new vertex, resize vertex properties accordingly. More...
Halfedge	new_edge ()
	Allocate a new edge, resize edge and halfedge properties accordingly. More...
Halfedge	new_edge (Vertex start, Vertex end)
	Allocate a new edge, resize edge and halfedge properties accordingly. More...
Face	new_face ()
	Allocate a new face, resize face properties accordingly. More...

Constructor & Destructor Documentation

SurfaceMesh()

SurfaceMesh ( const SurfaceMesh &  rhs )

inline

performs a deep copy of all properties.

Member Function Documentation

add_edge_property()

EdgeProperty<T> add_edge_property ( const std::string &  name, const T  t = T()  )

inline

fails if a property named name exists already, since the name has to be unique. in this case it returns an invalid property.

add_face()

Face add_face

(

const std::vector< Vertex > &

vertices

)

Exceptions

TopologyException

in case a topological error occurs.

See also

add_triangle, add_quad

add_face_property()

FaceProperty<T> add_face_property ( const std::string &  name, const T  t = T()  )

inline

fails if a property named name exists already, since the name has to be unique. in this case it returns an invalid property

add_halfedge_property()

HalfedgeProperty<T> add_halfedge_property ( const std::string &  name, const T  t = T()  )

inline

fails if a property named name exists already, since the name has to be unique. in this case it returns an invalid property.

add_object_property()

ObjectProperty<T> add_object_property ( const std::string &  name, const T  t = T()  )

inline

fails if a property named name exists already, since the name has to be unique. in this case it returns an invalid property

add_quad()

Face add_quad	(	Vertex	v0,
		Vertex	v1,
		Vertex	v2,
		Vertex	v3
	)

See also

add_triangle, add_face

add_triangle()

Face add_triangle	(	Vertex	v0,
		Vertex	v1,
		Vertex	v2
	)

See also

add_face, add_quad

add_vertex_property()

VertexProperty<T> add_vertex_property ( const std::string &  name, const T  t = T()  )

inline

fails if a property named name exists already, since the name has to be unique. in this case it returns an invalid property

ccw_rotated_halfedge()

Halfedge ccw_rotated_halfedge ( Halfedge  h ) const

inline

it is the opposite halfedge of the previous halfedge of h.

collapse()

void collapse

(

Halfedge

h

)

For non-boundary halfedges this function removes one vertex, three edges, and two faces. For boundary halfedges it removes one vertex, two edges and one face.

Attention

This function is only valid for triangle meshes.

Halfedge collapses might lead to invalid faces. Call is_collapse_ok(Halfedge) to be sure the collapse is legal.

The removed items are only marked as deleted. You have to call garbage_collection() to finally remove them.

cw_rotated_halfedge()

Halfedge cw_rotated_halfedge ( Halfedge  h ) const

inline

it is the next halfedge of the opposite halfedge of h.

edge_property()

EdgeProperty<T> edge_property ( const std::string &  name, const T  t = T()  )

inline

otherwise this property is added (with default value t)

face_property()

FaceProperty<T> face_property ( const std::string &  name, const T  t = T()  )

inline

otherwise this property is added (with default value t)

flip()

void flip

(

Edge

e

)

Removes the edge e and add an edge between the two vertices opposite to edge e of the two incident triangles.

Attention

This function is only valid for triangle meshes.

Flipping an edge may result in a non-manifold mesh, hence check for yourself whether this operation is allowed or not!

See also

is_flip_ok()

get_edge_property()

EdgeProperty<T> get_edge_property ( const std::string &  name ) const

inline

returns an invalid VertexProperty if the property does not exist or if the type does not match.

get_edge_property_type()

const std::type_info& get_edge_property_type ( const std::string &  name )

inline

returns an typeid(void) if the property does not exist or if the type does not match.

get_face_property()

FaceProperty<T> get_face_property ( const std::string &  name ) const

inline

returns an invalid VertexProperty if the property does not exist or if the type does not match.

get_face_property_type()

const std::type_info& get_face_property_type ( const std::string &  name )

inline

returns an typeid(void) if the property does not exist or if the type does not match.

get_halfedge_property()

HalfedgeProperty<T> get_halfedge_property ( const std::string &  name ) const

inline

returns an invalid VertexProperty if the property does not exist or if the type does not match.

get_halfedge_property_type()

const std::type_info& get_halfedge_property_type ( const std::string &  name )

inline

returns an typeid(void) if the property does not exist or if the type does not match.

get_object_property()

ObjectProperty<T> get_object_property ( const std::string &  name ) const

inline

returns an invalid ObjectProperty if the property does not exist or if the type does not match.

get_object_propertyType()

const std::type_info& get_object_propertyType ( const std::string &  name )

inline

returns an typeid(void) if the property does not exist or if the type does not match.

get_vertex_property()

VertexProperty<T> get_vertex_property ( const std::string &  name ) const

inline

returns an invalid VertexProperty if the property does not exist or if the type does not match.

get_vertex_property_type()

const std::type_info& get_vertex_property_type ( const std::string &  name )

inline

returns an typeid(void) if the property does not exist or if the type does not match.

halfedge()

Halfedge halfedge ( Vertex  v ) const

inline

if v is a boundary vertex this will be a boundary halfedge.

halfedge_property()

HalfedgeProperty<T> halfedge_property ( const std::string &  name, const T  t = T()  )

inline

otherwise this property is added (with default value t)

insert_edge()

Halfedge insert_edge	(	Halfedge	h0,
		Halfedge	h1
	)

returns the new halfedge from v0 to v1.

Attention

h0 and h1 have to belong to the same face

insert_vertex() [1/3]

Halfedge insert_vertex ( Edge  e, const Point &  p  )

inline

Note that this function does not introduce any other edge or faces. It simply splits the edge. Returns halfedge that points to p.

See also

insert_vertex(Edge, Vertex)

insert_vertex(Halfedge, Vertex)

insert_vertex() [2/3]

Halfedge insert_vertex ( Edge  e, Vertex  v  )

inline

Note that this function does not introduce any other edge or faces. It simply splits the edge. Returns halfedge that points to p.

See also

insert_vertex(Edge, Point)

insert_vertex(Halfedge, Vertex)

insert_vertex() [3/3]

Halfedge insert_vertex	(	Halfedge	h0,
		Vertex	v
	)

Note that this function does not introduce any other edge or faces. It simply splits the edge. Returns the halfedge that points from v1 to v.

See also

insert_vertex(Edge, Point)

insert_vertex(Edge, Vertex)

is_collapse_ok()

bool is_collapse_ok

(

Halfedge

v0v1

)

Attention

This function is only valid for triangle meshes.

is_deleted() [1/4]

bool is_deleted ( Edge  e ) const

inline

See also

garbage_collection()

is_deleted() [2/4]

bool is_deleted ( Face  f ) const

inline

See also

garbage_collection()

is_deleted() [3/4]

bool is_deleted ( Halfedge  h ) const

inline

See also

garbage_collection()

is_deleted() [4/4]

bool is_deleted ( Vertex  v ) const

inline

See also

garbage_collection()

is_flip_ok()

bool is_flip_ok

(

Edge

e

)

const

Attention

This function is only valid for triangle meshes.

See also

flip(Edge)

is_quad_mesh()

bool is_quad_mesh

(

)

const

this function simply tests each face, and therefore is not very efficient.

is_triangle_mesh()

bool is_triangle_mesh

(

)

const

this function simply tests each face, and therefore is not very efficient.

See also

trianglate(), triangulate(Face)

is_valid() [1/2]

bool is_valid ( Halfedge  h ) const

inline

the index is stores it within the array bounds.

is_valid() [2/2]

bool is_valid ( Vertex  v ) const

inline

the index is stores it within the array bounds.

new_edge() [1/2]

Halfedge new_edge ( )

inline

Exceptions

AllocationException

in case of failure to allocate a new edge.

new_edge() [2/2]

Halfedge new_edge ( Vertex  start, Vertex  end  )

inline

Exceptions

AllocationException

in case of failure to allocate a new edge.

Parameters

start	starting Vertex of the new edge
end	end Vertex of the new edge

new_face()

Face new_face ( )

inline

Exceptions

AllocationException

in case of failure to allocate a new face.

new_vertex()

Vertex new_vertex ( )

inline

Exceptions

AllocationException

in case of failure to allocate a new vertex.

object_property()

ObjectProperty<T> object_property ( const std::string &  name, const T  t = T()  )

inline

otherwise this property is added (with default value t)

positions()

std::vector<Point>& positions ( )

inline

Returns

vector of point positions

read()

void read	(	const std::string &	filename,
		const IOFlags &	flags = IOFlags()
	)

File extension determines file type. Supported formats and vertex attributes (a=ASCII, b=binary):

Format	ASCII	Binary	Normals	Colors	Texcoords
OFF	yes	yes	a / b	a	a / b
OBJ	yes	no	a	no	no
STL	yes	yes	no	no	no
PLY	yes	yes	no	no	no
PMP	no	yes	no	no	no
XYZ	yes	no	a	no	no
AGI	yes	no	a	a	no

In addition, the OBJ and PMP formats support reading per-halfedge texture coordinates.

remove_edge()

bool remove_edge

(

Edge

e

)

This operation requires that the edge has two incident faces and that these two are not equal.

split() [1/4]

Halfedge split ( Edge  e, const Point &  p  )

inline

Returns the halfedge pointing to p that is created by splitting the existing edge e.

Attention

This function is only valid for triangle meshes.

See also

split(Edge, Vertex)

split() [2/4]

Halfedge split	(	Edge	e,
		Vertex	v
	)

Returns the halfedge pointing to v that is created by splitting the existing edge e.

Attention

This function is only valid for triangle meshes.

See also

split(Edge, Point)

split() [3/4]

Vertex split ( Face  f, const Point &  p  )

inline

For a triangle this is a standard one-to-three split.

See also

split(Face, Vertex)

split() [4/4]

void split	(	Face	f,
		Vertex	v
	)

For a triangle this is a standard one-to-three split.

See also

split(Face, const Point&)

vertex_property()

VertexProperty<T> vertex_property ( const std::string &  name, const T  t = T()  )

inline

otherwise this property is added (with default value t)

write()

void write	(	const std::string &	filename,
		const IOFlags &	flags = IOFlags()
	)		const

File extension determines file type. Supported formats and vertex attributes (a=ASCII, b=binary):

Format	ASCII	Binary	Normals	Colors	Texcoords
OFF	yes	yes	a	a	a
OBJ	yes	no	a	no	no
STL	yes	no	no	no	no
PLY	yes	yes	no	no	no
PMP	no	yes	no	no	no
XYZ	yes	no	a	no	no

In addition, the OBJ and PMP formats support writing per-halfedge texture coordinates.