Matrix4x4

java.lang.Object
- com.bergerkiller.bukkit.common.math.Matrix4x4

All Implemented Interfaces:: java.lang.Cloneable

Direct Known Subclasses:: Matrix4f

public class Matrix4x4
extends java.lang.Object
implements java.lang.Cloneable

Field Summary

Fields
Modifier and Type	Field and Description
`double`	`m00`
`double`	`m01`
`double`	`m02`
`double`	`m03`
`double`	`m10`
`double`	`m11`
`double`	`m12`
`double`	`m13`
`double`	`m20`
`double`	`m21`
`double`	`m22`
`double`	`m23`
`double`	`m30`
`double`	`m31`
`double`	`m32`
`double`	`m33`

Constructor Summary

Constructors
Constructor and Description
`Matrix4x4()` Constructs a new 4x4 matrix, initialized as an identity matrix:
`Matrix4x4(double m00, double m01, double m02, double m03, double m10, double m11, double m12, double m13, double m20, double m21, double m22, double m23, double m30, double m31, double m32, double m33)` Constructs a new 4x4 matrix using the 16 values specified
`Matrix4x4(Matrix4x4 matrix)` Constructs a new 4x4 matrix, copying the 16 values from another matrix

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Matrix4x4`	`clone()`
`static Matrix4x4`	`computeProjectionMatrix(Vector3[] p)`
`static Matrix4x4`	`fromColumns3x3(org.bukkit.util.Vector v0, org.bukkit.util.Vector v1, org.bukkit.util.Vector v2)` Creates a 4x4 matrix from 3 columns of a 3x3 matrix
`Quaternion`	`getRotation()` Gets the rotation transformation performed as a Quaternion
`org.bukkit.util.Vector`	`getYawPitchRoll()` Deduces the yaw/pitch/roll values in degrees that this matrix transforms objects with
`boolean`	`invert()` General invert routine.
`void`	`multiply(Matrix4x4 m1)` Multiplies this matrix with another, storing the result in this matrix
`void`	`rotate(Quaternion quat)` Multiplies this matrix with a rotation transformation defined in a Quaternion
`void`	`rotateX(double angle)` Multiplies this matrix with a rotation transformation about the X-axis
`void`	`rotateX(double y, double z)` Multiplies this matrix with a rotation transformation about the X-axis.
`void`	`rotateY(double angle)` Multiplies this matrix with a rotation transformation about the Y-axis
`void`	`rotateY(double x, double z)` Multiplies this matrix with a rotation transformation about the Y-axis.
`void`	`rotateYawPitchRoll(double pitch, double yaw, double roll)` Multiplies this matrix with a rotation transformation in yaw/pitch/roll, based on the Minecraft coordinate system.
`void`	`rotateYawPitchRoll(float pitch, float yaw, float roll)` Multiplies this matrix with a rotation transformation in yaw/pitch/roll, based on the Minecraft coordinate system.
`void`	`rotateYawPitchRoll(org.bukkit.util.Vector rotation)` Multiplies this matrix with a rotation transformation in yaw/pitch/roll, based on the Minecraft coordinate system.
`void`	`rotateYawPitchRoll(Vector3 rotation)` Multiplies this matrix with a rotation transformation in yaw/pitch/roll, based on the Minecraft coordinate system.
`void`	`rotateZ(double angle)` Multiplies this matrix with a rotation transformation about the Z-axis
`void`	`rotateZ(double x, double y)` Multiplies this matrix with a rotation transformation about the Z-axis.
`void`	`scale(double scale)` Multiplies this matrix with a scale transformation
`void`	`scale(double sx, double sy, double sz)` Multiplies this matrix with a scale transformation
`void`	`scale(Vector3 scale)` Multiplies this matrix with a scale transformation
`void`	`set(double[] values)` Sets this matrix to all the values in an array
`void`	`set(double m00, double m01, double m02, double m03, double m10, double m11, double m12, double m13, double m20, double m21, double m22, double m23, double m30, double m31, double m32, double m33)` Sets all 16 values of this 4x4 matrix
`void`	`set(float[] values)` Sets this matrix to all the values in an array
`void`	`set(Matrix4x4 m)` Sets this matrix to all values of another 4x4 matrix
`void`	`setIdentity()` Sets this matrix to the identity matrix:
`void`	`toArray(double[] values)` Gets all 16 values from this 4x4 matrix and writes them to an array
`void`	`toArray(float[] values)` Gets all 16 values from this 4x4 matrix and writes them to an array
`java.lang.String`	`toString()`
`org.bukkit.util.Vector`	`toVector()` Obtains the absolute position vector of this matrix, equivalent to performing transformPoint with a zero vector.
`Vector3`	`toVector3()` Obtains the absolute position vector of this matrix, equivalent to performing transformPoint with a zero vector.
`void`	`transformPoint(org.bukkit.util.Vector point)` Transforms a 3D point vector using this transformation matrix.
`void`	`transformPoint(Vector3 point)` Transforms a 3D point vector using this transformation matrix.
`void`	`transformPoint(Vector4 point)` Transforms a 4D point vector using this transformation matrix.
`void`	`transformQuad(Quad quad)` Transforms all four points of a quad using this transformation matrix.
`void`	`translate(double dx, double dy, double dz)` Multiplies this matrix with a translation transformation
`void`	`translate(org.bukkit.util.Vector translation)` Multiplies this matrix with a translation transformation.
`void`	`translate(Vector3 translation)` Multiplies this matrix with a translation transformation
`void`	`translateRotate(double x, double y, double z, float pitch, float yaw)` Translates and rotates this Matrix with position and rotation information
`void`	`translateRotate(double x, double y, double z, float pitch, float yaw, float roll)` Translates and rotates this Matrix with position and rotation information
`void`	`translateRotate(org.bukkit.Location location)` Translates and rotates this Matrix with the position information of a Bukkit Location

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

- Field Detail
  - m00
```
public double m00
```
  - m01
```
public double m01
```
  - m02
```
public double m02
```
  - m03
```
public double m03
```
  - m10
```
public double m10
```
  - m11
```
public double m11
```
  - m12
```
public double m12
```
  - m13
```
public double m13
```
  - m20
```
public double m20
```
  - m21
```
public double m21
```
  - m22
```
public double m22
```
  - m23
```
public double m23
```
  - m30
```
public double m30
```
  - m31
```
public double m31
```
  - m32
```
public double m32
```
  - m33
```
public double m33
```
- Constructor Detail
  - Matrix4x4
```
public Matrix4x4()
```
    Constructs a new 4x4 matrix, initialized as an identity matrix:
```
 1 0 0 0
 0 1 0 0
 0 0 1 0
 0 0 0 1
 
