< prev index next >

src/java.desktop/share/classes/java/awt/image/Raster.java

Print this page

        

@@ -180,27 +180,27 @@
      * <p> The upper left corner of the Raster is given by the
      * location argument.  If location is null, (0, 0) will be used.
      * The dataType parameter should be one of the enumerated values
      * defined in the DataBuffer class.
      *
-     * <p> Note that interleaved <code>DataBuffer.TYPE_INT</code>
+     * <p> Note that interleaved {@code DataBuffer.TYPE_INT}
      * Rasters are not supported.  To create a 1-band Raster of type
-     * <code>DataBuffer.TYPE_INT</code>, use
+     * {@code DataBuffer.TYPE_INT}, use
      * Raster.createPackedRaster().
      * <p> The only dataTypes supported currently are TYPE_BYTE
      * and TYPE_USHORT.
      * @param dataType  the data type for storing samples
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param bands     the number of bands
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified data type,
      *         width, height and number of bands.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
      */
     public static WritableRaster createInterleavedRaster(int dataType,
                                                          int w, int h,
                                                          int bands,

@@ -222,35 +222,35 @@
      * <p> The upper left corner of the Raster is given by the
      * location argument.  If location is null, (0, 0) will be used.
      * The dataType parameter should be one of the enumerated values
      * defined in the DataBuffer class.
      *
-     * <p> Note that interleaved <code>DataBuffer.TYPE_INT</code>
+     * <p> Note that interleaved {@code DataBuffer.TYPE_INT}
      * Rasters are not supported.  To create a 1-band Raster of type
-     * <code>DataBuffer.TYPE_INT</code>, use
+     * {@code DataBuffer.TYPE_INT}, use
      * Raster.createPackedRaster().
      * <p> The only dataTypes supported currently are TYPE_BYTE
      * and TYPE_USHORT.
      * @param dataType  the data type for storing samples
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param scanlineStride the line stride of the image data
      * @param pixelStride the pixel stride of the image data
      * @param bandOffsets the offsets of all bands
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified data type,
      *         width, height, scanline stride, pixel stride and band
      *         offsets.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
-     * @throws IllegalArgumentException if <code>dataType</code> is not
+     * @throws IllegalArgumentException if {@code dataType} is not
      *         one of the supported data types, which are
-     *         <code>DataBuffer.TYPE_BYTE</code>, or
-     *         <code>DataBuffer.TYPE_USHORT</code>.
+     *         {@code DataBuffer.TYPE_BYTE}, or
+     *         {@code DataBuffer.TYPE_USHORT}.
      */
     public static WritableRaster createInterleavedRaster(int dataType,
                                                          int w, int h,
                                                          int scanlineStride,
                                                          int pixelStride,

@@ -292,19 +292,19 @@
      * and TYPE_INT.
      * @param dataType  the data type for storing samples
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param bands     the number of bands
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified data type,
      *         width, height and number of bands.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
-     * @throws ArrayIndexOutOfBoundsException if <code>bands</code>
+     * @throws ArrayIndexOutOfBoundsException if {@code bands}
      *         is less than 1
      */
     public static WritableRaster createBandedRaster(int dataType,
                                                     int w, int h,
                                                     int bands,

@@ -343,26 +343,26 @@
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param scanlineStride the line stride of the image data
      * @param bankIndices the bank indices for each band
      * @param bandOffsets the offsets of all bands
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified data type,
      *         width, height, scanline stride, bank indices and band
      *         offsets.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
-     * @throws IllegalArgumentException if <code>dataType</code> is not
+     * @throws IllegalArgumentException if {@code dataType} is not
      *         one of the supported data types, which are
-     *         <code>DataBuffer.TYPE_BYTE</code>,
-     *         <code>DataBuffer.TYPE_USHORT</code>
-     *         or <code>DataBuffer.TYPE_INT</code>
-     * @throws ArrayIndexOutOfBoundsException if <code>bankIndices</code>
-     *         or <code>bandOffsets</code> is <code>null</code>
+     *         {@code DataBuffer.TYPE_BYTE},
+     *         {@code DataBuffer.TYPE_USHORT}
+     *         or {@code DataBuffer.TYPE_INT}
+     * @throws ArrayIndexOutOfBoundsException if {@code bankIndices}
+     *         or {@code bandOffsets} is {@code null}
      */
     public static WritableRaster createBandedRaster(int dataType,
                                                     int w, int h,
                                                     int scanlineStride,
                                                     int bankIndices[],

@@ -432,23 +432,23 @@
      * and TYPE_INT.
      * @param dataType  the data type for storing samples
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param bandMasks an array containing an entry for each band
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified data type,
      *         width, height, and band masks.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
-     * @throws IllegalArgumentException if <code>dataType</code> is not
+     * @throws IllegalArgumentException if {@code dataType} is not
      *         one of the supported data types, which are
-     *         <code>DataBuffer.TYPE_BYTE</code>,
-     *         <code>DataBuffer.TYPE_USHORT</code>
-     *         or <code>DataBuffer.TYPE_INT</code>
+     *         {@code DataBuffer.TYPE_BYTE},
+     *         {@code DataBuffer.TYPE_USHORT}
+     *         or {@code DataBuffer.TYPE_INT}
      */
     public static WritableRaster createPackedRaster(int dataType,
                                                     int w, int h,
                                                     int bandMasks[],
                                                     Point location) {

@@ -497,29 +497,29 @@
      * @param dataType  the data type for storing samples
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param bands     the number of bands
      * @param bitsPerBand the number of bits per band
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified data type,
      *         width, height, number of bands, and bits per band.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
      * @throws IllegalArgumentException if the product of
-     *         <code>bitsPerBand</code> and <code>bands</code> is
+     *         {@code bitsPerBand} and {@code bands} is
      *         greater than the number of bits held by
-     *         <code>dataType</code>
-     * @throws IllegalArgumentException if <code>bitsPerBand</code> or
-     *         <code>bands</code> is not greater than zero
-     * @throws IllegalArgumentException if <code>dataType</code> is not
+     *         {@code dataType}
+     * @throws IllegalArgumentException if {@code bitsPerBand} or
+     *         {@code bands} is not greater than zero
+     * @throws IllegalArgumentException if {@code dataType} is not
      *         one of the supported data types, which are
-     *         <code>DataBuffer.TYPE_BYTE</code>,
-     *         <code>DataBuffer.TYPE_USHORT</code>
-     *         or <code>DataBuffer.TYPE_INT</code>
+     *         {@code DataBuffer.TYPE_BYTE},
+     *         {@code DataBuffer.TYPE_USHORT}
+     *         or {@code DataBuffer.TYPE_INT}
      */
     public static WritableRaster createPackedRaster(int dataType,
                                                     int w, int h,
                                                     int bands,
                                                     int bitsPerBand,

@@ -594,37 +594,37 @@
      * specified DataBuffer, width, height, scanline stride, pixel
      * stride, and band offsets.  The number of bands is inferred from
      * bandOffsets.length.  The upper left corner of the Raster
      * is given by the location argument.  If location is null, (0, 0)
      * will be used.
-     * <p> Note that interleaved <code>DataBuffer.TYPE_INT</code>
+     * <p> Note that interleaved {@code DataBuffer.TYPE_INT}
      * Rasters are not supported.  To create a 1-band Raster of type
-     * <code>DataBuffer.TYPE_INT</code>, use
+     * {@code DataBuffer.TYPE_INT}, use
      * Raster.createPackedRaster().
-     * @param dataBuffer the <code>DataBuffer</code> that contains the
+     * @param dataBuffer the {@code DataBuffer} that contains the
      *        image data
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param scanlineStride the line stride of the image data
      * @param pixelStride the pixel stride of the image data
      * @param bandOffsets the offsets of all bands
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified
-     *         <code>DataBuffer</code>, width, height, scanline stride,
+     *         {@code DataBuffer}, width, height, scanline stride,
      *         pixel stride and band offsets.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
-     * @throws IllegalArgumentException if <code>dataType</code> is not
+     * @throws IllegalArgumentException if {@code dataType} is not
      *         one of the supported data types, which are
-     *         <code>DataBuffer.TYPE_BYTE</code>,
-     *         <code>DataBuffer.TYPE_USHORT</code>
-     * @throws RasterFormatException if <code>dataBuffer</code> has more
+     *         {@code DataBuffer.TYPE_BYTE},
+     *         {@code DataBuffer.TYPE_USHORT}
+     * @throws RasterFormatException if {@code dataBuffer} has more
      *         than one bank.
-     * @throws NullPointerException if <code>dataBuffer</code> is null
+     * @throws NullPointerException if {@code dataBuffer} is null
      */
     public static WritableRaster createInterleavedRaster(DataBuffer dataBuffer,
                                                          int w, int h,
                                                          int scanlineStride,
                                                          int pixelStride,

@@ -661,32 +661,32 @@
      * specified DataBuffer, width, height, scanline stride, bank
      * indices, and band offsets.  The number of bands is inferred
      * from bankIndices.length and bandOffsets.length, which must be
      * the same.  The upper left corner of the Raster is given by the
      * location argument.  If location is null, (0, 0) will be used.
-     * @param dataBuffer the <code>DataBuffer</code> that contains the
+     * @param dataBuffer the {@code DataBuffer} that contains the
      *        image data
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param scanlineStride the line stride of the image data
      * @param bankIndices the bank indices for each band
      * @param bandOffsets the offsets of all bands
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified
-     *         <code>DataBuffer</code>, width, height, scanline stride,
+     *         {@code DataBuffer}, width, height, scanline stride,
      *         bank indices and band offsets.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
-     * @throws IllegalArgumentException if <code>dataType</code> is not
+     * @throws IllegalArgumentException if {@code dataType} is not
      *         one of the supported data types, which are
-     *         <code>DataBuffer.TYPE_BYTE</code>,
-     *         <code>DataBuffer.TYPE_USHORT</code>
-     *         or <code>DataBuffer.TYPE_INT</code>
-     * @throws NullPointerException if <code>dataBuffer</code> is null
+     *         {@code DataBuffer.TYPE_BYTE},
+     *         {@code DataBuffer.TYPE_USHORT}
+     *         or {@code DataBuffer.TYPE_INT}
+     * @throws NullPointerException if {@code dataBuffer} is null
      */
     public static WritableRaster createBandedRaster(DataBuffer dataBuffer,
                                                     int w, int h,
                                                     int scanlineStride,
                                                     int bankIndices[],

@@ -731,33 +731,33 @@
      * Creates a Raster based on a SinglePixelPackedSampleModel with
      * the specified DataBuffer, width, height, scanline stride, and
      * band masks.  The number of bands is inferred from bandMasks.length.
      * The upper left corner of the Raster is given by
      * the location argument.  If location is null, (0, 0) will be used.
-     * @param dataBuffer the <code>DataBuffer</code> that contains the
+     * @param dataBuffer the {@code DataBuffer} that contains the
      *        image data
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param scanlineStride the line stride of the image data
      * @param bandMasks an array containing an entry for each band
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified
-     *         <code>DataBuffer</code>, width, height, scanline stride,
+     *         {@code DataBuffer}, width, height, scanline stride,
      *         and band masks.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
-     * @throws IllegalArgumentException if <code>dataType</code> is not
+     * @throws IllegalArgumentException if {@code dataType} is not
      *         one of the supported data types, which are
-     *         <code>DataBuffer.TYPE_BYTE</code>,
-     *         <code>DataBuffer.TYPE_USHORT</code>
-     *         or <code>DataBuffer.TYPE_INT</code>
-     * @throws RasterFormatException if <code>dataBuffer</code> has more
+     *         {@code DataBuffer.TYPE_BYTE},
+     *         {@code DataBuffer.TYPE_USHORT}
+     *         or {@code DataBuffer.TYPE_INT}
+     * @throws RasterFormatException if {@code dataBuffer} has more
      *         than one bank.
-     * @throws NullPointerException if <code>dataBuffer</code> is null
+     * @throws NullPointerException if {@code dataBuffer} is null
      */
     public static WritableRaster createPackedRaster(DataBuffer dataBuffer,
                                                     int w, int h,
                                                     int scanlineStride,
                                                     int bandMasks[],

@@ -793,32 +793,32 @@
     /**
      * Creates a Raster based on a MultiPixelPackedSampleModel with the
      * specified DataBuffer, width, height, and bits per pixel.  The upper
      * left corner of the Raster is given by the location argument.  If
      * location is null, (0, 0) will be used.
-     * @param dataBuffer the <code>DataBuffer</code> that contains the
+     * @param dataBuffer the {@code DataBuffer} that contains the
      *        image data
      * @param w         the width in pixels of the image data
      * @param h         the height in pixels of the image data
      * @param bitsPerPixel the number of bits for each pixel
-     * @param location  the upper-left corner of the <code>Raster</code>
+     * @param location  the upper-left corner of the {@code Raster}
      * @return a WritableRaster object with the specified
-     *         <code>DataBuffer</code>, width, height, and
+     *         {@code DataBuffer}, width, height, and
      *         bits per pixel.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>location.x + w</code> or
-     *         <code>location.y + h</code> results in integer
+     *         {@code location.x + w} or
+     *         {@code location.y + h} results in integer
      *         overflow
-     * @throws IllegalArgumentException if <code>dataType</code> is not
+     * @throws IllegalArgumentException if {@code dataType} is not
      *         one of the supported data types, which are
-     *         <code>DataBuffer.TYPE_BYTE</code>,
-     *         <code>DataBuffer.TYPE_USHORT</code>
-     *         or <code>DataBuffer.TYPE_INT</code>
-     * @throws RasterFormatException if <code>dataBuffer</code> has more
+     *         {@code DataBuffer.TYPE_BYTE},
+     *         {@code DataBuffer.TYPE_USHORT}
+     *         or {@code DataBuffer.TYPE_INT}
+     * @throws RasterFormatException if {@code dataBuffer} has more
      *         than one bank.
-     * @throws NullPointerException if <code>dataBuffer</code> is null
+     * @throws NullPointerException if {@code dataBuffer} is null
      */
     public static WritableRaster createPackedRaster(DataBuffer dataBuffer,
                                                     int w, int h,
                                                     int bitsPerPixel,
                                                     Point location) {

@@ -857,22 +857,22 @@
 
     /**
      *  Creates a Raster with the specified SampleModel and DataBuffer.
      *  The upper left corner of the Raster is given by the location argument.
      *  If location is null, (0, 0) will be used.
-     *  @param sm the specified <code>SampleModel</code>
-     *  @param db the specified <code>DataBuffer</code>
-     *  @param location the upper-left corner of the <code>Raster</code>
-     *  @return a <code>Raster</code> with the specified
-     *          <code>SampleModel</code>, <code>DataBuffer</code>, and
+     *  @param sm the specified {@code SampleModel}
+     *  @param db the specified {@code DataBuffer}
+     *  @param location the upper-left corner of the {@code Raster}
+     *  @return a {@code Raster} with the specified
+     *          {@code SampleModel}, {@code DataBuffer}, and
      *          location.
      * @throws RasterFormatException if computing either
-     *         <code>location.x + sm.getWidth()</code> or
-     *         <code>location.y + sm.getHeight()</code> results in integer
+     *         {@code location.x + sm.getWidth()} or
+     *         {@code location.y + sm.getHeight()} results in integer
      *         overflow
-     * @throws RasterFormatException if <code>db</code> has more
-     *         than one bank and <code>sm</code> is a
+     * @throws RasterFormatException if {@code db} has more
+     *         than one bank and {@code sm} is a
      *         PixelInterleavedSampleModel, SinglePixelPackedSampleModel,
      *         or MultiPixelPackedSampleModel.
      *  @throws NullPointerException if either SampleModel or DataBuffer is
      *          null
      */

@@ -920,18 +920,18 @@
 
     /**
      *  Creates a WritableRaster with the specified SampleModel.
      *  The upper left corner of the Raster is given by the location argument.
      *  If location is null, (0, 0) will be used.
-     *  @param sm the specified <code>SampleModel</code>
+     *  @param sm the specified {@code SampleModel}
      *  @param location the upper-left corner of the
-     *         <code>WritableRaster</code>
-     *  @return a <code>WritableRaster</code> with the specified
-     *          <code>SampleModel</code> and location.
+     *         {@code WritableRaster}
+     *  @return a {@code WritableRaster} with the specified
+     *          {@code SampleModel} and location.
      *  @throws RasterFormatException if computing either
-     *          <code>location.x + sm.getWidth()</code> or
-     *          <code>location.y + sm.getHeight()</code> results in integer
+     *          {@code location.x + sm.getWidth()} or
+     *          {@code location.y + sm.getHeight()} results in integer
      *          overflow
      */
     public static WritableRaster createWritableRaster(SampleModel sm,
                                                       Point location) {
         if (location == null) {

@@ -943,23 +943,23 @@
 
     /**
      *  Creates a WritableRaster with the specified SampleModel and DataBuffer.
      *  The upper left corner of the Raster is given by the location argument.
      *  If location is null, (0, 0) will be used.
-     *  @param sm the specified <code>SampleModel</code>
-     *  @param db the specified <code>DataBuffer</code>
+     *  @param sm the specified {@code SampleModel}
+     *  @param db the specified {@code DataBuffer}
      *  @param location the upper-left corner of the
-     *         <code>WritableRaster</code>
-     *  @return a <code>WritableRaster</code> with the specified
-     *          <code>SampleModel</code>, <code>DataBuffer</code>, and
+     *         {@code WritableRaster}
+     *  @return a {@code WritableRaster} with the specified
+     *          {@code SampleModel}, {@code DataBuffer}, and
      *          location.
      * @throws RasterFormatException if computing either
-     *         <code>location.x + sm.getWidth()</code> or
-     *         <code>location.y + sm.getHeight()</code> results in integer
+     *         {@code location.x + sm.getWidth()} or
+     *         {@code location.y + sm.getHeight()} results in integer
      *         overflow
-     * @throws RasterFormatException if <code>db</code> has more
-     *         than one bank and <code>sm</code> is a
+     * @throws RasterFormatException if {@code db} has more
+     *         than one bank and {@code sm} is a
      *         PixelInterleavedSampleModel, SinglePixelPackedSampleModel,
      *         or MultiPixelPackedSampleModel.
      * @throws NullPointerException if either SampleModel or DataBuffer is null
      */
     public static WritableRaster createWritableRaster(SampleModel sm,

@@ -1010,15 +1010,15 @@
      *  SampleModel.  A DataBuffer large enough to describe the
      *  Raster is automatically created.
      *  @param sampleModel     The SampleModel that specifies the layout
      *  @param origin          The Point that specified the origin
      *  @throws RasterFormatException if computing either
-     *          <code>origin.x + sampleModel.getWidth()</code> or
-     *          <code>origin.y + sampleModel.getHeight()</code> results in
+     *          {@code origin.x + sampleModel.getWidth()} or
+     *          {@code origin.y + sampleModel.getHeight()} results in
      *          integer overflow
-     *  @throws NullPointerException either <code>sampleModel</code> or
-     *          <code>origin</code> is null
+     *  @throws NullPointerException either {@code sampleModel} or
+     *          {@code origin} is null
      */
     protected Raster(SampleModel sampleModel,
                      Point origin) {
         this(sampleModel,
              sampleModel.createDataBuffer(),

@@ -1037,15 +1037,15 @@
      *  be compatible with SampleModel.
      *  @param sampleModel     The SampleModel that specifies the layout
      *  @param dataBuffer      The DataBuffer that contains the image data
      *  @param origin          The Point that specifies the origin
      *  @throws RasterFormatException if computing either
-     *          <code>origin.x + sampleModel.getWidth()</code> or
-     *          <code>origin.y + sampleModel.getHeight()</code> results in
+     *          {@code origin.x + sampleModel.getWidth()} or
+     *          {@code origin.y + sampleModel.getHeight()} results in
      *          integer overflow
-     *  @throws NullPointerException either <code>sampleModel</code> or
-     *          <code>origin</code> is null
+     *  @throws NullPointerException either {@code sampleModel} or
+     *          {@code origin} is null
      */
     protected Raster(SampleModel sampleModel,
                      DataBuffer dataBuffer,
                      Point origin) {
         this(sampleModel,

@@ -1073,17 +1073,17 @@
      * @param dataBuffer      The DataBuffer that contains the image data
      * @param aRegion         The Rectangle that specifies the image area
      * @param sampleModelTranslate  The Point that specifies the translation
      *                        from SampleModel to Raster coordinates
      * @param parent          The parent (if any) of this raster
-     * @throws NullPointerException if any of <code>sampleModel</code>,
-     *         <code>dataBuffer</code>, <code>aRegion</code> or
-     *         <code>sampleModelTranslate</code> is null
-     * @throws RasterFormatException if <code>aRegion</code> has width
+     * @throws NullPointerException if any of {@code sampleModel},
+     *         {@code dataBuffer}, {@code aRegion} or
+     *         {@code sampleModelTranslate} is null
+     * @throws RasterFormatException if {@code aRegion} has width
      *         or height less than or equal to zero, or computing either
-     *         <code>aRegion.x + aRegion.width</code> or
-     *         <code>aRegion.y + aRegion.height</code> results in integer
+     *         {@code aRegion.x + aRegion.width} or
+     *         {@code aRegion.y + aRegion.height} results in integer
      *         overflow
      */
     protected Raster(SampleModel sampleModel,
                      DataBuffer dataBuffer,
                      Rectangle aRegion,

@@ -1123,11 +1123,11 @@
     }
 
 
     /**
      * Returns the parent Raster (if any) of this Raster or null.
-     * @return the parent Raster or <code>null</code>.
+     * @return the parent Raster or {@code null}.
      */
     public Raster getParent() {
         return parent;
     }
 

@@ -1156,23 +1156,23 @@
     }
 
     /**
      * Create a compatible WritableRaster the same size as this Raster with
      * the same SampleModel and a new initialized DataBuffer.
-     * @return a compatible <code>WritableRaster</code> with the same sample
+     * @return a compatible {@code WritableRaster} with the same sample
      *         model and a new data buffer.
      */
     public WritableRaster createCompatibleWritableRaster() {
         return new SunWritableRaster(sampleModel, new Point(0,0));
     }
 
     /**
      * Create a compatible WritableRaster with the specified size, a new
      * SampleModel, and a new initialized DataBuffer.
-     * @param w the specified width of the new <code>WritableRaster</code>
-     * @param h the specified height of the new <code>WritableRaster</code>
-     * @return a compatible <code>WritableRaster</code> with the specified
+     * @param w the specified width of the new {@code WritableRaster}
+     * @param h the specified height of the new {@code WritableRaster}
+     * @return a compatible {@code WritableRaster} with the specified
      *         size and a new sample model and data buffer.
      * @exception RasterFormatException if the width or height is less than
      *                               or equal to zero.
      */
     public WritableRaster createCompatibleWritableRaster(int w, int h) {

@@ -1188,20 +1188,20 @@
 
     /**
      * Create a compatible WritableRaster with location (minX, minY)
      * and size (width, height) specified by rect, a
      * new SampleModel, and a new initialized DataBuffer.
-     * @param rect a <code>Rectangle</code> that specifies the size and
-     *        location of the <code>WritableRaster</code>
-     * @return a compatible <code>WritableRaster</code> with the specified
+     * @param rect a {@code Rectangle} that specifies the size and
+     *        location of the {@code WritableRaster}
+     * @return a compatible {@code WritableRaster} with the specified
      *         size and location and a new sample model and data buffer.
-     * @throws RasterFormatException if <code>rect</code> has width
+     * @throws RasterFormatException if {@code rect} has width
      *         or height less than or equal to zero, or computing either
-     *         <code>rect.x + rect.width</code> or
-     *         <code>rect.y + rect.height</code> results in integer
+     *         {@code rect.x + rect.width} or
+     *         {@code rect.y + rect.height} results in integer
      *         overflow
-     * @throws NullPointerException if <code>rect</code> is null
+     * @throws NullPointerException if {@code rect} is null
      */
     public WritableRaster createCompatibleWritableRaster(Rectangle rect) {
         if (rect == null) {
             throw new NullPointerException("Rect cannot be null");
         }

@@ -1212,21 +1212,21 @@
     /**
      * Create a compatible WritableRaster with the specified
      * location (minX, minY) and size (width, height), a
      * new SampleModel, and a new initialized DataBuffer.
      * @param x the X coordinate of the upper-left corner of
-     *        the <code>WritableRaster</code>
+     *        the {@code WritableRaster}
      * @param y the Y coordinate of the upper-left corner of
-     *        the <code>WritableRaster</code>
-     * @param w the specified width of the <code>WritableRaster</code>
-     * @param h the specified height of the <code>WritableRaster</code>
-     * @return a compatible <code>WritableRaster</code> with the specified
+     *        the {@code WritableRaster}
+     * @param w the specified width of the {@code WritableRaster}
+     * @param h the specified height of the {@code WritableRaster}
+     * @return a compatible {@code WritableRaster} with the specified
      *         size and location and a new sample model and data buffer.
-     * @throws RasterFormatException if <code>w</code> or <code>h</code>
+     * @throws RasterFormatException if {@code w} or {@code h}
      *         is less than or equal to zero, or computing either
-     *         <code>x + w</code> or
-     *         <code>y + h</code> results in integer
+     *         {@code x + w} or
+     *         {@code y + h} results in integer
      *         overflow
      */
     public WritableRaster createCompatibleWritableRaster(int x, int y,
                                                          int w, int h) {
         WritableRaster ret = createCompatibleWritableRaster(w, h);

@@ -1238,19 +1238,19 @@
      * as this one, but with a different location.  The new Raster
      * will possess a reference to the current Raster, accessible
      * through its getParent() method.
      *
      * @param childMinX the X coordinate of the upper-left
-     *        corner of the new <code>Raster</code>
+     *        corner of the new {@code Raster}
      * @param childMinY the Y coordinate of the upper-left
-     *        corner of the new <code>Raster</code>
-     * @return a new <code>Raster</code> with the same size, SampleModel,
-     *         and DataBuffer as this <code>Raster</code>, but with the
+     *        corner of the new {@code Raster}
+     * @return a new {@code Raster} with the same size, SampleModel,
+     *         and DataBuffer as this {@code Raster}, but with the
      *         specified location.
      * @throws RasterFormatException if  computing either
-     *         <code>childMinX + this.getWidth()</code> or
-     *         <code>childMinY + this.getHeight()</code> results in integer
+     *         {@code childMinX + this.getWidth()} or
+     *         {@code childMinY + this.getHeight()} results in integer
      *         overflow
      */
     public Raster createTranslatedChild(int childMinX, int childMinY) {
         return createChild(minX,minY,width,height,
                            childMinX,childMinY,null);

@@ -1295,19 +1295,19 @@
      * @param childMinX The X coordinate of the upper-left corner
      *                   of the returned Raster
      * @param childMinY The Y coordinate of the upper-left corner
      *                   of the returned Raster
      * @param bandList   Array of band indices, or null to use all bands
-     * @return a new <code>Raster</code>.
+     * @return a new {@code Raster}.
      * @exception RasterFormatException if the specified subregion is outside
      *                               of the raster bounds.
-     * @throws RasterFormatException if <code>width</code> or
-     *         <code>height</code>
+     * @throws RasterFormatException if {@code width} or
+     *         {@code height}
      *         is less than or equal to zero, or computing any of
-     *         <code>parentX + width</code>, <code>parentY + height</code>,
-     *         <code>childMinX + width</code>, or
-     *         <code>childMinY + height</code> results in integer
+     *         {@code parentX + width}, {@code parentY + height},
+     *         {@code childMinX + width}, or
+     *         {@code childMinY + height} results in integer
      *         overflow
      */
     public Raster createChild(int parentX, int parentY,
                               int width, int height,
                               int childMinX, int childMinY,

@@ -1349,46 +1349,46 @@
     }
 
     /**
      * Returns the bounding Rectangle of this Raster. This function returns
      * the same information as getMinX/MinY/Width/Height.
-     * @return the bounding box of this <code>Raster</code>.
+     * @return the bounding box of this {@code Raster}.
      */
     public Rectangle getBounds() {
         return new Rectangle(minX, minY, width, height);
     }
 
     /** Returns the minimum valid X coordinate of the Raster.
-     *  @return the minimum x coordinate of this <code>Raster</code>.
+     *  @return the minimum x coordinate of this {@code Raster}.
      */
     public final int getMinX() {
         return minX;
     }
 
     /** Returns the minimum valid Y coordinate of the Raster.
-     *  @return the minimum y coordinate of this <code>Raster</code>.
+     *  @return the minimum y coordinate of this {@code Raster}.
      */
     public final int getMinY() {
         return minY;
     }
 
     /** Returns the width in pixels of the Raster.
-     *  @return the width of this <code>Raster</code>.
+     *  @return the width of this {@code Raster}.
      */
     public final int getWidth() {
         return width;
     }
 
     /** Returns the height in pixels of the Raster.
-     *  @return the height of this <code>Raster</code>.
+     *  @return the height of this {@code Raster}.
      */
     public final int getHeight() {
         return height;
     }
 
     /** Returns the number of bands (samples per pixel) in this Raster.
-     *  @return the number of bands of this <code>Raster</code>.
+     *  @return the number of bands of this {@code Raster}.
      */
     public final int getNumBands() {
         return numBands;
     }
 

@@ -1422,18 +1422,18 @@
     public final int getTransferType() {
         return sampleModel.getTransferType();
     }
 
     /** Returns the DataBuffer associated with this Raster.
-     *  @return the <code>DataBuffer</code> of this <code>Raster</code>.
+     *  @return the {@code DataBuffer} of this {@code Raster}.
      */
     public DataBuffer getDataBuffer() {
         return dataBuffer;
     }
 
     /** Returns the SampleModel that describes the layout of the image data.
-     *  @return the <code>SampleModel</code> of this <code>Raster</code>.
+     *  @return the {@code SampleModel} of this {@code Raster}.
      */
     public SampleModel getSampleModel() {
         return sampleModel;
     }
 
< prev index next >