Spec-Zone.ru › OpenJDK 21

Класс SampleModel

java.lang.Object
java.awt.image.SampleModel
Прямые известные подклассы:
ComponentSampleModel, MultiPixelPackedSampleModel, SinglePixelPackedSampleModel 
public abstract class SampleModel extends Object
Этот абстрактный класс определяет интерфейс для извлечения выборок пикселей в изображении. Все данные изображения выражаются как коллекция пикселей. Каждый пиксель состоит из ряда выборок. Выборка — это данные для одного канала изображения, а канал состоит из всех выборок определенного типа в изображении. Например, пиксель может содержать три выборки, представляющие его красный, зеленый и синий компоненты. В изображении, содержащем этот пиксель, есть три канала. Один канал состоит из всех красных выборок всех пикселей в изображении. Второй канал состоит из всех зеленых выборок, а оставшийся канал состоит из всех синих выборок. Пиксель может храниться в различных форматах. Например, все выборки из определенного канала могут храниться непрерывно или все выборки из одного пикселя могут храниться непрерывно.

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

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

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

См. также:
  • DataBuffer
  • Raster
  • ComponentSampleModel
  • PixelInterleavedSampleModel
  • BandedSampleModel
  • MultiPixelPackedSampleModel
  • SinglePixelPackedSampleModel

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

Модификатор и тип Поле Описание
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)
Возвращает образцы для указанного пикселя в целочисленном массиве, по одному образцу на элемент массива.
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)
Возвращает все образцы для прямоугольника пикселей в целочисленном массиве, по одному образцу на элемент массива.
abstract int getSample(int x, int y, int b, DataBuffer data)
Возвращает образец в указанном канале для пикселя, расположенного в координатах (x,y), как целое число.
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)
Возвращает образцы для указанного канала для указанного прямоугольника пикселей в целочисленном массиве, по одному образцу на элемент массива.
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)
Записывает все образцы для прямоугольника пикселей из целочисленного массива, содержащего по одному образцу на элемент массива.
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)
Записывает образцы в указанный канал для указанного прямоугольника пикселей из целочисленного массива, содержащего по одному образцу на элемент массива.

Методы, объявленные в классе 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, хранящего пиксельные данные.
См. также:
  • 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.
Возвращает:
количество элементов данных.
См. также:
  • getDataElements(int, int, Object, DataBuffer)
  • getDataElements(int, int, int, int, Object, DataBuffer)
  • setDataElements(int, int, Object, DataBuffer)
  • setDataElements(int, int, int, int, Object, DataBuffer)
  • getTransferType()

getDataType

public final int getDataType()
Возвращает тип данных DataBuffer, хранящего пиксельные данные.
Возвращает:
тип данных.

getTransferType

public int getTransferType()
Возвращает TransferType, используемый для передачи пикселей через методы getDataElements и setDataElements. При передаче пикселей через эти методы они могут передаваться в упакованном или распакованном формате, в зависимости от реализации SampleModel. Используя эти методы, пиксели передаются как массив из getNumDataElements() элементов примитивного типа, заданного getTransferType(). Тип TransferType может или не может совпадать с типом хранения DataType. Тип TransferType будет одним из типов, определенных в DataBuffer.
Возвращает:
тип передачи.
См. также:
  • getDataElements(int, int, Object, DataBuffer)
  • getDataElements(int, int, int, int, Object, DataBuffer)
  • setDataElements(int, int, Object, DataBuffer)
  • setDataElements(int, int, int, int, Object, DataBuffer)
  • getNumDataElements()
  • 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 слишком мал для хранения вывода.
См. также:
  • setPixel(int, int, int[], DataBuffer)

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 - если data равна null.
ArrayIndexOutOfBoundsException - если координаты находятся вне границ или если obj слишком мал для хранения вывода.
См. также:
  • getNumDataElements()
  • getTransferType()
  • DataBuffer
  • setDataElements(int, int, Object, DataBuffer)

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:
  • getNumDataElements()
  • getTransferType()
  • setDataElements(int, int, int, int, Object, DataBuffer)
  • DataBuffer

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);
Использование getDataElements/setDataElements для передачи между двумя парами DataBuffer/SampleModel допустимо, если SampleModel имеют одинаковое количество каналов, соответствующие каналы имеют одинаковое количество битов на образец, и TransferType совпадают.

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

Parameters:
x - Координата X расположения пикселя.
y - Координата Y расположения пикселя.
obj - Массив примитивных типов, содержащий данные пикселей.
data - DataBuffer, содержащий данные изображения.
Throws:
NullPointerException - если данные равны null.
ArrayIndexOutOfBoundsException - если координаты не находятся в пределах границ, или если obj слишком мал для хранения входных данных.
See Also:
  • getNumDataElements()
  • getTransferType()
  • getDataElements(int, int, Object, DataBuffer)
  • DataBuffer

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. Данные в массиве могут быть в упакованном формате, что повышает эффективность передачи данных.

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

