< 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 >