java.awt.image

Класс WritableRaster

java.lang. Объект

java.awt.image. Растр

java.awt.image. WritableRaster

public class WritableRaster
extends Raster

Этот class расширяет Растр, чтобы обеспечить пиксельные возможности записи. Сошлитесь на комментарий class для Растра для описаний того, как Растр хранит пиксели.

Конструкторы этого class защищаются. Чтобы инстанцировать WritableRaster, используйте один из createWritableRaster методов фабрики в Растре class.

Полевая Сводка

Поля, наследованные от class java.awt.image. Растр

dataBuffer, height, minX, minY, numBands, numDataElements, parent, sampleModel, sampleModelTranslateX, sampleModelTranslateY, width

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	WritableRaster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin) Создает WritableRaster с данным SampleModel и DataBuffer.
protected	WritableRaster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point sampleModelTranslate, WritableRaster parent) Создает WritableRaster с данным SampleModel, DataBuffer, и родителем.
protected	WritableRaster(SampleModel sampleModel, Point origin) Создает WritableRaster с данным SampleModel.

Сводка метода

Модификатор и Тип	Метод и Описание
WritableRaster	createWritableChild(int parentX, int parentY, int w, int h, int childMinX, int childMinY, int[] bandList) Возвращает новый WritableRaster, который совместно использует все или часть DataBuffer этого WritableRaster.
WritableRaster	createWritableTranslatedChild(int childMinX, int childMinY) Создайте WritableRaster с тем же самым размером, SampleModel и DataBuffer как этот, но с различным расположением.
WritableRaster	getWritableParent() Возвращает родительский WritableRaster (если любой) этого WritableRaster, или иначе нуля.
void	setDataElements(int x, int y, int w, int h, Object inData) Устанавливает данные для прямоугольника пикселей от примитивного массива типа TransferType.
void	setDataElements(int x, int y, Object inData) Устанавливает данные для единственного пикселя от примитивного массива типа TransferType.
void	setDataElements(int x, int y, Raster inRaster) Устанавливает данные для прямоугольника пикселей от входного Растра.
void	setPixel(int x, int y, double[] dArray) Устанавливает пиксель в DataBuffer, используя двойной массив выборок для ввода.
void	setPixel(int x, int y, float[] fArray) Устанавливает пиксель в DataBuffer, используя массив плавающий выборок для ввода.
void	setPixel(int x, int y, int[] iArray) Устанавливает пиксель в DataBuffer, используя международный массив выборок для ввода.
void	setPixels(int x, int y, int w, int h, double[] dArray) Наборы все выборки для прямоугольника пикселей от двойного массива, содержащего одну выборку на элемент массива.
void	setPixels(int x, int y, int w, int h, float[] fArray) Наборы все выборки для прямоугольника пикселей от массива плавающего, содержащего одну выборку на элемент массива.
void	setPixels(int x, int y, int w, int h, int[] iArray) Наборы все выборки для прямоугольника пикселей от международного массива, содержащего одну выборку на элемент массива.
void	setRect(int dx, int dy, Raster srcRaster) Пиксели копий от Растра srcRaster к этому WritableRaster.
void	setRect(Raster srcRaster) Пиксели копий от Растра srcRaster к этому WritableRaster.
void	setSample(int x, int y, int b, double s) Устанавливает выборку в указанной полосе для пикселя, расположенного в (x, y) в DataBuffer, используя двойное для ввода.
void	setSample(int x, int y, int b, float s) Устанавливает выборку в указанной полосе для пикселя, расположенного в (x, y) в DataBuffer, используя плавание для ввода.
void	setSample(int x, int y, int b, int s) Устанавливает выборку в указанной полосе для пикселя, расположенного в (x, y) в DataBuffer, используя интервал для ввода.
void	setSamples(int x, int y, int w, int h, int b, double[] dArray) Устанавливает выборки в указанной полосе для указанного прямоугольника пикселей от двойного массива, содержащего одну выборку на элемент массива.
void	setSamples(int x, int y, int w, int h, int b, float[] fArray) Устанавливает выборки в указанной полосе для указанного прямоугольника пикселей от массива плавающего, содержащего одну выборку на элемент массива.
void	setSamples(int x, int y, int w, int h, int b, int[] iArray) Устанавливает выборки в указанной полосе для указанного прямоугольника пикселей от международного массива, содержащего одну выборку на элемент массива.

Методы, наследованные от class java.awt.image. Растр

