Класс SampleModel

java.lang.Object

java.awt.image.SampleModel

Прямые известные подклассы:: ComponentSampleModel, MultiPixelPackedSampleModel, SinglePixelPackedSampleModel

public abstract class SampleModel extends Object

Этот абстрактный класс определяет интерфейс для извлечения образцов пикселей в изображении. Все данные изображения выражаются как набор пикселей. Каждый пиксель состоит из нескольких образцов. Образец — это данные для одного канала изображения, а канал состоит из всех образцов определённого типа в изображении. Например, пиксель может содержать три образца, представляющие его красный, зелёный и синий компоненты. В изображении, содержащем этот пиксель, есть три канала. Один канал состоит из всех красных образцов со всех пикселей изображения. Второй канал состоит из всех зелёных образцов, а оставшийся канал — из всех синих образцов. Пиксель может храниться в различных форматах. Например, все образцы из определённого канала могут храниться непрерывно, или все образцы одного пикселя могут храниться непрерывно.

Подклассы SampleModel определяют типы образцов, которые они могут представлять (например, беззнаковые 8-битные байты, знакомые 16-битные целые числа и т. д.) и могут указывать, как образцы организованы в памяти. В API Java 2D(tm) встроенные операторы обработки изображений могут не работать со всеми возможными типами образцов, но обычно работают с беззнаковыми целочисленными образцами размером 16 бит или меньше. Некоторые операторы поддерживают более широкий спектр типов образцов.

Множество пикселей представлено как Raster, состоящий из DataBuffer и SampleModel. SampleModel позволяет получить доступ к образцам в DataBuffer и может предоставлять низкоуровневую информацию, которую программист может использовать для прямого манипулирования образцами и пикселями в DataBuffer.

