| sun.awt.image.SunWritableRaster sun.awt.image.IntegerComponentRaster sun.awt.image.IntegerInterleavedRaster
IntegerInterleavedRaster | public class IntegerInterleavedRaster extends IntegerComponentRaster (Code) | | This class defines a Raster with pixels consisting of one or more 32-bit
data elements stored in close proximity to each other in a integer array.
The bit precision per data element is that
of the data type (that is, the bit precision for this raster is 32).
There is only one pixel stride and one scanline stride for all
bands. For a given pixel, all samples fit in N data elements and these
N data elements hold samples for only one pixel. This type of Raster
can be used with a PackedColorModel.
For example, if there is only one data element per pixel, a
SinglePixelPackedSampleModel can be used to represent multiple
bands with a PackedColorModel (including a DirectColorModel) for
color interpretation.
version: 10 Feb 1997 |
Constructor Summary | |
public | IntegerInterleavedRaster(SampleModel sampleModel, Point origin) Constructs a IntegerInterleavedRaster with the given SampleModel.
The Raster's upper left corner is origin and it is the same
size as the SampleModel. | public | IntegerInterleavedRaster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin) Constructs a IntegerInterleavedRaster with the given SampleModel
and DataBuffer. | public | IntegerInterleavedRaster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point origin, IntegerInterleavedRaster parent) Constructs a IntegerInterleavedRaster with the given SampleModel,
DataBuffer, and parent. |
Method Summary | |
public Raster | createChild(int x, int y, int width, int height, int x0, int y0, int bandList) Creates a subraster given a region of the raster. | public WritableRaster | createCompatibleWritableRaster(int w, int h) Creates a raster with the same band layout but using a different
width and height, and with new zeroed data arrays. | public WritableRaster | createCompatibleWritableRaster() Creates a raster with the same data layout and the same
width and height, and with new zeroed data arrays. | public WritableRaster | createWritableChild(int x, int y, int width, int height, int x0, int y0, int bandList) Creates a subraster given a region of the raster. | public Object | getDataElements(int x, int y, Object obj) Returns the data elements for all bands at the specified
location. | public Object | getDataElements(int x, int y, int w, int h, Object obj) Returns an array of data elements from the specified rectangular
region.
An ArrayIndexOutOfBounds exception will be thrown at runtime
if the pixel coordinates are out of bounds.
A ClassCastException will be thrown if the input object is non null
and references anything other than an array of transferType.
int[] bandData = (int[])raster.getDataElements(x, y, w, h, null);
int numDataElements = raster.getNumDataElements();
int[] pixel = new int[numDataElements];
// To find a data element at location (x2, y2)
System.arraycopy(bandData, ((y2-y)*w + (x2-x))*numDataElements,
pixel, 0, numDataElements);
Parameters: x - The X coordinate of the upper left pixel location. Parameters: y - The Y coordinate of the upper left pixel location. Parameters: width - Width of the pixel rectangle. Parameters: height - Height of the pixel rectangle. Parameters: outData - An object reference to an array of type defined bygetTransferType() and length w*h*getNumDataElements().If null an array of appropriate type and size will beallocated. | public int | getDataOffset(int band) Returns data offset for the specified band. | public int[] | getDataOffsets() Returns a copy of the data offsets array. | public int[] | getDataStorage() Returns a reference to the data array. | public int | getPixelStride() Returns pixel stride -- the number of data array elements between two
samples for the same band on the same scanline. | public int | getScanlineStride() Returns the scanline stride -- the number of data array elements between
a given sample and the sample in the same column of the next row. | public void | setDataElements(int x, int y, Object obj) Stores the data elements for all bands at the specified location. | public void | setDataElements(int x, int y, Raster inRaster) Stores the Raster data at the specified location. | public void | setDataElements(int x, int y, int w, int h, Object obj) Stores an array of data elements into the specified rectangular
region.
An ArrayIndexOutOfBounds exception will be thrown at runtime
if the pixel coordinates are out of bounds.
A ClassCastException will be thrown if the input object is non null
and references anything other than an array of transferType.
The data elements in the
data array are assumed to be packed. | public String | toString() |
IntegerInterleavedRaster | public IntegerInterleavedRaster(SampleModel sampleModel, Point origin)(Code) | | Constructs a IntegerInterleavedRaster with the given SampleModel.
The Raster's upper left corner is origin and it is the same
size as the SampleModel. A DataBuffer large enough to describe the
Raster is automatically created. SampleModel must be of type
SinglePixelPackedSampleModel.
Parameters: sampleModel - The SampleModel that specifies the layout. Parameters: origin - The Point that specified the origin. |
IntegerInterleavedRaster | public IntegerInterleavedRaster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin)(Code) | | Constructs a IntegerInterleavedRaster with the given SampleModel
and DataBuffer. The Raster's upper left corner is origin and
it is the same sizes the SampleModel. The DataBuffer is not
initialized and must be a DataBufferInt compatible with SampleModel.
SampleModel must be of type SinglePixelPackedSampleModel.
Parameters: sampleModel - The SampleModel that specifies the layout. Parameters: dataBuffer - The DataBufferInt that contains the image data. Parameters: origin - The Point that specifies the origin. |
IntegerInterleavedRaster | public IntegerInterleavedRaster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point origin, IntegerInterleavedRaster parent)(Code) | | Constructs a IntegerInterleavedRaster with the given SampleModel,
DataBuffer, and parent. DataBuffer must be a DataBufferInt and
SampleModel must be of type SinglePixelPackedSampleModel.
When translated into the base Raster's
coordinate system, aRegion must be contained by the base Raster.
Origin is the coodinate in the new Raster's coordinate system of
the origin of the base Raster. (The base Raster is the Raster's
ancestor which has no parent.)
Note that this constructor should generally be called by other
constructors or create methods, it should not be used directly.
Parameters: sampleModel - The SampleModel that specifies the layout. Parameters: dataBuffer - The DataBufferInt that contains the image data. Parameters: aRegion - The Rectangle that specifies the image area. Parameters: origin - The Point that specifies the origin. Parameters: parent - The parent (if any) of this raster. |
createChild | public Raster createChild(int x, int y, int width, int height, int x0, int y0, int bandList)(Code) | | Creates a subraster given a region of the raster. The x and y
coordinates specify the horizontal and vertical offsets
from the upper-left corner of this raster to the upper-left corner
of the subraster. A subset of the bands of the parent raster may
be specified. If this is null, then all the bands are present in the
subRaster. Note that the subraster will reference the same
DataBuffer as the parent raster, but using different offsets.
Parameters: x - X offset. Parameters: y - Y offset. Parameters: width - Width (in pixels) of the subraster. Parameters: height - Height (in pixels) of the subraster. Parameters: x0 - Translated X origin of the subRaster. Parameters: y0 - Translated Y origin of the subRaster. Parameters: bandList - Array of band indices. exception: RasterFormatException - if the specified bounding box is outside of the parent raster. |
createCompatibleWritableRaster | public WritableRaster createCompatibleWritableRaster(int w, int h)(Code) | | Creates a raster with the same band layout but using a different
width and height, and with new zeroed data arrays.
|
createCompatibleWritableRaster | public WritableRaster createCompatibleWritableRaster()(Code) | | Creates a raster with the same data layout and the same
width and height, and with new zeroed data arrays. If
the raster is a subraster, this will call
createCompatibleRaster(width, height).
|
createWritableChild | public WritableRaster createWritableChild(int x, int y, int width, int height, int x0, int y0, int bandList)(Code) | | Creates a subraster given a region of the raster. The x and y
coordinates specify the horizontal and vertical offsets
from the upper-left corner of this raster to the upper-left corner
of the subraster. A subset of the bands of the parent Raster may
be specified. If this is null, then all the bands are present in the
subRaster. A translation to the subRaster may also be specified.
Note that the subraster will reference the same
DataBuffer as the parent raster, but using different offsets.
Parameters: x - X offset. Parameters: y - Y offset. Parameters: width - Width (in pixels) of the subraster. Parameters: height - Height (in pixels) of the subraster. Parameters: x0 - Translated X origin of the subraster. Parameters: y0 - Translated Y origin of the subraster. Parameters: bandList - Array of band indices. exception: RasterFormatException - if the specified bounding box is outside of the parent raster. |
getDataElements | public Object getDataElements(int x, int y, Object obj)(Code) | | Returns the data elements for all bands at the specified
location.
An ArrayIndexOutOfBounds exception will be thrown at runtime
if the pixel coordinate is out of bounds.
A ClassCastException will be thrown if the input object is non null
and references anything other than an array of transferType.
Parameters: x - The X coordinate of the pixel location. Parameters: y - The Y coordinate of the pixel location. Parameters: outData - An object reference to an array of type defined bygetTransferType() and length getNumDataElements().If null an array of appropriate type and size will beallocated. An object reference to an array of type defined bygetTransferType() with the request pixel data. |
getDataElements | public Object getDataElements(int x, int y, int w, int h, Object obj)(Code) | | Returns an array of data elements from the specified rectangular
region.
An ArrayIndexOutOfBounds exception will be thrown at runtime
if the pixel coordinates are out of bounds.
A ClassCastException will be thrown if the input object is non null
and references anything other than an array of transferType.
int[] bandData = (int[])raster.getDataElements(x, y, w, h, null);
int numDataElements = raster.getNumDataElements();
int[] pixel = new int[numDataElements];
// To find a data element at location (x2, y2)
System.arraycopy(bandData, ((y2-y)*w + (x2-x))*numDataElements,
pixel, 0, numDataElements);
Parameters: x - The X coordinate of the upper left pixel location. Parameters: y - The Y coordinate of the upper left pixel location. Parameters: width - Width of the pixel rectangle. Parameters: height - Height of the pixel rectangle. Parameters: outData - An object reference to an array of type defined bygetTransferType() and length w*h*getNumDataElements().If null an array of appropriate type and size will beallocated. An object reference to an array of type defined bygetTransferType() with the request pixel data. |
getDataOffset | public int getDataOffset(int band)(Code) | | Returns data offset for the specified band. The data offset
is the index into the data array in which the first sample
of the first scanline is stored.
|
getDataOffsets | public int[] getDataOffsets()(Code) | | Returns a copy of the data offsets array. For each band the data offset
is the index into the band's data array, of the first sample of the
band.
|
getDataStorage | public int[] getDataStorage()(Code) | | Returns a reference to the data array.
|
getPixelStride | public int getPixelStride()(Code) | | Returns pixel stride -- the number of data array elements between two
samples for the same band on the same scanline.
|
getScanlineStride | public int getScanlineStride()(Code) | | Returns the scanline stride -- the number of data array elements between
a given sample and the sample in the same column of the next row.
|
setDataElements | public void setDataElements(int x, int y, Object obj)(Code) | | Stores the data elements for all bands at the specified location.
An ArrayIndexOutOfBounds exception will be thrown at runtime
if the pixel coordinate is out of bounds.
A ClassCastException will be thrown if the input object is non null
and references anything other than an array of transferType.
Parameters: x - The X coordinate of the pixel location. Parameters: y - The Y coordinate of the pixel location. Parameters: inData - An object reference to an array of type defined bygetTransferType() and length getNumDataElements()containing the pixel data to place at x,y. |
setDataElements | public void setDataElements(int x, int y, Raster inRaster)(Code) | | Stores the Raster data at the specified location.
The transferType of the inputRaster must match this raster.
An ArrayIndexOutOfBoundsException will be thrown at runtime
if the pixel coordinates are out of bounds.
Parameters: x - The X coordinate of the pixel location. Parameters: y - The Y coordinate of the pixel location. Parameters: inRaster - Raster of data to place at x,y location. |
setDataElements | public void setDataElements(int x, int y, int w, int h, Object obj)(Code) | | Stores an array of data elements into the specified rectangular
region.
An ArrayIndexOutOfBounds exception will be thrown at runtime
if the pixel coordinates are out of bounds.
A ClassCastException will be thrown if the input object is non null
and references anything other than an array of transferType.
The data elements in the
data array are assumed to be packed. That is, a data element
for the nth band at location (x2, y2) would be found at:
inData[((y2-y)*w + (x2-x))*numDataElements + n]
Parameters: x - The X coordinate of the upper left pixel location. Parameters: y - The Y coordinate of the upper left pixel location. Parameters: w - Width of the pixel rectangle. Parameters: h - Height of the pixel rectangle. Parameters: inData - An object reference to an array of type defined bygetTransferType() and length w*h*getNumDataElements()containing the pixel data to place between x,y andx+h, y+h. |
Methods inherited from sun.awt.image.IntegerComponentRaster | public Raster createChild(int x, int y, int width, int height, int x0, int y0, int bandList)(Code)(Java Doc) public WritableRaster createCompatibleWritableRaster(int w, int h)(Code)(Java Doc) public WritableRaster createCompatibleWritableRaster()(Code)(Java Doc) public WritableRaster createWritableChild(int x, int y, int width, int height, int x0, int y0, int bandList)(Code)(Java Doc) public Object getDataElements(int x, int y, Object obj)(Code)(Java Doc) public Object getDataElements(int x, int y, int w, int h, Object obj)(Code)(Java Doc) public int getDataOffset(int band)(Code)(Java Doc) public int[] getDataOffsets()(Code)(Java Doc) public int[] getDataStorage()(Code)(Java Doc) public int getPixelStride()(Code)(Java Doc) public int getScanlineStride()(Code)(Java Doc) public void setDataElements(int x, int y, Object obj)(Code)(Java Doc) public void setDataElements(int x, int y, Raster inRaster)(Code)(Java Doc) public void setDataElements(int x, int y, int w, int h, Object obj)(Code)(Java Doc) public String toString()(Code)(Java Doc)
|
|
|