ITK  4.4.0
Insight Segmentation and Registration Toolkit
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | List of all members
itk::Point< TCoordRep, NPointDimension > Class Template Reference
Geometry Representation Objects | Data Representation Objects | Module ITKCommon

#include <itkPoint.h>

+ Inheritance diagram for itk::Point< TCoordRep, NPointDimension >:
+ Collaboration diagram for itk::Point< TCoordRep, NPointDimension >:

Detailed Description

template<class TCoordRep, unsigned int NPointDimension = 3>
class itk::Point< TCoordRep, NPointDimension >

A templated class holding a geometric point in n-Dimensional space.

Point is a templated class that holds a set of coordinates (components). Point can be used as the data type held at each pixel in an Image or at each vertex of an Mesh. The template parameter T can be any data type that behaves like a primitive (or atomic) data type (int, short, float, complex). The NPointDimension defines the number of components in the point array.

See Also
Image
Mesh
Vector
CovariantVector
Matrix
Wiki Examples:

Definition at line 51 of file itkPoint.h.

Public Types

typedef FixedArray< TCoordRep,
NPointDimension > 		BaseArray
 
typedef BaseArray::ConstIterator ConstIterator
 
typedef TCoordRep CoordRepType
 
typedef BaseArray::Iterator Iterator
 
typedef NumericTraits
< ValueType >::RealType 		RealType
 
typedef Point Self
 
typedef FixedArray< TCoordRep,
NPointDimension > 		Superclass
 
typedef TCoordRep ValueType
 
typedef Vector< ValueType,
NPointDimension > 		VectorType
 
- Public Types inherited from itk::FixedArray< TCoordRep, NPointDimension >
typedef ValueType CArray [VLength]
 
typedef const ValueType * const_pointer
 
typedef const ValueType & const_reference
 
typedef const ValueType * ConstIterator
 
typedef ValueType * Iterator
 
typedef ValueType * pointer
 
typedef ValueType & reference
 
typedef unsigned int SizeType
 
typedef TCoordRep ValueType
 

Public Member Functions

template<typename TCoordRepB >
RealType EuclideanDistanceTo (const Point< TCoordRepB, NPointDimension > &pa) const
 
VectorType GetVectorFromOrigin () const
 
vnl_vector_ref< TCoordRep > GetVnlVector (void)
 
vnl_vector< TCoordRep > GetVnlVector (void) const
 
 itkLegacyMacro (vnl_vector_ref< TCoordRep > Get_vnl_vector(void))
 
 itkLegacyMacro (vnl_vector< TCoordRep > Get_vnl_vector(void) const)
 
bool operator!= (const Self &pt) const
 
Self operator+ (const VectorType &vec) const
 
const Self & operator+= (const VectorType &vec)
 
VectorType operator- (const Self &pnt) const
 
Self operator- (const VectorType &vec) const
 
const Self & operator-= (const VectorType &vec)
 
Point & operator= (const Self &r)
 
Point & operator= (const ValueType r[NPointDimension])
 
bool operator== (const Self &pt) const
 
 Point ()
 
void SetToMidPoint (const Self &, const Self &)
 
template<typename TCoordRepB >
RealType SquaredEuclideanDistanceTo (const Point< TCoordRepB, NPointDimension > &pa) const
 
template<class TPointValueType >
 Point (const Point< TPointValueType, NPointDimension > &r)
 
 Point (const ValueType r[NPointDimension])
 
 Point (const ValueType &v)
 
void SetToBarycentricCombination (const Self &A, const Self &B, double alpha)
 
void SetToBarycentricCombination (const Self &A, const Self &B, const Self &C, double weightA, double weightB)
 
void SetToBarycentricCombination (const Self *P, const double *weights, unsigned int N)
 
template<typename TCoordRepB >
void CastFrom (const Point< TCoordRepB, NPointDimension > &pa)
 
- Public Member Functions inherited from itk::FixedArray< TCoordRep, NPointDimension >
Iterator Begin ()
 
ConstIterator Begin () const
 
Iterator End ()
 
ConstIterator End () const
 
