java.awt.image

Класс BandedSampleModel

java.lang. Объект

java.awt.image. SampleModel

java.awt.image. ComponentSampleModel

java.awt.image. BandedSampleModel

public final class BandedSampleModel
extends ComponentSampleModel

Этот class представляет данные изображения, которые хранятся в полосе чередованный вид и для которого каждая выборка пикселя занимает один элемент данных DataBuffer. Это разделяет ComponentSampleModel на подклассы, но обеспечивает больше efficent реализации для того, чтобы оно получило доступ к полосе чередованные данные изображения, чем обеспечивается ComponentSampleModel. Этот class должен обычно использоваться, работая с изображениями, которые хранят демонстрационные данные для каждой полосы в различном банке DataBuffer. Методы средства доступа обеспечиваются так, чтобы данными изображения можно было управлять непосредственно. Пиксельный шаг является числом элементов массива данных между двумя выборками для той же самой полосы на той же самой строке развертки. Пиксельный шаг для BandedSampleModel является тем. Шаг строки развертки является числом элементов массива данных между данной выборкой и соответствующей выборкой в том же самом столбце следующей строки развертки. Смещения полосы обозначают число элементов массива данных от первого элемента массива данных банка DataBuffer, содержащего каждую полосу к первой выборке полосы. Полосы нумеруются от 0 до N-1. Индексы банка обозначают корреспонденцию между банком буфера данных и полосой данных изображения. Этот class поддерживает TYPE_BYTE, TYPE_USHORT, TYPE_SHORT, TYPE_INT, TYPE_FLOAT, и TYPE_DOUBLE типы данных

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

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

bandOffsets, bankIndices, numBands, numBanks, pixelStride, scanlineStride

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

dataType, height, width

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

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

Конструктор и Описание
BandedSampleModel(int dataType, int w, int h, int numBands) Создает BandedSampleModel с указанными параметрами.
BandedSampleModel(int dataType, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets) Создает BandedSampleModel с указанными параметрами.

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

Модификатор и Тип	Метод и Описание
SampleModel	createCompatibleSampleModel(int w, int h) Создает новый BandedSampleModel с указанным width и height.
DataBuffer	createDataBuffer() Создает DataBuffer, который соответствует этому BandedSampleModel, типу данных DataBuffer, числу банков, и размер будет непротиворечивым с этим BandedSampleModel.
SampleModel	createSubsetSampleModel(int[] bands) Создает новый BandedSampleModel с подмножеством полос этого BandedSampleModel.
Объект	getDataElements(int x, int y, Object obj, DataBuffer data) Данные возвратов для единственного пикселя в примитивном массиве типа TransferType.
int[]	getPixel(int x, int y, int[] iArray, DataBuffer data) Возвраты все выборки для указанного пикселя в международном массиве.
int[]	getPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data) Возвраты все выборки для указанного прямоугольника пикселей в международном массиве, одна выборка на элемент массива данных.
int	getSample(int x, int y, int b, DataBuffer data) Возвраты как интервал выборка в указанной полосе для пикселя, расположенного в (x, y).
double	getSampleDouble(int x, int y, int b, DataBuffer data) Возвращает выборку в указанной полосе для пикселя, расположенного в (x, y) как двойное.
float	getSampleFloat(int x, int y, int b, DataBuffer data) Возвращает выборку в указанной полосе для пикселя, расположенного в (x, y) как плавание.
int[]	getSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data) Возвращает выборки в указанной полосе для указанного прямоугольника пикселей в международном массиве, одну выборку на элемент массива данных.
int	hashCode() Возвращает значение хэш-кода для объекта.
void	setDataElements(int x, int y, Object obj, DataBuffer data) Устанавливает данные для единственного пикселя в указанном DataBuffer от примитивного массива типа TransferType.
void	setPixel(int x, int y, int[] iArray, DataBuffer data) Устанавливает пиксель в DataBuffer, используя международный массив выборок для ввода.
void	setPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data) Наборы все выборки для прямоугольника пикселей от международного массива, содержащего одну выборку на элемент массива.
void	setSample(int x, int y, int b, double s, DataBuffer data) Устанавливает выборку в указанной полосе для пикселя, расположенного в (x, y) в DataBuffer, используя двойное для ввода.
void	setSample(int x, int y, int b, float s, DataBuffer data) Устанавливает выборку в указанной полосе для пикселя, расположенного в (x, y) в DataBuffer, используя плавание для ввода.
void	setSample(int x, int y, int b, int s, DataBuffer data) Устанавливает выборку в указанной полосе для пикселя, расположенного в (x, y) в DataBuffer, используя интервал для ввода.
void	setSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data) Устанавливает выборки в указанной полосе для указанного прямоугольника пикселей от международного массива, содержащего одну выборку на элемент массива данных.

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

