face.h

/*!
*	@file	face.h
*	@brief	Contains face class
*/

#ifndef __FACE_H__
#define __FACE_H__

#include <boost/logic/tribool.hpp>

#include "vertex.h"
#include "directed_edge.h"

namespace psalm
{

/*!
*	@class face
*	@brief Data for a face of the mesh
*/

class face
{
	public:
		face();

		void add_edge(const directed_edge& edge);
		void add_vertex(vertex* v);
		void add_face_vertex(vertex* v);

		size_t num_edges() const;
		size_t num_vertices() const;

		vertex* get_vertex(size_t i);
		const vertex* get_vertex(size_t i) const;
		vertex* get_face_vertex(size_t i);

		directed_edge& get_edge(size_t i);
		const directed_edge& get_edge(size_t i) const;

		/*!
		*	@brief Pointer to face point.
		*
		*	Pointer to face point that corresponds to the current
		*	face. This pointer is only set and read during
		*	subdivision algorithms and must \e not be relied on
		*	within other functions.
		*/

		vertex* face_point;

		bool is_on_boundary() const;
		void set_on_boundary(bool boundary = true);

		bool is_obtuse();

		void reconstruct_from_edges();

		double calc_area() const;

	private:
		std::vector<directed_edge> E;
		std::vector<vertex*> V;

		std::vector<vertex*> V_F;

		size_t id;

		bool boundary;	///< Flag signalling that the face is a
				///< boundary face.

		/*!
		*	Flag signalling that the face is an obtuse triangle.
		*	This makes only sense for triangles, of course. By
		*	using the tribool, the function `is_obtuse()` may
		*	decide whether it is required to _calculate_ the value
		*	of the flag or can simply return it.
		*/

		boost::logic::tribool obtuse;
};

} // end of namespace "psalm"

#endif