void Fill (const ValueType &)
 
ValueType * GetDataPointer ()
 
const ValueType * GetDataPointer () const
 
bool operator!= (const FixedArray &r) const
 
FixedArray & operator= (const ValueType r[VLength])
 
bool operator== (const FixedArray &r) const
 
ReverseIterator rBegin ()
 
ConstReverseIterator rBegin () const
 
ReverseIterator rEnd ()
 
ConstReverseIterator rEnd () const
 
SizeType Size () const
 
 FixedArray ()
 
 FixedArray (const ValueType r[VLength])
 
 FixedArray (const ValueType &r)
 
 FixedArray (const FixedArray< TFixedArrayValueType, VLength > &r)
 
FixedArray & operator= (const FixedArray< TFixedArrayValueType, VLength > &r)
 
reference operator[] (short index)
 
const_reference operator[] (short index) const
 
reference operator[] (unsigned short index)
 
const_reference operator[] (unsigned short index) const
 
reference operator[] (int index)
 
const_reference operator[] (int index) const
 
reference operator[] (unsigned int index)
 
const_reference operator[] (unsigned int index) const
 
reference operator[] (long index)
 
const_reference operator[] (long index) const
 
reference operator[] (unsigned long index)
 
const_reference operator[] (unsigned long index) const
 
reference operator[] (long long index)
 
const_reference operator[] (long long index) const
 
reference operator[] (unsigned long long index)
 
const_reference operator[] (unsigned long long index) const
 
void SetElement (unsigned short index, const_reference value)
 
const_reference GetElement (unsigned short index) const
 

Static Public Member Functions

static unsigned int GetPointDimension ()
 
- Static Public Member Functions inherited from itk::FixedArray< TCoordRep, NPointDimension >
static FixedArray Filled (const ValueType &)
 

Static Public Attributes

static const unsigned int PointDimension = NPointDimension
 
- Static Public Attributes inherited from itk::FixedArray< TCoordRep, NPointDimension >
static const unsigned int Dimension
 
static const unsigned int Length
 

Member Typedef Documentation

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef FixedArray< TCoordRep, NPointDimension > itk::Point< TCoordRep, NPointDimension >::BaseArray

The Array type from which this Vector is derived.

Definition at line 69 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef BaseArray::ConstIterator itk::Point< TCoordRep, NPointDimension >::ConstIterator

Definition at line 71 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef TCoordRep itk::Point< TCoordRep, NPointDimension >::CoordRepType

Definition at line 61 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef BaseArray::Iterator itk::Point< TCoordRep, NPointDimension >::Iterator

Definition at line 70 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef NumericTraits< ValueType >::RealType itk::Point< TCoordRep, NPointDimension >::RealType

Definition at line 63 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef Point itk::Point< TCoordRep, NPointDimension >::Self

Standard class typedefs.

Definition at line 55 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef FixedArray< TCoordRep, NPointDimension > itk::Point< TCoordRep, NPointDimension >::Superclass

Definition at line 56 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef TCoordRep itk::Point< TCoordRep, NPointDimension >::ValueType

ValueType can be used to declare a variable that is the same type as a data element held in an Point.

Definition at line 60 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
typedef Vector< ValueType, NPointDimension > itk::Point< TCoordRep, NPointDimension >::VectorType

VectorType define the difference between two Points

Definition at line 78 of file itkPoint.h.

Constructor & Destructor Documentation

template<class TCoordRep, unsigned int NPointDimension = 3>
itk::Point< TCoordRep, NPointDimension >::Point ( )
inline

Default constructor has nothing to do.

Definition at line 81 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
template<class TPointValueType >
itk::Point< TCoordRep, NPointDimension >::Point ( const Point< TPointValueType, NPointDimension > &  r)
inline

Pass-through constructors for the Array base class.

Definition at line 85 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
itk::Point< TCoordRep, NPointDimension >::Point ( const ValueType  r[NPointDimension])
inline

Pass-through constructors for the Array base class.