```
  - Matrix4x4
```
public Matrix4x4(double m00,
                 double m01,
                 double m02,
                 double m03,
                 double m10,
                 double m11,
                 double m12,
                 double m13,
                 double m20,
                 double m21,
                 double m22,
                 double m23,
                 double m30,
                 double m31,
                 double m32,
                 double m33)
```
    Constructs a new 4x4 matrix using the 16 values specified
  - Matrix4x4
```
public Matrix4x4(Matrix4x4 matrix)
```
    Constructs a new 4x4 matrix, copying the 16 values from another matrix
    
    Parameters:
    
    matrix - to set to
- Method Detail
  - set
```
public final void set(double m00,
                      double m01,
                      double m02,
                      double m03,
                      double m10,
                      double m11,
                      double m12,
                      double m13,
                      double m20,
                      double m21,
                      double m22,
                      double m23,
                      double m30,
                      double m31,
                      double m32,
                      double m33)
```
    Sets all 16 values of this 4x4 matrix
  - set
```
public final void set(Matrix4x4 m)
```
    Sets this matrix to all values of another 4x4 matrix
    
    Parameters:
    
    m - matrix to set to
  - setIdentity
```
public final void setIdentity()
```
    Sets this matrix to the identity matrix:
```
 1 0 0 0
 0 1 0 0
 0 0 1 0
 0 0 0 1
 
