diff --git a/src/share/classes/java/awt/image/BufferStrategy.java b/src/share/classes/java/awt/image/BufferStrategy.java index 82ad5e07d9735f6f8fd2297b59f68fc49428608a..de7877330b9ce23c3e51804f3af94b53b1084a3f 100644 --- a/src/share/classes/java/awt/image/BufferStrategy.java +++ b/src/share/classes/java/awt/image/BufferStrategy.java @@ -55,7 +55,7 @@ import java.awt.Image; * Alternatively, the contents of the back buffer can be copied, or * blitted forward in a chain instead of moving the video pointer. *

- *

+ * 
{@code
  * Double buffering:
  *
  *                    ***********         ***********
@@ -72,7 +72,7 @@ import java.awt.Image;
  *          *         * <------ *         * <----- *         *
  *          ***********         ***********        ***********
  *
- * 
+ * }
*

* Here is an example of how buffer strategies can be created and used: *


diff --git a/src/share/classes/java/awt/image/BufferedImage.java b/src/share/classes/java/awt/image/BufferedImage.java
index d510dcc1ba4ec8da210200459b9a4d1c679b3147..b4222b1e740c70d4879338d49bd0c48c23a42471 100644
--- a/src/share/classes/java/awt/image/BufferedImage.java
+++ b/src/share/classes/java/awt/image/BufferedImage.java
@@ -602,12 +602,12 @@ public class BufferedImage extends java.awt.Image
      *                  the raster has been premultiplied with alpha.
      * @param properties Hashtable of
      *                  String/Object pairs.
-     * @exception RasterFormatException if the number and
+     * @exception RasterFormatException if the number and
      * types of bands in the SampleModel of the
      * Raster do not match the number and types required by
      * the ColorModel to represent its color and alpha
      * components.
-     * @exception IllegalArgumentException if
+     * @exception IllegalArgumentException if
      *          raster is incompatible with cm
      * @see ColorModel
      * @see Raster
@@ -927,7 +927,7 @@ public class BufferedImage extends java.awt.Image
      * each color component in the returned data when
      * using this method.  With a specified coordinate (x, y) in the
      * image, the ARGB pixel can be accessed in this way:
-     * 

+ *

* *

      *    pixel   = rgbArray[offset + (y-startY)*scansize + (x-startX)]; 