createBandedRaster, createBandedRaster, createBandedRaster, createChild, createCompatibleWritableRaster, createCompatibleWritableRaster, createCompatibleWritableRaster, createCompatibleWritableRaster, createInterleavedRaster, createInterleavedRaster, createInterleavedRaster, createPackedRaster, createPackedRaster, createPackedRaster, createPackedRaster, createRaster, createTranslatedChild, createWritableRaster, createWritableRaster, getBounds, getDataBuffer, getDataElements, getDataElements, getHeight, getMinX, getMinY, getNumBands, getNumDataElements, getParent, getPixel, getPixel, getPixel, getPixels, getPixels, getPixels, getSample, getSampleDouble, getSampleFloat, getSampleModel, getSampleModelTranslateX, getSampleModelTranslateY, getSamples, getSamples, getSamples, getTransferType, getWidth

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

WritableRaster

protected WritableRaster(SampleModel sampleModel,
                         Point origin)

Создает WritableRaster с данным SampleModel. Левый верхний угол WritableRaster является источником, и это - тот же самый размер как SampleModel. DataBuffer, достаточно крупный, чтобы описать WritableRaster, автоматически создается.

Параметры:

sampleModel - SampleModel, который определяет расположение.

origin - Точка, которая определяет источник.

Броски:

RasterFormatException - вычисляя также origin.x + sampleModel.getWidth() или origin.y + sampleModel.getHeight() результаты в целочисленном переполнении

WritableRaster

protected WritableRaster(SampleModel sampleModel,
                         DataBuffer dataBuffer,
                         Point origin)

Создает WritableRaster с данным SampleModel и DataBuffer. Левый верхний угол WritableRaster является источником, и это - тот же самый размер как SampleModel. DataBuffer не инициализируется и должен быть совместимым с SampleModel.

Параметры:

sampleModel - SampleModel, который определяет расположение.

dataBuffer - DataBuffer, который содержит данные изображения.

origin - Точка, которая определяет источник.

Броски:

RasterFormatException - вычисляя также origin.x + sampleModel.getWidth() или origin.y + sampleModel.getHeight() результаты в целочисленном переполнении

WritableRaster

protected WritableRaster(SampleModel sampleModel,
                         DataBuffer dataBuffer,
                         Rectangle aRegion,
                         Point sampleModelTranslate,
                         WritableRaster parent)

Создает WritableRaster с данным SampleModel, DataBuffer, и родителем. aRegion определяет ограничительный прямоугольник нового Растра. Когда преобразовано в систему координат основного Растра, aRegion должен содержаться основным Растром. (Основной Растр является предком Растра, у которого нет никакого родителя.) sampleModelTranslate определяет sampleModelTranslateX и sampleModelTranslateY значения нового Растра. Отметьте, что этого конструктора должны обычно вызвать другие конструкторы или создать методы, это не должно использоваться непосредственно.

Параметры:

sampleModel - SampleModel, который определяет расположение.

dataBuffer - DataBuffer, который содержит данные изображения.

aRegion - Прямоугольник, который определяет область изображения.

sampleModelTranslate - Точка, которая определяет преобразование от SampleModel до Растровых координат.

parent - Родитель (если любой) этого растра.

Броски:

RasterFormatException - если aRegion имеет width или height, меньше чем или равный нулю, или вычисляющий также aRegion.x + aRegion.width или aRegion.y + aRegion.height результаты в целочисленном переполнении

Деталь метода

getWritableParent

public WritableRaster getWritableParent()

Возвращает родительский WritableRaster (если любой) этого WritableRaster, или иначе нуля.

Возвраты:

родитель этого WritableRaster, или null.

createWritableTranslatedChild

public WritableRaster createWritableTranslatedChild(int childMinX,
                                                    int childMinY)

Создайте WritableRaster с тем же самым размером, SampleModel и DataBuffer как этот, но с различным расположением. Новый WritableRaster будет обладать ссылкой на текущий WritableRaster, доступный через его getParent () и getWritableParent () методы.

Параметры:

childMinX - X coord левого верхнего угла нового Растра.

childMinY - Y coord левого верхнего угла нового Растра.

Возвраты:

a WritableRaster то же самое как этот за исключением указанного расположения.

Броски:

RasterFormatException - вычисляя также childMinX + this.getWidth() или childMinY + this.getHeight() результаты в целочисленном переполнении

createWritableChild

public WritableRaster createWritableChild(int parentX,
                                          int parentY,
                                          int w,
                                          int h,
                                          int childMinX,
                                          int childMinY,
                                          int[] bandList)

