plane Class Reference

Mathematical plane equation. More...

#include <plane.h>

Collaboration diagram for plane:

List of all members.

Public Member Functions
boolc	nmlxIsZero () const
	Is the normals x component zero?
boolc	nmlyIsZero () const
	Is the normals y component zero?
boolc	nmlzIsZero () const
	Is the normals z component zero?
	plane (point3< double > const &nml_, doublec d0_)
	Construct a plane.
	plane (bool &valid, point3< double > const &p0, point3< double > const &p1, point3< double > const &p2)
	Construct a plane through three points.
boolc	intersects (point3< double > &A, point3< double > &B, plane const &P2) const
	Find the line A+Bt that is the two planes intersection.
boolc	isPointOnPlane (point3< double > const &p) const
	Determine if a point is on a plane or not.
	operator stringc () const
	Write this object as a string.
Public Attributes
point3< double >	nml
	nml*X=d0.
double	d0
	The plane constant.

---

Detailed Description

Mathematical plane equation.

N*X = d. N is the normal and d is the plane equations constant.

Definition at line 15 of file plane.h.

---

Constructor & Destructor Documentation

plane::plane	(	point3< double > const &	nml_,
		doublec	d0_
	)			[inline]

Construct a plane.

Definition at line 35 of file plane.h.

    : nml(nml_), d0(d0_) {}

plane::plane	(	bool &	valid,
		point3< double > const &	p0,
		point3< double > const &	p1,
		point3< double > const &	p2
	)

Construct a plane through three points.

Definition at line 11 of file plane.cpp.

References crossproduct::evalxyz().

{
  valid=false;
  point3<double> arm1(p1-p0);
  point3<double> arm2(p2-p0);

  // If the points are colinear then the plane can not
  // be determined.
  crossproduct::evalxyz(nml,arm1,arm2);
  if (nml.x*nml.x+nml.y*nml.y+nml.z*nml.z<zero<double>::val)
    return;

  valid=true;

  d0 = nml.dot(p0);
}

---

Member Function Documentation

boolc plane::intersects	(	point3< double > &	A,
		point3< double > &	B,
		plane const &	P2
	)			const

Find the line A+Bt that is the two planes intersection.

Definition at line 35 of file plane.cpp.

References d0, solverInconsistent< T >::d2linearequ(), point3< T >::dot(), crossproduct::evalxyz(), nml, point3< T >::x, point3< T >::y, and point3< T >::z.

Referenced by planeinttest::test01(), planetest::test02(), and planetest::test03().

{
  //crossprod< point3<double> > cp;
  //cp(B,nml,P2.nml);
  crossproduct::evalxyz(B,nml,P2.nml);
  if (zero<double>::test(B.dot(B)))
    return false;

  point3<double> w;
  bool res;
  res = solverInconsistent<double>::d2linearequ
  (
    A.x, A.y, A.z,
    nml.x, nml.y, nml.z, d0,
    P2.nml.x, P2.nml.y, P2.nml.z, P2.d0
  );

  return res;

//  if (B.dot(B)<zero<double>::val)
//    return false;

  // Find an intersection point.

/*
  if (nmlxIsZero())
    if (P2.nmlxIsZero())
    {
      A.x = 0.0;
    
      return solver<double>::d2linearequ
      (
        A.y,
        A.z,
        nml.y,
        nml.z,
        P2.nml.y,
        P2.nml.z,
        d0,
        P2.d0
      );
    }

  //if (abs(nml.y)+abs(P2.nml.y) < zero )
  if (nmlyIsZero())
    if (P2.nmlyIsZero())
    {
      A.y = 0.0;
    
      return solver<double>::d2linearequ
      (
        A.x,
        A.z,
        nml.x,
        nml.z,
        P2.nml.x,
        P2.nml.z,
        d0,
        P2.d0
      );
    }

  if (nmlzIsZero())
    if (P2.nmlzIsZero())
    {
      A.z = 0.0;
    
      return solver<double>::d2linearequ
      (
        A.x,
        A.y,
        nml.x,
        nml.y,
        P2.nml.x,
        P2.nml.y,
        d0,
        P2.d0
      );
    }

  A.z=1.0;
  return solver<double>::d2linearequ
  (
    A.x,
    A.y,
    nml.x,
    nml.y,
    P2.nml.x,
    P2.nml.y,
    d0-nml.z,
    P2.d0-P2.nml.z
  );
*/
}

boolc plane::isPointOnPlane

(

point3< double > const &

p

)

const [inline]

Determine if a point is on a plane or not.

Definition at line 57 of file plane.h.

References d0, point3< T >::dot(), and nml.

Referenced by planetest::test02(), and planetest::test03().

    { return zero<double>::test(nml.dot(p)-d0); }

boolc plane::nmlxIsZero

(

)

const [inline]

Is the normals x component zero?

Definition at line 25 of file plane.h.

References nml, and point3< T >::x.

    { return nml.x*nml.x<zero<double>::val; }

boolc plane::nmlyIsZero

(

)

const [inline]

Is the normals y component zero?

Definition at line 28 of file plane.h.

References nml, and point3< T >::y.

    { return nml.y*nml.y<zero<double>::val; }

boolc plane::nmlzIsZero

(

)

const [inline]

Is the normals z component zero?

Definition at line 31 of file plane.h.

References nml, and point3< T >::z.

    { return nml.z*nml.z<zero<double>::val; }

plane::operator stringc

(

)

const

Write this object as a string.

The normal first then the plane constant.

---

Member Data Documentation

double plane::d0

The plane constant.

Definition at line 22 of file plane.h.

Referenced by intersects(), and isPointOnPlane().

point3<double> plane::nml

nml*X=d0.

Definition at line 20 of file plane.h.

Referenced by intersects(), isPointOnPlane(), nmlxIsZero(), nmlyIsZero(), and nmlzIsZero().

---

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

• mathlib/plane.h
• mathlib/plane.cpp