equals, getBandOffsets, getBankIndices, getNumDataElements, getOffset, getOffset, getPixelStride, getSampleSize, getSampleSize, getScanlineStride

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

getDataElements, getDataType, getHeight, getNumBands, getPixel, getPixel, getPixels, getPixels, getSamples, getSamples, getTransferType, getWidth, setDataElements, setPixel, setPixel, setPixels, setPixels, setSamples, setSamples

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

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

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

BandedSampleModel

public BandedSampleModel(int dataType,
                         int w,
                         int h,
                         int numBands)

Создает BandedSampleModel с указанными параметрами. Пиксельный шаг будет одним элементом данных. Шаг строки развертки будет тем же самым как width. Каждая полоса будет сохранена в отдельном банке, и все смещения полосы будут нулем.

Параметры:

dataType - Тип данных для того, чтобы сохранить выборки.

w - width (в пикселях) области данных изображения описывается.

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

numBands - Число полос для данных изображения.

Броски:

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

BandedSampleModel

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

Создает BandedSampleModel с указанными параметрами. Число полос будет выведено из длин bandOffsets bankIndices массивы, которые должны быть равными. Пиксельный шаг будет одним элементом данных.

Параметры:

dataType - Тип данных для того, чтобы сохранить выборки.

w - width (в пикселях) области данных изображения описывается.

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

scanlineStride - Шаг строки данных изображения.

bankIndices - Банк индексирует для каждой полосы.

bandOffsets - Полоса смещается для каждой полосы.

Броски:

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

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

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

Создает новый BandedSampleModel с указанным width и height. У нового BandedSampleModel будет то же самое число полос, типа данных хранения, и индексов банка как этот BandedSampleModel. Смещения полосы будут сжаты так, что, смещение между полосами будет w*pixelStride, и минимум всех смещений полосы является нулем.

Переопределения:

createCompatibleSampleModel в class ComponentSampleModel

Параметры:

w - width получающегося BandedSampleModel

h - height получающегося BandedSampleModel

Возвраты:

новое BandedSampleModel с указанным width и height.

Броски:

IllegalArgumentException - если w или h равняется также Integer.MAX_VALUE или Integer.MIN_VALUE

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

createSubsetSampleModel

public SampleModel createSubsetSampleModel(int[] bands)

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

Переопределения:

createSubsetSampleModel в class ComponentSampleModel

Параметры:

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

Возвраты:

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

Броски:

RasterFormatException - если число полос больше чем число банков в этой демонстрационной модели.

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

createDataBuffer

public DataBuffer createDataBuffer()

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

Переопределения:

createDataBuffer в class ComponentSampleModel

Возвраты:

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

Броски:

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

getDataElements

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

Данные возвратов для единственного пикселя в примитивном массиве типа TransferType. Для BandedSampleModel это будет тем же самым как типом данных, и выборки будут возвращены один на элемент массива. Обычно, в obj нужно передать как нуль, так, чтобы Объект был создан автоматически и был правильного примитивного типа данных.

Следующий код иллюстрирует передачу данных для одного пикселя от DataBuffer db1, чье расположение хранения описывается BandedSampleModel bsm1, к DataBuffer db2, чье расположение хранения описывается BandedSampleModel bsm2. Передача обычно будет более эффективной чем использование getPixel/setPixel.

       BandedSampleModel bsm1, bsm2;
       DataBufferInt db1, db2;
       bsm2.setDataElements(x, y, bsm1.getDataElements(x, y, null, db1),
                            db2);
 

Используя getDataElements/setDataElements, чтобы передать между двумя парами DataBuffer/SampleModel законно, если у SampleModels есть то же самое число полос, у соответствующих полос есть то же самое число битов на выборку, и TransferTypes являются тем же самым.

Если obj является ненулем, это должен быть примитивный массив типа TransferType. Иначе, ClassCastException бросается. ArrayIndexOutOfBoundsException может быть брошен, если координаты не находятся в границах, или если obj является ненулем и не является достаточно большим, чтобы содержать пиксельные данные.

Переопределения:

getDataElements в class ComponentSampleModel

Параметры:

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

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

