java.awt.image

Класс SinglePixelPackedSampleModel

java.lang. Объект

java.awt.image. SampleModel

java.awt.image.SinglePixelPackedSampleModel

public class SinglePixelPackedSampleModel
extends SampleModel

Этот class представляет пиксельные данные, упакованные так, что выборки N, которые составляют единственный пиксель, сохранены в единственном элементе массива данных, и каждый элемент массива данных данных содержит выборки только для одного пикселя. Этот class поддерживает TYPE_BYTE, TYPE_USHORT, TYPE_INT типы данных. Все элементы массива данных находятся в первом банке DataBuffer. Методы средства доступа обеспечиваются так, чтобы данными изображения можно было управлять непосредственно. Шаг строки развертки является числом элементов массива данных между данной выборкой и соответствующей выборкой в том же самом столбце следующей строки развертки. Битовые маски являются масками, требуемыми извлечь выборки, представляющие полосы пикселя. Разрядные смещения являются смещениями в битах в элемент массива данных выборок, представляющих полосы пикселя.

Следующий код иллюстрирует извлечение битов демонстрационной полосы представления b для пикселя x,y от DataBuffer data:

      int sample = data.getElem(y * scanlineStride + x);
      sample = (sample & bitMasks[b]) >>> bitOffsets[b];
 

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

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

dataType, height, numBands, width

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

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

Конструктор и Описание
SinglePixelPackedSampleModel(int dataType, int w, int h, int[] bitMasks) Создает SinglePixelPackedSampleModel с bitMasks.length полосами.
SinglePixelPackedSampleModel(int dataType, int w, int h, int scanlineStride, int[] bitMasks) Создает SinglePixelPackedSampleModel с bitMasks.length полосами и шагом строки развертки, равным scanlineStride элементам массива данных.

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

Модификатор и Тип	Метод и Описание
SampleModel	createCompatibleSampleModel(int w, int h) Создает новый SinglePixelPackedSampleModel с указанным width и height.
DataBuffer	createDataBuffer() Создает DataBuffer, который соответствует этому SinglePixelPackedSampleModel.
SampleModel	createSubsetSampleModel(int[] bands) Это создает новый SinglePixelPackedSampleModel с подмножеством полос этого SinglePixelPackedSampleModel.
boolean	equals(Object o) Указывает, " ли некоторый другой объект равен" этому.
int[]	getBitMasks() Возвращает битовые маски для всех полос.
int[]	getBitOffsets() Возвращает разрядные смещения в элемент массива данных, представляющий пиксель для всех полос.
Объект	getDataElements(int x, int y, Object obj, DataBuffer data) Данные возвратов для единственного пикселя в примитивном массиве типа TransferType.
int	getNumDataElements() Возвращается число элементов данных должно было передать один пиксель через getDataElements и setDataElements методы.
int	getOffset(int x, int y) Возвращает смещение (в элементах массива данных) пикселя (x, y).
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).
int[]	getSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data) Возвращает выборки для указанной полосы для указанного прямоугольника пикселей в международном массиве, одну выборку на элемент массива.
int[]	getSampleSize() Возвращает число битов на выборку для всех полос.
int	getSampleSize(int band) Возвращает число битов на выборку для указанной полосы.
int	getScanlineStride() Возвращает шаг строки развертки этого SinglePixelPackedSampleModel.
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, 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. SampleModel

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

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

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

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

SinglePixelPackedSampleModel

public SinglePixelPackedSampleModel(int dataType,
                                    int w,
                                    int h,
                                    int[] bitMasks)

Создает SinglePixelPackedSampleModel с bitMasks.length полосами. Каждая выборка сохранена в элементе массива данных в позиции его соответствующей битовой маски. Каждая битовая маска должна быть непрерывной, и маски не должны наложиться. Битовые маски, превышающие емкость типа данных, являются усеченными.

Параметры:

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

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

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

bitMasks - Битовые маски для всех полос.

Броски:

IllegalArgumentException - если dataType не также DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, или DataBuffer.TYPE_INT

SinglePixelPackedSampleModel

public SinglePixelPackedSampleModel(int dataType,
                                    int w,
                                    int h,
                                    int scanlineStride,
                                    int[] bitMasks)

Создает SinglePixelPackedSampleModel с bitMasks.length полосами и шагом строки развертки, равным scanlineStride элементам массива данных. Каждая выборка сохранена в элементе массива данных в позиции его соответствующей битовой маски. Каждая битовая маска должна быть непрерывной, и маски не должны наложиться. Битовые маски, превышающие емкость типа данных, являются усеченными.

Параметры:

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

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

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

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

bitMasks - Битовые маски для всех полос.

Броски:

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

IllegalArgumentException - если любая маска в bitMask не непрерывно