Этот класс обычно используется в качестве резервного метода для работы с изображениями. Более эффективный код преобразует SampleModel в соответствующий подкласс и извлекает необходимую информацию для прямого манипулирования пикселями в DataBuffer.

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected int`	`dataType`	Тип данных DataBuffer, хранящего пиксельные данные.
`protected int`	`height`	Высота в пикселях области данных изображения, описываемой этим SampleModel.
`protected int`	`numBands`	Количество каналов данных изображения, описываемых этим SampleModel.
`protected int`	`width`	Ширина в пикселях области данных изображения, описываемой этим SampleModel.

Краткое описание конструкторов

Конструктор	Описание
`SampleModel(int dataType, int w, int h, int numBands)`	Создаёт SampleModel со значениями указанных параметров.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract SampleModel`	`createCompatibleSampleModel(int w, int h)`	Создаёт SampleModel, описывающий данные в формате этого SampleModel, но с другой шириной и высотой.
`abstract DataBuffer`	`createDataBuffer()`	Создаёт DataBuffer, соответствующий этому SampleModel.
`abstract SampleModel`	`createSubsetSampleModel(int[] bands)`	Создаёт новый SampleModel с подмножеством каналов этого SampleModel.
`Object`	`getDataElements(int x, int y, int w, int h, Object obj, DataBuffer data)`	Возвращает пиксельные данные для заданного прямоугольника пикселей в примитивном массиве типа TransferType.
`abstract Object`	`getDataElements(int x, int y, Object obj, DataBuffer data)`	Возвращает данные для одного пикселя в примитивном массиве типа TransferType.
`final int`	`getDataType()`	Возвращает тип данных DataBuffer, хранящего пиксельные данные.
`final int`	`getHeight()`	Возвращает высоту в пикселях.
`final int`	`getNumBands()`	Возвращает общее количество каналов данных изображения.
`abstract int`	`getNumDataElements()`	Возвращает количество элементов данных, необходимых для передачи пикселя с помощью методов getDataElements и setDataElements.
`double[]`	`getPixel(int x, int y, double[] dArray, DataBuffer data)`	Возвращает образцы для заданного пикселя в массиве double.
`float[]`	`getPixel(int x, int y, float[] fArray, DataBuffer data)`	Возвращает образцы для заданного пикселя в массиве float.
`int[]`	`getPixel(int x, int y, int[] iArray, DataBuffer data)`	Возвращает образцы для заданного пикселя в массиве int, по одному образцу на элемент массива.
`double[]`	`getPixels(int x, int y, int w, int h, double[] dArray, DataBuffer data)`	Возвращает все образцы для прямоугольника пикселей в массиве double, по одному образцу на элемент массива.
`float[]`	`getPixels(int x, int y, int w, int h, float[] fArray, DataBuffer data)`	Возвращает все образцы для прямоугольника пикселей в массиве float, по одному образцу на элемент массива.
`int[]`	`getPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)`	Возвращает все образцы для прямоугольника пикселей в массиве int, по одному образцу на элемент массива.
`abstract int`	`getSample(int x, int y, int b, DataBuffer data)`	Возвращает образец в указанном канале для пикселя, расположенного в координатах (x,y), как int.
`double`	`getSampleDouble(int x, int y, int b, DataBuffer data)`	Возвращает образец в указанном канале для пикселя, расположенного в координатах (x,y), как double.
`float`	`getSampleFloat(int x, int y, int b, DataBuffer data)`	Возвращает образец в указанном канале для пикселя, расположенного в координатах (x,y), как float.
`double[]`	`getSamples(int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)`	Возвращает образцы для указанного канала для заданного прямоугольника пикселей в массиве double, по одному образцу на элемент массива.
`float[]`	`getSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)`	Возвращает образцы для указанного канала для заданного прямоугольника пикселей в массиве float, по одному образцу на элемент массива.
`int[]`	`getSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)`	Возвращает образцы для указанного канала для заданного прямоугольника пикселей в массиве int, по одному образцу на элемент массива.
`abstract int[]`	`getSampleSize()`	Возвращает размер в битах образцов для всех каналов.
`abstract int`	`getSampleSize(int band)`	Возвращает размер в битах образцов для указанного канала.
`int`	`getTransferType()`	Возвращает TransferType, используемый для передачи пикселей с помощью методов getDataElements и setDataElements.
`final int`	`getWidth()`	Возвращает ширину в пикселях.
`void`	`setDataElements(int x, int y, int w, int h, Object obj, DataBuffer data)`	Записывает данные для прямоугольника пикселей в указанный DataBuffer из примитивного массива типа TransferType.
`abstract void`	`setDataElements(int x, int y, Object obj, DataBuffer data)`	Записывает данные для одного пикселя в указанный DataBuffer из примитивного массива типа TransferType.
`void`	`setPixel(int x, int y, double[] dArray, DataBuffer data)`	Записывает пиксель в DataBuffer, используя массив double образцов для ввода.
`void`	`setPixel(int x, int y, float[] fArray, DataBuffer data)`	Записывает пиксель в DataBuffer, используя массив float образцов для ввода.
`void`	`setPixel(int x, int y, int[] iArray, DataBuffer data)`	Записывает пиксель в DataBuffer, используя массив int образцов для ввода.
`void`	`setPixels(int x, int y, int w, int h, double[] dArray, DataBuffer data)`	Записывает все образцы для прямоугольника пикселей из массива double, содержащего по одному образцу на элемент массива.
`void`	`setPixels(int x, int y, int w, int h, float[] fArray, DataBuffer data)`	Записывает все образцы для прямоугольника пикселей из массива float, содержащего по одному образцу на элемент массива.
`void`	`setPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)`	Записывает все образцы для прямоугольника пикселей из массива int, содержащего по одному образцу на элемент массива.
`void`	`setSample(int x, int y, int b, double s, DataBuffer data)`	Записывает образец в указанном канале для пикселя, расположенного в координатах (x,y) в DataBuffer, используя double для ввода.
`void`	`setSample(int x, int y, int b, float s, DataBuffer data)`	Записывает образец в указанном канале для пикселя, расположенного в координатах (x,y) в DataBuffer, используя float для ввода.
`abstract void`	`setSample(int x, int y, int b, int s, DataBuffer data)`	Записывает образец в указанном канале для пикселя, расположенного в координатах (x,y) в DataBuffer, используя int для ввода.
`void`	`setSamples(int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)`	Записывает образцы в указанном канале для заданного прямоугольника пикселей из массива double, содержащего по одному образцу на элемент массива.
`void`	`setSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)`	Записывает образцы в указанном канале для заданного прямоугольника пикселей из массива float, содержащего по одному образцу на элемент массива.
`void`	`setSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)`	Записывает образцы в указанном канале для заданного прямоугольника пикселей из массива int, содержащего по одному образцу на элемент массива.

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

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

Подробное описание полей

width

protected int width

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

height

protected int height

Высота в пикселях области данных изображения, описываемой этим SampleModel.

numBands

protected int numBands

Количество каналов данных изображения, описываемых этим SampleModel.

dataType

protected int dataType

Тип данных DataBuffer, хранящего пиксельные данные.

См. также:

Подробное описание конструкторов

SampleModel

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

Создаёт SampleModel с указанными параметрами.

Параметры:: dataType - Тип данных DataBuffer, хранящего пиксельные данные.; w - Ширина (в пикселях) области данных изображения.; h - Высота (в пикселях) области данных изображения.; numBands - Количество каналов данных изображения.
Исключение:: IllegalArgumentException - если w или h не больше 0; IllegalArgumentException - если произведение w и h больше Integer.MAX_VALUE; IllegalArgumentException - если dataType не является одним из предопределённых типов данных в классе DataBuffer; IllegalArgumentException - если numBands меньше 1

Подробное описание методов

getWidth