obj - Если ненуль, примитивный массив, в котором можно возвратить пиксельные данные.

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

Возвраты:

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

См. Также:

setDataElements(int, int, Object, DataBuffer)

getPixel

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

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

Переопределения:

getPixel в class ComponentSampleModel

Параметры:

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

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

iArray - Если ненуль, возвращает выборки в этом массиве

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

Возвраты:

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

См. Также:

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

getPixels

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

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

Переопределения:

getPixels в class ComponentSampleModel

Параметры:

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

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

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

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

iArray - Если ненуль, возвращает выборки в этом массиве

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 в class ComponentSampleModel

Параметры:

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 в class ComponentSampleModel

Параметры:

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

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

b - Полоса, чтобы возвратиться

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

Возвраты:

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

getSampleDouble

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

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

Переопределения:

getSampleDouble в class ComponentSampleModel

Параметры:

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)

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

Переопределения:

getSamples в class ComponentSampleModel

Параметры:

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

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

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

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

b - Полоса, чтобы возвратиться

iArray - Если ненуль, возвращает выборки в этом массиве

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

Возвраты:

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

См. Также:

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

setDataElements

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

Устанавливает данные для единственного пикселя в указанном DataBuffer от примитивного массива типа TransferType. Для BandedSampleModel это будет тем же самым как типом данных, и выборки передаются один на элемент массива.

Следующий код иллюстрирует передачу данных для одного пикселя от DataBuffer db1, чье расположение хранения описывается BandedSampleModel bsm1, к DataBuffer db2, чье расположение хранения описывается BandedSampleModel bsm2. Передача обычно будет более эффективной чем использование getPixel/setPixel.

       BandedSampleModel bsm1, bsm2;
       DataBufferInt db1, db2;
       bsm2.setDataElements(x, y, bsm1.getDataElements(x, y, null, db1),
                            db2);
 

Используя getDataElements/setDataElements, чтобы передать между двумя парами DataBuffer/SampleModel законно, если у SampleModels есть то же самое число полос, у соответствующих полос есть то же самое число битов на выборку, и TransferTypes являются тем же самым.

obj должен быть примитивным массивом типа TransferType. Иначе, ClassCastException бросается. ArrayIndexOutOfBoundsException может быть брошен, если координаты не находятся в границах, или если obj не является достаточно большим, чтобы содержать пиксельные данные.

Переопределения:

setDataElements в class ComponentSampleModel

Параметры:

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

Переопределения:

setPixel в class ComponentSampleModel

Параметры:

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

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

iArray - Входные выборки в международном массиве

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

См. Также:

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

setPixels

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

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

Переопределения:

setPixels в class ComponentSampleModel

Параметры:

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

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

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

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

iArray - Входные выборки в международном массиве

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

Переопределения:

setSample в class ComponentSampleModel

Параметры:

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 в class ComponentSampleModel

Параметры:

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 в class ComponentSampleModel

Параметры:

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 в class ComponentSampleModel

Параметры:

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

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

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

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

b - Полоса, чтобы установить

iArray - Входной демонстрационный массив

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

См. Также:

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

хэш-код

public int hashCode()

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

Возвращает значение хэш-кода для объекта. Этот метод поддерживается в пользу хэш-таблиц, таких как обеспеченные HashMap.

Общий контракт hashCode :

• Всякий раз, когда это вызывается на тот же самый объект не раз во время выполнения приложения Java, hashCode метод должен последовательно возвращать то же самое целое число, не предоставил информации, используемой в equals сравнения на объекте изменяются. Эта целочисленная потребность не остается непротиворечивой от одного выполнения приложения к другому выполнению того же самого приложения.
• Если два объекта равны согласно equals(Object) метод, затем вызывая hashCode метод на каждом из двух объектов должен привести к тому же самому целочисленному результату.
• Не требуется это, если два объекта неравны согласно Object.equals(java.lang.Object) метод, затем вызывая hashCode метод на каждом из двух объектов должен привести к отличным целочисленным результатам. Однако, программист должен знать, что приведение к отличным целочисленным результатам для неравных объектов может улучшить производительность хэш-таблиц.

Столько, сколько разумно практично, метод хэш-кода, определенный class Object действительно возвращает отличные целые числа для отличных объектов. (Это обычно реализуется, преобразовывая внутренний адрес объекта в целое число, но этот метод реализации не требуется языком программирования Java™.)

Переопределения:

hashCode в class ComponentSampleModel

Возвраты:

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

См. Также:

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