@@ -1131,7 +1131,7 @@ public class BufferedImage extends java.awt.Image * @return an {@link Object} that is the property referred to by the * specified name or null if the * properties of this image are not yet known. - * @throws NullPointerException if the property name is null. + * @throws NullPointerException if the property name is null. * @see ImageObserver * @see java.awt.Image#UndefinedProperty */ @@ -1144,7 +1144,7 @@ public class BufferedImage extends java.awt.Image * @param name the property name * @return an Object that is the property referred to by * the specified name. - * @throws NullPointerException if the property name is null. + * @throws NullPointerException if the property name is null. */ public Object getProperty(String name) { if (name == null) { @@ -1196,7 +1196,7 @@ public class BufferedImage extends java.awt.Image * @param h the height of the specified rectangular region * @return a BufferedImage that is the subimage of this * BufferedImage. - * @exception RasterFormatException if the specified + * @exception RasterFormatException if the specified * area is not contained within this BufferedImage. */ public BufferedImage getSubimage (int x, int y, int w, int h) { @@ -1388,7 +1388,7 @@ public class BufferedImage extends java.awt.Image * @param tileY the y index of the requested tile in the tile array * @return a Raster that is the tile defined by the * arguments tileX and tileY. - * @exception ArrayIndexOutOfBoundsException if both + * @exception ArrayIndexOutOfBoundsException if both * tileX and tileY are not * equal to 0 */ @@ -1558,7 +1558,7 @@ public class BufferedImage extends java.awt.Image * @return true if the tile specified by the specified * indices is checked out for writing; false * otherwise. - * @exception ArrayIndexOutOfBoundsException if both + * @exception ArrayIndexOutOfBoundsException if both * tileX and tileY are not equal * to 0 */ diff --git a/src/share/classes/java/awt/image/ByteLookupTable.java b/src/share/classes/java/awt/image/ByteLookupTable.java index 6f7e67d74329eff95ea61fe83b24a3c3a1308157..35968d62ac8b8eb51517070995f3ca9a210dc455 100644 --- a/src/share/classes/java/awt/image/ByteLookupTable.java +++ b/src/share/classes/java/awt/image/ByteLookupTable.java @@ -171,7 +171,7 @@ public class ByteLookupTable extends LookupTable { * @exception ArrayIndexOutOfBoundsException if src is * longer than dst or if for any element * i of src, - * (src[i]&0xff)-offset is either less than + * {@code (src[i]&0xff)-offset} is either less than * zero or greater than or equal to the length of the * lookup table for any band. */ diff --git a/src/share/classes/java/awt/image/ColorModel.java b/src/share/classes/java/awt/image/ColorModel.java index 5ce313e1bf3185a7f59c9b298b635618d0713fcc..73f5b49fc28dca5030929764c558e09711d63ef6 100644 --- a/src/share/classes/java/awt/image/ColorModel.java +++ b/src/share/classes/java/awt/image/ColorModel.java @@ -692,12 +692,12 @@ public abstract class ColorModel implements Transparency{ * DataBuffer.TYPE_INT. * @param inData an array of pixel values * @return the value of the green component of the specified pixel. - * @throws ClassCastException if inData + * @throws ClassCastException if inData * is not a primitive array of type transferType - * @throws ArrayIndexOutOfBoundsException if + * @throws ArrayIndexOutOfBoundsException if * inData is not large enough to hold a pixel value * for this ColorModel - * @throws UnsupportedOperationException if this + * @throws UnsupportedOperationException if this * tranferType is not supported by this * ColorModel */ diff --git a/src/share/classes/java/awt/image/DirectColorModel.java b/src/share/classes/java/awt/image/DirectColorModel.java index 751d780ba6451f45063d05516c365563be90671f..2ddd85c1ad1cec5bbe9b459ac59de120f1a75546 100644 --- a/src/share/classes/java/awt/image/DirectColorModel.java +++ b/src/share/classes/java/awt/image/DirectColorModel.java @@ -642,12 +642,12 @@ public class DirectColorModel extends PackedColorModel { * @param inData the specified pixel * @return the alpha component of the specified pixel, scaled from * 0 to 255. - * @exception ClassCastException if inData + * @exception ClassCastException if inData * is not a primitive array of type transferType - * @exception ArrayIndexOutOfBoundsException if + * @exception ArrayIndexOutOfBoundsException if * inData is not large enough to hold a pixel value * for this ColorModel - * @exception UnsupportedOperationException if this + * @exception UnsupportedOperationException if this * tranferType is not supported by this * ColorModel */ @@ -1055,7 +1055,7 @@ public class DirectColorModel extends PackedColorModel { * begin retrieving the color and alpha components * @return an int pixel value in this * ColorModel corresponding to the specified components. - * @exception ArrayIndexOutOfBoundsException if + * @exception ArrayIndexOutOfBoundsException if * the components array is not large enough to * hold all of the color and alpha components starting at * offset @@ -1097,9 +1097,9 @@ public class DirectColorModel extends PackedColorModel { * and alpha components * @return an Object representing an array of color and * alpha components. - * @exception ClassCastException if obj + * @exception ClassCastException if obj * is not a primitive array of type transferType - * @exception ArrayIndexOutOfBoundsException if + * @exception ArrayIndexOutOfBoundsException if * obj is not large enough to hold a pixel value * for this ColorModel or the components * array is not large enough to hold all of the color and alpha diff --git a/src/share/classes/java/awt/image/ImageProducer.java b/src/share/classes/java/awt/image/ImageProducer.java index 768aad50dd96d2ecb08e92f74442c84bb81328a6..a419f8bd644449bee88e070de816805ab387fb4b 100644 --- a/src/share/classes/java/awt/image/ImageProducer.java +++ b/src/share/classes/java/awt/image/ImageProducer.java @@ -100,11 +100,11 @@ public interface ImageProducer { * ImageProducer should respond by executing * the following minimum set of ImageConsumer * method calls: - *
+     * 
{@code
      *  ic.setHints(TOPDOWNLEFTRIGHT | < otherhints >);
      *  ic.setPixels(...);      // As many times as needed
      *  ic.imageComplete();
-     * 
+ * }
* @param ic the specified ImageConsumer * @see ImageConsumer#setHints */ diff --git a/src/share/classes/java/awt/image/IndexColorModel.java b/src/share/classes/java/awt/image/IndexColorModel.java index fabe8d20432cfe19face31984e8eb6c053354030..d26e3d381becc2c6e4ae46e2a43de0d9884eaf5a 100644 --- a/src/share/classes/java/awt/image/IndexColorModel.java +++ b/src/share/classes/java/awt/image/IndexColorModel.java @@ -98,6 +98,7 @@ import java.math.BigInteger; * Index values greater than or equal to the map size, but less than * 2n, are undefined and return 0 for all color and * alpha components. + * *

