Plane (jMonkeyEngine3)

java.lang.Object
- com.jme3.math.Plane

All Implemented Interfaces:

Savable, java.io.Serializable, java.lang.Cloneable
```
public class Plane
extends java.lang.Object
implements Savable, java.lang.Cloneable, java.io.Serializable
```
Plane defines a plane where Normal dot (x,y,z) = Constant. This provides methods for calculating a "distance" of a point from this plane. The distance is pseudo due to the fact that it can be negative if the point is on the non-normal side of the plane.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Plane.Side

Nested Classes
Modifier and Type	Class and Description
`static class`	`Plane.Side`

Field Summary

Fields
Modifier and Type Field and Description

protected float constant
Constant of the plane.

protected Vector3f normal
Vector normal to the plane.

Fields
Modifier and Type	Field and Description
`protected float`	`constant` Constant of the plane.
`protected Vector3f`	`normal` Vector normal to the plane.

Constructor Summary

Constructors
Constructor and Description
`Plane()` Constructor instantiates a new `Plane` object.
`Plane(Vector3f normal, float constant)` Constructor instantiates a new `Plane` object.
`Plane(Vector3f normal, Vector3f displacement)` Constructor instantiates a new `Plane` object.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Plane`	`clone()`
`Vector3f`	`getClosestPoint(Vector3f point)`
`Vector3f`	`getClosestPoint(Vector3f point, Vector3f store)`
`float`	`getConstant()` `getConstant` returns the constant of the plane.
`Vector3f`	`getNormal()` `getNormal` retrieves the normal of the plane.
`boolean`	`isOnPlane(Vector3f point)`
`float`	`pseudoDistance(Vector3f point)` `pseudoDistance` calculates the distance from this plane to a provided point.
`void`	`read(JmeImporter e)`
`Vector3f`	`reflect(Vector3f point, Vector3f store)`
`void`	`setConstant(float constant)` `setConstant` sets the constant value that helps define the plane.
`void`	`setNormal(float x, float y, float z)` `setNormal` sets the normal of the plane.
`void`	`setNormal(Vector3f normal)` `setNormal` sets the normal of the plane.
`void`	`setOriginNormal(Vector3f origin, Vector3f normal)` Initialize this plane using a point of origin and a normal.
`void`	`setPlanePoints(AbstractTriangle t)` Initialize this plane using the three points of the given triangle.
`void`	`setPlanePoints(Vector3f v1, Vector3f v2, Vector3f v3)` Initialize the Plane using the given 3 points as coplanar.
`java.lang.String`	`toString()` `toString` returns a string that represents the string representation of this plane.
`Plane.Side`	`whichSide(Vector3f point)` `whichSide` returns the side at which a point lies on the plane.
`void`	`write(JmeExporter e)`

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - normal
```
protected Vector3f normal
```
    Vector normal to the plane.
  - constant
```
protected float constant
```
    Constant of the plane. See formula in class definition.
- Constructor Detail
  - Plane
```
public Plane()
```
    Constructor instantiates a new Plane object. This is the default object and contains a normal of (0,0,0) and a constant of 0.
  - Plane
```
public Plane(Vector3f normal,
             float constant)
```
    Constructor instantiates a new Plane object. The normal and constant values are set at creation.
    
    Parameters:
    
    normal - the normal of the plane.
    
    constant - the constant of the plane.
  - Plane
```
public Plane(Vector3f normal,
             Vector3f displacement)
```
    Constructor instantiates a new Plane object.
    
    Parameters:
    
    normal - The normal of the plane.
    
    displacement - A vector representing a point on the plane.
- Method Detail
  - setNormal
```
public void setNormal(Vector3f normal)
```
    setNormal sets the normal of the plane.
    
    Parameters:
    
    normal - the new normal of the plane.
  - setNormal
```
public void setNormal(float x,
                      float y,
                      float z)
```
    setNormal sets the normal of the plane.
    
    Parameters:
    
    x - the desired X component for the normal vector
    
    y - the desired Y component for the normal vector
    
    z - the desired Z component for the normal vector
  - getNormal
```
public Vector3f getNormal()
```
    getNormal retrieves the normal of the plane.
    
    Returns:
    
    the normal of the plane.
  - setConstant
```
public void setConstant(float constant)
```
    setConstant sets the constant value that helps define the plane.
    
    Parameters:
    
    constant - the new constant value.
  - getConstant
```
public float getConstant()
```
    getConstant returns the constant of the plane.
    
    Returns:
    
    the constant of the plane.
  - getClosestPoint
```
public Vector3f getClosestPoint(Vector3f point,
                                Vector3f store)
```
  - getClosestPoint
```
public Vector3f getClosestPoint(Vector3f point)
```
  - reflect
```
public Vector3f reflect(Vector3f point,
                        Vector3f store)
```
  - pseudoDistance
```
public float pseudoDistance(Vector3f point)
```
    pseudoDistance calculates the distance from this plane to a provided point. If the point is on the negative side of the plane the distance returned is negative, otherwise it is positive. If the point is on the plane, it is zero.
    
    Parameters:
    
    point - the point to check.
    
    Returns:
    
    the signed distance from the plane to a point.
  - whichSide
```
public Plane.Side whichSide(Vector3f point)
```
    whichSide returns the side at which a point lies on the plane. The positive values returned are: NEGATIVE_SIDE, POSITIVE_SIDE and NO_SIDE.
    
    Parameters:
    
    point - the point to check.
    
    Returns:
    
    the side at which the point lies.
  - isOnPlane
```
public boolean isOnPlane(Vector3f point)
```
  - setPlanePoints
```
public void setPlanePoints(AbstractTriangle t)
```
    Initialize this plane using the three points of the given triangle.
    
    Parameters:
    
    t - the triangle
  - setOriginNormal
```
public void setOriginNormal(Vector3f origin,
                            Vector3f normal)
```
    Initialize this plane using a point of origin and a normal.
    
    Parameters:
    
    origin -
    
    normal -
  - setPlanePoints
```
public void setPlanePoints(Vector3f v1,
                           Vector3f v2,
                           Vector3f v3)
```
    Initialize the Plane using the given 3 points as coplanar.
    
    Parameters:
    
    v1 - the first point
    
    v2 - the second point
    
    v3 - the third point
  - toString
```
public java.lang.String toString()
```
    toString returns a string that represents the string representation of this plane. It represents the normal as a Vector3f object, so the format is the following: com.jme.math.Plane [Normal: org.jme.math.Vector3f [X=XX.XXXX, Y=YY.YYYY, Z=ZZ.ZZZZ] - Constant: CC.CCCCC]
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    the string representation of this plane.
  - write
```
public void write(JmeExporter e)
           throws java.io.IOException
```
    Specified by:
    
    write in interface Savable
    
    Throws:
    
    java.io.IOException
  - read
```
public void read(JmeImporter e)
          throws java.io.IOException
```
    Specified by:
    
    read in interface Savable
    
    Throws:
    
    java.io.IOException
  - clone
```
public Plane clone()
```
    Overrides:
    
    clone in class java.lang.Object

Class Plane

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

normal

constant

Constructor Detail

Plane

Plane

Plane

Method Detail

setNormal

setNormal

getNormal

setConstant

getConstant

getClosestPoint

getClosestPoint

reflect

pseudoDistance

whichSide

isOnPlane

setPlanePoints

setOriginNormal

setPlanePoints

toString

write

read

clone