#include <CGAL/Point_3.h>

Definition

template<typename Kernel>
class CGAL::Point_3< Kernel >

An object of the class Point_3 is a point in the three-dimensional Euclidean space \( \E^3\).

Remember that Kernel::RT and Kernel::FT denote a RingNumberType and a FieldNumberType, respectively. For the kernel model Cartesian<NT>, the two types are the same. For the kernel model Homogeneous<NT>, Kernel::RT is equal to NT, and Kernel::FT is equal to Quotient<NT>.

Operators

The following operations can be applied on points:

Is Model Of:

Kernel::Point_3

Hashable if Kernel is a cartesian kernel and if Kernel::FT is Hashable

Related Functions
(Note that these are not member functions.)
bool	operator< (const Point_3< Kernel > &p, const Point_3< Kernel > &q)
	returns true iff `p` is lexicographically smaller than `q` (the lexicographical order being defined on the Cartesian coordinates). More...

bool	operator> (const Point_3< Kernel > &p, const Point_3< Kernel > &q)
	returns true iff `p` is lexicographically greater than `q`. More...

bool	operator<= (const Point_3< Kernel > &p, const Point_3< Kernel > &q)
	returns true iff `p` is lexicographically smaller or equal to `q`. More...

bool	operator>= (const Point_3< Kernel > &p, const Point_3< Kernel > &q)
	returns true iff `p` is lexicographically greater or equal to `q`. More...

Vector_3< Kernel >	operator- (const Point_3< Kernel > &p, const Point_3< Kernel > &q)
	returns the difference vector between `q` and `p`. More...

Point_3< Kernel >	operator+ (const Point_3< Kernel > &p, const Vector_3< Kernel > &v)
	returns the point obtained by translating `p` by the vector `v`. More...

Point_3< Kernel >	operator- (const Point_3< Kernel > &p, const Vector_3< Kernel > &v)
	returns the point obtained by translating `p` by the vector -`v`. More...

Types
typedef unspecified_type	Cartesian_const_iterator
	An iterator for enumerating the Cartesian coordinates of a point. More...

Creation
	Point_3 (const Origin &ORIGIN)
	introduces a point with Cartesian coordinates \( (0,0,0)\). More...

	Point_3 (int x, int y, int z)
	introduces a point `p` initialized to `(x,y,z)`. More...

	Point_3 (double x, double y, double z)
	introduces a point `p` initialized to `(x,y,z)` provided `RT` supports it. More...

	Point_3 (const Kernel::RT &hx, const Kernel::RT &hy, const Kernel::RT &hz, const Kernel::RT &hw=RT(1))
	introduces a point `p` initialized to `(hx/hw,hy/hw, hz/hw)`. More...

	Point_3 (const Kernel::FT &x, const Kernel::FT &y, const Kernel::FT &z)
	introduces a point `p` initialized to `(x,y,z)`. More...

	Point_3 (const Kernel::Weighted_point_3 &wp)
	introduces a point from a weighted point. More...

Operations
bool	operator== (const Point_3< Kernel > &q) const
	Test for equality: Two points are equal, iff their \( x\), \( y\) and \( z\) coordinates are equal. More...

bool	operator!= (const Point_3< Kernel > &q) const
	Test for inequality. More...

Point_3< Kernel > &	operator+= (const Vector_3< Kernel > &v)
	translates the point by the vector `v`. More...

Point_3< Kernel > &	operator-= (const Vector_3< Kernel > &v)
	translates the point by the vector -`v`. More...

Coordinate Access
There are two sets of coordinate access functions, namely to the homogeneous and to the Cartesian coordinates. They can be used independently from the chosen kernel model. Note that you do not lose information with the homogeneous representation, because the FieldNumberType is a quotient.
Kernel::RT	hx () const
	returns the homogeneous \( x\) coordinate. More...

Kernel::RT	hy () const
	returns the homogeneous \( y\) coordinate. More...

Kernel::RT	hz () const
	returns the homogeneous \( z\) coordinate. More...

Kernel::RT	hw () const
	returns the homogenizing coordinate. More...

Kernel::FT	x () const
	returns the Cartesian \( x\) coordinate, that is `hx()`/`hw()`. More...

Kernel::FT	y () const
	returns the Cartesian \( y\) coordinate, that is `hy()`/`hw()`. More...

