Mainly Javadoc fixes and Math stuff

This commit is contained in:
Caspian Rychlik-Prince 2002-08-23 16:14:38 +00:00
parent a5615938c9
commit 0f2936e709
5 changed files with 30 additions and 27 deletions

View File

@ -83,7 +83,7 @@ public final class Display {
* @param displayMode a display mode to choose
* @param fullscreen whether to create the display fullscreen
* @throws Exception if the display mode could not be set
* @see destroy()
* @see #destroy()
*/
public static void create(
DisplayMode displayMode,
@ -108,7 +108,7 @@ public final class Display {
* Native method to create the display. This will set the handle if it is
* successful.
* @return true if the display was successfully created
* @see create()
* @see #create(org.lwjgl.DisplayMode, boolean)
*/
private static native boolean nCreate(
int width,

View File

@ -43,18 +43,18 @@ package org.lwjgl;
public final class DisplayMode {
public final int width, height, freq, bpp;
public final int width, height, bpp, freq;
/**
* Construct a display mode.
*
* @see Display
*/
public DisplayMode(int width, int height, int freq, int bpp) {
public DisplayMode(int width, int height, int bpp, int freq) {
this.width = width;
this.height = height;
this.freq = freq;
this.bpp = bpp;
this.freq = freq;
}

View File

@ -119,7 +119,7 @@ public final class Math {
};
/** Straight copy */
public static final class MatrixOpCopy extends UnaryMatrixOperation {
private static final class MatrixOpCopy extends UnaryMatrixOperation {
MatrixOpCopy() {
super(0, "copy");
@ -183,7 +183,7 @@ public final class Math {
public static final MatrixOpCopy MATRIXOP_COPY = new MatrixOpCopy();
/** Negate the vector */
public static final class MatrixOpNegate extends UnaryMatrixOperation {
private static final class MatrixOpNegate extends UnaryMatrixOperation {
MatrixOpNegate() {
super(1, "negate");
@ -247,7 +247,7 @@ public final class Math {
public static final MatrixOpNegate MATRIXOP_NEGATE = new MatrixOpNegate();
/** Normalise the vector (set to length 1) */
public static final class MatrixOpNormalise extends UnaryMatrixOperation {
private static final class MatrixOpNormalise extends UnaryMatrixOperation {
MatrixOpNormalise() {
super(2, "normalise");
@ -311,7 +311,7 @@ public final class Math {
public static final MatrixOpNormalise MATRIXOP_NORMALISE = new MatrixOpNormalise();
/** Compute the inverse matrix */
public static final class MatrixOpInvert extends UnaryMatrixOperation {
private static final class MatrixOpInvert extends UnaryMatrixOperation {
MatrixOpInvert() {
super(3, "invert");
@ -392,10 +392,11 @@ public final class Math {
/**
* Check the compatibility of a binary matrix operation.
* @return the miniumum stride, in bytes
* @throws IllegalArgumentException if the source and destinations are not
* compatible
*/
abstract void checkCompatibility(
abstract int checkCompatibility(
int leftSourceWidth,
int leftSourceHeight,
boolean transposeLeftSource,
@ -410,13 +411,13 @@ public final class Math {
/** Multiply left source by right source */
public static final class MatrixOpMultiply extends BinaryMatrixOperation {
private static final class MatrixOpMultiply extends BinaryMatrixOperation {
MatrixOpMultiply() {
super(0, "multiply");
}
void checkCompatibility(
int checkCompatibility(
int leftSourceWidth,
int leftSourceHeight,
boolean transposeLeftSource,
@ -430,6 +431,9 @@ public final class Math {
int rightHeight = transposeRightSource ? rightSourceWidth : rightSourceHeight;
if (leftWidth != rightHeight)
throw new IllegalArgumentException("Left and right matrices are not compatible.");
int leftHeight = transposeLeftSource ? leftSourceWidth : leftSourceHeight;
int rightWidth = transposeRightSource ? rightSourceHeight : rightSourceWidth;
return (rightWidth * leftHeight) << 2;
}
MatrixOpClassification classify() {
return MATRIXOP_NONE;
@ -502,13 +506,13 @@ public final class Math {
public static final MatrixOpMultiply MATRIXOP_MULTIPLY = new MatrixOpMultiply();
/** Add right source to left source */
public static final class MatrixOpAdd extends BinaryMatrixOperation {
private static final class MatrixOpAdd extends BinaryMatrixOperation {
MatrixOpAdd() {
super(1, "add");
}
void checkCompatibility(
int checkCompatibility(
int leftSourceWidth,
int leftSourceHeight,
boolean transposeLeftSource,
@ -526,6 +530,7 @@ public final class Math {
if (leftSourceWidth != rightSourceHeight || leftSourceHeight != rightSourceWidth)
throw new IllegalArgumentException("Left and right matrices are not the same size.");
}
return (leftSourceWidth * leftSourceHeight) << 2;
}
MatrixOpClassification classify() {
@ -599,13 +604,13 @@ public final class Math {
public static final MatrixOpAdd MATRIXOP_ADD = new MatrixOpAdd();
/** Subtract right source from left source */
public static final class MatrixOpSubtract extends BinaryMatrixOperation {
private static final class MatrixOpSubtract extends BinaryMatrixOperation {
MatrixOpSubtract() {
super(2, "subtract");
}
void checkCompatibility(
int checkCompatibility(
int leftSourceWidth,
int leftSourceHeight,
boolean transposeLeftSource,
@ -615,7 +620,7 @@ public final class Math {
boolean transposeDest)
{
// Same as for add, obviously...
MATRIXOP_ADD.checkCompatibility(
return MATRIXOP_ADD.checkCompatibility(
leftSourceWidth,
leftSourceHeight,
transposeLeftSource,
@ -994,7 +999,7 @@ public final class Math {
rightSourceStride = rightSourceWidth * rightSourceHeight;
// Ensure the source and destination matrices are compatible
operation.checkCompatibility(
int minStride = operation.checkCompatibility(
leftSourceWidth,
leftSourceHeight,
transposeLeftSource,
@ -1003,10 +1008,8 @@ public final class Math {
transposeRightSource,
transposeDest);
if (destStride == 0) {
// Calculate the destination stride from the input matrix sizes
}
if (destStride == 0)
destStride = minStride;
// Check unary matrix operation type
MatrixOpClassification op = operation.classify().check(leftSourceAddress, leftSourceStride, leftElements, destAddress, destStride);

View File

@ -54,7 +54,7 @@ public final class Sys {
* inside a process which is already a different priority then this will not
* be the initial priority.
*
* @see #setProcessPriority()
* @see #setProcessPriority(int)
*/
public static final int NORMAL_PRIORITY = 0;
@ -70,7 +70,7 @@ public final class Sys {
*
* This priority is <strong>not</strong> recommended for gaming applications.
*
* @see #setProcessPriority()
* @see #setProcessPriority(int)
*/
public static final int REALTIME_PRIORITY = 2;

View File

@ -88,7 +88,7 @@ abstract class BaseGL {
* @param alphaBits the number of alpha bits (eg. 0 or 8)
* @param depthBits the number of depth bits (eg. 16 or 24)
* @param stencilBits the number of stencil bits (eg. 0 or 8)
* @see create()
* @see #create()
*/
public BaseGL(int colorBits, int alphaBits, int depthBits, int stencilBits) {
this.colorBits = colorBits;
@ -125,7 +125,7 @@ abstract class BaseGL {
* created by calling its setDisplayMode() method.
*
* @return true if the GL was created successfully
* @see org.lwjgl.Display#create()
* @see org.lwjgl.Display#create(org.lwjgl.DisplayMode, boolean)
*/
private native boolean nCreate(int colorBits, int alphaBits, int depthBits, int stencilBits);
@ -157,7 +157,7 @@ abstract class BaseGL {
* Finalizer, marked final. To perform specialized cleanup override the
* cleanup() method.
*
* @see cleanup()
* @see #cleanup()
*/
public final void finalize() throws Throwable {
super.finalize();