* For those methods that use a primitive array pixel representation of * type transferType, the array length is always one. diff --git a/src/share/classes/java/awt/image/MemoryImageSource.java b/src/share/classes/java/awt/image/MemoryImageSource.java index b5fd99b475f8b97df1b25dcad845a5c1d208ab6a..90519ce26e403aebe29363729eeeb0fb6b98e1bb 100644 --- a/src/share/classes/java/awt/image/MemoryImageSource.java +++ b/src/share/classes/java/awt/image/MemoryImageSource.java @@ -37,7 +37,7 @@ import java.util.Enumeration; * uses an array to produce pixel values for an Image. Here is an example * which calculates a 100x100 image representing a fade from black to blue * along the X axis and a fade from black to red along the Y axis: - *

+ * 
{@code
  *
  *      int w = 100;
  *      int h = 100;
@@ -52,12 +52,12 @@ import java.util.Enumeration;
  *      }
  *      Image img = createImage(new MemoryImageSource(w, h, pix, 0, w));
  *
- * 
+ * }
* The MemoryImageSource is also capable of managing a memory image which * varies over time to allow animation or custom rendering. Here is an * example showing how to set up the animation source and signal changes * in the data (adapted from the MemoryAnimationSourceDemo by Garth Dickie): - *
+ * 
{@code
  *
  *      int pixels[];
  *      MemoryImageSource source;
@@ -96,7 +96,7 @@ import java.util.Enumeration;
  *          }
  *      }
  *
- * 
+ * }
* * @see ImageProducer * diff --git a/src/share/classes/java/awt/image/MultiPixelPackedSampleModel.java b/src/share/classes/java/awt/image/MultiPixelPackedSampleModel.java index 43d3a8080ba35b37ae56f5194f0f47c0d959a752..8095dad2fc5a74851c80ae133924a757c0936578 100644 --- a/src/share/classes/java/awt/image/MultiPixelPackedSampleModel.java +++ b/src/share/classes/java/awt/image/MultiPixelPackedSampleModel.java @@ -52,14 +52,14 @@ package java.awt.image; * x, y from DataBuffer data * and storing the pixel data in data elements of type * dataType: - *
+ * 
{@code
  *      int dataElementSize = DataBuffer.getDataTypeSize(dataType);
  *      int bitnum = dataBitOffset + x*pixelBitStride;
  *      int element = data.getElem(y*scanlineStride + bitnum/dataElementSize);
  *      int shift = dataElementSize - (bitnum & (dataElementSize-1))
  *                  - pixelBitStride;
  *      int pixel = (element >> shift) & ((1 << pixelBitStride) - 1);
- * 
+ * }
*/ public class MultiPixelPackedSampleModel extends SampleModel diff --git a/src/share/classes/java/awt/image/PixelGrabber.java b/src/share/classes/java/awt/image/PixelGrabber.java index 85dde7875ce48da681a430ec7c2f4831d65cefbc..2053ed71bdceba2a6a55c6d245fe6769e20dbb26 100644 --- a/src/share/classes/java/awt/image/PixelGrabber.java +++ b/src/share/classes/java/awt/image/PixelGrabber.java @@ -35,7 +35,7 @@ import java.awt.Image; * The PixelGrabber class implements an ImageConsumer which can be attached * to an Image or ImageProducer object to retrieve a subset of the pixels * in that image. Here is an example: - *
+ * 
{@code
  *
  * public void handlesinglepixel(int x, int y, int pixel) {
  *      int alpha = (pixel >> 24) & 0xff;
@@ -65,7 +65,7 @@ import java.awt.Image;
  *      }
  * }
  *
