Класс ComponentSampleModel

Поля

bandOffsets

protected int[] bandOffsets

Смещения для всех полос в элементах массива данных.

bankIndices

protected int[] bankIndices

Индекс каждого банка, хранящего полосу данных изображения.

numBands

protected int numBands

Количество полос в этом ComponentSampleModel.

numBanks

protected int numBanks

Количество банков в этом ComponentSampleModel.

scanlineStride

protected int scanlineStride

Шаг строки (в элементах массива данных) области данных изображения, описываемой этим ComponentSampleModel.

pixelStride

protected int pixelStride

Шаг пикселя (в элементах массива данных) области данных изображения, описываемой этим ComponentSampleModel.

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

ComponentSampleModel

public ComponentSampleModel(int dataType,
                            int w,
                            int h,
                            int pixelStride,
                            int scanlineStride,
                            int[] bandOffsets)

Создаёт ComponentSampleModel с указанными параметрами. Количество полос будет задаваться длиной массива bandOffsets. Все полосы будут храниться в первом банке DataBuffer.

Параметры:

dataType - тип данных для хранения образцов

w - ширина (в пикселях) области данных изображения, описываемой

h - высота (в пикселях) области данных изображения, описываемой

pixelStride - шаг пикселя области данных изображения, описываемой

scanlineStride - шаг строки области данных изображения, описываемой

bandOffsets - смещения всех полос

Исключения:

IllegalArgumentException - если w или h не больше 0

IllegalArgumentException - если pixelStride меньше 0

IllegalArgumentException - если scanlineStride меньше 0

IllegalArgumentException - если numBands меньше 1

IllegalArgumentException - если произведение w и h больше Integer.MAX_VALUE

IllegalArgumentException - если dataType не является одним из поддерживаемых типов данных

ComponentSampleModel

public ComponentSampleModel(int dataType,
                            int w,
                            int h,
                            int pixelStride,
                            int scanlineStride,
                            int[] bankIndices,
                            int[] bandOffsets)

Создаёт ComponentSampleModel с указанными параметрами. Количество полос будет задаваться длиной массива bandOffsets. Разные полосы могут храниться в разных банках DataBuffer.

Параметры:

dataType - тип данных для хранения образцов

w - ширина (в пикселях) области данных изображения, описываемой

h - высота (в пикселях) области данных изображения, описываемой

pixelStride - шаг пикселя области данных изображения, описываемой

scanlineStride - Шаг строки области данных изображения, описываемой

bankIndices - индексы банков всех полос

bandOffsets - смещения всех полос

Исключения:

IllegalArgumentException - если w или h не больше 0

IllegalArgumentException - если pixelStride меньше 0

IllegalArgumentException - если scanlineStride меньше 0

IllegalArgumentException - если длина bankIndices не равна длине bankOffsets

IllegalArgumentException - если любой из индексов банков bandIndices меньше 0

IllegalArgumentException - если dataType не является одним из поддерживаемых типов данных

Методы

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

Создаёт новый ComponentSampleModel с заданной шириной и высотой. Новый SampleModel будет иметь то же количество полос, тип данных, схему интерливирования и шаг пикселя, что и этот SampleModel.

Определено в:

createCompatibleSampleModel в классе SampleModel

Параметры:

w - ширина результирующего SampleModel

h - высота результирующего SampleModel

Возвращает:

новый ComponentSampleModel заданного размера

Исключения:

IllegalArgumentException - если w или h не больше 0

createSubsetSampleModel

public SampleModel createSubsetSampleModel(int[] bands)

Создаёт новый ComponentSampleModel с подмножеством полос этого ComponentSampleModel. Новый ComponentSampleModel может использоваться с любым DataBuffer, с которым может использоваться существующий ComponentSampleModel. Новая комбинация ComponentSampleModel/DataBuffer будет представлять изображение с подмножеством полос исходной комбинации ComponentSampleModel/DataBuffer.

Определено в:

createSubsetSampleModel в классе SampleModel

Параметры:

