Point3D

java.lang.Object
- graphicslib3D.Point3D

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable
```
public class Point3D
extends java.lang.Object
implements java.lang.Cloneable, java.io.Serializable
```
Defines a three-dimensional homogeneous point. Each Point3D object contains four components: X, Y, and Z, the 3-dimensional coordinates of the point, and W, the homogeneous component.

Version:

4.10 02/19/05

Author:

William Dimaculangan, Monika Jankun-Kelly, John Clevenger

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`Point3D()` Creates a new Point3D with defaults of X,Y,Z = 0.0 and W = 1.0.
`Point3D(double[] values)` Creates a new Point3D whose values are taken from the specified array of doubles.
`Point3D(double X, double Y, double Z)` Creates a new Point3D given three coordinates.
`Point3D(double X, double Y, double Z, double W)` Creates a new Point3D given three coordinates and a W value.
`Point3D(float[] values)` Creates a new Point3D whose values are taken from the specified array of floats.
`Point3D(Vector3D vec)` Constructs a new Point3D implied by the specified `Vector3D`; that is, considers the specified `Vector3D` as a vector from the origin to the point specified by the head of the vector, and constructs a Point3D containing the same X,Y,Z values as the `Vector3D`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Point3D`	`add(Point3D p2)` Returns a new Point3D whose X,Y,Z values are the sum of this point's values and the specified point's values.
`java.lang.Object`	`clone()` Returns a new Point3D which is a deep clone of this Point3D.
`double`	`distanceTo(Point3D p2)` Returns a real number that is the distance between this point and the specified point.
`Point3D`	`div(double theDivisor)` Returns a new Point3D which is the result of dividing this point by the given divisor.
`boolean`	`equals(Point3D other)` Returns true if all four elements of this `Point3D` are equal to the corresponding elements of the specified `Point3D`; false if one or more elements are not the same.
`double`	`getW()` Returns the W component of this Point3D object.
`double`	`getX()` Returns the X component of this Point3D object.
`double`	`getY()` Returns the Y component of this Point3D object.
`double`	`getZ()` Returns the Z component of this Point3D object.
`Point3D`	`mid(Point3D p2)` Returns a new Point3D which is the midpoint between this point and the specified point.
`Point3D`	`minus(Point3D p2)` Returns a new Point3D whose X,Y,Z values are the difference between this point's X,Y,Z and the specified point's X,Y,Z.
`Point3D`	`mult(double theMultiplier)` Returns a new Point3D which is the result of multiplying this point by the given multiplier.
`Point3D`	`mult(Matrix3D mat)` Returns a new Point3D which is the result of multiplying this point by the given matrix.
`void`	`scale(double scaleFactor)` Scales each of the X, Y, and Z components of this point by the given scaleFactor.
`void`	`setW(double newW)` Sets the W component of this Point3D object.
`void`	`setX(double newX)` Sets the X component of this Point3D object.
`void`	`setY(double newY)` Sets the Y component of this Point3D object.
`void`	`setZ(double newZ)` Sets the Z component of this Point3D object.
`java.lang.String`	`toString()` Returns a printable representation of this Point3D.

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

- Constructor Detail
  - Point3D
```
public Point3D()
```
    Creates a new Point3D with defaults of X,Y,Z = 0.0 and W = 1.0.
  - Point3D
```
public Point3D(double X,
               double Y,
               double Z)
```
    Creates a new Point3D given three coordinates. The default value for W is 1.0.
  - Point3D
```
public Point3D(double X,
               double Y,
               double Z,
               double W)