Kernel::FT	z () const
	returns the Cartesian \( z\) coordinate, that is `hz()`/`hw()`. More...

Convenience Operators
The following operations are for convenience and for compatibility with code for higher dimensional points. Again they come in a Cartesian and in a homogeneous flavor.
Kernel::RT	homogeneous (int i) const
	returns the i'th homogeneous coordinate of `p`. More...

Kernel::FT	cartesian (int i) const
	returns the i'th Cartesian coordinate of `p`. More...

Kernel::FT	operator[] (int i) const
	returns `cartesian(i)`. More...

Cartesian_const_iterator	cartesian_begin () const
	returns an iterator to the Cartesian coordinates of `p`, starting with the 0th coordinate. More...

Cartesian_const_iterator	cartesian_end () const
	returns an off the end iterator to the Cartesian coordinates of `p`. More...

int	dimension () const
	returns the dimension (the constant 3). More...

Bbox_3	bbox () const
	returns a bounding box containing `p`. More...

Point_3< Kernel >	transform (const Aff_transformation_3< Kernel > &t) const
	returns the point obtained by applying `t` on `p`. More...

Member Typedef Documentation

◆ Cartesian_const_iterator

template<typename Kernel >

typedef unspecified_type CGAL::Point_3< Kernel >::Cartesian_const_iterator

An iterator for enumerating the Cartesian coordinates of a point.

Constructor & Destructor Documentation

◆ Point_3() [1/6]

template<typename Kernel >

CGAL::Point_3< Kernel >::Point_3 ( const Origin & ORIGIN )

introduces a point with Cartesian coordinates \( (0,0,0)\).

◆ Point_3() [2/6]

template<typename Kernel >

CGAL::Point_3< Kernel >::Point_3	(	int	x,
		int	y,
		int	z
	)

introduces a point p initialized to (x,y,z).

◆ Point_3() [3/6]

template<typename Kernel >

CGAL::Point_3< Kernel >::Point_3	(	double	x,
		double	y,
		double	z
	)

introduces a point p initialized to (x,y,z) provided RT supports it.

◆ Point_3() [4/6]

template<typename Kernel >

CGAL::Point_3< Kernel >::Point_3	(	const Kernel::RT &	hx,
		const Kernel::RT &	hy,
		const Kernel::RT &	hz,
		const Kernel::RT &	hw = `RT(1)`
	)

introduces a point p initialized to (hx/hw,hy/hw, hz/hw).

Precondition: hw \( \neq\) 0.

◆ Point_3() [5/6]

template<typename Kernel >

CGAL::Point_3< Kernel >::Point_3	(	const Kernel::FT &	x,
		const Kernel::FT &	y,
		const Kernel::FT &	z
	)

introduces a point p initialized to (x,y,z).

◆ Point_3() [6/6]

template<typename Kernel >

CGAL::Point_3< Kernel >::Point_3 ( const Kernel::Weighted_point_3 & wp )

explicit

introduces a point from a weighted point.

Warning: The explicit keyword is used to avoid accidental implicit conversions between Point_3 and Weighted_point_3.

Member Function Documentation

◆ bbox()

template<typename Kernel >

Bbox_3 CGAL::Point_3< Kernel >::bbox ( ) const

returns a bounding box containing p.

◆ cartesian()

template<typename Kernel >

Kernel::FT CGAL::Point_3< Kernel >::cartesian ( int i ) const

returns the i'th Cartesian coordinate of p.

Precondition: \( 0\leq i \leq2\).

◆ cartesian_begin()

template<typename Kernel >

Cartesian_const_iterator CGAL::Point_3< Kernel >::cartesian_begin ( ) const

returns an iterator to the Cartesian coordinates of p, starting with the 0th coordinate.

◆ cartesian_end()

template<typename Kernel >

Cartesian_const_iterator CGAL::Point_3< Kernel >::cartesian_end ( ) const

returns an off the end iterator to the Cartesian coordinates of p.

◆ dimension()

template<typename Kernel >

int CGAL::Point_3< Kernel >::dimension ( ) const

returns the dimension (the constant 3).

◆ homogeneous()

template<typename Kernel >

Kernel::RT CGAL::Point_3< Kernel >::homogeneous ( int i ) const

returns the i'th homogeneous coordinate of p.

Precondition: \( 0\leq i \leq3\).

◆ hw()

template<typename Kernel >

Kernel::RT CGAL::Point_3< Kernel >::hw ( ) const

