A quadrangle. More...

#include <bayeux/geomtools/quadrangle.h>

Inheritance diagram for geomtools::quadrangle:

Public Types
enum	inner_triangle_index_type { IT_NONE = 0, IT_FIRST = 1, IT_SECOND = 2 }
	Index of an inner triangle. More...

enum	quadrangle_wires_rendering_option_type { WR_QUADRANGLE_NO_FIRST_EDGE = (WR_BASE_LAST << 1), WR_QUADRANGLE_NO_SECOND_EDGE = (WR_BASE_LAST << 2), WR_QUADRANGLE_NO_THIRD_EDGE = (WR_BASE_LAST << 3), WR_QUADRANGLE_NO_FOURTH_EDGE = (WR_BASE_LAST << 4), WR_QUADRANGLE_NO_EXTERNAL_EDGES, WR_QUADRANGLE_LAST = (WR_QUADRANGLE_NO_FOURTH_EDGE), WR_QUADRANGLE_MASK }
	3D rendering options More...

Public Types inherited from geomtools::i_shape_2d
enum	faces_mask_type { FACE_NONE = face_identifier::FACE_BITS_NONE, FACE_UNIQUE = datatools::bit_mask::bit00, FACE_UP = FACE_UNIQUE, FACE_DOWN = datatools::bit_mask::bit01, FACE_ALL = FACE_UNIQUE }
	The up/down identifier of the face. More...

Public Types inherited from geomtools::i_object_3d
enum	dimensional_type { DIMENSIONAL_0 = 0, DIMENSIONAL_1 = 1, DIMENSIONAL_2 = 2, DIMENSIONAL_3 = 3 }
	Known dimensions. More...

typedef datatools::handle< i_object_3d >	handle_type
	A handle to a 3D object. More...

typedef std::map< std::string, object_entry >	handle_dict_type
	Dictionary of handle of 3D object entries. More...

Public Types inherited from datatools::i_tree_dumpable
enum	ostream_type { OSTREAM_COUT = 1, OSTREAM_CERR = 2, OSTREAM_CLOG = 3 }
	Enumeration for standard output streams. More...

Public Types inherited from geomtools::i_wires_3d_rendering
enum	wires_rendering_option_type { WR_NONE = 0, WR_BASE_GRID = datatools::bit_mask::bit00, WR_BASE_GRID_LOW_DENSITY = (WR_BASE_GRID << 1), WR_BASE_GRID_HIGH_DENSITY = (WR_BASE_GRID << 2), WR_BASE_GRID_VERY_HIGH_DENSITY = (WR_BASE_GRID << 3), WR_BASE_GRID_HUGE_DENSITY = (WR_BASE_GRID << 4), WR_BASE_LOW_ANGLE_SAMPLING = (WR_BASE_GRID << 5), WR_BASE_HIGH_ANGLE_SAMPLING = (WR_BASE_GRID << 6), WR_BASE_VERY_HIGH_ANGLE_SAMPLING = (WR_BASE_GRID << 7), WR_BASE_HUGE_ANGLE_SAMPLING = (WR_BASE_GRID << 8), WR_BASE_UNUSED_09 = (WR_BASE_GRID << 9), WR_BASE_UNUSED_10 = (WR_BASE_GRID << 10), WR_BASE_UNUSED_11 = (WR_BASE_GRID << 11), WR_BASE_UNUSED_12 = (WR_BASE_GRID << 12), WR_BASE_UNUSED_13 = (WR_BASE_GRID << 13), WR_BASE_BOUNDINGS = (WR_BASE_GRID << 14), WR_BASE_EXPLODE = (WR_BASE_GRID << 15), WR_BASE_LAST = (WR_BASE_EXPLODE), WR_BASE_MASK = datatools::bit_mask::nbits16 }
	Wires rendering optional flags. More...

enum	sampling_level_type { SL_NONE = 0, SL_LOW = 1, SL_NORMAL = 2, SL_HIGH = 3, SL_VERY_HIGH = 4, SL_HUGE = 5 }
	Sampling levels. More...