IllegalArgumentException - если dataType не также DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, или DataBuffer.TYPE_INT

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

getNumDataElements

public int getNumDataElements()

Возвращается число элементов данных должно было передать один пиксель через getDataElements и setDataElements методы. Для SinglePixelPackedSampleModel это - то.

Определенный:

getNumDataElements в class SampleModel

Возвраты:

число элементов данных.

См. Также:

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

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

Создает новый SinglePixelPackedSampleModel с указанным width и height. У нового SinglePixelPackedSampleModel будут тот же самый тип данных хранения и битовые маски как этот SinglePixelPackedSampleModel.

Определенный:

createCompatibleSampleModel в class SampleModel

Параметры:

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

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

Возвраты:

a SinglePixelPackedSampleModel с указанным width и height.

Броски:

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

createDataBuffer

public DataBuffer createDataBuffer()

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

Определенный:

createDataBuffer в class SampleModel

Возвраты:

a DataBuffer соответствие этому SampleModel.

getSampleSize

public int[] getSampleSize()

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

Определенный:

getSampleSize в class SampleModel

Возвраты:

размер выборок для всех полос.

getSampleSize

public int getSampleSize(int band)

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

Определенный:

getSampleSize в class SampleModel

Параметры:

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

Возвраты:

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

getOffset

public int getOffset(int x,
                     int y)

Возвращает смещение (в элементах массива данных) пикселя (x, y). Элемент данных, содержащий пиксель x,y может быть получен от DataBuffer data с SinglePixelPackedSampleModel sppsm как:

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

Параметры:

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

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

Возвраты:

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

getBitOffsets

public int[] getBitOffsets()

Возвращает разрядные смещения в элемент массива данных, представляющий пиксель для всех полос.

Возвраты:

разрядные смещения, представляющие пиксель для всех полос.

getBitMasks

public int[] getBitMasks()

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

Возвраты:

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

getScanlineStride

public int getScanlineStride()

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

Возвраты:

шаг строки развертки этого SinglePixelPackedSampleModel.

createSubsetSampleModel

public SampleModel createSubsetSampleModel(int[] bands)

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

Определенный:

createSubsetSampleModel в class SampleModel

Параметры:

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

Возвраты:

a SampleModel с подмножеством полос этого SampleModel.

Броски:

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

getDataElements

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

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

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

       SinglePixelPackedSampleModel sppsm1, sppsm2;
       DataBufferInt db1, db2;
       sppsm2.setDataElements(x, y, sppsm1.getDataElements(x, y, null,
                              db1), db2);
 

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

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

Определенный:

getDataElements в class SampleModel

Параметры:

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 SampleModel

Параметры:

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 SampleModel

Параметры:

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 SampleModel

Параметры:

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

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

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

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

Возвраты:

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

См. Также:

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

getSamples

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

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

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

getSamples в class SampleModel

Параметры:

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

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

       SinglePixelPackedSampleModel sppsm1, sppsm2;
       DataBufferInt db1, db2;
       sppsm2.setDataElements(x, y, sppsm1.getDataElements(x, y, null,
                              db1), db2);
 

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

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

Определенный:

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

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

setPixel в class SampleModel

Параметры:

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 SampleModel

Параметры:

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

Параметры:

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

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

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

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

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

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

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

См. Также:

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

равняется

public boolean equals(Object o)

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

Указывает, " ли некоторый другой объект равен" этому.

equals метод реализует отношение эквивалентности на ненулевых ссылках на объект:

• Это рефлексивно: для любого ненулевого ссылочного значения x, x.equals(x) должен возвратиться true.
• Это симметрично: для любых ненулевых ссылочных значений x и y, x.equals(y) должен возвратиться true если и только если y.equals(x) возвраты true.
• Это является переходным: для любых ненулевых ссылочных значений x, y, и z, если x.equals(y) возвраты true и y.equals(z) возвраты true, тогда x.equals(z) должен возвратиться true.
• Это является непротиворечивым: для любых ненулевых ссылочных значений x и y, многократные вызовы x.equals(y) последовательно возвращайтесь true или последовательно возвращайтесь false, предоставленный никакая информация, используемая в equals сравнения на объектах изменяются.
• Для любого ненулевого ссылочного значения x, x.equals(null) должен возвратиться false.

equals метод для class Object реализует самое отличительное отношение эквивалентности на объектах; то есть, для любых ненулевых ссылочных значений x и y, этот метод возвраты true если и только если x и y обратитесь к тому же самому объекту (x == y имеет значение true).

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

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

equals в class Object

Параметры:

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

Возвраты:

true если этот объект является тем же самым как obj параметром; false иначе.

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

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

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

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

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

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

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

hashCode в class Object

Возвраты:

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

См. Также:

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