Parameters:
x - Минимальная координата X прямоугольника пикселей.
y - Минимальная координата Y прямоугольника пикселей.
w - Ширина прямоугольника пикселей.
h - Высота прямоугольника пикселей.
obj - Массив примитивных типов, содержащий данные пикселей.
data - DataBuffer, содержащий данные изображения.
Throws:
NullPointerException - если данные равны null.
ArrayIndexOutOfBoundsException - если координаты не находятся в пределах границ, или если obj слишком мал для хранения входных данных.
See Also:
  • getNumDataElements()
  • getTransferType()
  • getDataElements(int, int, int, int, Object, DataBuffer)
  • DataBuffer

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:
  • setPixel(int, int, float[], DataBuffer)

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:
  • setPixel(int, int, double[], DataBuffer)

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:
  • setPixels(int, int, int, int, int[], DataBuffer)

getPixels

public float[] getPixels(int x, int y, int w, int h, float[] fArray, DataBuffer data)
Возвращает все образцы для прямоугольника пикселей в массиве float, по одному образцу на элемент массива. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X верхнего левого пикселя.
y - Координата Y верхнего левого пикселя.
w - Ширина прямоугольника пикселей.
h - Высота прямоугольника пикселей.
fArray - Если не null, возвращает образцы в этом массиве.
data - DataBuffer, содержащий данные изображения.
Returns:
образцы для указанной области пикселей.
Throws:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты не находятся в границах или fArray слишком мал для хранения результата.
See Also:
  • setPixels(int, int, int, int, float[], DataBuffer)

getPixels

public double[] getPixels(int x, int y, int w, int h, double[] dArray, DataBuffer data)
Возвращает все образцы для прямоугольника пикселей в массиве double, по одному образцу на элемент массива. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X верхнего левого пикселя.
y - Координата Y верхнего левого пикселя.
w - Ширина прямоугольника пикселей.
h - Высота прямоугольника пикселей.
dArray - Если не null, возвращает образцы в этом массиве.
data - DataBuffer, содержащий данные изображения.
Returns:
образцы для указанной области пикселей.
Throws:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты не находятся в границах или dArray слишком мал для хранения результата.
See Also:
  • setPixels(int, int, int, int, double[], DataBuffer)

getSample

public abstract int getSample(int x, int y, int b, DataBuffer data)
Возвращает образец в указанной полосе для пикселя, расположенного по координатам (x,y), как целое число. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X пикселя.
y - Координата Y пикселя.
b - Номер полосы для возврата.
data - DataBuffer, содержащий данные изображения.
Returns:
образец в указанной полосе для указанного пикселя.
Throws:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в границах.
See Also:
  • setSample(int, int, int, int, DataBuffer)

getSampleFloat

public float getSampleFloat(int x, int y, int b, DataBuffer data)
Возвращает образец в указанной полосе для пикселя, расположенного по координатам (x,y), как число с плавающей точкой. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X пикселя.
y - Координата Y пикселя.
b - Номер полосы для возврата.
data - DataBuffer, содержащий данные изображения.
Returns:
образец в указанной полосе для указанного пикселя.
Throws:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в границах.

getSampleDouble

public double getSampleDouble(int x, int y, int b, DataBuffer data)
Возвращает образец в указанной полосе для пикселя, расположенного по координатам (x,y), как число с двойной точностью. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X пикселя.
y - Координата Y пикселя.
b - Номер полосы для возврата.
data - DataBuffer, содержащий данные изображения.
Returns:
образец в указанной полосе для указанного пикселя.
Throws:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в границах.

getSamples

public int[] getSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)
Возвращает образцы для указанной полосы для указанного прямоугольника пикселей в массиве int, по одному образцу на элемент массива. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X верхнего левого пикселя.
y - Координата Y верхнего левого пикселя.
w - Ширина прямоугольника пикселей.
h - Высота прямоугольника пикселей.
b - Номер полосы для возврата.
iArray - Если не null, возвращает образцы в этом массиве.
data - DataBuffer, содержащий данные изображения.
Returns:
образцы для указанной полосы для указанной области пикселей.
Throws:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в границах или iArray слишком мал для хранения результата.
See Also:
  • setSamples(int, int, int, int, int, int[], DataBuffer)

getSamples

