Класс WritableRaster

Этот класс расширяет Raster, предоставляя возможности записи пикселей. Обратитесь к комментарию к классу Raster для описания того, как Raster хранит пиксели.

Конструкторы этого класса защищены. Для создания WritableRaster используйте один из методов-фабрик createWritableRaster в классе Raster.

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

WritableRaster

protected WritableRaster(SampleModel sampleModel,
                         Point origin)

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

Параметры:

sampleModel - SampleModel, определяющий структуру.

origin - Точка, определяющая origin.

Исключения:

RasterFormatException - если вычисление либо origin.x + sampleModel.getWidth(), либо origin.y + sampleModel.getHeight() приводит к переполнению целого числа

WritableRaster

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

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

Параметры:

sampleModel - SampleModel, определяющий структуру.

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

origin - Точка, определяющая 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 определяет прямоугольник границ нового Raster. При переводе в систему координат базового Raster, aRegion должен быть частью базового Raster. (Базовый Raster - это предок Raster, у которого нет родителя.) sampleModelTranslate задаёт значения sampleModelTranslateX и sampleModelTranslateY нового Raster. Обратите внимание, что этот конструктор, как правило, вызывается другими конструкторами или методами create, а не используется напрямую.

Параметры:

sampleModel - SampleModel, определяющий структуру.

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

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

sampleModelTranslate - Точка, определяющая сдвиг от координат SampleModel к координатам Raster.

parent - Родительский элемент (если есть) этого raster.

Исключения:

RasterFormatException - если у aRegion ширина или высота меньше или равны нулю, или вычисление либо aRegion.x + aRegion.width, либо aRegion.y + aRegion.height приводит к переполнению целого числа

Методы

getWritableParent

public WritableRaster getWritableParent()

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

Возвращает:

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

createWritableTranslatedChild

public WritableRaster createWritableTranslatedChild(int childMinX,
                                                    int childMinY)

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

Параметры:

childMinX - Координата X верхнего левого угла нового Raster.

childMinY - Координата Y верхнего левого угла нового Raster.

Возвращает:

новый 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)

Параметры:

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

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

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

h - Высота области, начинающейся в (parentX, parentY).

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

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

bandList - Массив индексов каналов или null для использования всех каналов.

Возвращает:

новый WritableRaster, разделяющий все или часть DataBuffer этого WritableRaster.

Исключения:

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

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

setDataElements

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

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

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

Параметры:

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

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

inRaster - Raster, содержащий данные, которые нужно поместить в x,y.

Исключения:

NullPointerException - если inRaster равен null.

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

setDataElements

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

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

Параметры:

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

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

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

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

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

Исключения:

NullPointerException - если inData равен null.

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

См. также:

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

setRect

public void setRect(Raster srcRaster)

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

Параметры:

srcRaster - Растр, из которого копируются пиксели.

Исключения:

NullPointerException - если srcRaster имеет значение null.

setRect

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

Копирует пиксели из Raster srcRaster в этот WritableRaster. Для каждого адреса (x, y) в srcRaster соответствующий пиксель копируется в адрес (x+dx, y+dy) в этом WritableRaster, если только (x+dx, y+dy) не выходит за границы этого растра. srcRaster должен иметь такое же количество полос, как и этот WritableRaster. Копирование представляет собой простое копирование образцов источника в соответствующие образцы назначения. Для получения подробной информации см. setRect(Raster).

Параметры:

dx - Коэффициент сдвига X из пространства src в пространство dst копии.

dy - Коэффициент сдвига Y из пространства src в пространство dst копии.

srcRaster - Растр, из которого копируются пиксели.

Исключения:

NullPointerException - если srcRaster имеет значение null.

setPixel

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

Устанавливает пиксель в DataBuffer, используя целочисленный массив образцов для ввода. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

iArray - Входные образцы в целочисленном массиве.

Исключения:

NullPointerException - если iArray имеет значение null.

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

setPixel

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

Устанавливает пиксель в DataBuffer, используя массив типа float образцов для ввода. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

fArray - Входные образцы в массиве типа float.

Исключения:

NullPointerException - если fArray имеет значение null.

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

setPixel

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

Устанавливает пиксель в DataBuffer, используя массив типа double образцов для ввода. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

dArray - Входные образцы в массиве типа double.

Исключения:

NullPointerException - если dArray имеет значение null.

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

setPixels

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

Устанавливает все образцы для прямоугольника пикселей из целочисленного массива, содержащего один образец на элемент массива. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

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

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

iArray - Входной целочисленный массив пикселей.

Исключения:

NullPointerException - если iArray имеет значение null.

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

setPixels

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

Устанавливает все образцы для прямоугольника пикселей из массива типа float, содержащего один образец на элемент массива. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

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

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

fArray - Входной массив пикселей типа float.

Исключения:

NullPointerException - если fArray имеет значение null.

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

setPixels

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

Устанавливает все образцы для прямоугольника пикселей из массива типа double, содержащего один образец на элемент массива. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

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

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

dArray - Входной массив пикселей типа double.

Исключения:

NullPointerException - если dArray имеет значение null.

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

setSample

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

Устанавливает образец в указанной полосе для пикселя, расположенного в точке (x,y) в DataBuffer, используя целое число для ввода. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

b - Полоса для установки.

s - Входной образец.

Исключения:

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

setSample

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

Устанавливает образец в указанной полосе для пикселя, расположенного в точке (x,y) в DataBuffer, используя значение типа float для ввода. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

b - Полоса для установки.

s - Входной образец как float.

Исключения:

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

setSample

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

Устанавливает образец в указанной полосе для пикселя, расположенного в точке (x,y) в DataBuffer, используя значение типа double для ввода. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

b - Полоса для установки.

s - Входной образец как double.

Исключения:

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

setSamples

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

Устанавливает образцы в указанной полосе для указанного прямоугольника пикселей из целочисленного массива, содержащего один образец на элемент массива. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

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

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

b - Полоса для установки.

iArray - Входной целочисленный массив образцов.

Исключения:

NullPointerException - если iArray имеет значение null.

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

setSamples

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

Устанавливает образцы в указанной полосе для указанного прямоугольника пикселей из массива типа float, содержащего один образец на элемент массива. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты находятся за пределами границ. Однако явная проверка границ не гарантируется.

Параметры:

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

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

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

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

b - Полоса для установки.

fArray - Входной массив сэмплов с плавающей точкой.

Исключения:

NullPointerException - если fArray равен null.

ArrayIndexOutOfBoundsException - если координаты или индекс полосы выходят за пределы, или если fArray слишком мал для хранения входных данных.

setSamples

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

Устанавливает сэмплы в указанной полосе для указанного прямоугольника пикселей из массива с двойной точностью, содержащего по одному сэмплу на элемент массива. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты выходят за пределы. Однако явное проверка границ не гарантируется.

Параметры:

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

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

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

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

b - Полоса для установки.

dArray - Входной массив сэмплов с двойной точностью.

Исключения:

NullPointerException - если dArray равен null.

ArrayIndexOutOfBoundsException - если координаты или индекс полосы выходят за пределы, или если dArray слишком мал для хранения входных данных.