eu.mihosoft.jcsg.ext.quickhull3d

Class Point3d

java.lang.Object

eu.mihosoft.jcsg.ext.quickhull3d.Point3d

public class Point3d
extends java.lang.Object

A three-element spatial point. The only difference between a point and a vector is in the the way it is transformed by an affine transformation. Since the transform method is not included in this reduced implementation for QuickHull3D, the difference is purely academic.

Field Summary

Fields

Modifier and Type	Field and Description
double	x First element
double	y Second element
double	z Third element

Constructor Summary

Constructors

Constructor and Description
Point3d() Creates a Point3d and initializes it to zero.
Point3d(double x, double y, double z) Creates a Point3d with the supplied element values.
Point3d(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v) Creates a Point3d by copying a vector

Method Summary

Modifier and Type	Method and Description
void	add(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1) Adds this vector to v1 and places the result in this vector.
void	add(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1, eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v2) Adds vector v1 to v2 and places the result in this vector.
void	cross(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1, eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v2) Computes the cross product of v1 and v2 and places the result in this vector.
double	distance(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v) Returns the Euclidean distance between this vector and vector v.
double	distanceSquared(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v) Returns the squared of the Euclidean distance between this vector and vector v.
double	dot(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1) Returns the dot product of this vector and v1.
double	get(int i) Gets a single element of this vector.
double	norm() Returns the 2 norm of this vector.
void	normalize() Normalizes this vector in place.
double	normSquared() Returns the square of the 2 norm of this vector.
void	scale(double s) Scales the elements of this vector by s.
void	scale(double s, eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1) Scales the elements of vector v1 by s and places the results in this vector.
void	set(double x, double y, double z) Sets the elements of this vector to the prescribed values.
void	set(int i, double value) Sets a single element of this vector.
void	set(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1) Sets the values of this vector to those of v1.
protected void	setRandom(double lower, double upper, java.util.Random generator) Sets the elements of this vector to uniformly distributed random values in a specified range, using a supplied random number generator.
void	setZero() Sets the elements of this vector to zero.
void	sub(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1) Subtracts v1 from this vector and places the result in this vector.
void	sub(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1, eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v2) Subtracts vector v1 from v2 and places the result in this vector.
java.lang.String	toString() Returns a string representation of this vector, consisting of the x, y, and z coordinates.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

x

public double x

First element

y

public double y

Second element

z

public double z

Third element

Constructor Detail

Point3d

public Point3d()

Creates a Point3d and initializes it to zero.

Point3d

public Point3d(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v)

Creates a Point3d by copying a vector

Parameters:

v - vector to be copied

Point3d

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

Creates a Point3d with the supplied element values.

Parameters:

x - first element

y - second element

z - third element

Method Detail

get

public double get(int i)

Gets a single element of this vector. Elements 0, 1, and 2 correspond to x, y, and z.

Parameters:

i - element index

Returns:

element value throws ArrayIndexOutOfBoundsException if i is not in the range 0 to 2.

set

public void set(int i,
                double value)

Sets a single element of this vector. Elements 0, 1, and 2 correspond to x, y, and z.

Parameters:

i - element index

value - element value

set

public void set(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1)

Sets the values of this vector to those of v1.

Parameters:

v1 - vector whose values are copied

add

public void add(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1,
                eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v2)

Adds vector v1 to v2 and places the result in this vector.

Parameters:

v1 - left-hand vector

v2 - right-hand vector

add

public void add(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1)

Adds this vector to v1 and places the result in this vector.

Parameters:

v1 - right-hand vector

sub

public void sub(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1,
                eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v2)

Subtracts vector v1 from v2 and places the result in this vector.

Parameters:

v1 - left-hand vector

v2 - right-hand vector

sub

public void sub(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1)

Subtracts v1 from this vector and places the result in this vector.

Parameters:

v1 - right-hand vector

scale

public void scale(double s)

Scales the elements of this vector by s.

Parameters:

s - scaling factor

scale

public void scale(double s,
                  eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1)

Scales the elements of vector v1 by s and places the results in this vector.

Parameters:

s - scaling factor

v1 - vector to be scaled

norm

public double norm()

Returns the 2 norm of this vector. This is the square root of the sum of the squares of the elements.

Returns:

vector 2 norm

normSquared

public double normSquared()

Returns the square of the 2 norm of this vector. This is the sum of the squares of the elements.

Returns:

square of the 2 norm

distance

public double distance(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v)

Returns the Euclidean distance between this vector and vector v.

Returns:

distance between this vector and v

distanceSquared

public double distanceSquared(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v)

Returns the squared of the Euclidean distance between this vector and vector v.

Returns:

squared distance between this vector and v

dot

public double dot(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1)

Returns the dot product of this vector and v1.

Parameters:

v1 - right-hand vector

Returns:

dot product

normalize

public void normalize()

Normalizes this vector in place.

setZero

public void setZero()

Sets the elements of this vector to zero.

set

public void set(double x,
                double y,
                double z)

Sets the elements of this vector to the prescribed values.

Parameters:

x - value for first element

y - value for second element

z - value for third element

cross

public void cross(eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v1,
                  eu.mihosoft.jcsg.ext.quickhull3d.Vector3d v2)

Computes the cross product of v1 and v2 and places the result in this vector.

Parameters:

v1 - left-hand vector

v2 - right-hand vector

setRandom

protected void setRandom(double lower,
                         double upper,
                         java.util.Random generator)

Sets the elements of this vector to uniformly distributed random values in a specified range, using a supplied random number generator.

Parameters:

lower - lower random value (inclusive)

upper - upper random value (exclusive)

generator - random number generator

toString

public java.lang.String toString()

Returns a string representation of this vector, consisting of the x, y, and z coordinates.

Overrides:

toString in class java.lang.Object

Returns:

string representation