| sun.awt.image.SunWritableRaster sun.awt.image.ShortComponentRaster
All known Subclasses: sun.awt.image.ShortInterleavedRaster,
ShortComponentRaster | public class ShortComponentRaster extends SunWritableRaster (Code) | | This class defines a Raster with pixels consisting of one or more 16-bit
data elements stored in close proximity to each other in a short integer
array. The bit precision per data element is that
of the data type (that is, the bit precision for this Raster is 16).
There is only one pixel stride and one scanline stride for all
bands. This type of Raster can be used with a
ComponentColorModel if there are multiple bands, or a
IndexColorModel if there is only one band.
For example, 5-6-5 RGB image data can be represented by a
ShortComponentRaster using a SinglePixelPackedSampleModel and
a ComponentColorModel.
version: 10 Feb 1997 |
Field Summary | |
protected int | bandOffset | protected short[] | data The image data array. | protected int[] | dataOffsets Data offsets for each band of image data. | protected int | pixelStride Pixel stride of the image data contained in this Raster. | protected int | scanlineStride Scanline stride of the image data contained in this Raster. | int | type |
Constructor Summary | |
public | ShortComponentRaster(SampleModel sampleModel, Point origin) Constructs a ShortComponentRaster with the given SampleModel.
The Raster's upper left corner is origin and it is the same
size as the SampleModel. | public | ShortComponentRaster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin) Constructs a ShortComponentRaster with the given SampleModel
and DataBuffer. | public | ShortComponentRaster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point origin, ShortComponentRaster parent) Constructs a ShortComponentRaster 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 layout but using a different
width and height, and with new zeroed data arrays. | public WritableRaster | createCompatibleWritableRaster() Creates a Raster with the same 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 Writable 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.
short[] bandData = (short[])Raster.getDataElements(x, y, w, h, null);
int numDataElements = Raster.getBands();
short[] pixel = new short[numDataElements];
// To find the 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 the data offset for the specified band. | public int[] | getDataOffsets() Returns a copy of the data offsets array. | public short[] | 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 same sample in the same column of the next row. | public short[] | getShortData(int x, int y, int w, int h, int band, short[] outData) Returns a short integer 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.
short[] bandData = Raster.getShortData(x, y, w, h, null);
// To find the data element at location (x2, y2)
short dataElenent = bandData[((y2-y)*w + (x2-x))];
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 sample rectangle. Parameters: height - Height of the sample rectangle. Parameters: band - The band to return. Parameters: outData - If non-null, data elements for all bandsat the specified location are returned in this array. | public short[] | getShortData(int x, int y, int w, int h, short[] outData) Returns a short integer 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.
short[] bandData = Raster.getShortData(x, y, w, h, null);
int numDataElements = Raster.getNumBands();
short[] pixel = new short[numDataElements];
// To find the 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 - If non-null, data elements for all bandsat the specified location are returned in this array. | public void | putShortData(int x, int y, int w, int h, int band, short[] inData) Stores a short integer 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.
The data elements in the
data array are assumed to be packed. | public void | putShortData(int x, int y, int w, int h, short[] inData) Stores a short integer 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.
The data elements in the
data array are assumed to be packed. | 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() |
bandOffset | protected int bandOffset(Code) | | private band offset for use by native code
|
data | protected short[] data(Code) | | The image data array.
|
dataOffsets | protected int[] dataOffsets(Code) | | Data offsets for each band of image data.
|
pixelStride | protected int pixelStride(Code) | | Pixel stride of the image data contained in this Raster.
|
scanlineStride | protected int scanlineStride(Code) | | Scanline stride of the image data contained in this Raster.
|
ShortComponentRaster | public ShortComponentRaster(SampleModel sampleModel, Point origin)(Code) | | Constructs a ShortComponentRaster 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
ComponentSampleModel or SinglePixelPackedSampleModel.
Parameters: sampleModel - The SampleModel that specifies the layout. Parameters: origin - The Point that specified the origin. |
ShortComponentRaster | public ShortComponentRaster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin)(Code) | | Constructs a ShortComponentRaster 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 DataBufferUShort compatible with SampleModel.
SampleModel must be of type ComponentSampleModel or
SinglePixelPackedSampleModel.
Parameters: sampleModel - The SampleModel that specifies the layout. Parameters: dataBuffer - The DataBufferUShort that contains the image data. Parameters: origin - The Point that specifies the origin. |
ShortComponentRaster | public ShortComponentRaster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point origin, ShortComponentRaster parent)(Code) | | Constructs a ShortComponentRaster with the given SampleModel,
DataBuffer, and parent. DataBuffer must be a DataBufferUShort and
SampleModel must be of type ComponentSampleModel or
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 DataBufferUShort 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. A translation to the subRaster may also be specified.
Note that the subraster will reference the same
band objects 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 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 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 Writable 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
DataBuffers 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.
short[] bandData = (short[])Raster.getDataElements(x, y, w, h, null);
int numDataElements = Raster.getBands();
short[] pixel = new short[numDataElements];
// To find the 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 the 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.
Parameters: band - The band whose offset is returned. |
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 short[] 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 same sample in the same column of the next row.
|
getShortData | public short[] getShortData(int x, int y, int w, int h, int band, short[] outData)(Code) | | Returns a short integer 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.
short[] bandData = Raster.getShortData(x, y, w, h, null);
// To find the data element at location (x2, y2)
short dataElenent = bandData[((y2-y)*w + (x2-x))];
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 sample rectangle. Parameters: height - Height of the sample rectangle. Parameters: band - The band to return. Parameters: outData - If non-null, data elements for all bandsat the specified location are returned in this array. Data array with data elements for all bands. |
getShortData | public short[] getShortData(int x, int y, int w, int h, short[] outData)(Code) | | Returns a short integer 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.
short[] bandData = Raster.getShortData(x, y, w, h, null);
int numDataElements = Raster.getNumBands();
short[] pixel = new short[numDataElements];
// To find the 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 - If non-null, data elements for all bandsat the specified location are returned in this array. Data array with data elements for all bands. |
putShortData | public void putShortData(int x, int y, int w, int h, int band, short[] inData)(Code) | | Stores a short integer 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.
The data elements in the
data array are assumed to be packed. That is, a data element
at location (x2, y2) would be found at:
inData[((y2-y)*w + (x2-x))]
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: band - The band to set. Parameters: inData - The data elements to be stored. |
putShortData | public void putShortData(int x, int y, int w, int h, short[] inData)(Code) | | Stores a short integer 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.
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 - The data elements to be stored. |
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.
An ArrayIndexOutOfBounds exception 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. |
|
|