public final int getWidth()

Возвращает ширину в пикселях.

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

getHeight

public final int getHeight()

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

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

getNumBands

public final int getNumBands()

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

Возвращает:: количество каналов данных изображения, описываемых этим SampleModel.

getNumDataElements

public abstract int getNumDataElements()

Возвращает количество элементов данных, необходимых для передачи пикселя через методы getDataElements и setDataElements. При передаче пикселей через эти методы они могут передаваться в упакованном или распакованном формате, в зависимости от реализации SampleModel. Используя эти методы, пиксели передаются как массив из getNumDataElements() элементов примитивного типа, заданного getTransferType(). Тип TransferType может или не может совпадать с типом хранения DataType.

Возвращает:

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

См. также:

getDataType

public final int getDataType()

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

Возвращает:: тип данных.

getTransferType

public int getTransferType()

Возвращает TransferType, используемый для передачи пикселей через методы getDataElements и setDataElements. При передаче пикселей через эти методы они могут передаваться в упакованном или распакованном формате, в зависимости от реализации SampleModel. Используя эти методы, пиксели передаются как массив из getNumDataElements() элементов примитивного типа, заданного getTransferType(). Тип TransferType может или не может совпадать с типом хранения DataType. TransferType будет одним из типов, определённых в DataBuffer.

Возвращает:

тип передачи.

См. также:

getPixel

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

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

Параметры:

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

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

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

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

Возвращает:

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

Исключение:

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

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

См. также:

getDataElements

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

Возвращает данные для отдельного пикселя в примитивном массиве типа TransferType. Для данных изображений, поддерживаемых API Java 2D, это будет один из DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT или DataBuffer.TYPE_DOUBLE. Данные могут возвращаться в упакованном формате, что повышает эффективность передачи данных. Как правило, obj должен передаваться как null, чтобы объект создавался автоматически и был правильного примитивного типа данных.

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

       SampleModel sm1, sm2;
       DataBuffer db1, db2;
       sm2.setDataElements(x, y, sm1.getDataElements(x, y, null, db1), db2);

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

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

Параметры:

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

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

obj - Если не null, примитивный массив, в котором возвращаются данные пикселя.

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

Возвращает:

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

Исключение:

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

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

См. также:

getDataElements

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

Возвращает данные пикселей для указанного прямоугольника пикселей в примитивном массиве типа TransferType. Для данных изображений, поддерживаемых API Java 2D, это будет один из DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT или DataBuffer.TYPE_DOUBLE. Данные могут возвращаться в упакованном формате, что повышает эффективность передачи данных. Как правило, obj следует передавать как null, чтобы объект создавался автоматически и был правильного примитивного типа данных.

Следующий код иллюстрирует передачу данных для прямоугольной области пикселей из DataBuffer db1, структура хранения которого описана в SampleModel sm1, в DataBuffer db2, структура хранения которого описана в SampleModel sm2. Передача, как правило, будет более эффективной, чем использование getPixels/setPixels.

       SampleModel sm1, sm2;
       DataBuffer db1, db2;
       sm2.setDataElements(x, y, w, h, sm1.getDataElements(x, y, w,
                           h, null, db1), db2);

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

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

Parameters:

x - Минимальная координата X прямоугольника пикселей.

y - Минимальная координата Y прямоугольника пикселей.

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

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

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

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

Returns:

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

Throws:

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

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

See Also:

setDataElements

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

Устанавливает данные для отдельного пикселя в указанном DataBuffer из примитивного массива типа TransferType. Для данных изображений, поддерживаемых API Java 2D, это будет один из DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT или DataBuffer.TYPE_DOUBLE. Данные в массиве могут быть в упакованном формате, что повышает эффективность передачи данных.

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

       SampleModel sm1, sm2;
       DataBuffer db1, db2;
       sm2.setDataElements(x, y, sm1.getDataElements(x, y, null, db1),
                           db2);

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

Parameters:

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

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

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

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

Throws:

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

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

See Also:

setDataElements

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

Устанавливает данные для прямоугольника пикселей в указанном DataBuffer из примитивного массива типа TransferType. Для данных изображений, поддерживаемых API Java 2D, это будет один из DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, DataBuffer.TYPE_INT, DataBuffer.TYPE_SHORT, DataBuffer.TYPE_FLOAT или DataBuffer.TYPE_DOUBLE. Данные в массиве могут быть в упакованном формате, что повышает эффективность передачи данных.

       SampleModel sm1, sm2;
       DataBuffer db1, db2;
       sm2.setDataElements(x, y, w, h, sm1.getDataElements(x, y, w, h,
                           null, db1), db2);

Parameters:

x - Минимальная координата X прямоугольника пикселей.

y - Минимальная координата Y прямоугольника пикселей.

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

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

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

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

Throws:

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

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

See Also:

getPixel

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

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

