| java.lang.Object
 javax.media.j3d.HiResCoord
| HiResCoord | | public class HiResCoord (Code) | | The HiResCoord object specifies the location of scene
components within the Virtual Universe.
The coordinates of all scene graph objects are relative to
the HiResCoord of the Locale in which they are contained.
The HiResCoord defines a point using a set of three
high-resolution coordinates, each of which consists of three
two's-complement fixed-point numbers.
Each high-resolution number consists of 256 total bits with a
binary point at bit 128, or between the integers at index
3 and 4. A high-resolution coordinate of 1.0 is defined to be exactly
1 meter. This coordinate system is sufficient to describe a
universe in excess of several billion light years across, yet
still define objects smaller than a proton.
Java 3D uses integer arrays of length
eight to define or extract a single 256-bit coordinate value.
Java 3D interprets the integer at index 0 as the 32
most-significant bits and the integer at index 7 as the 32
least-significant bits.
|
| Field Summary | |
| int | x
The eight-element array containing the high resolution coordinate's
x value. | | int | y
The eight-element array containing the high resolution coordinate's
y value. | | int | z
The eight-element array containing the high resolution coordinate's
z value. |
| Constructor Summary | |
| public | HiResCoord(int[] X, int[] Y, int[] Z)
Constructs and initializes a new HiResCoord using the values
provided in the argument. | | public | HiResCoord(HiResCoord hc)
Constructs and initializes a new HiResCoord using the values
provided in the argument. | | public | HiResCoord()
Constructs and initializes a new HiResCoord located at (0, 0, 0). |
| Method Summary | |
| public void | add(HiResCoord h1, HiResCoord h2)
Adds two HiResCoords placing the results into this HiResCoord. | | public void | difference(HiResCoord h1, Vector3d v)
Subtracts the specified HiResCoord from this HiResCoord
placing the difference vector into the specified
double-precision vector. | | public double | distance(HiResCoord h1)
The floating point distance between the specified
HiResCoord and this HiResCoord. | | public boolean | equals(HiResCoord h1)
Compares the specified HiResCoord to this HiResCoord. | | public boolean | equals(Object o1)
Returns true if the Object o1 is of type HiResCoord and all of the
data members of o1 are equal to the corresponding data members in
this HiResCoord. | | public void | getHiResCoord(int[] X, int[] Y, int[] Z)
Retrieves this HiResCoord's location and saves the coordinates
in the specified arrays. | | public void | getHiResCoord(HiResCoord hc)
Retrieves this HiResCoord's location and places it into the hires
argument. | | public void | getHiResCoordX(int[] X)
Retrieves this HiResCoord's X value and stores it in the specified
array. | | public void | getHiResCoordY(int[] Y)
Retrieves this HiResCoord's Y value and stores it in the specified
array. | | public void | getHiResCoordZ(int[] Z)
Retrieves this HiResCoord's Z value and stores it in the specified
array. | | public void | negate(HiResCoord h1)
Negates the specified HiResCoords and places the
results into this HiResCoord. | | public void | negate()
| | public void | scale(int scale, HiResCoord h1)
Scales the specified HiResCoords by the specified value and
places the results into this HiResCoord. | | public void | scale(int scale)
Scales this HiResCoord by the specified value. | | public void | setHiResCoord(int[] X, int[] Y, int[] Z)
Sets this HiResCoord to the location specified by the
parameters provided. | | public void | setHiResCoord(HiResCoord hires)
Sets this HiResCoord to the location specified by the
hires provided. | | public void | setHiResCoordX(int[] X)
Sets this HiResCoord's X value to that specified by the argument. | | public void | setHiResCoordY(int[] Y)
Sets this HiResCoord's Y value to that specified by the argument. | | public void | setHiResCoordZ(int[] Z)
Sets this HiResCoord's Z value to that specified by the argument. | | public void | sub(HiResCoord h1, HiResCoord h2)
Subtracts two HiResCoords placing the results into this HiResCoord. |
| x | | int x(Code) | | The eight-element array containing the high resolution coordinate's
x value.
|
| y | | int y(Code) | | The eight-element array containing the high resolution coordinate's
y value.
|
| z | | int z(Code) | | The eight-element array containing the high resolution coordinate's
z value.
|
| HiResCoord | | public HiResCoord(int[] X, int[] Y, int[] Z)(Code) | | Constructs and initializes a new HiResCoord using the values
provided in the argument.
The HiResCoord represents 768 bits of floating point 3-Space.
Parameters:
X - an eight element array specifying the x position
Parameters:
Y - an eight element array specifying the y position
Parameters:
Z - an eight element array specifying the z position |
| HiResCoord | | public HiResCoord(HiResCoord hc)(Code) | | Constructs and initializes a new HiResCoord using the values
provided in the argument.
The HiResCoord represents 768 bits of floating point 3-Space.
Parameters:
hc - the HiResCoord to copy |
| HiResCoord | | public HiResCoord()(Code) | | Constructs and initializes a new HiResCoord located at (0, 0, 0).
The HiResCoord represents 768 bits of floating point 3-Space.
|
| add | | public void add(HiResCoord h1, HiResCoord h2)(Code) | | Adds two HiResCoords placing the results into this HiResCoord.
Parameters:
h1 - the first HiResCoord
Parameters:
h2 - the second HiResCoord |
| difference | | public void difference(HiResCoord h1, Vector3d v)(Code) | | Subtracts the specified HiResCoord from this HiResCoord
placing the difference vector into the specified
double-precision vector.
Parameters:
h1 - the HiResCoord to be subtracted from this
Parameters:
v - the vector that will receive the result |
| distance | | public double distance(HiResCoord h1)(Code) | | The floating point distance between the specified
HiResCoord and this HiResCoord.
Parameters:
h1 - the second HiResCoord |
| equals | | public boolean equals(HiResCoord h1)(Code) | | Compares the specified HiResCoord to this HiResCoord.
Parameters:
h1 - the second HiResCoord true if equal, false if not equal |
| equals | | public boolean equals(Object o1)(Code) | | Returns true if the Object o1 is of type HiResCoord and all of the
data members of o1 are equal to the corresponding data members in
this HiResCoord.
Parameters:
o1 - the second HiResCoord true if equal, false if not equal |
| getHiResCoord | | public void getHiResCoord(int[] X, int[] Y, int[] Z)(Code) | | Retrieves this HiResCoord's location and saves the coordinates
in the specified arrays. The arrays must be large enough
to hold all of the ints.
Parameters:
X - an eight element array that will receive the x position
Parameters:
Y - an eight element array that will receive the y position
Parameters:
Z - an eight element array that will receive the z position |
| getHiResCoord | | public void getHiResCoord(HiResCoord hc)(Code) | | Retrieves this HiResCoord's location and places it into the hires
argument.
Parameters:
hc - the hires coordinate that will receive this node's location |
| getHiResCoordX | | public void getHiResCoordX(int[] X)(Code) | | Retrieves this HiResCoord's X value and stores it in the specified
array. The array must be large enough to hold all of the ints.
Parameters:
X - an eight-element array that will receive the x position |
| getHiResCoordY | | public void getHiResCoordY(int[] Y)(Code) | | Retrieves this HiResCoord's Y value and stores it in the specified
array. The array must be large enough to hold all of the ints.
Parameters:
Y - an eight-element array that will receive the y position |
| getHiResCoordZ | | public void getHiResCoordZ(int[] Z)(Code) | | Retrieves this HiResCoord's Z value and stores it in the specified
array. The array must be large enough to hold all of the ints.
Parameters:
Z - an eight-element array that will receive the z position |
| negate | | public void negate(HiResCoord h1)(Code) | | Negates the specified HiResCoords and places the
results into this HiResCoord.
Parameters:
h1 - the source HiResCoord |
| negate | | public void negate()(Code) | | Negates this HiResCoord
|
| scale | | public void scale(int scale, HiResCoord h1)(Code) | | Scales the specified HiResCoords by the specified value and
places the results into this HiResCoord.
Parameters:
scale - the amount to scale the specified HiResCoord
Parameters:
h1 - the source HiResCoord |
| scale | | public void scale(int scale)(Code) | | Scales this HiResCoord by the specified value.
Parameters:
scale - the amount to scale the specified HiResCoord |
| setHiResCoord | | public void setHiResCoord(int[] X, int[] Y, int[] Z)(Code) | | Sets this HiResCoord to the location specified by the
parameters provided.
Parameters:
X - an eight-element array specifying the x position
Parameters:
Y - an eight-element array specifying the y position
Parameters:
Z - an eight-element array specifying the z position |
| setHiResCoord | | public void setHiResCoord(HiResCoord hires)(Code) | | Sets this HiResCoord to the location specified by the
hires provided.
Parameters:
hires - the hires coordinate to copy |
| setHiResCoordX | | public void setHiResCoordX(int[] X)(Code) | | Sets this HiResCoord's X value to that specified by the argument.
Parameters:
X - an eight-element array specifying the x position |
| setHiResCoordY | | public void setHiResCoordY(int[] Y)(Code) | | Sets this HiResCoord's Y value to that specified by the argument.
Parameters:
Y - an eight-element array specifying the y position |
| setHiResCoordZ | | public void setHiResCoordZ(int[] Z)(Code) | | Sets this HiResCoord's Z value to that specified by the argument.
Parameters:
Z - an eight-element array specifying the z position |
| sub | | public void sub(HiResCoord h1, HiResCoord h2)(Code) | | Subtracts two HiResCoords placing the results into this HiResCoord.
Parameters:
h1 - the first HiResCoord
Parameters:
h2 - the second HiResCoord |
|
|