org.joml

Class Planed

java.lang.Object

org.joml.Planed

public class Planed
extends Object

Represents a 3D plane using double-precision floating-point numbers.

Author:

Kai Burjack

Field Summary

Fields

Modifier and Type	Field and Description
double	a
double	b
double	c
double	d

Constructor Summary

Constructors

Constructor and Description
Planed() Create a new undefined Planed.
Planed(double a, double b, double c, double d) Create a new Planed with the plane equation a*x + b*y + c*z + d = 0.
Planed(Planed source) Create a new Planed as a copy of the given source.
Planed(Vector3dc point, Vector3dc normal) Create a new Planed from the given point lying on the plane and the given normal.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
static Vector4d	equationFromPoints(double v0X, double v0Y, double v0Z, double v1X, double v1Y, double v1Z, double v2X, double v2Y, double v2Z, Vector4d dest) Compute the factors a, b, c and d in the plane equation a*x + b*y + c*z + d = 0 from the three points (v0X, v0Y, v0Z), (v1X, v1Y, v1Z) and (v2X, v2Y, v2Z) on the plane, and write the values to the x, y, z and w components, respectively, of the given dest vector.
static Vector4d	equationFromPoints(Vector3d v0, Vector3d v1, Vector3d v2, Vector4d dest) Compute the factors a, b, c and d in the plane equation a*x + b*y + c*z + d = 0 from the given three points on the plane, and write the values to the x, y, z and w components, respectively, of the given dest vector.
int	hashCode()
Planed	normalize() Normalize this plane.
Planed	normalize(Planed dest) Normalize this plane and store the result in dest.
Planed	set(double a, double b, double c, double d) Set the components of this plane.
String	toString() Return a string representation of this plane.
String	toString(NumberFormat formatter) Return a string representation of this plane by formatting the components with the given NumberFormat.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

a

public double a

b

public double b

c

public double c

d

public double d

Constructor Detail

Planed

public Planed()

Create a new undefined Planed.

Planed

public Planed(Planed source)

Create a new Planed as a copy of the given source.

Parameters:

source - the Planed to copy from

Planed

public Planed(Vector3dc point,
              Vector3dc normal)

Create a new Planed from the given point lying on the plane and the given normal.

Parameters:

point - any point lying on the plane

normal - the normal of the plane

Planed

public Planed(double a,
              double b,
              double c,
              double d)

Create a new Planed with the plane equation a*x + b*y + c*z + d = 0.

Parameters:

a - the x factor in the plane equation

b - the y factor in the plane equation

c - the z factor in the plane equation

d - the constant in the plane equation

Method Detail

set

public Planed set(double a,
                  double b,
                  double c,
                  double d)

Set the components of this plane.

Parameters:

a - the x factor in the plane equation

b - the y factor in the plane equation

c - the z factor in the plane equation

d - the constant in the plane equation

Returns:

this

normalize

public Planed normalize()

Normalize this plane.

Returns:

this

normalize

public Planed normalize(Planed dest)

Normalize this plane and store the result in dest.

Parameters:

dest - will hold the result

Returns:

dest

equationFromPoints

public static Vector4d equationFromPoints(Vector3d v0,
                                          Vector3d v1,
                                          Vector3d v2,
                                          Vector4d dest)

Compute the factors a, b, c and d in the plane equation a*x + b*y + c*z + d = 0 from the given three points on the plane, and write the values to the x, y, z and w components, respectively, of the given dest vector.

Parameters:

v0 - the first point on the plane

v1 - the second point on the plane

v2 - the third point on the plane

dest - will hold the result

Returns:

dest

equationFromPoints

public static Vector4d equationFromPoints(double v0X,
                                          double v0Y,
                                          double v0Z,
                                          double v1X,
                                          double v1Y,
                                          double v1Z,
                                          double v2X,
                                          double v2Y,
                                          double v2Z,
                                          Vector4d dest)

Compute the factors a, b, c and d in the plane equation a*x + b*y + c*z + d = 0 from the three points (v0X, v0Y, v0Z), (v1X, v1Y, v1Z) and (v2X, v2Y, v2Z) on the plane, and write the values to the x, y, z and w components, respectively, of the given dest vector.

Parameters:

v0X - the x coordinate of the first point on the plane

v0Y - the y coordinate of the first point on the plane

v0Z - the z coordinate of the first point on the plane

v1X - the x coordinate of the second point on the plane

v1Y - the y coordinate of the second point on the plane

v1Z - the z coordinate of the second point on the plane

v2X - the x coordinate of the third point on the plane

v2Y - the y coordinate of the third point on the plane

v2Z - the z coordinate of the third point on the plane

dest - will hold the result

Returns:

dest

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Return a string representation of this plane.

This method creates a new DecimalFormat on every invocation with the format string "0.000E0;-".

Overrides:

toString in class Object

Returns:

the string representation

toString

public String toString(NumberFormat formatter)

Return a string representation of this plane by formatting the components with the given NumberFormat.

Parameters:

formatter - the NumberFormat used to format the components with

Returns:

the string representation