Класс WritableRaster

protected WritableRaster(SampleModel sampleModel, Point origin)

Создаёт WritableRaster с заданным SampleModel. Верхний левый угол WritableRaster — origin, а его размеры совпадают с размерами SampleModel. Буфер данных достаточной длины для описания 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(tm), это будет один из 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 setDataElements(int x, int y, Raster inRaster)

Задает данные для прямоугольника пикселей из входного Raster. Входной Raster должен быть совместим с этим WritableRaster, то есть у них должно быть одинаковое количество каналов, соответствующие каналы должны иметь одинаковое количество битов на образец, TransferType и 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 образец как знаковое или беззнаковое значение.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Устанавливает образец в указанной полосе для пикселя, расположенного в (x,y) в DataBuffer, используя число с плавающей запятой для ввода. Может быть брошено исключение 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, если координаты выходят за пределы границ. Однако явная проверка границ не гарантируется.