Public Member Functions
bool	is_valid () const
	Check the validity of the quadrangle. More...

virtual double	get_perimeter (uint32_t flags_=ALL_PIECES) const
	Return the perimeter. More...

virtual double	get_surface (uint32_t flags_=ALL_PIECES) const
	Return the surface. More...

void	set_vertexes (const vector_3d &p0_, const vector_3d &p1_, const vector_3d &p2_, const vector_3d &p3_)
	Set the 3 vertexes. More...

void	set_vertexes_ext (const vector_3d &p0_, const vector_3d &p1_, const vector_3d &p2_, const vector_3d &p3_)
	Set the 3 vertexes as handle to external vertexes. More...

bool	has_vertex_0_ext () const
	Check if the first vertex is referenced from an outside object. More...

bool	has_vertex_1_ext () const
	Check if the second vertex is referenced from an outside object. More...

bool	has_vertex_2_ext () const
	Check if the third vertex is referenced from an outside object. More...

bool	has_vertex_3_ext () const
	Check if the fourth vertex is referenced from an outside object. More...

const vector_3d &	get_vertex_0 () const
	Return the vertex 0. More...

const vector_3d &	get_vertex_1 () const
	Return the vertex 1. More...

const vector_3d &	get_vertex_2 () const
	Return the vertex 2. More...

const vector_3d &	get_vertex_3 () const
	Return the vertex 3. More...

const vector_3d &	get_vertex (int) const
	Return the vertex by index. More...

	quadrangle ()
	Default constructor. More...

	quadrangle (const vector_3d &p0_, const vector_3d &p1_, const vector_3d &p2_, const vector_3d &p3_)
	Constructor. More...

virtual	~quadrangle ()
	Destructor. More...

void	initialize (const datatools::properties &, const handle_dict_type *=0)
	Initialize from properties and a dictionary of 3D-objects. More...

void	reset ()
	Reset. More...

virtual std::string	get_shape_name () const
	Return the identifier/name of the shape. More...

virtual bool	is_on_surface (const vector_3d &, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE) const
	Check is a given point belongs to the surface of the 2D shape. More...

virtual vector_3d	get_normal_on_surface (const vector_3d &position_, bool check_=false, double skin_=GEOMTOOLS_PROPER_TOLERANCE) const
	Return the normal direction at some position on the 2D shape's path. More...

virtual bool	find_intercept (const vector_3d &from_, const vector_3d &direction_, face_intercept_info &intercept_, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE) const
	Find the intercept of a ray with the 2D shape's surfaces. More...

virtual void	tree_dump (std::ostream &out_=std::clog, const std::string &title_="", const std::string &indent_="", bool inherit_=false) const
	Smart print. More...

void	make_pair_of_triangles (triangle &ta_, triangle &tb_, int=0) const
	Generate a pair of complementary triangles from the quadrangle. More...

const triangle &	get_triangle (inner_triangle_index_type i_) const
	Return a non mutable reference to one of the inner triangles. More...

void	compute_proper_frame (vector_3d &u0_, vector_3d &u1_, vector_3d &u2_) const
	Compute the vectors of the proper frame (V0, VOV1, V0V2, V0V1^V0V1) system. More...

bool	compute_proper_frame_coordinates (const vector_3d &position_, double &xp_, double &yp_, double &zp_) const
	Compute the coordinates of a point with respect to the (V0, VOV1, V0V2, V0V1^V0V1) system. More...

virtual void	generate_wires_self (wires_type &wires_, uint32_t options_=0) const
	Generate a sequence of polylines for wires 3D rendering. More...

virtual unsigned int	compute_vertexes (vertex_col_type &vertexes_) const
	Build an ordered collection of vertexes. More...

Public Member Functions inherited from geomtools::i_shape_2d
virtual bool	has_number_of_sides () const
	Check if the 2D shape knows its number of associated sides. More...

virtual unsigned int	get_number_of_sides () const
	Return the number of associated sides. More...

