PPoint3dC - Point in 3D projective space

User Documentation

Centre for Vision, Speech & Signal Processing

Comments:
The class represents a point in 3 dimensional projective space. The point contains 4 real numbers which serve as its projective coordinates.

Parent Classes:

PPointPlane3dC

Typedefs:

typedef PPointPlane3dC::PCoordT PCoordT;: A projective coordinate.
typedef PPointPlane3dC::CCoordT CCoordT;: An cartesian coordinate.

Methods:

PPoint3dC(): Constructs the point whose coordinates are zeros, eg. non-existing projective point.
PPoint3dC(CCoordT x,CCoordT y,CCoordT z): Constructs the point (x, y, z, 1).
PPoint3dC(const Point3dC & p): Construct the projective point (p.X(), p.Y(), p.Z(), 1).
PPoint3dC(const Vector3dC & v): Construct the projective point (v.X(), v.Y(), v.Z(), 0).
PPoint3dC(PCoordT p0,PCoordT p1,PCoordT p2,PCoordT p3): Constructs the point (p1, p2, p3, p4).
PPoint3dC(const PPointPlane3dC & p): Constructs the point from the point/plane object 'p'.
PPoint3dC(const PPointPlane3dC & p0,const PPointPlane3dC & p1,const PPointPlane3dC & p2): Constructs the point of intersection of three projective planes 'p0', 'p1', and 'p2'.
PPoint3dC(const PPoint3dC & p): Copy constructor.
const PPoint3dC & operator=(const PPoint3dC & p): Assigment of point. Access to the object. ---------------------
const PPoint3dC & PPoint3d() const: Access to this constant object.
PPoint3dC & PPoint3d(): Access to the point. Logical conditions. -------------------
BooleanT IsIdeal() const: Returns TRUE iff this point is an ideal projective point. The point is an ideal projective point if the absolute value of the ratio Scale()/SumAbs() is smaller or equal to the threshold 'Point4dC::relZero'.
BooleanT IsColinear(const PPoint3dC & q2,const PPoint3dC & q3) const: Returns TRUE iff this point and the points 'q2' and 'q3' are colinear. Arithmetical operations. ------------------------
const PPoint3dC & operator+=(const PPoint3dC & point): Adds the values of the coordinates of the 'point' to this point.
const PPoint3dC & operator-=(const PPoint3dC & point): Subtracts the values of the coordinates of the 'point' from this point.
const PPoint3dC & operator*=(const RealT alpha): Multiplies both coordinates by 'alpha'.
const PPoint3dC & operator/=(const RealT alpha): Divides both coordinates by 'alpha'.
PPoint3dC operator+(const PPoint3dC & point) const: Returns the point which is the sum of this point and the 'point'.
PPoint3dC operator*(const RealT alpha) const: Returns the point which coordinates are multiplied by 'alpha'.
PPoint3dC operator/(const RealT alpha) const: Returns the point which coordinates are divided by 'alpha'. Geometrical operations. -----------------------
PPoint3dC Translation(const PPoint3dC & newOrigin) const: Returns the point with projective coordinates related to the new origin 'newOrigin'.

#include "amma/PPtPl3d.hh"

