edu.mines.jtk.sgl

Class Point4

java.lang.Object

edu.mines.jtk.sgl.Tuple4

edu.mines.jtk.sgl.Point4

public class Point4
extends Tuple4

A point with four coordinates x, y, z, and w.

Field Summary

Fields inherited from class edu.mines.jtk.sgl.Tuple4

w, x, y, z

Constructor Summary

Constructors

Constructor and Description
Point4() Constructs a point with coordinates (x,y,z) = 0 and w = 1.
Point4(double x, double y, double z) Constructs a point with specified (x,y,z) coordinates and w = 1.
Point4(double x, double y, double z, double w) Constructs a point with specified coordinates.
Point4(Point3 p) Constructs a point from the specified 3-D point.
Point4(Point4 p) Constructs a copy of the specified point.

Method Summary

Methods

Modifier and Type	Method and Description
Point4	affine(double a, Point4 q) Returns an affine combination of this point p and the specified point q.
Point4	homogenize() Returns the homogenized point equivalent to this point.
Point4	homogenizeEquals() Homogenizes this point.
Point4	minus(Vector3 v) Returns the point q = p-v, for this point p and the specified vector v.
Point4	minusEquals(Vector3 v) Moves this point p by subtracting the specified vector v.
Point4	plus(Vector3 v) Returns the point q = p+v, for this point p and the specified vector v.
Point4	plusEquals(Vector3 v) Moves this point p by adding the specified vector v.

Methods inherited from class edu.mines.jtk.sgl.Tuple4

equals, hashCode, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Point4

public Point4()

Constructs a point with coordinates (x,y,z) = 0 and w = 1.

Point4

public Point4(double x,
      double y,
      double z)

Constructs a point with specified (x,y,z) coordinates and w = 1.

Parameters:

x - the x coordinate.

y - the y coordinate.

z - the z coordinate.

Point4

public Point4(double x,
      double y,
      double z,
      double w)

Constructs a point with specified coordinates.

Parameters:

x - the x coordinate.

y - the y coordinate.

z - the z coordinate.

w - the w coordinate.

Point4

public Point4(Point3 p)

Constructs a point from the specified 3-D point. The (x,y,z,w) coordinates of the constructed point are (p.x,p.y,p.z,1).

Parameters:

p - the 3-D point.

Point4

public Point4(Point4 p)

Constructs a copy of the specified point.

Parameters:

p - the point.

Method Detail

homogenize

public Point4 homogenize()

Returns the homogenized point equivalent to this point. Homogenization is division of the coordinates (x,y,z,w) by w.

Returns:

the homogenized point.

homogenizeEquals

public Point4 homogenizeEquals()

Homogenizes this point. Homogenization is division of the coordinates (x,y,z,w) by w.

Returns:

this homogenized point.

plus

public Point4 plus(Vector3 v)

Returns the point q = p+v, for this point p and the specified vector v.

Parameters:

v - the vector v.

Returns:

the point q = p+v.

minus

public Point4 minus(Vector3 v)

Returns the point q = p-v, for this point p and the specified vector v.

Parameters:

v - the vector v.

Returns:

the point q = p-v.

plusEquals

public Point4 plusEquals(Vector3 v)

Moves this point p by adding the specified vector v.

Parameters:

v - the vector v.

Returns:

this point, p += v, moved.

minusEquals

public Point4 minusEquals(Vector3 v)

Moves this point p by subtracting the specified vector v.

Parameters:

v - the vector v.

Returns:

this point, p -= v, moved.

affine

public Point4 affine(double a,
            Point4 q)

Returns an affine combination of this point p and the specified point q.

Parameters:

a - the weight of the point q.

q - the point q.

Returns:

the affine combination (1-a)*p + a*q.