virtual bool	has_perimeter (uint32_t flags_=ALL_PIECES) const
	Check if the 2D shape known its perimeter. More...

virtual bool	has_surface (uint32_t flags_=ALL_PIECES) const
	Check if the 2D shape surface is defined. More...

int	get_dimensional () const
	Return the dimension of the object. More...

	i_shape_2d ()
	Default constructor. More...

	i_shape_2d (double tolerance_)
	Constructor. More...

	i_shape_2d (double tolerance_, double angular_tolerance_)
	Constructor. More...

virtual	~i_shape_2d ()
	Destructor. More...

Public Member Functions inherited from geomtools::i_object_3d
datatools::logger::priority	get_logging_priority () const
	Return the logging priority threshold. More...

void	set_logging_priority (datatools::logger::priority)
	Set the logging priority threshold. More...

bool	has_wires_drawer () const
	Check is a wires drawer is available. More...

void	set_wires_drawer (i_wires_3d_rendering &wires_drawer_)
	Set a wires drawer. More...

void	reset_wires_drawer ()
	Reset the wires drawer. More...

i_wires_3d_rendering &	grab_wires_drawer ()
	Return a wires drawer. More...

const i_wires_3d_rendering &	get_wires_drawer () const
	Return a wires drawer. More...

double	compute_tolerance (double tolerance_) const
	Return the distance tolerance. More...

double	compute_angular_tolerance (double angular_tolerance_) const
	Return the angular tolerance. More...

double	get_tolerance () const
	Return the distance tolerance. More...

void	set_tolerance (double tolerance_)
	Set the distance tolerance. More...

double	get_angular_tolerance () const
	Return the angular tolerance. More...

void	set_angular_tolerance (double tolerance_)
	Set the angular tolerance. More...

virtual bool	is_composite () const
	Check if the object is composite. More...

	i_object_3d ()
	Default constructor. More...

	i_object_3d (double tolerance_)
	Constructor on length tolerance. More...

	i_object_3d (double tolerance_, double angular_tolerance_)
	Constructor on length tolerance. More...

	i_object_3d (const i_object_3d &)
	Copy constructor. More...

i_object_3d &	operator= (const i_object_3d &)
	Assignment operator. More...

virtual	~i_object_3d ()
	Destructor. More...

void	initialize_simple ()
	Initialize the 3D object. More...

Public Member Functions inherited from datatools::i_serializable
	i_serializable ()
	Default constructor. More...

virtual	~i_serializable ()
	Destructor. More...

virtual const std::string &	get_serial_tag () const =0
	Return the serialization string identifier of the class. More...

Public Member Functions inherited from datatools::i_tree_dumpable
	i_tree_dumpable ()
	Constructor. More...

virtual	~i_tree_dumpable ()
	Destructor. More...

virtual void	print_tree (std::ostream &out_=std::clog, const boost::property_tree::ptree &options_=empty_options()) const
	Main new interface method for printing. More...

void	print_tree_json (std::ostream &out_=std::clog, const std::string &json_options_="") const
	Printing with jsonized options. More...

void	print_tree_json (std::ostream &out_=std::clog, const char *json_options_=nullptr) const
	Printing with jsonized options. More...

void	tree_dump_id (const int out_type_=OSTREAM_CLOG, const std::string &title_="", const std::string &indent_="", const bool inherit_=false) const

void	tree_print_id (const int out_type_=OSTREAM_CLOG, const std::string &title_="") const

void	smart_print_id (const int out_type_=OSTREAM_CLOG, const std::string &title_="", const std::string &indent_="") const

Public Member Functions inherited from geomtools::i_find_intercept
	i_find_intercept ()
	Default constructor. More...

virtual	~i_find_intercept ()
	Destructor. More...

bool	find_intercept_self (const vector_3d &a_from, const vector_3d &a_direction, face_intercept_info &a_intercept, double a_skin=GEOMTOOLS_PROPER_TOLERANCE) const

bool	find_intercept (const vector_3d &a_from, const vector_3d &a_direction, const placement &a_placement, face_intercept_info &a_intercept, double a_skin=GEOMTOOLS_PROPER_TOLERANCE) const

