Provided by: libcoin80-doc_3.1.4~abc9f50-4ubuntu2_all

**NAME**

SbDPPlane - TheSbDPPlaneclass represents a plane in 3D space.SbDPPlaneis used by many other classes in Coin. It provides a way of representing a plane, specified by a plane normal vector and a distance from the origin of the coordinate system.

**SYNOPSIS**

#include <Inventor/SbLinear.h>PublicMemberFunctionsSbDPPlane(void)SbDPPlane(constSbVec3d&normal, const double D)SbDPPlane(constSbVec3d&p0, constSbVec3d&p1, constSbVec3d&p2)SbDPPlane(constSbVec3d&normal, constSbVec3d&point) voidoffset(const double d) SbBoolintersect(constSbDPLine&l,SbVec3d&intersection) const voidtransform(constSbDPMatrix&matrix) SbBoolisInHalfSpace(constSbVec3d&point) const doublegetDistance(constSbVec3d&point) const constSbVec3d&getNormal(void) const doublegetDistanceFromOrigin(void) const voidintersect(constSbDPPlane&pl,SbDPLine&line) constFriendsintoperator==(constSbDPPlane&p1, constSbDPPlane&p2) intoperator!=(constSbDPPlane&p1, constSbDPPlane&p2)

**Detailed** **Description**

TheSbDPPlaneclass represents a plane in 3D space.SbDPPlaneis used by many other classes in Coin. It provides a way of representing a plane, specified by a plane normal vector and a distance from the origin of the coordinate system. Be aware that this class is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.Since:Coin 2.0

**Constructor** **&** **Destructor** **Documentation**

SbDPPlane::SbDPPlane(void)AnSbDPPlaneinstantiated with the default constructor will be uninitialized.SbDPPlane::SbDPPlane(constSbVec3d&normalref,constdoubleD)Construct anSbDPPlaneinstance with a normal pointing in the given direction and the given shortest distance from the origin of the coordinate system to a point in the plane.normalmust not be a null vector.SbDPPlane::SbDPPlane(constSbVec3d&p0,constSbVec3d&p1,constSbVec3d&p2)Construct anSbDPPlanewith three points laying in the plane. Make surep0,p1andp2are actually three distinct points when using this constructor.SbDPPlane::SbDPPlane(constSbVec3d&normalref,constSbVec3d&point)Construct anSbDPPlanefrom a normal and a point laying in the plane.normalmust not be a null vector.

**Member** **Function** **Documentation**

voidSbDPPlane::offset(constdoubled)Add the given offsetdto the plane distance from the origin.SbBoolSbDPPlane::intersect(constSbDPLine&l,SbVec3d&intersection)constFind the point on given linelintersecting the plane and return it inintersection. If the line is parallel to the plane, we return FALSE, otherwise TRUE. Do not pass an invalid line for thelparameter (i.e. with a null direction vector).voidSbDPPlane::transform(constSbDPMatrix&matrix)Transform the plane bymatrix.SeeAlso:offset()SbBoolSbDPPlane::isInHalfSpace(constSbVec3d&point)constCheck if the given point lies in the halfspace of the plane which the plane normal vector is pointing.doubleSbDPPlane::getDistance(constSbVec3d&point)constReturn the distance frompointto plane. Positive distance means the point is in the plane's half space. This method is an extension specific to Coin versus the original SGI Inventor API.constSbVec3d&SbDPPlane::getNormal(void)constReturn the plane's normal vector, which indicates which direction the plane is oriented.SeeAlso:getDistanceFromOrigin().doubleSbDPPlane::getDistanceFromOrigin(void)constReturn distance from origin of coordinate system to the point in the plane which is closest to the origin.SeeAlso:getNormal().voidSbDPPlane::print(FILE*fp)constDump the state of this object to thefilestream. Only works in debug version of library, method does nothing in an optimized build.SbBoolSbDPPlane::intersect(constSbDPPlane&pl,SbDPLine&line)constIntersect this plane withpl, and return the resulting line inline. Returns TRUE if an intersection line can be found, and FALSE if the planes are parallel. This function is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.Since:Coin 2.0

**Friends** **And** **Related** **Function** **Documentation**

intoperator==(constSbDPPlane&p1,constSbDPPlane&p2)[friend]Check the two given planes for equality.intoperator!=(constSbDPPlane&p1,constSbDPPlane&p2)[friend]Check the two given planes for unequality.

**Author**

Generated automatically by Doxygen for Coin from the source code.