Возвращает новый WritableRaster, который совместно использует все или часть DataBuffer этого WritableRaster. Новый WritableRaster будет обладать ссылкой на текущий WritableRaster, доступный через его getParent () и getWritableParent () методы.

parentX, parentY, width и параметры height формируют Прямоугольник в координатном пространстве этого WritableRaster, указывая на область пикселей, которые будут совместно использованы. Ошибка будет брошена, если этот Прямоугольник не будет содержаться с границами текущего WritableRaster.

Новый WritableRaster может дополнительно быть преобразован в различную систему координат для плоскости чем используемое текущим WritableRaster. childMinX и childMinY параметры дают новое (x, y) координата верхнего левого пикселя возвращенного WritableRaster; координата (childMinX, childMinY) в новом WritableRaster отобразится на тот же самый пиксель как координата (parentX, parentY) в текущем WritableRaster.

Новый WritableRaster может быть определен, чтобы содержать только подмножество полос текущего WritableRaster, возможно переупорядоченного, посредством bandList параметра. Если bandList является нулем, он берется, чтобы включать все полосы текущего WritableRaster в их текущем порядке.

Чтобы создать новый WritableRaster, который содержит подобласть текущего WritableRaster, но совместно использует его систему координат и полосы, этот метод нужно вызвать с childMinX, равным parentX, childMinY равный parentY, и bandList равный нулю.

Параметры:

parentX - X координат левого верхнего угла в координатах этого WritableRaster.

parentY - Y координата левого верхнего угла в координатах этого WritableRaster.

w - Ширина области, запускающейся в (parentX, parentY).

h - Высота области, запускающейся в (parentX, parentY).

childMinX - X координат левого верхнего угла возвращенного WritableRaster.

childMinY - Y координата левого верхнего угла возвращенного WritableRaster.

bandList - Массив индексов полосы, или нуль, чтобы использовать все полосы.

Возвраты:

a WritableRaster совместное использование всех или части DataBuffer из этого WritableRaster.

Броски:

RasterFormatException - если подобласть за пределами растровых границ.

RasterFormatException - если w или h меньше чем или равно нулю, или вычисляющий любой из parentX + w, parentY + h, childMinX + w, или childMinY + h результаты в целочисленном переполнении

setDataElements

public void setDataElements(int x,
                            int y,
                            Object inData)

Устанавливает данные для единственного пикселя от примитивного массива типа TransferType. Для данных изображения, поддерживаемых Java, 2-D (ТМ) API, это будет одним из DataBuffer. TYPE_BYTE, DataBuffer. TYPE_USHORT, DataBuffer. TYPE_INT, DataBuffer. TYPE_SHORT, DataBuffer. TYPE_FLOAT, или DataBuffer. TYPE_DOUBLE. Данные в массиве могут быть в упакованном формате, таким образом увеличивая эффективность для передач данных. ArrayIndexOutOfBoundsException может быть брошен, если координаты не находятся в границах, или если inData не является достаточно большим, чтобы содержать пиксельные данные. Однако, явная проверка границ не гарантируется. ClassCastException будет брошен, если входной объект не будет нулем и сошлется на что-нибудь кроме массива TransferType.

Параметры:

x - X координат пиксельного расположения.

y - Координата Y пиксельного расположения.

inData - Ссылка на объект на массив типа, определенного getTransferType () и длина getNumDataElements () содержащий пиксельные данные, чтобы поместить в x, y.

Броски:

ArrayIndexOutOfBoundsException - если координаты не находятся в границах, или если inData является слишком маленьким, чтобы содержать ввод.

См. Также:

SampleModel.setDataElements(int, int, Object, DataBuffer)

setDataElements

public void setDataElements(int x,
                            int y,
                            Raster inRaster)

Устанавливает данные для прямоугольника пикселей от входного Растра. Входной Растр должен быть совместимым с этим WritableRaster, в котором у них должно быть то же самое число полос, у соответствующих полос должно быть то же самое число битов на выборку, TransferTypes и NumDataElements должны быть тем же самым, и упаковка, используемая getDataElements/setDataElements, должна быть идентичной. ArrayIndexOutOfBoundsException может быть брошен, если координаты не находятся в границах. Однако, явная проверка границ не гарантируется.

Параметры:

x - X координат пиксельного расположения.

y - Координата Y пиксельного расположения.

inRaster - Растр, содержащий данные, чтобы поместить в x, y.

Броски:

NullPointerException - если inRaster является нулем.

ArrayIndexOutOfBoundsException - если координаты не находятся в границах.

setDataElements

public void setDataElements(int x,
                            int y,
                            int w,
                            int h,
                            Object inData)