Public Member Functions inherited from geomtools::i_wires_3d_rendering
virtual	~i_wires_3d_rendering ()
	Destructor. More...

void	generate_wires (wires_type &wires_, const placement &positioning_, uint32_t options_=0) const

void	generate_wires (wires_type &wires_, const geomtools::vector_3d &position_, const geomtools::rotation_3d &rotation_, uint32_t options_=0) const

Static Public Member Functions
static const std::string &	quadrangle_label ()
	Return the class label. More...

static bool	check_vertexes (const geomtools::vector_3d &v0_, const geomtools::vector_3d &v1_, const geomtools::vector_3d &v2_, const geomtools::vector_3d &v3_, double tolerance_=0.0)
	Check the alignment of 4 points candidate to make a quadrangle. More...

Static Public Member Functions inherited from geomtools::i_shape_2d
static void	init_ocd (datatools::object_configuration_description &ocd_)

Static Public Member Functions inherited from geomtools::i_object_3d
static void	init_ocd (datatools::object_configuration_description &)
	OCD support. More...

Static Public Member Functions inherited from datatools::i_tree_dumpable
static const boost::property_tree::ptree &	empty_options ()

static boost::property_tree::ptree	make_base_print_options (const std::string &title_, const std::string &indent_="", const bool inherit_=false)

static std::ostream &	last_skip_tag (std::ostream &out_)

static std::ostream &	skip_tag (std::ostream &out_)

static std::ostream &	last_tag (std::ostream &out_)

static std::ostream &	tag (std::ostream &out_)

Static Public Member Functions inherited from geomtools::i_wires_3d_rendering
static uint32_t	linear_sampling (sampling_level_type)
	Return linear sampling from sampling level. More...

static uint32_t	linear_sampling_from_options (uint32_t)
	Return linear sampling from rendering options. More...

static uint32_t	angular_sampling (sampling_level_type)
	Return angular sampling from sampling level. More...

static uint32_t	angular_sampling_from_options (uint32_t)
	Return angular sampling from rendering options. More...

static void	boost_linear_sampling (uint32_t &)
	Boost the linear sampling. More...

Protected Member Functions
void	_set_defaults ()
	Set defaults attributes. More...

Protected Member Functions inherited from geomtools::i_object_3d
void	_set_defaults ()
	Set default values for attributes. More...

void	_initialize (const datatools::properties &, const handle_dict_type *=0)
	Initialize from properties. More...

void	_reset ()
	Reset. More...

Additional Inherited Members
Static Public Attributes inherited from geomtools::i_shape_2d
static const uint32_t	ALL_PIECES = 0xFFFFFFFF
	Special flag representing all pieces composing a 2D shape. More...

Detailed Description

A quadrangle.

Member Enumeration Documentation

◆ inner_triangle_index_type

enum geomtools::quadrangle::inner_triangle_index_type

Index of an inner triangle.

Enumerator
IT_NONE	None.
IT_FIRST	First triangle (v0, v1, v2)
IT_SECOND	Second triangle (v0, v2, v3)

◆ quadrangle_wires_rendering_option_type

enum geomtools::quadrangle::quadrangle_wires_rendering_option_type

3D rendering options

Enumerator
WR_QUADRANGLE_NO_FIRST_EDGE	Do not render the first external edges.
WR_QUADRANGLE_NO_SECOND_EDGE	Do not render the second external edges.
WR_QUADRANGLE_NO_THIRD_EDGE	Do not render the third external edges.
WR_QUADRANGLE_NO_FOURTH_EDGE	Do not render the fourth external edges.
WR_QUADRANGLE_NO_EXTERNAL_EDGES	Do not render the external edges.
WR_QUADRANGLE_LAST	Last defined bit.
WR_QUADRANGLE_MASK	Rendering options bit mask.

Constructor & Destructor Documentation

◆ quadrangle() [1/2]

geomtools::quadrangle::quadrangle ( )

Default constructor.