Definition at line 86 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
itk::Point< TCoordRep, NPointDimension >::Point ( const ValueType &  v)
inline

Pass-through constructors for the Array base class.

Definition at line 87 of file itkPoint.h.

Member Function Documentation

template<class TCoordRep, unsigned int NPointDimension = 3>
template<typename TCoordRepB >
void itk::Point< TCoordRep, NPointDimension >::CastFrom ( const Point< TCoordRepB, NPointDimension > &  pa)
inline

Copy from another Point with a different representation type. Casting is done with C-Like rules

Definition at line 228 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
template<typename TCoordRepB >
RealType itk::Point< TCoordRep, NPointDimension >::EuclideanDistanceTo ( const Point< TCoordRepB, NPointDimension > &  pa) const
inline

Compute the Euclidean Distance from this point to another point with a different representation type. Casting is done with C-Like rules

Definition at line 259 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
static unsigned int itk::Point< TCoordRep, NPointDimension >::GetPointDimension ( )
inlinestatic

Get the dimension (size) of the point.

Definition at line 74 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
VectorType itk::Point< TCoordRep, NPointDimension >::GetVectorFromOrigin ( ) const

Access an element of a point.

template<class TCoordRep, unsigned int NPointDimension = 3>
vnl_vector_ref< TCoordRep > itk::Point< TCoordRep, NPointDimension >::GetVnlVector ( void  )

Get a vnl_vector_ref referencing the same memory block

template<class TCoordRep, unsigned int NPointDimension = 3>
vnl_vector< TCoordRep > itk::Point< TCoordRep, NPointDimension >::GetVnlVector ( void  ) const

Get a vnl_vector with a copy of the internal memory block.

template<class TCoordRep, unsigned int NPointDimension = 3>
itk::Point< TCoordRep, NPointDimension >::itkLegacyMacro ( vnl_vector_ref< TCoordRep >   Get_vnl_vectorvoid)

Get a vnl_vector_ref referencing the same memory block

Deprecated:
Use GetVnlVector() instead.
template<class TCoordRep, unsigned int NPointDimension = 3>
itk::Point< TCoordRep, NPointDimension >::itkLegacyMacro ( vnl_vector< TCoordRep > Get_vnl_vector(void)  const)

Get a vnl_vector with a copy of the internal memory block.

Deprecated:
Use GetVnlVector() instead.
template<class TCoordRep, unsigned int NPointDimension = 3>
bool itk::Point< TCoordRep, NPointDimension >::operator!= ( const Self &  pt) const
inline

Compare two points for inequality.

Definition at line 108 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
Self itk::Point< TCoordRep, NPointDimension >::operator+ ( const VectorType &  vec) const

Add a vector to a point. Return a new point.

template<class TCoordRep, unsigned int NPointDimension = 3>
const Self& itk::Point< TCoordRep, NPointDimension >::operator+= ( const VectorType &  vec)

Point operator+=. Adds a vector to the current point.

template<class TCoordRep, unsigned int NPointDimension = 3>
VectorType itk::Point< TCoordRep, NPointDimension >::operator- ( const Self &  pnt) const

Computes the Vector difference between two points

template<class TCoordRep, unsigned int NPointDimension = 3>
Self itk::Point< TCoordRep, NPointDimension >::operator- ( const VectorType &  vec) const

Subtract a vector from a point. Return a new point.

template<class TCoordRep, unsigned int NPointDimension = 3>
const Self& itk::Point< TCoordRep, NPointDimension >::operator-= ( const VectorType &  vec)

Point operator-=. Subtracts a vector from a current point.

template<class TCoordRep, unsigned int NPointDimension = 3>
Point& itk::Point< TCoordRep, NPointDimension >::operator= ( const Self &  r)

Pass-through assignment operator for the Array base class.

template<class TCoordRep, unsigned int NPointDimension = 3>
Point& itk::Point< TCoordRep, NPointDimension >::operator= ( const ValueType  r[NPointDimension])
template<class TCoordRep, unsigned int NPointDimension = 3>
bool itk::Point< TCoordRep, NPointDimension >::operator== ( const Self &  pt) const
inline