Устанавливает данные для прямоугольника пикселей от примитивного массива типа TransferType. Для данных изображения, поддерживаемых Java 2-D API, это будет одним из DataBuffer. TYPE_BYTE, DataBuffer. TYPE_USHORT, DataBuffer. TYPE_INT, DataBuffer. TYPE_SHORT, DataBuffer. TYPE_FLOAT, или DataBuffer. TYPE_DOUBLE. Данные в массиве могут быть в упакованном формате, таким образом увеличивая эффективность для передач данных. ArrayIndexOutOfBoundsException может быть брошен, если координаты не находятся в границах, или если inData не является достаточно большим, чтобы содержать пиксельные данные. Однако, явная проверка границ не гарантируется. ClassCastException будет брошен, если входной объект не будет нулем и сошлется на что-нибудь кроме массива TransferType.

Параметры:

x - X координат верхнего левого пиксельного расположения.

y - Координата Y верхнего левого пиксельного расположения.

w - Ширина пиксельного прямоугольника.

h - Высота пиксельного прямоугольника.

inData - Ссылка на объект на массив типа, определенного getTransferType () и длина w*h*getNumDataElements () содержащий пиксельные данные, чтобы поместить между x, y и x+w-1, y+h-1.

Броски:

NullPointerException - если inData является нулем.

ArrayIndexOutOfBoundsException - если координаты не находятся в границах, или если inData является слишком маленьким, чтобы содержать ввод.

См. Также:

SampleModel.setDataElements(int, int, int, int, Object, DataBuffer)

setRect

public void setRect(Raster srcRaster)

Пиксели копий от Растра srcRaster к этому WritableRaster. Каждый пиксель в srcRaster копируется в тот же самый x, y адрес в этом растре, если адрес не падает вне границ этого растра. у srcRaster должно быть то же самое число полос как этот WritableRaster. Копия является простой копией исходных выборок к соответствующим целевым выборкам.

Если все выборки и источника и целевых Растров имеют целочисленный тип и меньше чем или равны 32 битам в размере, то вызов этого метода эквивалентен выполнению следующего кода для всех x,y адреса, допустимые в обоих Растрах.

       Raster srcRaster;
       WritableRaster dstRaster;
       for (int b = 0; b < srcRaster.getNumBands(); b++) {
           dstRaster.setSample(x, y, b, srcRaster.getSample(x, y, b));
       }
 

Thus, when copying an integral type source to an integral type destination, if the source sample size is greater than the destination sample size for a particular band, the high order bits of the source sample are truncated. If the source sample size is less than the destination size for a particular band, the high order bits of the destination are zero-extended or sign-extended depending on whether srcRaster's SampleModel treats the sample as a signed or unsigned quantity.

When copying a float or double source to an integral type destination, each source sample is cast to the destination type. When copying an integral type source to a float or double destination, the source is first converted to a 32-bit int (if necessary), using the above rules for integral types, and then the int is cast to float or double.

Parameters:

srcRaster - The Raster from which to copy pixels.

Throws:

NullPointerException - if srcRaster is null.

setRect

public void setRect(int dx,
                    int dy,
                    Raster srcRaster)

Copies pixels from Raster srcRaster to this WritableRaster. For each (x, y) address in srcRaster, the corresponding pixel is copied to address (x+dx, y+dy) in this WritableRaster, unless (x+dx, y+dy) falls outside the bounds of this raster. srcRaster must have the same number of bands as this WritableRaster. The copy is a simple copy of source samples to the corresponding destination samples. For details, see setRect(Raster).

Parameters:

dx - The X translation factor from src space to dst space of the copy.

dy - The Y translation factor from src space to dst space of the copy.

srcRaster - The Raster from which to copy pixels.

Throws:

NullPointerException - if srcRaster is null.

setPixel

public void setPixel(int x,
                     int y,
                     int[] iArray)

Sets a pixel in the DataBuffer using an int array of samples for input. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the pixel location.

y - The Y coordinate of the pixel location.

iArray - The input samples in a int array.

Throws:

NullPointerException - if iArray is null.

ArrayIndexOutOfBoundsException - if the coordinates are not in bounds, or if iArray is too small to hold the input.

setPixel

public void setPixel(int x,
                     int y,
                     float[] fArray)

Sets a pixel in the DataBuffer using a float array of samples for input. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the pixel location.

y - The Y coordinate of the pixel location.

fArray - The input samples in a float array.

Throws:

NullPointerException - if fArray is null.