Parameters:

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

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

fArray - Если не null, возвращает выборки в этом массиве.

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

Returns:

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

Throws:

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

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

See Also:

getPixel

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

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

Parameters:

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

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

dArray - Если не null, возвращает выборки в этом массиве.

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

Returns:

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

Throws:

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

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

See Also:

getPixels

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

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

Parameters:

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

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

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

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

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

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

Returns:

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

Throws:

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

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

See Also:

getPixels

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

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

Параметры:

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

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

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

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

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

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

Возвращает:

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

Исключение:

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

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

См. также:

getPixels

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

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

Параметры:

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

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

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

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

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

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

Возвращает:

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

Исключение:

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

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

См. также:

getSample

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

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

Параметры:

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

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

b - Полоса для возврата.

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

Возвращает:

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

Исключение:

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

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

См. также:

getSampleFloat

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

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

Параметры:: x - Координата X пикселя.; y - Координата Y пикселя.; b - Полоса для возврата.; data - Объект DataBuffer, содержащий данные изображения.
Возвращает:: образец в указанной полосе для указанного пикселя.
Исключение:: NullPointerException - если data равно null.; ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в пределах границ.

getSampleDouble

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

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

Параметры:: x - Координата X пикселя.; y - Координата Y пикселя.; b - Полоса для возврата.; data - Объект DataBuffer, содержащий данные изображения.
Возвращает:: образец в указанной полосе для указанного пикселя.
Исключение:: NullPointerException - если data равно null.; ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в пределах границ.

getSamples

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

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

Параметры:

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

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

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

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

b - Полоса для возврата.

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

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

Возвращает:

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

Исключение:

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

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

См. также:

getSamples

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

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

Параметры:

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

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

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

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

b - Полоса для возврата.

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

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

Возвращает:

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

Исключение:

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

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

См. также:

getSamples

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

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

Параметры:

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

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

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

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

b - Полоса для возврата.

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

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

Возвращает:

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

Исключение:

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

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

См. также:

setPixel

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

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

Параметры:

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

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

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

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

Исключение:

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

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

См. также:

setPixel

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

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

Параметры:

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

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

fArray - Входные данные в массиве float.

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

Исключения:

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

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

См. также:

setPixel

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

Устанавливает пиксель в DataBuffer, используя массив double для входных данных.

Параметры:

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

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

dArray - Входные данные в массиве double.

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

Исключения:

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

См. также:

setPixels

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

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

Параметры:

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

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

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

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

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

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

Исключения:

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

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

См. также:

setPixels

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

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

Параметры:

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

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

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

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

fArray - Входные образцы в массиве float.

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

Исключения:

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

См. также:

setPixels

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

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

Параметры:

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

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

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

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

dArray - Входные образцы в массиве double.

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

Исключения:

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

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

См. также:

setSample

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

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

Параметры:

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

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

b - Канал для установки.

s - Входной образец в виде int.

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

Исключения:

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

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

См. также:

setSample

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

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

Параметры:

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

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

b - Канал для установки.

s - Входной образец в виде float.

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

Исключения:

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

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

См. также:

setSample

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

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

Параметры:

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

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

b - Канал для установки.

s - Входной образец в виде double.

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

Исключения:

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

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

См. также:

setSamples

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

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

Параметры:

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

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

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

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

b - Канал для установки.

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

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

Исключения:

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

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

См. также:

setSamples

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

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

Parameters:

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

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

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

b - Полоса для установки.

fArray - Входные образцы в массиве с плавающей запятой.

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

Throws:

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

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

See Also:

setSamples

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

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

Parameters:

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

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

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

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

b - Полоса для установки.

dArray - Входные образцы в массиве с двойной точностью.

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

Throws:

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

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

See Also:

createCompatibleSampleModel

public abstract SampleModel createCompatibleSampleModel(int w, int h)

Создаёт SampleModel, описывающий данные в формате этого SampleModel, но с другой шириной и высотой.

Parameters:: w - ширина данных изображения; h - высота данных изображения
Returns:: объект SampleModel, описывающий те же данные изображения, что и этот SampleModel, но с другим размером.

createSubsetSampleModel

public abstract SampleModel createSubsetSampleModel(int[] bands)

Создаёт новый SampleModel с подмножеством полос этого SampleModel.

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

createDataBuffer

public abstract DataBuffer createDataBuffer()

Создаёт DataBuffer, соответствующий этому SampleModel. Ширина и высота DataBuffer будут соответствовать этому SampleModel.

Returns:: DataBuffer, соответствующий этому SampleModel.

getSampleSize

public abstract int[] getSampleSize()

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

Returns:: размер образцов для всех полос.

getSampleSize

public abstract int getSampleSize(int band)

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

Parameters:: band - указанная полоса
Returns:: размер образцов указанной полосы.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/SampleModel.html