Класс WritableRaster

protected WritableRaster(SampleModel sampleModel, Point origin)

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

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

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

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. Обратите внимание, что этот конструктор обычно должен вызываться другими конструкторами или методами создания, а не использоваться напрямую.

public WritableRaster getWritableParent()

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

public WritableRaster createWritableTranslatedChild(int childMinX, int childMinY)

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

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 равен null, предполагается, что он включает все каналы текущего WritableRaster в их текущем порядке.

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

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 недостаточно велик для хранения данных пикселей. Однако гарантии явного проверки границ нет. Если входной объект не null и ссылается на что-либо, кроме массива типа TransferType, будет выброшено ClassCastException.

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

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

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.

public void setRect(Raster srcRaster)

Копирует пиксели из Raster 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));
       }
 

Таким образом, при копировании источника целого типа в целочисленный тип назначения, если размер образца источника больше размера образца назначения для определённой полосы, старшие биты образца источника усекаются. Если размер образца источника меньше размера назначения для определенной полосы, старшие биты назначения дополняются нулями или знаком в зависимости от того, рассматривает ли SampleModel srcRaster образец как знаковое или беззнаковое количество.

При копировании плавающего или двойного типа источника в целочисленный тип назначения каждый образец источника преобразуется в тип назначения. При копировании целочисленного типа источника в тип float или double сначала исходный образец преобразуется в 32-битовое целое число (при необходимости), используя приведенные выше правила для целочисленных типов, а затем целое число приводится к float или double.

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).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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