◆ quadrangle() [2/2]

geomtools::quadrangle::quadrangle	(	const vector_3d &	p0_,
		const vector_3d &	p1_,
		const vector_3d &	p2_,
		const vector_3d &	p3_
	)

Constructor.

◆ ~quadrangle()

virtual geomtools::quadrangle::~quadrangle ( )

virtual

Destructor.

Member Function Documentation

◆ _set_defaults()

void geomtools::quadrangle::_set_defaults ( )

protected

Set defaults attributes.

◆ check_vertexes()

static bool geomtools::quadrangle::check_vertexes	(	const geomtools::vector_3d &	v0_,
		const geomtools::vector_3d &	v1_,
		const geomtools::vector_3d &	v2_,
		const geomtools::vector_3d &	v3_,
		double	tolerance_ = `0.0`
	)

static

Check the alignment of 4 points candidate to make a quadrangle.

◆ compute_proper_frame()

void geomtools::quadrangle::compute_proper_frame	(	vector_3d &	u0_,
		vector_3d &	u1_,
		vector_3d &	u2_
	)		const

Compute the vectors of the proper frame (V0, VOV1, V0V2, V0V1^V0V1) system.

◆ compute_proper_frame_coordinates()

bool geomtools::quadrangle::compute_proper_frame_coordinates	(	const vector_3d &	position_,
		double &	xp_,
		double &	yp_,
		double &	zp_
	)		const

Compute the coordinates of a point with respect to the (V0, VOV1, V0V2, V0V1^V0V1) system.

◆ compute_vertexes()

virtual unsigned int geomtools::quadrangle::compute_vertexes ( vertex_col_type & vertexes_ ) const

virtual

Build an ordered collection of vertexes.

Implements geomtools::i_polygon.

◆ find_intercept()