bands - подмножество полос из этого ComponentSampleModel

Возвращает:

ComponentSampleModel созданный с подмножеством полос из этого ComponentSampleModel.

createDataBuffer

public DataBuffer createDataBuffer()

Создаёт DataBuffer, соответствующий этому ComponentSampleModel. Тип данных, количество банков и размер объекта DataBuffer будут соответствовать этому ComponentSampleModel.

Определено в:

createDataBuffer в классе SampleModel

Возвращает:

DataBuffer, тип данных, количество банков и размер которого соответствуют этому ComponentSampleModel.

getOffset

public int getOffset(int x,
                     int y)

Получает смещение для первой полосы пикселя (x,y). Образец первой полосы можно получить из DataBuffer с ComponentSampleModel, как data с ComponentSampleModel csm как

data.getElem(csm.getOffset(x, y));

Параметры:

x - положение X пикселя

y - положение Y пикселя

Возвращает:

смещение для первой полосы указанного пикселя.

getOffset

public int getOffset(int x,
                     int y,
                     int b)

Получает смещение для полосы b пикселя (x,y). Образец полосы b можно получить из DataBuffer с ComponentSampleModel, как data с ComponentSampleModel csm как

data.getElem(csm.getOffset(x, y, b));

Параметры:

x - положение X указанного пикселя

y - положение Y указанного пикселя

b - указанная полоса

Возвращает:

смещение для указанной полосы указанного пикселя.

getSampleSize

public final int[] getSampleSize()

Возвращает количество бит на образец для всех полос.

Определено в:

getSampleSize в классе SampleModel

Возвращает:

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

getSampleSize

public final int getSampleSize(int band)

Возвращает количество бит на образец для указанной полосы.

Определено в:

getSampleSize в классе SampleModel

Параметры:

band - указанная полоса

Возвращает:

количество бит на образец для указанной полосы.

getBankIndices

public final int[] getBankIndices()

Возвращает индексы банков для всех полос.

Возвращает:

индексы банков для всех полос.

getBandOffsets

public final int[] getBandOffsets()

Возвращает смещение полос для всех полос.

Возвращает:

смещения полос для всех полос.

getScanlineStride

public final int getScanlineStride()

Возвращает шаг строки этого ComponentSampleModel.

Возвращает:

шаг строки этого ComponentSampleModel.

getPixelStride

public final int getPixelStride()

Возвращает шаг пикселя этого ComponentSampleModel.

Возвращает:

шаг пикселя этого ComponentSampleModel.

getNumDataElements

public final int getNumDataElements()

Возвращает количество элементов данных, необходимых для передачи пикселя с помощью методов getDataElements(int, int, Object, DataBuffer) и setDataElements(int, int, Object, DataBuffer). Для ComponentSampleModel это идентично количеству полос.

Определено в:

getNumDataElements в классе SampleModel

Возвращает:

количество элементов данных, необходимых для передачи пикселя с помощью методов getDataElements и setDataElements.

См. также:

SampleModel.getNumDataElements(), SampleModel.getNumBands()

getDataElements

public Object getDataElements(int x,
                              int y,
                              Object obj,
                              DataBuffer data)

ComponentSampleModel csm1, csm2;
       DataBufferInt db1, db2;
       csm2.setDataElements(x, y,
                            csm1.getDataElements(x, y, null, db1), db2);

Указано:

getDataElements в классе SampleModel

Параметры:

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

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

obj - если не null, массив для возврата данных пикселя

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

Возвращает:

данные указанного пикселя

Исключения:

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

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

См. также:

setDataElements(int, int, Object, DataBuffer)

getPixel

public int[] getPixel(int x,
                      int y,
                      int[] iArray,
                      DataBuffer data)

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

Переопределяет:

getPixel в классе SampleModel

Параметры:

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

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

iArray - если не null, возвращает образцы в этом массиве

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

Возвращает:

образцы указанного пикселя.

Исключения:

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

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

См. также:

setPixel(int, int, int[], DataBuffer)

getPixels