const PPointPlane3dC & operator=(const PPointPlane3dC & p): Assigment of point/plane. Access to the object parameters. --------------------------------
const PCoordT & operator[](IndexT i) const: Returns the value of the (i+1)-th coordinate.
PCoordT & operator[](IndexT i): Access the value of the (i+1)-th coordinate.
CCoordT operator()(IndexT i) const: Returns the value of the (i+1)-th Cartesian coordinate. The function does not check if the point/plane is ideal or not or the range of the index 'i'.
PCoordT Scale() const: Returns the value of the last projective coordinate P4().
const PCoordT & P1() const: Returns the value of the 1st coordinate.
const PCoordT & P2() const: Returns the value of the 2nd coordinate.
const PCoordT & P3() const: Returns the value of the 3rd coordinate.
const PCoordT & P4() const: Returns the value of the 4th coordinate.
PCoordT & P1(): Returns the value of the 1st coordinate.
PCoordT & P2(): Returns the value of the 2nd coordinate.
PCoordT & P3(): Returns the value of the 3rd coordinate.
PCoordT & P4(): Returns the value of the 4th coordinate.
CCoordT X() const: Returns the value of the 1. Cartesian coordinate. The function does not check if the point/plane is ideal or not.
CCoordT Y() const: Returns the value of the 2. Cartesian coordinate. The function does not check if the point/plane is ideal or not.
CCoordT Z() const: Returns the value of the 3. Cartesian coordinate. The function does not check if the point/plane is ideal or not.
Point3dC Point3d() const: Returns the point in 3D Euiclidian space corresponding to this projective object. This object is treated as a projective point. It is not checked if the projective point is ideal or not.
const PPointPlane3dC & PPointPlane3d() const: Access to this constant object.
PPointPlane3dC & PPointPlane3d(): Access to the point/plane. Logical conditions. -------------------
BooleanT operator==(const PPointPlane3dC & p) const: Returns TRUE iff 2 points/planes are the same projective point/plane. Two projective points/planes are equal iff their 4D Cartesian representants are equal.
BooleanT operator!=(const PPointPlane3dC & p) const: Returns TRUE iff 2 points/planes are different projective points/planes. Two projective points/planes are different iff they are not equal in the sense of the operator '=='.
BooleanT IsIdealPoint() const: Returns TRUE iff this point/plane represents an ideal projective point. The point is an ideal projective point if the absolute value of the ratio Scale()/SumAbs() is smaller or equal to the threshold 'Point4dC::relZero'.
BooleanT IsIdealPlane() const: Returns TRUE iff this point/plane represents an ideal projective plane. The plane is an ideal projective plane if the absolute value of the ratio (Abs(P1)+Abs(P2()+Abs(P3))/Scale() is smaller or equal to the threshold 'Point4dC::relZero'.
BooleanT IsValid() const: Returns TRUE if the sum of absolute values of the projective coordinates is bigger than the threshold 'Point4dC::zeroDistance'. Setting of the coordinates. ---------------------------
void Set(const PPointPlane3dC & p): Sets both coordinates according to the values of the point/plane 'p'.
void Set(const PCoordT p1,const PCoordT p2,const PCoordT p3,const PCoordT p4): Sets the 1-st coordinate to be 'p1', the 2nd one to be 'p2', the 3rd one to be 'p3', and the 4th one to be 'p4'. Information about extrems. --------------------------
IndexT MaxIndex() const: Returns the index of the maximum coordinate.
IndexT MinIndex() const: Returns the index of the minimum coordinate.
IndexT AbsMaxIndex() const: Returns the index of the maximum coordinate in absolute value.
IndexT AbsMinIndex() const: Returns the index of the minimum coordinate in absolute value.
PCoordT Sum() const: Returns the sum of coordinates.
PCoordT SumAbs() const: Returns the sum of absolute value of coordinates. Arithmetical operations. ------------------------
const PPointPlane3dC & operator+=(const PPointPlane3dC & p): Adds the values of the coordinates of the 'p' to this point/plane.
const PPointPlane3dC & operator-=(const PPointPlane3dC & p): Subtracts the values of the coordinates of the 'p' from this point/plane.
const PPointPlane3dC & operator*=(const RealT alpha): Multiplies all coordinates by 'alpha'.
const PPointPlane3dC & operator/=(const RealT alpha): Divides all coordinates by 'alpha'.
PPointPlane3dC operator+(const PPointPlane3dC & p) const: Returns the point/plane which is the sum of this point and the 'p'.
PPointPlane3dC operator*(const RealT alpha) const: Returns the point/plane which coordinates are multiplied by 'alpha'.
PPointPlane3dC operator/(const RealT alpha) const: Returns the point/plane which coordinates are divided by 'alpha'. Geometrical operations. -----------------------
RealT operator&(const PPointPlane3dC & p) const: Returns the sum P1()*p.P1() + P2()*p.P2() + P3()*p.P3() + P4()*p.P4(). In 3 dimensional Euclidian vector space the result is equivalent to dot product of 2 vectors.

Programmer:Radek Marik, Documentation by CxxDoc: Tue Mar 20 10:48:08 2001

PPoint3dC

Point in 3D projective space

include	"amma/PPoint3d.hh"
User Level:	Default
Library:	Mpg3
Example:	exMat2d.cc
Section:	Geometry.Projective.3-D
In Scope:	std