returns the homogenizing coordinate.

◆ hx()

template<typename Kernel >

Kernel::RT CGAL::Point_3< Kernel >::hx ( ) const

returns the homogeneous \( x\) coordinate.

◆ hy()

template<typename Kernel >

Kernel::RT CGAL::Point_3< Kernel >::hy ( ) const

returns the homogeneous \( y\) coordinate.

◆ hz()

template<typename Kernel >

Kernel::RT CGAL::Point_3< Kernel >::hz ( ) const

returns the homogeneous \( z\) coordinate.

◆ operator!=()

template<typename Kernel >

bool CGAL::Point_3< Kernel >::operator!= ( const Point_3< Kernel > & q ) const

Test for inequality.

◆ operator+=()

template<typename Kernel >

Point_3<Kernel>& CGAL::Point_3< Kernel >::operator+= ( const Vector_3< Kernel > & v )

translates the point by the vector v.

◆ operator-=()

template<typename Kernel >

Point_3<Kernel>& CGAL::Point_3< Kernel >::operator-= ( const Vector_3< Kernel > & v )

translates the point by the vector -v.

◆ operator==()

template<typename Kernel >

bool CGAL::Point_3< Kernel >::operator== ( const Point_3< Kernel > & q ) const

Test for equality: Two points are equal, iff their \( x\), \( y\) and \( z\) coordinates are equal.

◆ operator[]()

template<typename Kernel >

Kernel::FT CGAL::Point_3< Kernel >::operator[] ( int i ) const

returns cartesian(i).

Precondition: \( 0\leq i \leq2\).

◆ transform()

template<typename Kernel >

Point_3<Kernel> CGAL::Point_3< Kernel >::transform ( const Aff_transformation_3< Kernel > & t ) const

returns the point obtained by applying t on p.

◆ x()

template<typename Kernel >

Kernel::FT CGAL::Point_3< Kernel >::x ( ) const

returns the Cartesian \( x\) coordinate, that is hx()/hw().

◆ y()

template<typename Kernel >

Kernel::FT CGAL::Point_3< Kernel >::y ( ) const

returns the Cartesian \( y\) coordinate, that is hy()/hw().

◆ z()

template<typename Kernel >

Kernel::FT CGAL::Point_3< Kernel >::z ( ) const

returns the Cartesian \( z\) coordinate, that is hz()/hw().

Friends And Related Function Documentation

◆ operator-()

template<typename Kernel >

Vector_3< Kernel > operator-	(	const Point_3< Kernel > &	p,
		const Point_3< Kernel > &	q
	)

You can substitute ORIGIN for either p or q, but not for both.

◆ operator<()

template<typename Kernel >

bool operator<	(	const Point_3< Kernel > &	p,
		const Point_3< Kernel > &	q
	)

◆ operator<=()

template<typename Kernel >

bool operator<=	(	const Point_3< Kernel > &	p,
		const Point_3< Kernel > &	q
	)

◆ operator>()

template<typename Kernel >

bool operator>	(	const Point_3< Kernel > &	p,
		const Point_3< Kernel > &	q
	)

◆ operator>=()

template<typename Kernel >

bool operator>=	(	const Point_3< Kernel > &	p,
		const Point_3< Kernel > &	q
	)

Definition

template<typename Kernel> class CGAL::Point_3< Kernel >

Related Functions

Types

Creation

Operations

Coordinate Access

Convenience Operators

Member Typedef Documentation

◆ Cartesian_const_iterator

Constructor & Destructor Documentation

◆ Point_3() [1/6]

◆ Point_3() [2/6]

◆ Point_3() [3/6]

◆ Point_3() [4/6]

◆ Point_3() [5/6]

◆ Point_3() [6/6]

Member Function Documentation

◆ bbox()

◆ cartesian()

◆ cartesian_begin()

◆ cartesian_end()

◆ dimension()

◆ homogeneous()

◆ hw()

◆ hx()

◆ hy()

◆ hz()

◆ operator!=()

◆ operator+=()

◆ operator-=()

◆ operator==()

◆ operator[]()

◆ transform()

◆ x()

◆ y()

◆ z()

Friends And Related Function Documentation

◆ operator-()

◆ operator<()

◆ operator<=()

◆ operator>()

◆ operator>=()

template<typename Kernel>
class CGAL::Point_3< Kernel >