public float[] getSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)
Возвращает образцы для указанной полосы для указанного прямоугольника пикселей в массиве float, по одному образцу на элемент массива. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X верхнего левого пикселя.
y - Координата Y верхнего левого пикселя.
w - Ширина прямоугольника пикселей.
h - Высота прямоугольника пикселей.
b - Номер полосы для возврата.
fArray - Если не null, возвращает образцы в этом массиве.
data - DataBuffer, содержащий данные изображения.
Returns:
образцы для указанной полосы для указанной области пикселей.
Throws:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в границах или fArray слишком мал для хранения результата.
See Also:
  • setSamples(int, int, int, int, int, float[], DataBuffer)

getSamples

public double[] getSamples(int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)
Возвращает образцы для указанной полосы для указанного прямоугольника пикселей в массиве double, по одному образцу на элемент массива. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X верхнего левого пикселя.
y - Координата Y верхнего левого пикселя.
w - Ширина прямоугольника пикселей.
h - Высота прямоугольника пикселей.
b - Номер полосы для возврата.
dArray - Если не null, возвращает образцы в этом массиве.
data - DataBuffer, содержащий данные изображения.
Returns:
образцы для указанной полосы для указанной области пикселей.
Throws:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в границах или dArray слишком мал для хранения результата.
See Also:
  • setSamples(int, int, int, int, int, double[], DataBuffer)

setPixel

public void setPixel(int x, int y, int[] iArray, DataBuffer data)
Устанавливает пиксель в DataBuffer, используя массив int образцов для ввода. ArrayIndexOutOfBoundsException может быть выброшен, если координаты не находятся в границах.
Parameters:
x - Координата X пикселя.
y - Координата Y пикселя.
iArray - Входные образцы в массиве int.
data - DataBuffer, содержащий данные изображения.
Throws:
NullPointerException - если iArray или data равны null.
ArrayIndexOutOfBoundsException - если координаты не находятся в границах или iArray слишком мал для хранения ввода.
See Also:
  • getPixel(int, int, int[], DataBuffer)

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 слишком мал для хранения входных данных.
См. также:
  • getPixel(int, int, float[], DataBuffer)

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.
ArrayIndexOutOfBoundsException - если координаты не находятся в пределах границ или если dArray слишком мал для хранения входных данных.
См. также:
  • getPixel(int, int, double[], DataBuffer)

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 слишком мал для хранения входных данных.
См. также:
  • getPixels(int, int, int, int, int[], DataBuffer)

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.
ArrayIndexOutOfBoundsException - если координаты не находятся в пределах границ или если fArray слишком мал для хранения входных данных.
См. также:
  • getPixels(int, int, int, int, float[], DataBuffer)

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 слишком мал для хранения входных данных.
См. также:
  • getPixels(int, int, int, int, double[], DataBuffer)

setSample

public abstract void setSample(int x, int y, int b, int s, DataBuffer data)
Устанавливает образец в указанную полосу для пикселя, расположенного в координатах (x, y) в DataBuffer, используя целое число в качестве входных данных. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты не находятся в пределах границ.
Параметры:
x - Координата X расположения пикселя.
y - Координата Y расположения пикселя.
b - Полоса для установки.
s - Входной образец в виде целого числа.
data - DataBuffer, содержащий данные изображения.
Исключения:
NullPointerException - если data равно null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы не находятся в пределах границ.
См. также:
  • getSample(int, int, int, DataBuffer)

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 - если координаты или индекс полосы не находятся в пределах границ.
См. также:
  • getSample(int, int, int, DataBuffer)

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 - если координаты или индекс полосы не находятся в пределах границ.
См. также:
  • getSample(int, int, int, DataBuffer)

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 слишком мал для хранения входных данных.
См. также:
  • getSamples(int, int, int, int, int, int[], DataBuffer)

setSamples

public void setSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)
Устанавливает выборки в указанной полосе для заданного прямоугольника пикселей из массива с плавающей запятой, содержащего по одной выборке на элемент массива. Может быть выброшено исключение ArrayIndexOutOfBoundsException, если координаты не находятся в пределах границ.
Parameters:
x - Координата X верхнего левого пикселя.
y - Координата Y верхнего левого пикселя.
w - Ширина прямоугольника пикселей.
h - Высота прямоугольника пикселей.
b - Полоса для установки.
fArray - Входные выборки в массиве с плавающей запятой.
data - DataBuffer, содержащий данные изображения.
Throws:
NullPointerException - если fArray или data равны null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы находятся вне границ или если fArray слишком мал для хранения входных данных.
See Also:
  • getSamples(int, int, int, int, int, float[], DataBuffer)

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 или data равны null.
ArrayIndexOutOfBoundsException - если координаты или индекс полосы находятся вне границ или если dArray слишком мал для хранения входных данных.
See Also:
  • getSamples(int, int, int, int, int, double[], DataBuffer)

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, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/image/SampleModel.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API