Package primitives

Class NormalizedVector

java.lang.Object

primitives.Triple

primitives.Vector

primitives.NonZeroVector

primitives.NormalizedVector

public class NormalizedVector
extends NonZeroVector

This class represents a special kind of NonZeroVector whose length is one.

Field Summary

Fields

Modifier and Type	Field	Description
static NormalizedVector	I	The I unit vector
static NormalizedVector	J	The J unit vector
static NormalizedVector	K	The K unit vector

Fields inherited from class primitives.Triple

x, y, z

Constructor Summary

Constructors

Constructor	Description
NormalizedVector(double x, double y, double z)	This constructor accepts 3 doubles and returns the appropriate NonZeroVector.
NormalizedVector(NonZeroVector vector)	Constructs a NormalizedVector from a not necessarily normalized NonZeroVector

Method Summary

Modifier and Type	Method	Description
double	length()	Gets the length of the vector.
NormalizedVector	normalized()	Creates a new NonZeroVector with the same direction as this one but with a magnitude of one.
NormalizedVector	reversed()	Calculates a new NormalizedVector with the opposite direction to this vector.
double	squareLength()	Gets the length of the vector squared.

Methods inherited from class primitives.NonZeroVector

add, angle, cross, scale, subtract

Methods inherited from class primitives.Vector

add, cross, cross, dot, scale, subtract, toString

Methods inherited from class primitives.Triple

equals, equals, hashCode, transform, transform

Methods inherited from class java.lang.Object

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

Field Details

I

public static final NormalizedVector I

The I unit vector

J

public static final NormalizedVector J

The J unit vector

K

public static final NormalizedVector K

The K unit vector

Constructor Details

NormalizedVector

public NormalizedVector(NonZeroVector vector)

Constructs a NormalizedVector from a not necessarily normalized NonZeroVector

Parameters:

vector - The unnormalized vector.

NormalizedVector

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

This constructor accepts 3 doubles and returns the appropriate NonZeroVector.

Parameters:

x - The value of the x coordinate.

y - The value of the y coordinate.

z - The value of the z coordinate.

Throws:

ZeroVectorException - if the x, y, and z are all zero.

Method Details

normalized

public NormalizedVector normalized()

Description copied from class: NonZeroVector

Creates a new NonZeroVector with the same direction as this one but with a magnitude of one.

Overrides:

normalized in class NonZeroVector

Returns:

new NonZeroVector

reversed

public NormalizedVector reversed()

Calculates a new NormalizedVector with the opposite direction to this vector.

Overrides:

reversed in class NonZeroVector

Returns:

Since the magnitude is unchanged, the returned NonZeroVector is a NormalizedVector.

length

public double length()

Gets the length of the vector.

Overrides:

length in class Vector

Returns:

1.0 since a normalized vector by definition has a length of one.

squareLength

public double squareLength()

Gets the length of the vector squared.

Overrides:

squareLength in class Vector

Returns:

1.0 since a normalized vector by definition has a length of one.