```
  - set
```
public final void set(float[] values)
```
    Sets this matrix to all the values in an array
    
    Parameters:
    
    values - to set to (length 16 or less)
  - set
```
public final void set(double[] values)
```
    Sets this matrix to all the values in an array
    
    Parameters:
    
    values - array to read from (length 16 or more)
  - toArray
```
public final void toArray(float[] values)
```
    Gets all 16 values from this 4x4 matrix and writes them to an array
    
    Parameters:
    
    values - array to write to (length 16 or more)
  - toArray
```
public final void toArray(double[] values)
```
    Gets all 16 values from this 4x4 matrix and writes them to an array
    
    Parameters:
    
    values - array to write to (length 16 or more)
  - invert
```
public final boolean invert()
```
    General invert routine. Inverts m1 and places the result in "this". Note that this routine handles both the "this" version and the non-"this" version. Also note that since this routine is slow anyway, we won't worry about allocating a little bit of garbage.
  - rotate
```
public final void rotate(Quaternion quat)
```
    Multiplies this matrix with a rotation transformation defined in a Quaternion
    
    Parameters:
    
    quat - to rotate with
  - rotateX
```
public final void rotateX(double angle)
```
    Multiplies this matrix with a rotation transformation about the X-axis
    
    Parameters:
    
    angle - the angle to rotate about the X axis in degrees
  - rotateX
```
public final void rotateX(double y,
                          double z)
```
    Multiplies this matrix with a rotation transformation about the X-axis. Instead of a single angle, the y and z of the rotated vector can be specified.
    
    Parameters:
    
    y -
    
    z -
  - rotateY
```
public final void rotateY(double angle)
```
    Multiplies this matrix with a rotation transformation about the Y-axis
    
    Parameters:
    
    angle - the angle to rotate about the Y axis in degrees
  - rotateY
```
public final void rotateY(double x,
                          double z)
```
    Multiplies this matrix with a rotation transformation about the Y-axis. Instead of a single angle, the x and z of the rotated vector can be specified.
    
    Parameters:
    
    x -
    
    z -
  - rotateZ
```
public final void rotateZ(double angle)
```
    Multiplies this matrix with a rotation transformation about the Z-axis
    
    Parameters:
    
    angle - the angle to rotate about the Z axis in degrees
  - rotateZ
```
public final void rotateZ(double x,
                          double y)
```
    Multiplies this matrix with a rotation transformation about the Z-axis. Instead of a single angle, the x and y of the rotated vector can be specified.
    
    Parameters:
    
    x -
    
    y -
  - rotateYawPitchRoll
```
public final void rotateYawPitchRoll(Vector3 rotation)
```
    Multiplies this matrix with a rotation transformation in yaw/pitch/roll, based on the Minecraft coordinate system. This will differ slightly from the standard rotateX/Y/Z functions.
    
    Parameters:
    
    rotation - (x=pitch, y=yaw, z=roll)
  - rotateYawPitchRoll
```
public final void rotateYawPitchRoll(org.bukkit.util.Vector rotation)
```
    Multiplies this matrix with a rotation transformation in yaw/pitch/roll, based on the Minecraft coordinate system. This will differ slightly from the standard rotateX/Y/Z functions.
    
    Parameters:
    
    rotation - (x=pitch, y=yaw, z=roll)
  - rotateYawPitchRoll
```
public final void rotateYawPitchRoll(double pitch,
                                     double yaw,
                                     double roll)
```
    Multiplies this matrix with a rotation transformation in yaw/pitch/roll, based on the Minecraft coordinate system. This will differ slightly from the standard rotateX/Y/Z functions.
    
    Parameters:
    
    pitch - rotation (X)
    
    yaw - rotation (Y)
    
    roll - rotation (Z)
  - rotateYawPitchRoll
```
public final void rotateYawPitchRoll(float pitch,
                                     float yaw,
                                     float roll)
```
    Multiplies this matrix with a rotation transformation in yaw/pitch/roll, based on the Minecraft coordinate system. This will differ slightly from the standard rotateX/Y/Z functions.
    
    Parameters:
    
    pitch - rotation (X)
    
    yaw - rotation (Y)
    
    roll - rotation (Z)
  - getRotation
```
public final Quaternion getRotation()
```
    Gets the rotation transformation performed as a Quaternion
    
    Returns:
    
    rotation quaternion
  - getYawPitchRoll
```
public final org.bukkit.util.Vector getYawPitchRoll()
```
    Deduces the yaw/pitch/roll values in degrees that this matrix transforms objects with
    
    Returns:
    
    axis rotations: {x=pitch, y=yaw, z=roll}
  - translate
```
public final void translate(Vector3 translation)
```
    Multiplies this matrix with a translation transformation
    
    Parameters:
    
    translation -
  - translate
```
public final void translate(double dx,
                            double dy,
                            double dz)