ArrayIndexOutOfBoundsException - if the coordinates are not in bounds, or if fArray is too small to hold the input.

setPixel

public void setPixel(int x,
                     int y,
                     double[] dArray)

Sets a pixel in the DataBuffer using a double array of samples for input. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the pixel location.

y - The Y coordinate of the pixel location.

dArray - The input samples in a double array.

Throws:

NullPointerException - if dArray is null.

ArrayIndexOutOfBoundsException - if the coordinates are not in bounds, or if dArray is too small to hold the input.

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      int[] iArray)

Sets all samples for a rectangle of pixels from an int array containing one sample per array element. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the upper left pixel location.

y - The Y coordinate of the upper left pixel location.

w - Width of the pixel rectangle.

h - Height of the pixel rectangle.

iArray - The input int pixel array.

Throws:

NullPointerException - if iArray is null.

ArrayIndexOutOfBoundsException - if the coordinates are not in bounds, or if iArray is too small to hold the input.

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      float[] fArray)

Sets all samples for a rectangle of pixels from a float array containing one sample per array element. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the upper left pixel location.

y - The Y coordinate of the upper left pixel location.

w - Width of the pixel rectangle.

h - Height of the pixel rectangle.

fArray - The input float pixel array.

Throws:

NullPointerException - if fArray is null.

ArrayIndexOutOfBoundsException - if the coordinates are not in bounds, or if fArray is too small to hold the input.

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      double[] dArray)

Sets all samples for a rectangle of pixels from a double array containing one sample per array element. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the upper left pixel location.

y - The Y coordinate of the upper left pixel location.

w - Width of the pixel rectangle.

h - Height of the pixel rectangle.

dArray - The input double pixel array.

Throws:

NullPointerException - if dArray is null.

ArrayIndexOutOfBoundsException - if the coordinates are not in bounds, or if dArray is too small to hold the input.

setSample

public void setSample(int x,
                      int y,
                      int b,
                      int s)

Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using an int for input. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the pixel location.

y - The Y coordinate of the pixel location.

b - The band to set.

s - The input sample.

Throws:

ArrayIndexOutOfBoundsException - if the coordinates or the band index are not in bounds.

setSample

public void setSample(int x,
                      int y,
                      int b,
                      float s)

Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using a float for input. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the pixel location.

y - The Y coordinate of the pixel location.

b - The band to set.

s - The input sample as a float.

Throws:

ArrayIndexOutOfBoundsException - if the coordinates or the band index are not in bounds.

setSample

public void setSample(int x,
                      int y,
                      int b,
                      double s)

Sets a sample in the specified band for the pixel located at (x,y) in the DataBuffer using a double for input. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the pixel location.

y - The Y coordinate of the pixel location.

b - The band to set.

s - The input sample as a double.

Throws:

ArrayIndexOutOfBoundsException - if the coordinates or the band index are not in bounds.

setSamples

public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       int[] iArray)

Sets the samples in the specified band for the specified rectangle of pixels from an int array containing one sample per array element. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the upper left pixel location.

y - The Y coordinate of the upper left pixel location.

w - Width of the pixel rectangle.

h - Height of the pixel rectangle.

b - The band to set.

iArray - The input int sample array.

Throws:

NullPointerException - if iArray is null.

ArrayIndexOutOfBoundsException - if the coordinates or the band index are not in bounds, or if iArray is too small to hold the input.

setSamples

public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       float[] fArray)

Sets the samples in the specified band for the specified rectangle of pixels from a float array containing one sample per array element. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the upper left pixel location.

y - The Y coordinate of the upper left pixel location.

w - Width of the pixel rectangle.

h - Height of the pixel rectangle.

b - The band to set.

fArray - The input float sample array.

Throws:

NullPointerException - if fArray is null.

ArrayIndexOutOfBoundsException - if the coordinates or the band index are not in bounds, or if fArray is too small to hold the input.

setSamples

public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       double[] dArray)

Sets the samples in the specified band for the specified rectangle of pixels from a double array containing one sample per array element. An ArrayIndexOutOfBoundsException may be thrown if the coordinates are not in bounds. However, explicit bounds checking is not guaranteed.

Parameters:

x - The X coordinate of the upper left pixel location.

y - The Y coordinate of the upper left pixel location.

w - Width of the pixel rectangle.

h - Height of the pixel rectangle.

b - The band to set.

dArray - The input double sample array.

Throws:

NullPointerException - if dArray is null.

ArrayIndexOutOfBoundsException - if the coordinates or the band index are not in bounds, or if dArray is too small to hold the input.