\( \newcommand{\E}{\mathrm{E}} \) \( \newcommand{\A}{\mathrm{A}} \) \( \newcommand{\R}{\mathrm{R}} \) \( \newcommand{\N}{\mathrm{N}} \) \( \newcommand{\Q}{\mathrm{Q}} \) \( \newcommand{\Z}{\mathrm{Z}} \) \( \def\ccSum #1#2#3{ \sum_{#1}^{#2}{#3} } \def\ccProd #1#2#3{ \sum_{#1}^{#2}{#3} }\)
CGAL 4.7 - 2D and 3D Linear Geometry Kernel
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
CGAL::Vector_2< Kernel > Class Template Reference

#include <CGAL/Vector_2.h>

Definition

An object v of the class Vector_2 is a vector in the two-dimensional vector space \( \mathbb{R}^2\).

Geometrically spoken, a vector is the difference of two points \( p_2\), \( p_1\) and denotes the direction and the distance from \( p_1\) to \( p_2\).

CGAL defines a symbolic constant NULL_VECTOR. We will explicitly state where you can pass this constant as an argument instead of a vector initialized with zeros.

See also
Kernel::Vector_2

Public Member Functions

Vector_2< Kerneloperator- () const
 returns the opposite vector. More...
 
Kernel::FT operator* (const Vector_2< Kernel > &w) const
 returns the scalar product (= inner product) of the two vectors. More...
 
Vector_2< Kerneloperator/ (const Kernel::RT &s) const
 Division by a scalar. More...
 
Kernel::FT squared_length () const
 returns the squared length of v. More...
 
Vector_2< Kerneloperator* (const Vector_2< Kernel > &v, const Kernel::RT &s)
 Multiplication with a scalar from the right. More...
 
Vector_2< Kerneloperator* (const Vector_2< Kernel > &v, const Kernel::FT &s)
 Multiplication with a scalar from the right. More...
 
Vector_2< Kerneloperator* (const Kernel::RT &s, const Vector_2< Kernel > &v)
 Multiplication with a scalar from the left. More...
 
Vector_2< Kerneloperator* (const Kernel::FT &s, const Vector_2< Kernel > &v)
 Multiplication with a scalar from the left. More...
 

Types

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

Creation

 Vector_2 (const Point_2< Kernel > &a, const Point_2< Kernel > &b)
 introduces the vector b-a. More...
 
 Vector_2 (const Segment_2< Kernel > &s)
 introduces the vector s.target()-s.source(). More...
 
 Vector_2 (const Ray_2< Kernel > &r)
 introduces the vector having the same direction as r. More...
 
 Vector_2 (const Line_2< Kernel > &l)
 introduces the vector having the same direction as l. More...
 
 Vector_2 (const Null_vector &NULL_VECTOR)
 introduces a null vector v. More...
 
 Vector_2 (int x, int y)
 introduces a vector v initialized to (x,y). More...
 
 Vector_2 (double x, double y)
 introduces a vector v initialized to (x,y). More...
 
 Vector_2 (const Kernel::RT &hx, const Kernel::RT &hy, const Kernel::RT &hw=RT(1))
 introduces a vector v initialized to (hx/hw,hy/hw). More...
 
 Vector_2 (const Kernel::FT &x, const Kernel::FT &y)
 introduces a vector v initialized to (x,y). More...
 

Operations

bool operator== (const Vector_2< Kernel > &w) const
 Test for equality: two vectors are equal, iff their \( x\) and \( y\) coordinates are equal. More...
 
bool operator!= (const Vector_2< Kernel > &w) const
 Test for inequality. 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 loose 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 hw () const
 returns the homogenizing coordinate. More...
 
Kernel::FT x () const
 returns the x-coordinate of v, that is hx()/hw(). More...
 
Kernel::FT y () const
 returns the y-coordinate of v, that is hy()/hw(). More...
 

Convenience Operators

The following operations are for convenience and for compatibility with higher dimensional vectors.

Again they come in a Cartesian and homogeneous flavor.

Kernel::RT homogeneous (int i) const
 returns the i'th homogeneous coordinate of v, starting with 0. More...
 
Kernel::FT cartesian (int i) const
 returns the i'th Cartesian coordinate of v, starting at 0. 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 v, starting with the 0th coordinate. More...
 
Cartesian_const_iterator cartesian_end () const
 returns an off the end iterator to the Cartesian coordinates of v. More...
 
int dimension () const
 returns the dimension (the constant 2). More...
 
Direction_2< Kerneldirection () const
 returns the direction which passes through v. More...
 
Vector_2< Kerneltransform (const Aff_transformation_2< Kernel > &t) const
 returns the vector obtained by applying t on v. More...
 
Vector_2< Kernelperpendicular (const Orientation &o) const
 returns the vector perpendicular to v in clockwise or counterclockwise orientation. More...
 

Operators

Vector_2< Kerneloperator+ (const Vector_2< Kernel > &w) const
 Addition. More...
 
Vector_2< Kerneloperator- (const Vector_2< Kernel > &w) const
 Subtraction. More...
 

Member Typedef Documentation

template<typename Kernel >
typedef unspecified_type CGAL::Vector_2< Kernel >::Cartesian_const_iterator

An iterator for enumerating the Cartesian coordinates of a vector.

Constructor & Destructor Documentation

template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( const Point_2< Kernel > &  a,
const Point_2< Kernel > &  b 
)

introduces the vector b-a.

template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( const Segment_2< Kernel > &  s)

introduces the vector s.target()-s.source().

template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( const Ray_2< Kernel > &  r)

introduces the vector having the same direction as r.

template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( const Line_2< Kernel > &  l)

introduces the vector having the same direction as l.

template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( const Null_vector NULL_VECTOR)

introduces a null vector v.

template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( int  x,
int  y 
)

introduces a vector v initialized to (x,y).

template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( double  x,
double  y 
)

introduces a vector v initialized to (x,y).

template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( const Kernel::RT hx,
const Kernel::RT hy,
const Kernel::RT hw = RT(1) 
)

introduces a vector v initialized to (hx/hw,hy/hw).

Precondition
\( hw\neq0\).
template<typename Kernel >
CGAL::Vector_2< Kernel >::Vector_2 ( const Kernel::FT x,
const Kernel::FT y 
)

introduces a vector v initialized to (x,y).

Member Function Documentation

template<typename Kernel >
Kernel::FT CGAL::Vector_2< Kernel >::cartesian ( int  i) const

returns the i'th Cartesian coordinate of v, starting at 0.

Precondition
\( 0\leq i \leq1\).
template<typename Kernel >
Cartesian_const_iterator CGAL::Vector_2< Kernel >::cartesian_begin ( ) const

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

template<typename Kernel >
Cartesian_const_iterator CGAL::Vector_2< Kernel >::cartesian_end ( ) const

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

template<typename Kernel >
int CGAL::Vector_2< Kernel >::dimension ( ) const

returns the dimension (the constant 2).

template<typename Kernel >
Direction_2<Kernel> CGAL::Vector_2< Kernel >::direction ( ) const

returns the direction which passes through v.

template<typename Kernel >
Kernel::RT CGAL::Vector_2< Kernel >::homogeneous ( int  i) const

returns the i'th homogeneous coordinate of v, starting with 0.

Precondition
\( 0\leq i \leq2\).
template<typename Kernel >
Kernel::RT CGAL::Vector_2< Kernel >::hw ( ) const

returns the homogenizing coordinate.

template<typename Kernel >
Kernel::RT CGAL::Vector_2< Kernel >::hx ( ) const

returns the homogeneous \( x\) coordinate.

template<typename Kernel >
Kernel::RT CGAL::Vector_2< Kernel >::hy ( ) const

returns the homogeneous \( y\) coordinate.

template<typename Kernel >
bool CGAL::Vector_2< Kernel >::operator!= ( const Vector_2< Kernel > &  w) const

Test for inequality.

You can compare a vector with the NULL_VECTOR.

template<typename Kernel >
Kernel::FT CGAL::Vector_2< Kernel >::operator* ( const Vector_2< Kernel > &  w) const

returns the scalar product (= inner product) of the two vectors.

template<typename Kernel >
Vector_2<Kernel> CGAL::Vector_2< Kernel >::operator- ( ) const

returns the opposite vector.

template<typename Kernel >
Vector_2<Kernel> CGAL::Vector_2< Kernel >::operator/ ( const Kernel::RT s) const

Division by a scalar.

template<typename Kernel >
bool CGAL::Vector_2< Kernel >::operator== ( const Vector_2< Kernel > &  w) const

Test for equality: two vectors are equal, iff their \( x\) and \( y\) coordinates are equal.

You can compare a vector with the NULL_VECTOR.

template<typename Kernel >
Kernel::FT CGAL::Vector_2< Kernel >::operator[] ( int  i) const

returns cartesian(i).

Precondition
\( 0\leq i \leq1\).
template<typename Kernel >
Vector_2<Kernel> CGAL::Vector_2< Kernel >::perpendicular ( const Orientation o) const

returns the vector perpendicular to v in clockwise or counterclockwise orientation.

template<typename Kernel >
Kernel::FT CGAL::Vector_2< Kernel >::squared_length ( ) const

returns the squared length of v.

template<typename Kernel >
Vector_2<Kernel> CGAL::Vector_2< Kernel >::transform ( const Aff_transformation_2< Kernel > &  t) const

returns the vector obtained by applying t on v.

template<typename Kernel >
Kernel::FT CGAL::Vector_2< Kernel >::x ( ) const

returns the x-coordinate of v, that is hx()/hw().

template<typename Kernel >
Kernel::FT CGAL::Vector_2< Kernel >::y ( ) const

returns the y-coordinate of v, that is hy()/hw().