public int[] getPixels(int x,
                       int y,
                       int w,
                       int h,
                       int[] iArray,
                       DataBuffer data)

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

Переопределяет:

getPixels в классе SampleModel

Параметры:

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

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

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

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

iArray - если не null, возвращает образцы в этом массиве

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

Возвращает:

образцы пикселей в указанном регионе.

См. также:

setPixels(int, int, int, int, int[], DataBuffer)

getSample

public int getSample(int x,
                     int y,
                     int b,
                     DataBuffer data)

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

Указано:

getSample в классе SampleModel

Параметры:

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

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

b - канал для возврата

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

Возвращает:

образец в указанном канале для указанного пикселя

См. также:

setSample(int, int, int, int, DataBuffer)

getSampleFloat

public float getSampleFloat(int x,
                            int y,
                            int b,
                            DataBuffer data)

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

Переопределяет:

getSampleFloat в классе SampleModel

Параметры:

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

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

b - Возвращаемый канал

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

Возвращает:

значение с плавающей запятой, представляющее образец в указанном канале для указанного пикселя.

getSampleDouble

public double getSampleDouble(int x,
                              int y,
                              int b,
                              DataBuffer data)

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

Переопределяет:

getSampleDouble в классе SampleModel

Параметры:

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

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

b - Возвращаемый канал

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

Возвращает:

значение двойной точности, представляющее образец в указанном канале для указанного пикселя.

getSamples

public int[] getSamples(int x,
                        int y,
                        int w,
                        int h,
                        int b,
                        int[] iArray,
                        DataBuffer data)

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

Переопределяет:

getSamples в классе SampleModel

Параметры:

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

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

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

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

b - канал для возврата

iArray - если не null, возвращает образцы в этом массиве

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

Возвращает:

образцы в указанном канале указанного пикселя

См. также:

setSamples(int, int, int, int, int, int[], DataBuffer)

setDataElements

public void setDataElements(int x,
                            int y,
                            Object obj,
                            DataBuffer data)

ComponentSampleModel csm1, csm2;
       DataBufferInt db1, db2;
       csm2.setDataElements(x, y, csm1.getDataElements(x, y, null, db1),
                            db2);

Указано:

setDataElements в классе SampleModel

Параметры:

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

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

obj - массив, содержащий данные пикселя

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

См. также:

getDataElements(int, int, Object, DataBuffer)

setPixel

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

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

Переопределяет:

setPixel в классе SampleModel

Параметры:

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

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

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

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

См. также:

getPixel(int, int, int[], DataBuffer)

setPixels

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

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

Переопределяет:

setPixels в классе SampleModel

Параметры:

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

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

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

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

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

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

См. также:

getPixels(int, int, int, int, int[], DataBuffer)

setSample

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

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

Определяется в:

setSample в классе SampleModel

Параметры:

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

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

b - полоса для задания

s - входное значение образца как целое число

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

См. также:

getSample(int, int, int, DataBuffer)

setSample

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

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

Переопределяет:

setSample в классе SampleModel

Параметры:

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

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

b - полоса для задания

s - входное значение образца как значение с плавающей точкой

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

См. также:

getSample(int, int, int, DataBuffer)

setSample

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

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

Переопределяет:

setSample в классе SampleModel

Параметры:

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

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

b - полоса для задания

s - входное значение образца как значение с двойной точностью

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

См. также:

getSample(int, int, int, DataBuffer)

setSamples

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

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

Переопределяет:

setSamples в классе SampleModel

Параметры:

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

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

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

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

b - полоса для задания

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

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

См. также:

getSamples(int, int, int, int, int, int[], DataBuffer)

equals

public boolean equals(Object o)

Описание скопировано из класса: Object

Переопределяет:

equals в классе Object

Параметры:

o - объект-ссылка, с которым нужно сравнить.

Возвращает:

true если этот объект такой же, как аргумент obj; false в противном случае.

См. также:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Описание скопировано из класса: Object

Переопределяет:

hashCode в классе Object

Возвращает:

значение кода хеширования для этого объекта.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)