```
    Multiplies this matrix with a translation transformation
    
    Parameters:
    
    dx - translation
    
    dy - translation
    
    dz - translation
  - translate
```
public final void translate(org.bukkit.util.Vector translation)
```
    Multiplies this matrix with a translation transformation.
    
    Parameters:
    
    translation -
  - scale
```
public final void scale(Vector3 scale)
```
    Multiplies this matrix with a scale transformation
    
    Parameters:
    
    scale -
  - scale
```
public final void scale(double sx,
                        double sy,
                        double sz)
```
    Multiplies this matrix with a scale transformation
    
    Parameters:
    
    sx - scale
    
    sy - scale
    
    sz - scale
  - scale
```
public final void scale(double scale)
```
    Multiplies this matrix with a scale transformation
    
    Parameters:
    
    scale -
  - translateRotate
```
public final void translateRotate(org.bukkit.Location location)
```
    Translates and rotates this Matrix with the position information of a Bukkit Location
    
    Parameters:
    
    location - to translate and rotate by
  - translateRotate
```
public final void translateRotate(double x,
                                  double y,
                                  double z,
                                  float pitch,
                                  float yaw)
```
    Translates and rotates this Matrix with position and rotation information
    
    Parameters:
    
    x - position
    
    y - position
    
    z - position
    
    pitch - rotation (X)
    
    yaw - rotation (Y)
  - translateRotate
```
public final void translateRotate(double x,
                                  double y,
                                  double z,
                                  float pitch,
                                  float yaw,
                                  float roll)
```
    Translates and rotates this Matrix with position and rotation information
    
    Parameters:
    
    x - position
    
    y - position
    
    z - position
    
    pitch - rotation (X)
    
    yaw - rotation (Y)
    
    roll - rotation (Z)
  - multiply
```
public final void multiply(Matrix4x4 m1)
```
    Multiplies this matrix with another, storing the result in this matrix
    
    Parameters:
    
    m1 - the other matrix to multiply with
  - transformPoint
```
public final void transformPoint(org.bukkit.util.Vector point)
```
    Transforms a 3D point vector using this transformation matrix. The result is written to the input point.
    
    Parameters:
    
    point - to transform
  - transformPoint
```
public final void transformPoint(Vector3 point)
```
    Transforms a 3D point vector using this transformation matrix. The result is written to the input point.
    
    Parameters:
    
    point - to transform
  - transformPoint
```
public final void transformPoint(Vector4 point)
```
    Transforms a 4D point vector using this transformation matrix. The result is written to the input point.
    
    Parameters:
    
    point - to transform
  - transformQuad
```
public final void transformQuad(Quad quad)
```
    Transforms all four points of a quad using this transformation matrix.
    
    Parameters:
    
    quad - to transform
  - toVector3
```
public Vector3 toVector3()
```
    Obtains the absolute position vector of this matrix, equivalent to performing transformPoint with a zero vector.
    
    Returns:
    
    position vector
  - toVector
```
public org.bukkit.util.Vector toVector()
```
    Obtains the absolute position vector of this matrix, equivalent to performing transformPoint with a zero vector.
    
    Returns:
    
    position vector
  - clone
```
public Matrix4x4 clone()
```
    Overrides:
    
    clone in class java.lang.Object
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - fromColumns3x3
```
public static Matrix4x4 fromColumns3x3(org.bukkit.util.Vector v0,
                                       org.bukkit.util.Vector v1,
                                       org.bukkit.util.Vector v2)
```
    Creates a 4x4 matrix from 3 columns of a 3x3 matrix
    
    Parameters:
    
    v0 - column 0
    
    v1 - column 1
    
    v2 - column 2
    
    Returns:
    
    4x4 matrix
  - computeProjectionMatrix
```
public static Matrix4x4 computeProjectionMatrix(Vector3[] p)
```

Class Matrix4x4

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

m00

m01

m02

m03

m10

m11

m12

m13

m20

m21

m22

m23

m30

m31

m32

m33

Constructor Detail

Matrix4x4

Matrix4x4

Matrix4x4

Method Detail

set

set

setIdentity

set

set

toArray

toArray

invert

rotate

rotateX

rotateX

rotateY

rotateY

rotateZ

rotateZ

rotateYawPitchRoll

rotateYawPitchRoll

rotateYawPitchRoll

rotateYawPitchRoll

getRotation

getYawPitchRoll

translate

translate

translate

scale

scale

scale

translateRotate

translateRotate

translateRotate

multiply

transformPoint

transformPoint

transformPoint

transformQuad

toVector3

toVector

clone

toString

fromColumns3x3

computeProjectionMatrix