< prev index next >
src/java.desktop/share/classes/java/awt/image/Raster.java
Print this page
*** 180,206 ****
* <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>
* Rasters are not supported. To create a 1-band Raster of type
! * <code>DataBuffer.TYPE_INT</code>, 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>
* @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>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
*/
public static WritableRaster createInterleavedRaster(int dataType,
int w, int h,
int bands,
--- 180,206 ----
* <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}
* Rasters are not supported. To create a 1-band Raster of type
! * {@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}
* @return a WritableRaster object with the specified data type,
* width, height and number of bands.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@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,256 ****
* <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>
* Rasters are not supported. To create a 1-band Raster of type
! * <code>DataBuffer.TYPE_INT</code>, 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>
* @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>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
! * @throws IllegalArgumentException if <code>dataType</code> is not
* one of the supported data types, which are
! * <code>DataBuffer.TYPE_BYTE</code>, or
! * <code>DataBuffer.TYPE_USHORT</code>.
*/
public static WritableRaster createInterleavedRaster(int dataType,
int w, int h,
int scanlineStride,
int pixelStride,
--- 222,256 ----
* <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}
* Rasters are not supported. To create a 1-band Raster of type
! * {@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}
* @return a WritableRaster object with the specified data type,
* width, height, scanline stride, pixel stride and band
* offsets.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
! * @throws IllegalArgumentException if {@code dataType} is not
* one of the supported data types, which are
! * {@code DataBuffer.TYPE_BYTE}, or
! * {@code DataBuffer.TYPE_USHORT}.
*/
public static WritableRaster createInterleavedRaster(int dataType,
int w, int h,
int scanlineStride,
int pixelStride,
*** 292,310 ****
* 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>
* @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>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
! * @throws ArrayIndexOutOfBoundsException if <code>bands</code>
* is less than 1
*/
public static WritableRaster createBandedRaster(int dataType,
int w, int h,
int bands,
--- 292,310 ----
* 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}
* @return a WritableRaster object with the specified data type,
* width, height and number of bands.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
! * @throws ArrayIndexOutOfBoundsException if {@code bands}
* is less than 1
*/
public static WritableRaster createBandedRaster(int dataType,
int w, int h,
int bands,
*** 343,368 ****
* @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>
* @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>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
! * @throws IllegalArgumentException if <code>dataType</code> 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>
*/
public static WritableRaster createBandedRaster(int dataType,
int w, int h,
int scanlineStride,
int bankIndices[],
--- 343,368 ----
* @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}
* @return a WritableRaster object with the specified data type,
* width, height, scanline stride, bank indices and band
* offsets.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
! * @throws IllegalArgumentException if {@code dataType} is not
* one of the supported data types, which are
! * {@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,454 ****
* 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>
* @return a WritableRaster object with the specified data type,
* width, height, and band masks.
! * @throws RasterFormatException if <code>w</code> or <code>h</code>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
! * @throws IllegalArgumentException if <code>dataType</code> 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>
*/
public static WritableRaster createPackedRaster(int dataType,
int w, int h,
int bandMasks[],
Point location) {
--- 432,454 ----
* 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}
* @return a WritableRaster object with the specified data type,
* width, height, and band masks.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
! * @throws IllegalArgumentException if {@code dataType} is not
* one of the supported data types, which are
! * {@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,525 ****
* @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>
* @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>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
* @throws IllegalArgumentException if the product of
! * <code>bitsPerBand</code> and <code>bands</code> 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
* one of the supported data types, which are
! * <code>DataBuffer.TYPE_BYTE</code>,
! * <code>DataBuffer.TYPE_USHORT</code>
! * or <code>DataBuffer.TYPE_INT</code>
*/
public static WritableRaster createPackedRaster(int dataType,
int w, int h,
int bands,
int bitsPerBand,
--- 497,525 ----
* @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}
* @return a WritableRaster object with the specified data type,
* width, height, number of bands, and bits per band.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
* @throws IllegalArgumentException if the product of
! * {@code bitsPerBand} and {@code bands} is
* greater than the number of bits held by
! * {@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 DataBuffer.TYPE_USHORT}
! * or {@code DataBuffer.TYPE_INT}
*/
public static WritableRaster createPackedRaster(int dataType,
int w, int h,
int bands,
int bitsPerBand,
*** 594,630 ****
* 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>
* Rasters are not supported. To create a 1-band Raster of type
! * <code>DataBuffer.TYPE_INT</code>, use
* Raster.createPackedRaster().
! * @param dataBuffer the <code>DataBuffer</code> 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>
* @return a WritableRaster object with the specified
! * <code>DataBuffer</code>, width, height, scanline stride,
* pixel stride and band offsets.
! * @throws RasterFormatException if <code>w</code> or <code>h</code>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
! * @throws IllegalArgumentException if <code>dataType</code> 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
* than one bank.
! * @throws NullPointerException if <code>dataBuffer</code> is null
*/
public static WritableRaster createInterleavedRaster(DataBuffer dataBuffer,
int w, int h,
int scanlineStride,
int pixelStride,
--- 594,630 ----
* 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}
* Rasters are not supported. To create a 1-band Raster of type
! * {@code DataBuffer.TYPE_INT}, use
* Raster.createPackedRaster().
! * @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}
* @return a WritableRaster object with the specified
! * {@code DataBuffer}, width, height, scanline stride,
* pixel stride and band offsets.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
! * @throws IllegalArgumentException if {@code dataType} is not
* one of the supported data types, which are
! * {@code DataBuffer.TYPE_BYTE},
! * {@code DataBuffer.TYPE_USHORT}
! * @throws RasterFormatException if {@code dataBuffer} has more
* than one bank.
! * @throws NullPointerException if {@code dataBuffer} is null
*/
public static WritableRaster createInterleavedRaster(DataBuffer dataBuffer,
int w, int h,
int scanlineStride,
int pixelStride,
*** 661,692 ****
* 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
* 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>
* @return a WritableRaster object with the specified
! * <code>DataBuffer</code>, width, height, scanline stride,
* bank indices and band offsets.
! * @throws RasterFormatException if <code>w</code> or <code>h</code>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
! * @throws IllegalArgumentException if <code>dataType</code> 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
*/
public static WritableRaster createBandedRaster(DataBuffer dataBuffer,
int w, int h,
int scanlineStride,
int bankIndices[],
--- 661,692 ----
* 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} 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}
* @return a WritableRaster object with the specified
! * {@code DataBuffer}, width, height, scanline stride,
* bank indices and band offsets.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
! * @throws IllegalArgumentException if {@code dataType} is not
* one of the supported data types, which are
! * {@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,763 ****
* 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
* 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>
* @return a WritableRaster object with the specified
! * <code>DataBuffer</code>, width, height, scanline stride,
* and band masks.
! * @throws RasterFormatException if <code>w</code> or <code>h</code>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
! * @throws IllegalArgumentException if <code>dataType</code> 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
* than one bank.
! * @throws NullPointerException if <code>dataBuffer</code> is null
*/
public static WritableRaster createPackedRaster(DataBuffer dataBuffer,
int w, int h,
int scanlineStride,
int bandMasks[],
--- 731,763 ----
* 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} 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}
* @return a WritableRaster object with the specified
! * {@code DataBuffer}, width, height, scanline stride,
* and band masks.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
! * @throws IllegalArgumentException if {@code dataType} is not
* one of the supported data types, which are
! * {@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} is null
*/
public static WritableRaster createPackedRaster(DataBuffer dataBuffer,
int w, int h,
int scanlineStride,
int bandMasks[],
*** 793,824 ****
/**
* 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
* 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>
* @return a WritableRaster object with the specified
! * <code>DataBuffer</code>, width, height, and
* bits per pixel.
! * @throws RasterFormatException if <code>w</code> or <code>h</code>
* is less than or equal to zero, or computing either
! * <code>location.x + w</code> or
! * <code>location.y + h</code> results in integer
* overflow
! * @throws IllegalArgumentException if <code>dataType</code> 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
* than one bank.
! * @throws NullPointerException if <code>dataBuffer</code> is null
*/
public static WritableRaster createPackedRaster(DataBuffer dataBuffer,
int w, int h,
int bitsPerPixel,
Point location) {
--- 793,824 ----
/**
* 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} 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}
* @return a WritableRaster object with the specified
! * {@code DataBuffer}, width, height, and
* bits per pixel.
! * @throws RasterFormatException if {@code w} or {@code h}
* is less than or equal to zero, or computing either
! * {@code location.x + w} or
! * {@code location.y + h} results in integer
* overflow
! * @throws IllegalArgumentException if {@code dataType} is not
* one of the supported data types, which are
! * {@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} is null
*/
public static WritableRaster createPackedRaster(DataBuffer dataBuffer,
int w, int h,
int bitsPerPixel,
Point location) {
*** 857,878 ****
/**
* 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
* location.
* @throws RasterFormatException if computing either
! * <code>location.x + sm.getWidth()</code> or
! * <code>location.y + sm.getHeight()</code> results in integer
* overflow
! * @throws RasterFormatException if <code>db</code> has more
! * than one bank and <code>sm</code> is a
* PixelInterleavedSampleModel, SinglePixelPackedSampleModel,
* or MultiPixelPackedSampleModel.
* @throws NullPointerException if either SampleModel or DataBuffer is
* null
*/
--- 857,878 ----
/**
* 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}
! * @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()} or
! * {@code location.y + sm.getHeight()} results in integer
* overflow
! * @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,937 ****
/**
* 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 location the upper-left corner of the
! * <code>WritableRaster</code>
! * @return a <code>WritableRaster</code> with the specified
! * <code>SampleModel</code> and location.
* @throws RasterFormatException if computing either
! * <code>location.x + sm.getWidth()</code> or
! * <code>location.y + sm.getHeight()</code> results in integer
* overflow
*/
public static WritableRaster createWritableRaster(SampleModel sm,
Point location) {
if (location == null) {
--- 920,937 ----
/**
* 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}
* @param location the upper-left corner of the
! * {@code WritableRaster}
! * @return a {@code WritableRaster} with the specified
! * {@code SampleModel} and location.
* @throws RasterFormatException if computing either
! * {@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,965 ****
/**
* 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 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
* location.
* @throws RasterFormatException if computing either
! * <code>location.x + sm.getWidth()</code> or
! * <code>location.y + sm.getHeight()</code> results in integer
* overflow
! * @throws RasterFormatException if <code>db</code> has more
! * than one bank and <code>sm</code> is a
* PixelInterleavedSampleModel, SinglePixelPackedSampleModel,
* or MultiPixelPackedSampleModel.
* @throws NullPointerException if either SampleModel or DataBuffer is null
*/
public static WritableRaster createWritableRaster(SampleModel sm,
--- 943,965 ----
/**
* 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}
! * @param db the specified {@code DataBuffer}
* @param location the upper-left corner of the
! * {@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()} or
! * {@code location.y + sm.getHeight()} results in integer
* overflow
! * @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,1024 ****
* 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
* integer overflow
! * @throws NullPointerException either <code>sampleModel</code> or
! * <code>origin</code> is null
*/
protected Raster(SampleModel sampleModel,
Point origin) {
this(sampleModel,
sampleModel.createDataBuffer(),
--- 1010,1024 ----
* 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()} or
! * {@code origin.y + sampleModel.getHeight()} results in
* integer overflow
! * @throws NullPointerException either {@code sampleModel} or
! * {@code origin} is null
*/
protected Raster(SampleModel sampleModel,
Point origin) {
this(sampleModel,
sampleModel.createDataBuffer(),
*** 1037,1051 ****
* 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
* integer overflow
! * @throws NullPointerException either <code>sampleModel</code> or
! * <code>origin</code> is null
*/
protected Raster(SampleModel sampleModel,
DataBuffer dataBuffer,
Point origin) {
this(sampleModel,
--- 1037,1051 ----
* 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()} or
! * {@code origin.y + sampleModel.getHeight()} results in
* integer overflow
! * @throws NullPointerException either {@code sampleModel} or
! * {@code origin} is null
*/
protected Raster(SampleModel sampleModel,
DataBuffer dataBuffer,
Point origin) {
this(sampleModel,
*** 1073,1089 ****
* @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
* 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
* overflow
*/
protected Raster(SampleModel sampleModel,
DataBuffer dataBuffer,
Rectangle aRegion,
--- 1073,1089 ----
* @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 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} or
! * {@code aRegion.y + aRegion.height} results in integer
* overflow
*/
protected Raster(SampleModel sampleModel,
DataBuffer dataBuffer,
Rectangle aRegion,
*** 1123,1133 ****
}
/**
* Returns the parent Raster (if any) of this Raster or null.
! * @return the parent Raster or <code>null</code>.
*/
public Raster getParent() {
return parent;
}
--- 1123,1133 ----
}
/**
* Returns the parent Raster (if any) of this Raster or null.
! * @return the parent Raster or {@code null}.
*/
public Raster getParent() {
return parent;
}
*** 1156,1178 ****
}
/**
* 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
* 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
* 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) {
--- 1156,1178 ----
}
/**
* Create a compatible WritableRaster the same size as this Raster with
* the same SampleModel and a new initialized DataBuffer.
! * @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}
! * @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,1207 ****
/**
* 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
* size and location and a new sample model and data buffer.
! * @throws RasterFormatException if <code>rect</code> 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
* overflow
! * @throws NullPointerException if <code>rect</code> is null
*/
public WritableRaster createCompatibleWritableRaster(Rectangle rect) {
if (rect == null) {
throw new NullPointerException("Rect cannot be null");
}
--- 1188,1207 ----
/**
* 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} 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} has width
* or height less than or equal to zero, or computing either
! * {@code rect.x + rect.width} or
! * {@code rect.y + rect.height} results in integer
* overflow
! * @throws NullPointerException if {@code rect} is null
*/
public WritableRaster createCompatibleWritableRaster(Rectangle rect) {
if (rect == null) {
throw new NullPointerException("Rect cannot be null");
}
*** 1212,1232 ****
/**
* 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>
* @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
* size and location and a new sample model and data buffer.
! * @throws RasterFormatException if <code>w</code> or <code>h</code>
* is less than or equal to zero, or computing either
! * <code>x + w</code> or
! * <code>y + h</code> results in integer
* overflow
*/
public WritableRaster createCompatibleWritableRaster(int x, int y,
int w, int h) {
WritableRaster ret = createCompatibleWritableRaster(w, h);
--- 1212,1232 ----
/**
* 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}
* @param y the Y coordinate of the upper-left corner of
! * 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} or {@code h}
* is less than or equal to zero, or computing either
! * {@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,1256 ****
* 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>
* @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
* specified location.
* @throws RasterFormatException if computing either
! * <code>childMinX + this.getWidth()</code> or
! * <code>childMinY + this.getHeight()</code> results in integer
* overflow
*/
public Raster createTranslatedChild(int childMinX, int childMinY) {
return createChild(minX,minY,width,height,
childMinX,childMinY,null);
--- 1238,1256 ----
* 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}
* @param childMinY the Y coordinate of the upper-left
! * 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()} 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,1313 ****
* @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>.
* @exception RasterFormatException if the specified subregion is outside
* of the raster bounds.
! * @throws RasterFormatException if <code>width</code> or
! * <code>height</code>
* 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
* overflow
*/
public Raster createChild(int parentX, int parentY,
int width, int height,
int childMinX, int childMinY,
--- 1295,1313 ----
* @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}.
* @exception RasterFormatException if the specified subregion is outside
* of the raster bounds.
! * @throws RasterFormatException if {@code width} or
! * {@code height}
* is less than or equal to zero, or computing any of
! * {@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,1394 ****
}
/**
* 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>.
*/
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>.
*/
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>.
*/
public final int getMinY() {
return minY;
}
/** Returns the width in pixels of the Raster.
! * @return the width of this <code>Raster</code>.
*/
public final int getWidth() {
return width;
}
/** Returns the height in pixels of the Raster.
! * @return the height of this <code>Raster</code>.
*/
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>.
*/
public final int getNumBands() {
return numBands;
}
--- 1349,1394 ----
}
/**
* 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}.
*/
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}.
*/
public final int getMinX() {
return minX;
}
/** Returns the minimum valid Y coordinate of the Raster.
! * @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}.
*/
public final int getWidth() {
return width;
}
/** Returns the height in pixels of the Raster.
! * @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}.
*/
public final int getNumBands() {
return numBands;
}
*** 1422,1439 ****
public final int getTransferType() {
return sampleModel.getTransferType();
}
/** Returns the DataBuffer associated with this Raster.
! * @return the <code>DataBuffer</code> of this <code>Raster</code>.
*/
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>.
*/
public SampleModel getSampleModel() {
return sampleModel;
}
--- 1422,1439 ----
public final int getTransferType() {
return sampleModel.getTransferType();
}
/** Returns the DataBuffer associated with this Raster.
! * @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} of this {@code Raster}.
*/
public SampleModel getSampleModel() {
return sampleModel;
}
< prev index next >