sigonasr2/jmonkeyengine
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

remove all javadoc references to the mythical JmeException

Browse Source
This commit is contained in:
Stephen Gold 2020-04-16 22:06:51 -07:00
parent e99c8a74a3
commit 50dc8349a1
10 changed files with 50 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
jme3-core/src/main/java/com/jme3/math/Matrix3f.java
View File

@ -146,13 +146,12 @@ public final class Matrix3f implements Savable, Cloneable, java.io.Serializable
} }
/** /**
* <code>get</code> retrieves a value from the matrix at the given * <code>get</code> retrieves a value from the matrix at the given position.
* position. If the position is invalid a <code>JmeException</code> is
* thrown.
* *
* @param i the row index. * @param i the row index.
* @param j the colum index. * @param j the column index.
* @return the value at (i, j). * @return the value at (i, j).
* @throws IllegalArgumentException if either index is invalid
*/ */
@SuppressWarnings("fallthrough") @SuppressWarnings("fallthrough")
public float get(int i, int j) { public float get(int i, int j) {
@ -549,16 +548,16 @@ public final class Matrix3f implements Savable, Cloneable, java.io.Serializable
/** /**
* <code>set</code> places a given value into the matrix at the given * <code>set</code> places a given value into the matrix at the given
* position. If the position is invalid a <code>JmeException</code> is * position.
* thrown.
* *
* @param i * @param i
* the row index. * the row index.
* @param j * @param j
* the colum index. * the column index.
* @param value * @param value
* the value for (i, j). * the value for (i, j).
* @return this * @return this
* @throws IllegalArgumentException if either index is invalid
*/ */
@SuppressWarnings("fallthrough") @SuppressWarnings("fallthrough")
public Matrix3f set(int i, int j, float value) { public Matrix3f set(int i, int j, float value) {
@ -611,8 +610,7 @@ public final class Matrix3f implements Savable, Cloneable, java.io.Serializable
* *
* @param matrix * @param matrix
* the new values of the matrix. * the new values of the matrix.
* @throws JmeException * @throws IllegalArgumentException if the matrix is not 3x3
* if the array is not of size 9.
* @return this * @return this
*/ */
public Matrix3f set(float[][] matrix) { public Matrix3f set(float[][] matrix) {

32
jme3-core/src/main/java/com/jme3/math/Matrix4f.java
View File

@ -249,12 +249,13 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
/** /**
* <code>get</code> retrieves a value from the matrix at the given * <code>get</code> retrieves a value from the matrix at the given
* position. If the position is invalid a <code>JmeException</code> is * position.
* thrown.
* *
* @param i the row index. * @param i the row index.
* @param j the colum index. * @param j the column index.
* @return the value at (i, j). * @return the value at (i, j).
* @throws IllegalArgumentException
* if either index is invalid
*/ */
@SuppressWarnings("fallthrough") @SuppressWarnings("fallthrough")
public float get(int i, int j) { public float get(int i, int j) {
@ -413,13 +414,14 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
/** /**
* <code>set</code> places a given value into the matrix at the given * <code>set</code> places a given value into the matrix at the given
* position. If the position is invalid a <code>JmeException</code> is * position.
* thrown.
* *
* @param i the row index. * @param i the row index.
* @param j the colum index. * @param j the column index.
* @param value * @param value
* the value for (i, j). * the value for (i, j).
* @throws IllegalArgumentException
* if either index is invalid
*/ */
@SuppressWarnings("fallthrough") @SuppressWarnings("fallthrough")
public void set(int i, int j, float value) { public void set(int i, int j, float value) {
@ -496,8 +498,8 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
* *
* @param matrix * @param matrix
* the matrix to set the value to. * the matrix to set the value to.
* @throws JmeException * @throws IllegalArgumentException
* if the array is not of size 16. * if the array is 4x4
*/ */
public void set(float[][] matrix) { public void set(float[][] matrix) {
if (matrix.length != 4 || matrix[0].length != 4) { if (matrix.length != 4 || matrix[0].length != 4) {
@ -1808,7 +1810,7 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
* *
* @param translation * @param translation
* the new values for the translation. * the new values for the translation.
* @throws JmeException * @throws IllegalArgumentException
* if translation is not size 3. * if translation is not size 3.
*/ */
public void setTranslation(float[] translation) { public void setTranslation(float[] translation) {
@ -1852,7 +1854,7 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
* *
* @param translation * @param translation
* the new values for the inverse translation. * the new values for the inverse translation.
* @throws JmeException * @throws IllegalArgumentException
* if translation is not size 3. * if translation is not size 3.
*/ */
public void setInverseTranslation(float[] translation) { public void setInverseTranslation(float[] translation) {
@ -1922,7 +1924,7 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
* *
* @param angles * @param angles
* the Euler angles in radians. * the Euler angles in radians.
* @throws JmeException * @throws IllegalArgumentException
* if angles is not size 3. * if angles is not size 3.
*/ */
public void setInverseRotationRadians(float[] angles) { public void setInverseRotationRadians(float[] angles) {
@ -1959,7 +1961,7 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
* *
* @param angles * @param angles
* the Euler angles in degrees. * the Euler angles in degrees.
* @throws JmeException * @throws IllegalArgumentException
* if angles is not size 3. * if angles is not size 3.
*/ */
public void setInverseRotationDegrees(float[] angles) { public void setInverseRotationDegrees(float[] angles) {
@ -1980,7 +1982,7 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
* *
* @param vec * @param vec
* the Vector3f data to be translated. * the Vector3f data to be translated.
* @throws JmeException * @throws IllegalArgumentException
* if the size of the Vector3f is not 3. * if the size of the Vector3f is not 3.
*/ */
public void inverseTranslateVect(float[] vec) { public void inverseTranslateVect(float[] vec) {
@ -2000,7 +2002,7 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
* *
* @param data * @param data
* the Vector3f to be translated. * the Vector3f to be translated.
* @throws JmeException * @throws IllegalArgumentException
* if the size of the Vector3f is not 3. * if the size of the Vector3f is not 3.
*/ */
public void inverseTranslateVect(Vector3f data) { public void inverseTranslateVect(Vector3f data) {
@ -2015,7 +2017,7 @@ public final class Matrix4f implements Savable, Cloneable, java.io.Serializable
* *
* @param data * @param data
* the Vector3f to be translated. * the Vector3f to be translated.
* @throws JmeException * @throws IllegalArgumentException
* if the size of the Vector3f is not 3. * if the size of the Vector3f is not 3.
*/ */
public void translateVect(Vector3f data) { public void translateVect(Vector3f data) {

2
jme3-desktop/src/main/java/com/jme3/app/SettingsDialog.java
View File

@ -133,7 +133,7 @@ public final class SettingsDialog extends JFrame {
* the image file to use as the title of the dialog; * the image file to use as the title of the dialog;
* <code>null</code> will result in to image being displayed * <code>null</code> will result in to image being displayed
* @param loadSettings * @param loadSettings
* @throws JmeException * @throws NullPointerException
* if the source is <code>null</code> * if the source is <code>null</code>
*/ */
public SettingsDialog(AppSettings source, URL imageFile, boolean loadSettings) { public SettingsDialog(AppSettings source, URL imageFile, boolean loadSettings) {

5
jme3-terrain/src/main/java/com/jme3/terrain/heightmap/AbstractHeightMap.java
View File

@ -112,7 +112,7 @@ public abstract class AbstractHeightMap implements HeightMap {
* the new size of the terrain. * the new size of the terrain.
* @throws Exception * @throws Exception
* *
* @throws JmeException * @throws Exception
* if the size is less than or equal to zero. * if the size is less than or equal to zero.
*/ */
@Override @Override
@ -132,7 +132,6 @@ public abstract class AbstractHeightMap implements HeightMap {
* @param filter * @param filter
* the erosion value. * the erosion value.
* @throws Exception * @throws Exception
* @throws JmeException
* if filter is less than 0 or greater than 1. * if filter is less than 0 or greater than 1.
*/ */
@Override @Override
@ -255,8 +254,6 @@ public abstract class AbstractHeightMap implements HeightMap {
* the file name to save the current data as. * the file name to save the current data as.
* @return true if the save was successful, false otherwise. * @return true if the save was successful, false otherwise.
* @throws Exception * @throws Exception
*
* @throws JmeException
* if filename is null. * if filename is null.
*/ */
public boolean save(String filename) throws Exception { public boolean save(String filename) throws Exception {

10
jme3-terrain/src/main/java/com/jme3/terrain/heightmap/CombinerHeightMap.java
View File

@ -74,7 +74,7 @@ public class CombinerHeightMap extends AbstractHeightMap {
* @param map2 the second heightmap to combine. * @param map2 the second heightmap to combine.
* @param mode denotes whether to add or subtract the heightmaps, may * @param mode denotes whether to add or subtract the heightmaps, may
* be either ADDITION or SUBTRACTION. * be either ADDITION or SUBTRACTION.
* @throws JmeException if either map is null, their size * @throws Exception if either map is null, their size
* do not match or the mode is invalid. * do not match or the mode is invalid.
*/ */
public CombinerHeightMap( public CombinerHeightMap(
@ -122,7 +122,7 @@ public class CombinerHeightMap extends AbstractHeightMap {
* @param factor2 the factor for map2. * @param factor2 the factor for map2.
* @param mode denotes whether to add or subtract the heightmaps, may * @param mode denotes whether to add or subtract the heightmaps, may
* be either ADDITION or SUBTRACTION. * be either ADDITION or SUBTRACTION.
* @throws JmeException if either map is null, their size * @throws Exception if either map is null, their size
* do not match, the mode is invalid, or the factors do not add * do not match, the mode is invalid, or the factors do not add
* to 1.0. * to 1.0.
*/ */
@ -173,7 +173,7 @@ public class CombinerHeightMap extends AbstractHeightMap {
* to 1.0. * to 1.0.
* @param factor1 the factor for map1. * @param factor1 the factor for map1.
* @param factor2 the factor for map2. * @param factor2 the factor for map2.
* @throws JmeException if the factors do not add to 1.0. * @throws Exception if the factors do not add to 1.0.
*/ */
public void setFactors(float factor1, float factor2) throws Exception { public void setFactors(float factor1, float factor2) throws Exception {
if ((factor1 + factor2) != 1.0f) { if ((factor1 + factor2) != 1.0f) {
@ -190,7 +190,7 @@ public class CombinerHeightMap extends AbstractHeightMap {
* The size of the height maps must be the same. * The size of the height maps must be the same.
* @param map1 the first height map. * @param map1 the first height map.
* @param map2 the second height map. * @param map2 the second height map.
* @throws JmeException if the either heightmap is null, or their * @throws Exception if the either heightmap is null, or their
* sizes do not match. * sizes do not match.
*/ */
public void setHeightMaps(AbstractHeightMap map1, AbstractHeightMap map2) throws Exception { public void setHeightMaps(AbstractHeightMap map1, AbstractHeightMap map2) throws Exception {
@ -213,7 +213,7 @@ public class CombinerHeightMap extends AbstractHeightMap {
* <code>setMode</code> sets the mode of the combiner. This may either * <code>setMode</code> sets the mode of the combiner. This may either
* be ADDITION or SUBTRACTION. * be ADDITION or SUBTRACTION.
* @param mode the mode of the combiner. * @param mode the mode of the combiner.
* @throws JmeException if mode is not ADDITION or SUBTRACTION. * @throws Exception if mode is not ADDITION or SUBTRACTION.
*/ */
public void setMode(int mode) throws Exception { public void setMode(int mode) throws Exception {
if (mode != ADDITION && mode != SUBTRACTION) { if (mode != ADDITION && mode != SUBTRACTION) {

6
jme3-terrain/src/main/java/com/jme3/terrain/heightmap/FluidSimHeightMap.java
View File

@ -81,7 +81,7 @@ public class FluidSimHeightMap extends AbstractHeightMap {
* the distance between each node of the heightmap * the distance between each node of the heightmap
* @param seed * @param seed
* the seed to generate the same heightmap again * the seed to generate the same heightmap again
* @throws JmeException * @throws Exception
* if size of the terrain is not greater that zero, or number of * if size of the terrain is not greater that zero, or number of
* iterations is not greater that zero, or the minimum initial height * iterations is not greater that zero, or the minimum initial height
* is greater than the maximum (or the other way around) * is greater than the maximum (or the other way around)
@ -116,7 +116,7 @@ public class FluidSimHeightMap extends AbstractHeightMap {
* size the size of the terrain to be generated * size the size of the terrain to be generated
* @param iterations * @param iterations
* the number of iterations to do * the number of iterations to do
* @throws JmeException * @throws Exception
* if size of the terrain is not greater that zero, or number of * if size of the terrain is not greater that zero, or number of
* iterations is not greater that zero * iterations is not greater that zero
*/ */
@ -233,7 +233,7 @@ public class FluidSimHeightMap extends AbstractHeightMap {
* *
* @param iterations * @param iterations
* the number of iterations to do * the number of iterations to do
* @throws JmeException * @throws Exception
* if iterations if not greater than zero * if iterations if not greater than zero
*/ */
public void setIterations(int iterations) throws Exception { public void setIterations(int iterations) throws Exception {

5
jme3-terrain/src/main/java/com/jme3/terrain/heightmap/HeightMap.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2009-2012 jMonkeyEngine * Copyright (c) 2009-2020 jMonkeyEngine
* All rights reserved. * All rights reserved.
* *
* Redistribution and use in source and binary forms, with or without * Redistribution and use in source and binary forms, with or without
@ -130,7 +130,6 @@ public interface HeightMap {
* @param filter * @param filter
* the erosion value. * the erosion value.
* @throws Exception * @throws Exception
* @throws JmeException
* if filter is less than 0 or greater than 1. * if filter is less than 0 or greater than 1.
*/ */
void setMagnificationFilter(float filter) throws Exception; void setMagnificationFilter(float filter) throws Exception;
@ -142,8 +141,6 @@ public interface HeightMap {
* @param size * @param size
* the new size of the terrain. * the new size of the terrain.
* @throws Exception * @throws Exception
*
* @throws JmeException
* if the size is less than or equal to zero. * if the size is less than or equal to zero.
*/ */
void setSize(int size) throws Exception; void setSize(int size) throws Exception;

7
jme3-terrain/src/main/java/com/jme3/terrain/heightmap/HillHeightMap.java
View File

@ -66,7 +66,6 @@ public class HillHeightMap extends AbstractHeightMap {
* @param seed * @param seed
* the seed to generate the same heightmap again * the seed to generate the same heightmap again
* @throws Exception * @throws Exception
* @throws JmeException
* if size of the terrain is not greater that zero, or number of * if size of the terrain is not greater that zero, or number of
* iterations is not greater that zero * iterations is not greater that zero
*/ */
@ -104,7 +103,6 @@ public class HillHeightMap extends AbstractHeightMap {
* @param maxRadius * @param maxRadius
* the maximum radius of a hill * the maximum radius of a hill
* @throws Exception * @throws Exception
* @throws JmeException
* if size of the terrain is not greater that zero, or number of * if size of the terrain is not greater that zero, or number of
* iterations is not greater that zero * iterations is not greater that zero
*/ */
@ -214,7 +212,6 @@ public class HillHeightMap extends AbstractHeightMap {
* @param iterations * @param iterations
* the number of hills to grow * the number of hills to grow
* @throws Exception * @throws Exception
* @throws JmeException
* if iterations if not greater than zero * if iterations if not greater than zero
*/ */
public void setIterations(int iterations) throws Exception { public void setIterations(int iterations) throws Exception {
@ -231,7 +228,6 @@ public class HillHeightMap extends AbstractHeightMap {
* @param maxRadius * @param maxRadius
* the maximum radius of a hill * the maximum radius of a hill
* @throws Exception * @throws Exception
* @throws JmeException
* if the maximum radius if not greater than zero or not greater * if the maximum radius if not greater than zero or not greater
* than the minimum radius * than the minimum radius
*/ */
@ -248,8 +244,7 @@ public class HillHeightMap extends AbstractHeightMap {
* *
* @param minRadius * @param minRadius
* the minimum radius of a hill * the minimum radius of a hill
* @throws Exception * @throws Exception if the minimum radius is not greater than zero or not
* @throws JmeException if the minimum radius is not greater than zero or not
* lower than the maximum radius * lower than the maximum radius
*/ */
public void setMinRadius(float minRadius) throws Exception { public void setMinRadius(float minRadius) throws Exception {

12
jme3-terrain/src/main/java/com/jme3/terrain/heightmap/ParticleDepositionHeightMap.java
View File

@ -76,7 +76,7 @@ public class ParticleDepositionHeightMap extends AbstractHeightMap {
* represented as a percentage, where 0.0 will not invert * represented as a percentage, where 0.0 will not invert
* anything, and 1.0 will invert all. * anything, and 1.0 will invert all.
* *
* @throws JmeException if any value is less than zero, and * @throws Exception if any value is less than zero, and
* if caldera is not between 0 and 1. If minParticles is greater than * if caldera is not between 0 and 1. If minParticles is greater than
* max particles as well. * max particles as well.
*/ */
@ -329,7 +329,7 @@ public class ParticleDepositionHeightMap extends AbstractHeightMap {
* <code>setJumps</code> sets the number of jumps or peaks that will * <code>setJumps</code> sets the number of jumps or peaks that will
* be created during the next call to <code>load</code>. * be created during the next call to <code>load</code>.
* @param jumps the number of jumps to use for next load. * @param jumps the number of jumps to use for next load.
* @throws JmeException if jumps is less than zero. * @throws Exception if jumps is less than zero.
*/ */
public void setJumps(int jumps) throws Exception { public void setJumps(int jumps) throws Exception {
if (jumps < 0) { if (jumps < 0) {
@ -344,7 +344,7 @@ public class ParticleDepositionHeightMap extends AbstractHeightMap {
* be aggitated. * be aggitated.
* *
* @param peakWalk the amount to aggitate the jump point. * @param peakWalk the amount to aggitate the jump point.
* @throws JmeException if peakWalk is negative or zero. * @throws Exception if peakWalk is negative or zero.
*/ */
public void setPeakWalk(int peakWalk) throws Exception { public void setPeakWalk(int peakWalk) throws Exception {
if (peakWalk <= 0) { if (peakWalk <= 0) {
@ -360,7 +360,7 @@ public class ParticleDepositionHeightMap extends AbstractHeightMap {
* *
* @param caldera the level at which a peak will be inverted. This must be * @param caldera the level at which a peak will be inverted. This must be
* between 0 and 1, as it is represented as a percentage. * between 0 and 1, as it is represented as a percentage.
* @throws JmeException if caldera is not between 0 and 1. * @throws Exception if caldera is not between 0 and 1.
*/ */
public void setCaldera(float caldera) throws Exception { public void setCaldera(float caldera) throws Exception {
if (caldera < 0.0f || caldera > 1.0f) { if (caldera < 0.0f || caldera > 1.0f) {
@ -374,7 +374,7 @@ public class ParticleDepositionHeightMap extends AbstractHeightMap {
* <code>setMaxParticles</code> sets the maximum number of particles * <code>setMaxParticles</code> sets the maximum number of particles
* for a single jump. * for a single jump.
* @param maxParticles the maximum number of particles for a single jump. * @param maxParticles the maximum number of particles for a single jump.
* @throws JmeException if maxParticles is negative or less than * @throws Exception if maxParticles is negative or less than
* the current number of minParticles. * the current number of minParticles.
*/ */
public void setMaxParticles(int maxParticles) { public void setMaxParticles(int maxParticles) {
@ -385,7 +385,7 @@ public class ParticleDepositionHeightMap extends AbstractHeightMap {
* <code>setMinParticles</code> sets the minimum number of particles * <code>setMinParticles</code> sets the minimum number of particles
* for a single jump. * for a single jump.
* @param minParticles the minimum number of particles for a single jump. * @param minParticles the minimum number of particles for a single jump.
* @throws JmeException if minParticles are greater than * @throws Exception if minParticles are greater than
* the current maxParticles; * the current maxParticles;
*/ */
public void setMinParticles(int minParticles) throws Exception { public void setMinParticles(int minParticles) throws Exception {

12
jme3-terrain/src/main/java/com/jme3/terrain/heightmap/RawHeightMap.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2009-2012 jMonkeyEngine * Copyright (c) 2009-2020 jMonkeyEngine
* All rights reserved. * All rights reserved.
* *
* Redistribution and use in source and binary forms, with or without * Redistribution and use in source and binary forms, with or without
@ -74,7 +74,7 @@ public class RawHeightMap extends AbstractHeightMap {
* the RAW file to use as the heightmap. * the RAW file to use as the heightmap.
* @param size * @param size
* the size of the RAW (must be square). * the size of the RAW (must be square).
* @throws JmeException * @throws Exception
* if the filename is null or not RAW, and if the size is 0 or * if the filename is null or not RAW, and if the size is 0 or
* less. * less.
*/ */
@ -137,10 +137,10 @@ public class RawHeightMap extends AbstractHeightMap {
/** /**
* <code>load</code> fills the height data array with the appropriate data * <code>load</code> fills the height data array with the appropriate data
* from the set RAW image. If the RAW image has not been set a JmeException * from the set RAW image.
* will be thrown.
* *
* @return true if the load is successfull, false otherwise. * @return true if the load is successfull, false otherwise.
* @throws RuntimeException if the RAW image has not been set
*/ */
@Override @Override
public boolean load() { public boolean load() {
@ -216,7 +216,7 @@ public class RawHeightMap extends AbstractHeightMap {
* *
* @param filename * @param filename
* the new file to use for the height data. * the new file to use for the height data.
* @throws JmeException * @throws Exception
* if the file is null or not RAW. * if the file is null or not RAW.
*/ */
public void setFilename(String filename) throws Exception { public void setFilename(String filename) throws Exception {
@ -236,7 +236,7 @@ public class RawHeightMap extends AbstractHeightMap {
* *
* @param stream * @param stream
* the new stream to use for the height data. * the new stream to use for the height data.
* @throws JmeException * @throws Exception
* if the stream is null or not RAW. * if the stream is null or not RAW.
*/ */
public void setHeightStream(InputStream stream) throws Exception { public void setHeightStream(InputStream stream) throws Exception {