```
    Creates a new Point3D given three coordinates and a W value.
  - Point3D
```
public Point3D(float[] values)
```
    Creates a new Point3D whose values are taken from the specified array of floats. If the array length is 3, the values are assumed to represent X, Y, and Z and a default value of W=1.0 is assigned. If the array length is 4 or more, the first four values are used for X, Y, Z, and W and any additional values are silently ignored. If the array length is less than 3 an exception is thrown.
  - Point3D
```
public Point3D(double[] values)
```
    Creates a new Point3D whose values are taken from the specified array of doubles. If the array length is 3, the values are assumed to represent X, Y, and Z and a default value of W=1.0 is assigned. If the array length is 4 or more, the first four values are used for X, Y, Z, and W and any additional values are silently ignored. If the array length is less than 3 an exception is thrown.
  - Point3D
```
public Point3D(Vector3D vec)
```
    Constructs a new Point3D implied by the specified Vector3D; that is, considers the specified Vector3D as a vector from the origin to the point specified by the head of the vector, and constructs a Point3D containing the same X,Y,Z values as the Vector3D. The W component of the new Point3D is set to 1, regardless of the value in the W component of the vector (which is normally 0).
    
    Parameters:
    
    vec -
- Method Detail
  - getX
```
public double getX()
```
    Returns the X component of this Point3D object.
  - getY
```
public double getY()
```
    Returns the Y component of this Point3D object.
  - getZ
```
public double getZ()
```
    Returns the Z component of this Point3D object.
  - getW
```
public double getW()
```
    Returns the W component of this Point3D object. W is is another name for the homogeneous component.
  - setX
```
public void setX(double newX)
```
    Sets the X component of this Point3D object.
  - setY
```
public void setY(double newY)
```
    Sets the Y component of this Point3D object.
  - setZ
```
public void setZ(double newZ)
```
    Sets the Z component of this Point3D object.
  - setW
```
public void setW(double newW)
```
    Sets the W component of this Point3D object.
  - clone
```
public java.lang.Object clone()
```
    Returns a new Point3D which is a deep clone of this Point3D.
    
    Overrides:
    
    clone in class java.lang.Object
  - minus
```
public Point3D minus(Point3D p2)
```
    Returns a new Point3D whose X,Y,Z values are the difference between this point's X,Y,Z and the specified point's X,Y,Z. The new Point3D's W value is the default (1.0).
  - distanceTo
```
public double distanceTo(Point3D p2)
```
    Returns a real number that is the distance between this point and the specified point.
  - add
```
public Point3D add(Point3D p2)
```
    Returns a new Point3D whose X,Y,Z values are the sum of this point's values and the specified point's values. The new Point3D's W value is the default (1.0).
  - mid
```
public Point3D mid(Point3D p2)
```
    Returns a new Point3D which is the midpoint between this point and the specified point. The new Point3D's W value is the default (1.0).
  - mult
```
public Point3D mult(double theMultiplier)
```
    Returns a new Point3D which is the result of multiplying this point by the given multiplier. The new Point3D's W value is the default (1.0).
  - div
```
public Point3D div(double theDivisor)
```
    Returns a new Point3D which is the result of dividing this point by the given divisor. The new Point3D's W value is the default (1.0).
  - mult
```
public Point3D mult(Matrix3D mat)
```
    Returns a new Point3D which is the result of multiplying this point by the given matrix. Multiplication is done "from the right". That is, this method returns a new point P' such that P' = [givenMatrix] x [thisPoint].
  - scale
```
public void scale(double scaleFactor)
```
    Scales each of the X, Y, and Z components of this point by the given scaleFactor. Note that unlike most Point3D methods, this method does NOT return a new Point3D; it scales THIS point. The W value in the point is unchanged.
  - equals
```
public boolean equals(Point3D other)
```
    Returns true if all four elements of this Point3D are equal to the corresponding elements of the specified Point3D; false if one or more elements are not the same.
  - toString
```
public java.lang.String toString()
```
    Returns a printable representation of this Point3D.
    
    Overrides:
    
    toString in class java.lang.Object

Class Point3D

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Point3D

Point3D

Point3D

Point3D

Point3D

Point3D

Method Detail

getX

getY

getZ

getW

setX

setY

setZ

setW

clone

minus

distanceTo

add

mid

mult

div

mult

scale

equals

toString