TYPE_BYTE
,
TYPE_USHORT
,
TYPE_SHORT
,
TYPE_INT
,
TYPE_FLOAT
, and
TYPE_DOUBLE
datatypes-
Field Summary
Fields declared in class java.awt.image.ComponentSampleModel
bandOffsets, bankIndices, numBands, numBanks, pixelStride, scanlineStride
Fields declared in class java.awt.image.SampleModel
dataType, height, width
-
Constructor Summary
ConstructorDescriptionBandedSampleModel
(int dataType, int w, int h, int numBands) Constructs a BandedSampleModel with the specified parameters.BandedSampleModel
(int dataType, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets) Constructs a BandedSampleModel with the specified parameters. -
Method Summary
Modifier and TypeMethodDescriptioncreateCompatibleSampleModel
(int w, int h) Creates a new BandedSampleModel with the specified width and height.Creates a DataBuffer that corresponds to this BandedSampleModel, The DataBuffer's data type, number of banks, and size will be consistent with this BandedSampleModel.createSubsetSampleModel
(int[] bands) Creates a new BandedSampleModel with a subset of the bands of this BandedSampleModel.getDataElements
(int x, int y, Object obj, DataBuffer data) Returns data for a single pixel in a primitive array of type TransferType.int[]
getPixel
(int x, int y, int[] iArray, DataBuffer data) Returns all samples for the specified pixel in an int array.int[]
getPixels
(int x, int y, int w, int h, int[] iArray, DataBuffer data) Returns all samples for the specified rectangle of pixels in an int array, one sample per data array element.int
getSample
(int x, int y, int b, DataBuffer data) Returns as int the sample in a specified band for the pixel located at (x,y).double
getSampleDouble
(int x, int y, int b, DataBuffer data) Returns the sample in a specified band for a pixel located at (x,y) as a double.float
getSampleFloat
(int x, int y, int b, DataBuffer data) Returns the sample in a specified band for the pixel located at (x,y) as a float.int[]
getSamples
(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data) Returns the samples in a specified band for the specified rectangle of pixels in an int array, one sample per data array element.void
setDataElements
(int x, int y, Object obj, DataBuffer data) Sets the data for a single pixel in the specified DataBuffer from a primitive array of type TransferType.void
setPixel
(int x, int y, int[] iArray, DataBuffer data) Sets a pixel in the DataBuffer using an int array of samples for input.void
setPixels
(int x, int y, int w, int h, int[] iArray, DataBuffer data) Sets all samples for a rectangle of pixels from an int array containing one sample per array element.void
setSample
(int x, int y, int b, double s, DataBuffer data) Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using a double for input.void
setSample
(int x, int y, int b, float s, DataBuffer data) Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using a float for input.void
setSample
(int x, int y, int b, int s, DataBuffer data) Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using an int for input.void
setSamples
(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data) Sets the samples in the specified band for the specified rectangle of pixels from an int array containing one sample per data array element.Methods declared in class java.awt.image.ComponentSampleModel
getBandOffsets, getBankIndices, getNumDataElements, getOffset, getOffset, getPixelStride, getSampleSize, getSampleSize, getScanlineStride
Methods declared in class java.awt.image.SampleModel
getDataElements, getDataType, getHeight, getNumBands, getPixel, getPixel, getPixels, getPixels, getSamples, getSamples, getTransferType, getWidth, setDataElements, setPixel, setPixel, setPixels, setPixels, setSamples, setSamples
-
Constructor Details
-
BandedSampleModel
public BandedSampleModel(int dataType, int w, int h, int numBands) Constructs a BandedSampleModel with the specified parameters. The pixel stride will be one data element. The scanline stride will be the same as the width. Each band will be stored in a separate bank and all band offsets will be zero.- Parameters:
dataType
- The data type for storing samples.w
- The width (in pixels) of the region of image data described.h
- The height (in pixels) of the region of image data described.numBands
- The number of bands for the image data.- Throws:
IllegalArgumentException
- ifw
andh
are not both greater than 0IllegalArgumentException
- if the product ofw
andh
is greater thanInteger.MAX_VALUE
IllegalArgumentException
- ifnumBands
is not > 0IllegalArgumentException
- ifdataType
is not one of the supported data types for this sample model.
-
BandedSampleModel
public BandedSampleModel(int dataType, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets) Constructs a BandedSampleModel with the specified parameters. The number of bands will be inferred from the lengths of the bandOffsets bankIndices arrays, which must be equal. The pixel stride will be one data element.- Parameters:
dataType
- The data type for storing samples.w
- The width (in pixels) of the region of image data described.h
- The height (in pixels) of the region of image data described.scanlineStride
- The line stride of the of the image data.bankIndices
- The bank index for each band.bandOffsets
- The band offset for each band.- Throws:
IllegalArgumentException
- ifw
andh
are not both greater than 0IllegalArgumentException
- if the product ofw
andh
is greater thanInteger.MAX_VALUE
IllegalArgumentException
- ifscanlineStride
is less than 0NullPointerException
- ifbankIndices
isnull
NullPointerException
- ifbandOffsets
isnull
IllegalArgumentException
- ifbandOffsets.length
is 0IllegalArgumentException
- if the length ofbankIndices
does not equal the length ofbandOffsets
IllegalArgumentException
- if any of the bank indices ofbandIndices
is less than 0IllegalArgumentException
- ifdataType
is not one of the supported data types for this sample model
-
-
Method Details
-
createCompatibleSampleModel
Creates a new BandedSampleModel with the specified width and height. The new BandedSampleModel will have the same number of bands, storage data type, and bank indices as this BandedSampleModel. The band offsets will be compressed such that the offset between bands will be w*pixelStride and the minimum of all of the band offsets is zero.- Overrides:
createCompatibleSampleModel
in classComponentSampleModel
- Parameters:
w
- the width of the resultingBandedSampleModel
h
- the height of the resultingBandedSampleModel
- Returns:
- a new
BandedSampleModel
with the specified width and height. - Throws:
IllegalArgumentException
- ifw
orh
equals eitherInteger.MAX_VALUE
orInteger.MIN_VALUE
IllegalArgumentException
- ifdataType
is not one of the supported data types
-
createSubsetSampleModel
Creates a new BandedSampleModel with a subset of the bands of this BandedSampleModel. The new BandedSampleModel can be used with any DataBuffer that the existing BandedSampleModel can be used with. The new BandedSampleModel/DataBuffer combination will represent an image with a subset of the bands of the original BandedSampleModel/DataBuffer combination.- Overrides:
createSubsetSampleModel
in classComponentSampleModel
- Parameters:
bands
- a subset of bands from thisComponentSampleModel
- Returns:
- a
ComponentSampleModel
created with a subset of bands from thisComponentSampleModel
. - Throws:
RasterFormatException
- if the number of bands is greater than the number of banks in this sample model.IllegalArgumentException
- ifdataType
is not one of the supported data types
-
createDataBuffer
Creates a DataBuffer that corresponds to this BandedSampleModel, The DataBuffer's data type, number of banks, and size will be consistent with this BandedSampleModel.- Overrides:
createDataBuffer
in classComponentSampleModel
- Returns:
- a
DataBuffer
whose data type, number of banks and size are consistent with thisComponentSampleModel
. - Throws:
IllegalArgumentException
- ifdataType
is not one of the supported types.
-
getDataElements
Returns data for a single pixel in a primitive array of type TransferType. For a BandedSampleModel, this will be the same as the data type, and samples will be returned one per array element. Generally, obj should be passed in as null, so that the Object will be created automatically and will be of the right primitive data type.The following code illustrates transferring data for one pixel from DataBuffer
db1
, whose storage layout is described by BandedSampleModelbsm1
, to DataBufferdb2
, whose storage layout is described by BandedSampleModelbsm2
. The transfer will generally be more efficient than using getPixel/setPixel.BandedSampleModel bsm1, bsm2; DataBufferInt db1, db2; bsm2.setDataElements(x, y, bsm1.getDataElements(x, y, null, db1), db2);
Using getDataElements/setDataElements to transfer between two DataBuffer/SampleModel pairs is legitimate if the SampleModels have the same number of bands, corresponding bands have the same number of bits per sample, and the TransferTypes are the same.If obj is non-null, it should be a primitive array of type TransferType. Otherwise, a ClassCastException is thrown. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds, or if obj is non-null and is not large enough to hold the pixel data.
- Overrides:
getDataElements
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationobj
- If non-null, a primitive array in which to return the pixel data.data
- The DataBuffer containing the image data.- Returns:
- the data for the specified pixel.
- See Also:
-
getPixel
Returns all samples for the specified pixel in an int array. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
getPixel
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationiArray
- If non-null, returns the samples in this arraydata
- The DataBuffer containing the image data- Returns:
- the samples for the specified pixel.
- See Also:
-
getPixels
Returns all samples for the specified rectangle of pixels in an int array, one sample per data array element. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
getPixels
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the upper left pixel locationy
- The Y coordinate of the upper left pixel locationw
- The width of the pixel rectangleh
- The height of the pixel rectangleiArray
- If non-null, returns the samples in this arraydata
- The DataBuffer containing the image data- Returns:
- the samples for the pixels within the specified region.
- See Also:
-
getSample
Returns as int the sample in a specified band for the pixel located at (x,y). ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
getSample
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationb
- The band to returndata
- The DataBuffer containing the image data- Returns:
- the sample in the specified band for the specified pixel.
- See Also:
-
getSampleFloat
Returns the sample in a specified band for the pixel located at (x,y) as a float. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
getSampleFloat
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationb
- The band to returndata
- The DataBuffer containing the image data- Returns:
- a float value that represents the sample in the specified band for the specified pixel.
-
getSampleDouble
Returns the sample in a specified band for a pixel located at (x,y) as a double. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
getSampleDouble
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationb
- The band to returndata
- The DataBuffer containing the image data- Returns:
- a double value that represents the sample in the specified band for the specified pixel.
-
getSamples
Returns the samples in a specified band for the specified rectangle of pixels in an int array, one sample per data array element. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
getSamples
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the upper left pixel locationy
- The Y coordinate of the upper left pixel locationw
- The width of the pixel rectangleh
- The height of the pixel rectangleb
- The band to returniArray
- If non-null, returns the samples in this arraydata
- The DataBuffer containing the image data- Returns:
- the samples in the specified band for the pixels within the specified region.
- See Also:
-
setDataElements
Sets the data for a single pixel in the specified DataBuffer from a primitive array of type TransferType. For a BandedSampleModel, this will be the same as the data type, and samples are transferred one per array element.The following code illustrates transferring data for one pixel from DataBuffer
db1
, whose storage layout is described by BandedSampleModelbsm1
, to DataBufferdb2
, whose storage layout is described by BandedSampleModelbsm2
. The transfer will generally be more efficient than using getPixel/setPixel.BandedSampleModel bsm1, bsm2; DataBufferInt db1, db2; bsm2.setDataElements(x, y, bsm1.getDataElements(x, y, null, db1), db2);
Using getDataElements/setDataElements to transfer between two DataBuffer/SampleModel pairs is legitimate if the SampleModels have the same number of bands, corresponding bands have the same number of bits per sample, and the TransferTypes are the same.obj must be a primitive array of type TransferType. Otherwise, a ClassCastException is thrown. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds, or if obj is not large enough to hold the pixel data.
- Overrides:
setDataElements
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationobj
- If non-null, returns the primitive array in this objectdata
- The DataBuffer containing the image data- See Also:
-
setPixel
Sets a pixel in the DataBuffer using an int array of samples for input. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
setPixel
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationiArray
- The input samples in an int arraydata
- The DataBuffer containing the image data- See Also:
-
setPixels
Sets all samples for a rectangle of pixels from an int array containing one sample per array element. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
setPixels
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the upper left pixel locationy
- The Y coordinate of the upper left pixel locationw
- The width of the pixel rectangleh
- The height of the pixel rectangleiArray
- The input samples in an int arraydata
- The DataBuffer containing the image data- See Also:
-
setSample
Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using an int for input. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
setSample
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationb
- The band to sets
- The input sample as an intdata
- The DataBuffer containing the image data- See Also:
-
setSample
Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using a float for input. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
setSample
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationb
- The band to sets
- The input sample as a floatdata
- The DataBuffer containing the image data- See Also:
-
setSample
Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using a double for input. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
setSample
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the pixel locationy
- The Y coordinate of the pixel locationb
- The band to sets
- The input sample as a doubledata
- The DataBuffer containing the image data- See Also:
-
setSamples
Sets the samples in the specified band for the specified rectangle of pixels from an int array containing one sample per data array element. ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds.- Overrides:
setSamples
in classComponentSampleModel
- Parameters:
x
- The X coordinate of the upper left pixel locationy
- The Y coordinate of the upper left pixel locationw
- The width of the pixel rectangleh
- The height of the pixel rectangleb
- The band to setiArray
- The input sample arraydata
- The DataBuffer containing the image data- See Also:
-