- * 
+ * }
* * @see ColorModel#getRGBdefault * @@ -165,8 +165,8 @@ public class PixelGrabber implements ImageConsumer { * accumulated in the default RGB ColorModel. If the forceRGB * parameter is true, then the pixels will be accumulated in the * default RGB ColorModel anyway. A buffer is allocated by the - * PixelGrabber to hold the pixels in either case. If (w < 0) or - * (h < 0), then they will default to the remaining width and + * PixelGrabber to hold the pixels in either case. If {@code (w < 0)} or + * {@code (h < 0)}, then they will default to the remaining width and * height of the source data when that information is delivered. * @param img the image to retrieve the image data from * @param x the x coordinate of the upper left corner of the rectangle @@ -233,10 +233,10 @@ public class PixelGrabber implements ImageConsumer { * behaves in the following ways, depending on the value of * ms: * * @param ms the number of milliseconds to wait for the image pixels diff --git a/src/share/classes/java/awt/image/RGBImageFilter.java b/src/share/classes/java/awt/image/RGBImageFilter.java index 59d77e3428d1af40246363aacfe10c8b0002903c..2f807ddf50f4007d4fe8bdc90612c53fb506a9de 100644 --- a/src/share/classes/java/awt/image/RGBImageFilter.java +++ b/src/share/classes/java/awt/image/RGBImageFilter.java @@ -39,7 +39,7 @@ import java.awt.image.ColorModel; * The only method which needs to be defined to create a useable image * filter is the filterRGB method. Here is an example of a definition * of a filter which swaps the red and blue components of an image: - *
+ * 
{@code
  *
  *      class RedBlueSwapFilter extends RGBImageFilter {
  *          public RedBlueSwapFilter() {
@@ -56,7 +56,7 @@ import java.awt.image.ColorModel;
  *          }
  *      }
  *
- * 
+ * }
* * @see FilteredImageSource * @see ImageFilter diff --git a/src/share/classes/java/awt/image/ShortLookupTable.java b/src/share/classes/java/awt/image/ShortLookupTable.java index 09309e0045e73830edcd83016cfae4d8b32f96ac..f0c18e0878e78ed7313cc1909cfa5bd32ea0c9fb 100644 --- a/src/share/classes/java/awt/image/ShortLookupTable.java +++ b/src/share/classes/java/awt/image/ShortLookupTable.java @@ -114,7 +114,7 @@ public class ShortLookupTable extends LookupTable { * @exception ArrayIndexOutOfBoundsException if src is * longer than dst or if for any element * i of src, - * (src[i]&0xffff)-offset is either less than + * {@code (src[i]&0xffff)-offset} is either less than * zero or greater than or equal to the length of the * lookup table for any band. */ @@ -165,7 +165,7 @@ public class ShortLookupTable extends LookupTable { * @exception ArrayIndexOutOfBoundsException if src is * longer than dst or if for any element * i of src, - * (src[i]&0xffff)-offset is either less than + * {@code (src[i]&0xffff)-offset} is either less than * zero or greater than or equal to the length of the * lookup table for any band. */ diff --git a/src/share/classes/java/awt/image/SinglePixelPackedSampleModel.java b/src/share/classes/java/awt/image/SinglePixelPackedSampleModel.java index b99eda6c79e2a92f6024c41f94c523a411a4c1aa..58c1db0b726ec77fdab2631059dc6c8ab1929c3c 100644 --- a/src/share/classes/java/awt/image/SinglePixelPackedSampleModel.java +++ b/src/share/classes/java/awt/image/SinglePixelPackedSampleModel.java @@ -57,10 +57,10 @@ import java.util.Arrays; * The following code illustrates extracting the bits of the sample * representing band b for pixel x,y * from DataBuffer data: - *
+ * 
{@code
  *      int sample = data.getElem(y * scanlineStride + x);
  *      sample = (sample & bitMasks[b]) >>> bitOffsets[b];
- * 
+ * }
*/ public class SinglePixelPackedSampleModel extends SampleModel diff --git a/src/share/classes/java/awt/image/WritableRaster.java b/src/share/classes/java/awt/image/WritableRaster.java index d38d7af3f60dbdd3c135a4362336ab75ab37d14d..190596af0a29dc4b56e5baba8d71d68fb252c350 100644 --- a/src/share/classes/java/awt/image/WritableRaster.java +++ b/src/share/classes/java/awt/image/WritableRaster.java @@ -372,13 +372,13 @@ public class WritableRaster extends Raster { * integral type and less than or equal to 32 bits in size, then calling * this method is equivalent to executing the following code for all * x,y addresses valid in both Rasters. - *
+     * 
{@code
      *       Raster srcRaster;
      *       WritableRaster dstRaster;
      *       for (int b = 0; b < srcRaster.getNumBands(); b++) {
      *           dstRaster.setSample(x, y, b, srcRaster.getSample(x, y, b));
      *       }
-     * 
+ * }
* Thus, when copying an integral type source to an integral type * destination, if the source sample size is greater than the destination * sample size for a particular band, the high order bits of the source