Compare two points for equality.

Definition at line 97 of file itkPoint.h.

template<class TCoordRep, unsigned int NPointDimension = 3>
void itk::Point< TCoordRep, NPointDimension >::SetToBarycentricCombination ( const Self &  A,
const Self &  B,
double  alpha 
)

Set the current point to a barycentric combination of the two points given as arguments.

Parameters
AFirst point
BSecond point
alphaWeight for the first point 
The first point is multiplied by \form#28, the second is multiplied
by * \form#29, and the sum is stored in the Point on which the
method is invoked.

\[ \overrightarrow{P}=\alpha * \overrightarrow{A}+ (1-\alpha)*\overrightarrow{B} \]

If the value of $ \alpha \in [0,1] $, the resulting point will be placed in the line segment $ \overline{AB} $ joining $ \overrightarrow{A} $ and $ \overrightarrow{A} $

If the value of $ \alpha < 0 $ the resulting point will be placed outside the line segment $ \overline{AB} $ on the side of $ \overrightarrow{A} $.

If the value of $ \alpha > 1 $ the resulting point will be placed outside the line segment $ \overline{AB} $ on the side of $ \overrightarrow{B} $.

See Also
SetToMedian
template<class TCoordRep, unsigned int NPointDimension = 3>
void itk::Point< TCoordRep, NPointDimension >::SetToBarycentricCombination ( const Self &  A,
const Self &  B,
const Self &  C,
double  weightA,
double  weightB 
)

Set the current point to a barycentric combination of three points Two values are expected to weight the contribution of the first two points, the weight of for the third point is computed to ensure that the three weights sum 1.

This method computes:

\[ \overrightarrow{P}= w_1 * \overrightarrow{P}_1 + w_2 * \overrightarrow{P}_2 + (1-w_1-w_2 ) * \overrightarrow{P}_3 \]

If the two weight are $ \in [0,1] $ , The resulting point will alway be placed inside the triangle formed by the three points given as arguments.

template<class TCoordRep, unsigned int NPointDimension = 3>
void itk::Point< TCoordRep, NPointDimension >::SetToBarycentricCombination ( const Self *  P,
const double *  weights,
unsigned int  N 
)

Set the current point to a barycentric combination of an array of N points An array of (N-1) values is expected to weight the contribution of the first (N-1) points, the weight of the Nth point is computed to ensure that the N weights sum 1.

This method computes:

\[ \overrightarrow{P}= \sum_{i=1}^{N-1} w_i * \overrightarrow{P}_i + \left(1- \sum_{i=1}^{N-1} w_i\right) * \overrightarrow{P}_N \]

template<class TCoordRep, unsigned int NPointDimension = 3>
void itk::Point< TCoordRep, NPointDimension >::SetToMidPoint ( const Self &  ,
const Self &   
)

Set to median point between the two points given as arguments

This method computes:

\[ \overrightarrow{P}=\frac{(\overrightarrow{A}+\overrightarrow{B})}{2} \]

using the two Points given as arguments, and store the result in the Point on which the method is invoked.

template<class TCoordRep, unsigned int NPointDimension = 3>
template<typename TCoordRepB >
RealType itk::Point< TCoordRep, NPointDimension >::SquaredEuclideanDistanceTo ( const Point< TCoordRepB, NPointDimension > &  pa) const
inline

Compute the Squared Euclidean Distance from this point to another point with a different representation type. Casting is done with C-Like rules

Definition at line 242 of file itkPoint.h.

Referenced by itk::Point< double, TPointDimension >::EuclideanDistanceTo().

Member Data Documentation

template<class TCoordRep, unsigned int NPointDimension = 3>
const unsigned int itk::Point< TCoordRep, NPointDimension >::PointDimension = NPointDimension
static

Dimension of the Space

Definition at line 66 of file itkPoint.h.

The documentation for this class was generated from the following file:
Tarballs of the nightly generated Doxygen documentation are available for the html, xml, and tag file.
Generated on Mon May 13 2013 01:47:34 for ITK by   doxygen 1.8.3.1