virtual bool geomtools::quadrangle::find_intercept	(	const vector_3d &	from_,
		const vector_3d &	direction_,
		face_intercept_info &	intercept_,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

virtual

Find the intercept of a ray with the 2D shape's surfaces.

Implements geomtools::i_find_intercept.

◆ generate_wires_self()

virtual void geomtools::quadrangle::generate_wires_self	(	wires_type &	wires_,
		uint32_t	options_ = `0`
	)		const

virtual

Generate a sequence of polylines for wires 3D rendering.

Implements geomtools::i_wires_3d_rendering.

◆ get_normal_on_surface()

virtual vector_3d geomtools::quadrangle::get_normal_on_surface	(	const vector_3d &	position_,
		bool	check_ = `false`,
		double	skin_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

virtual

Return the normal direction at some position on the 2D shape's path.

Implements geomtools::i_shape_2d.

◆ get_perimeter()

virtual double geomtools::quadrangle::get_perimeter ( uint32_t flags_ = ALL_PIECES ) const

virtual

Return the perimeter.

Reimplemented from geomtools::i_shape_2d.

◆ get_shape_name()

virtual std::string geomtools::quadrangle::get_shape_name ( ) const

virtual

Return the identifier/name of the shape.

Implements geomtools::i_object_3d.

◆ get_surface()

virtual double geomtools::quadrangle::get_surface ( uint32_t flags_ = ALL_PIECES ) const

virtual

Return the surface.

Reimplemented from geomtools::i_shape_2d.

◆ get_triangle()

const triangle& geomtools::quadrangle::get_triangle ( inner_triangle_index_type i_ ) const

Return a non mutable reference to one of the inner triangles.

◆ get_vertex()

const vector_3d& geomtools::quadrangle::get_vertex ( int ) const

Return the vertex by index.

◆ get_vertex_0()

const vector_3d& geomtools::quadrangle::get_vertex_0 ( ) const

Return the vertex 0.

◆ get_vertex_1()

const vector_3d& geomtools::quadrangle::get_vertex_1 ( ) const

Return the vertex 1.

◆ get_vertex_2()

const vector_3d& geomtools::quadrangle::get_vertex_2 ( ) const

Return the vertex 2.

◆ get_vertex_3()

const vector_3d& geomtools::quadrangle::get_vertex_3 ( ) const

Return the vertex 3.

◆ has_vertex_0_ext()

bool geomtools::quadrangle::has_vertex_0_ext ( ) const

Check if the first vertex is referenced from an outside object.

◆ has_vertex_1_ext()

bool geomtools::quadrangle::has_vertex_1_ext ( ) const

Check if the second vertex is referenced from an outside object.

◆ has_vertex_2_ext()

bool geomtools::quadrangle::has_vertex_2_ext ( ) const

Check if the third vertex is referenced from an outside object.

◆ has_vertex_3_ext()

bool geomtools::quadrangle::has_vertex_3_ext ( ) const

Check if the fourth vertex is referenced from an outside object.

◆ initialize()

void geomtools::quadrangle::initialize	(	const datatools::properties &	,
		const handle_dict_type *	= `0`
	)

virtual

Initialize from properties and a dictionary of 3D-objects.

Reimplemented from geomtools::i_object_3d.

◆ is_on_surface()

virtual bool geomtools::quadrangle::is_on_surface	(	const vector_3d &	,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

virtual

Check is a given point belongs to the surface of the 2D shape.

Implements geomtools::i_shape_2d.

◆ is_valid()

bool geomtools::quadrangle::is_valid ( ) const

virtual

Check the validity of the quadrangle.

Implements geomtools::i_object_3d.

◆ make_pair_of_triangles()

void geomtools::quadrangle::make_pair_of_triangles	(	triangle &	ta_,
		triangle &	tb_,
		int	= `0`
	)		const

Generate a pair of complementary triangles from the quadrangle.

◆ quadrangle_label()

static const std::string& geomtools::quadrangle::quadrangle_label ( )

static

Return the class label.

◆ reset()

void geomtools::quadrangle::reset ( )

virtual

Reset.

Reimplemented from geomtools::i_object_3d.

◆ set_vertexes()

void geomtools::quadrangle::set_vertexes	(	const vector_3d &	p0_,
		const vector_3d &	p1_,
		const vector_3d &	p2_,
		const vector_3d &	p3_
	)

Set the 3 vertexes.

◆ set_vertexes_ext()

void geomtools::quadrangle::set_vertexes_ext	(	const vector_3d &	p0_,
		const vector_3d &	p1_,
		const vector_3d &	p2_,
		const vector_3d &	p3_
	)

Set the 3 vertexes as handle to external vertexes.

◆ tree_dump()

virtual void geomtools::quadrangle::tree_dump	(	std::ostream &	out_ = `std::clog`,
		const std::string &	title_ = `""`,
		const std::string &	indent_ = `""`,
		bool	inherit_ = `false`
	)		const

virtual

Smart print.

Reimplemented from geomtools::i_object_3d.

The documentation for this class was generated from the following file:

bayeux/geomtools/quadrangle.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ inner_triangle_index_type

◆ quadrangle_wires_rendering_option_type

Constructor & Destructor Documentation

◆ quadrangle() [1/2]

◆ quadrangle() [2/2]

◆ ~quadrangle()

Member Function Documentation

◆ _set_defaults()

◆ check_vertexes()

◆ compute_proper_frame()

◆ compute_proper_frame_coordinates()

◆ compute_vertexes()

◆ find_intercept()

◆ generate_wires_self()

◆ get_normal_on_surface()

◆ get_perimeter()

◆ get_shape_name()

◆ get_surface()

◆ get_triangle()

◆ get_vertex()

◆ get_vertex_0()

◆ get_vertex_1()

◆ get_vertex_2()

◆ get_vertex_3()

◆ has_vertex_0_ext()

◆ has_vertex_1_ext()

◆ has_vertex_2_ext()

◆ has_vertex_3_ext()

◆ initialize()

◆ is_on_surface()

◆ is_valid()

◆ make_pair_of_triangles()

◆ quadrangle_label()

◆ reset()

◆ set_vertexes()

◆ set_vertexes_ext()

◆ tree_dump()