Класс DataBufferInt

java.lang.Object

java.awt.image.DataBuffer

java.awt.image.DataBufferInt

public final class DataBufferInt extends DataBuffer

Этот класс расширяет DataBuffer и хранит данные внутри в виде целых чисел.

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

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

Поля, объявленные в классе DataBuffer

banks, dataType, offset, offsets, size, TYPE_BYTE, TYPE_DOUBLE, TYPE_FLOAT, TYPE_INT, TYPE_SHORT, TYPE_UNDEFINED, TYPE_USHORT

Модификатор и тип	Поле	Описание
`protected int`	`banks`	Количество банков в этом DataBuffer.
`protected int`	`dataType`	Тип данных этого DataBuffer.
`protected int`	`offset`	Смещение в банке по умолчанию (первом), с которого начинается получение первого элемента.
`protected int[]`	`offsets`	Смещения во всех банках.
`protected int`	`size`	Используемый размер всех банков.
`static final int`	`TYPE_BYTE`	Тег для данных типа unsigned byte.
`static final int`	`TYPE_DOUBLE`	Тег для данных типа double.
`static final int`	`TYPE_FLOAT`	Тег для данных типа float.
`static final int`	`TYPE_INT`	Тег для данных типа int.
`static final int`	`TYPE_SHORT`	Тег для данных типа signed short.
`static final int`	`TYPE_UNDEFINED`	Тег для данных неопределенного типа.
`static final int`	`TYPE_USHORT`	Тег для данных типа unsigned short.

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

Конструктор	Описание
`DataBufferInt(int size)`	Создает `DataBuffer` на основе целых чисел с одним банком и указанным размером.
`DataBufferInt(int[][] dataArray, int size)`	Создает `DataBuffer` на основе целых чисел с указанными массивами.
`DataBufferInt(int[][] dataArray, int size, int[] offsets)`	Создает `DataBuffer` на основе целых чисел с указанными массивами, размером и смещениями.
`DataBufferInt(int[] dataArray, int size)`	Создает `DataBuffer` на основе целых чисел с одним банком, используя указанный массив.
`DataBufferInt(int[] dataArray, int size, int offset)`	Создает `DataBuffer` на основе целых чисел с одним банком, используя указанный массив, размер и смещение.
`DataBufferInt(int size, int numBanks)`	Создает `DataBuffer` на основе целых чисел с указанным количеством банков, каждый из которых имеет указанный размер.

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

Модификатор и тип	Метод	Описание
`int[][]`	`getBankData()`	Возвращает массивы данных всех банков.
`int[]`	`getData()`	Возвращает массив данных типа int банка по умолчанию (первого) в `DataBuffer`.
`int[]`	`getData(int bank)`	Возвращает массив данных указанного банка.
`int`	`getElem(int i)`	Возвращает запрошенный элемент массива данных из первого (банка по умолчанию) банка.
`int`	`getElem(int bank, int i)`	Возвращает запрошенный элемент массива данных из указанного банка.
`void`	`setElem(int i, int val)`	Устанавливает для запрошенного элемента массива данных в первом (банке по умолчанию) банке указанное значение.
`void`	`setElem(int bank, int i, int val)`	Устанавливает для запрошенного элемента массива данных в указанном банке целочисленное значение `i`.

Методы, объявленные в классе DataBuffer

getDataType, getDataTypeSize, getElemDouble, getElemDouble, getElemFloat, getElemFloat, getNumBanks, getOffset, getOffsets, getSize, setElemDouble, setElemDouble, setElemFloat, setElemFloat

Модификатор и тип	Метод	Описание
`int`	`getDataType()`	Возвращает тип данных этого DataBuffer.
`static int`	`getDataTypeSize(int type)`	Возвращает размер типа данных в битах для указанного тега типа данных.
`double`	`getElemDouble(int i)`	Возвращает запрошенный элемент массива данных из первого (банка по умолчанию) банка как значение типа double.
`double`	`getElemDouble(int bank, int i)`	Возвращает запрошенный элемент массива данных из указанного банка как значение типа double.
`float`	`getElemFloat(int i)`	Возвращает запрошенный элемент массива данных из первого (банка по умолчанию) банка как значение типа float.
`float`	`getElemFloat(int bank, int i)`	Возвращает запрошенный элемент массива данных из указанного банка как значение типа float.
`int`	`getNumBanks()`	Возвращает количество банков в этом DataBuffer.
`int`	`getOffset()`	Возвращает смещение банка по умолчанию в элементах массива.
`int[]`	`getOffsets()`	Возвращает смещения всех банков в элементах массива.
`int`	`getSize()`	Возвращает размер всех банков в элементах массива.
`void`	`setElemDouble(int i, double val)`	Устанавливает запрошенный элемент массива данных в первом (банке по умолчанию) банке, используя заданное значение типа double.
`void`	`setElemDouble(int bank, int i, double val)`	Устанавливает запрошенный элемент массива данных в указанном банке, используя заданное значение типа double.
`void`	`setElemFloat(int i, float val)`	Устанавливает запрошенный элемент массива данных в первом (банке по умолчанию) банке, используя заданное значение типа float.
`void`	`setElemFloat(int bank, int i, float val)`	Устанавливает запрошенный элемент массива данных в указанном банке, используя заданное значение типа float.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

DataBufferInt

public DataBufferInt(int size)

Создает DataBuffer на основе целых чисел с одним банком и указанным размером.

Параметры:: size — размер DataBuffer.
Вызывает исключение:: IllegalArgumentException — если size меньше или равен нулю.

DataBufferInt

public DataBufferInt(int size, int numBanks)

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

Параметры:: size — размер банков в DataBuffer.; numBanks — количество банков в DataBuffer.
Вызывает исключение:: IllegalArgumentException — если size или numBanks меньше или равно нулю.

DataBufferInt

public DataBufferInt(int[] dataArray, int size)

Создает DataBuffer на основе целых чисел с одним банком, используя указанный массив. Методы доступа к этому DataBuffer должны использовать только первые size элементов. dataArray должен быть достаточно большим, чтобы вместить size элементов.

Обратите внимание, что объекты DataBuffer, созданные этим конструктором, могут быть несовместимы с оптимизациями производительности, используемыми некоторыми реализациями (например, кэшированием связанного изображения в видеопамяти).

Параметры:: dataArray — целочисленный массив для DataBuffer.; size — размер банка DataBuffer.
Вызывает исключение:: NullPointerException — если dataArray имеет значение null.; IllegalArgumentException — если size меньше или равен нулю либо превышает длину dataArray.

DataBufferInt

public DataBufferInt(int[] dataArray, int size, int offset)

Создает DataBuffer на основе целых чисел с одним банком, используя указанный массив, размер и смещение. dataArray должен содержать не менее offset + size элементов. Методы доступа к этому DataBuffer должны использовать только элементы с offset по offset + size - 1.

Параметры:: dataArray — целочисленный массив для DataBuffer.; size — размер банка DataBuffer.; offset — смещение в dataArray.
Вызывает исключение:: NullPointerException — если dataArray имеет значение null.; IllegalArgumentException — если size меньше или равен нулю, либо offset меньше нуля, либо (offset + size) превышает длину dataArray.

DataBufferInt

public DataBufferInt(int[][] dataArray, int size)

Создает DataBuffer на основе целых чисел с указанными массивами. Количество банков будет равно dataArray.length. Методы доступа к этому DataBuffer должны использовать только первые size элементов каждого массива.

Параметры:: dataArray — целочисленные массивы для DataBuffer.; size — размер банков в DataBuffer.
Вызывает исключение:: NullPointerException — если dataArray имеет значение null.; IllegalArgumentException — если size меньше или равен нулю.; IllegalArgumentException — если dataArray не содержит хотя бы одного банка.; NullPointerException — если какой-либо банк dataArray имеет значение null.; IllegalArgumentException — если длина любого банка dataArray меньше size.

DataBufferInt

public DataBufferInt(int[][] dataArray, int size, int[] offsets)

Создает DataBuffer на основе целых чисел с указанными массивами, размером и смещениями. Количество банков равно dataArray.length. Каждый массив должен быть не меньше size + соответствующее смещение. Для каждой записи dataArray должна существовать запись в массиве смещений. Для каждого банка методы доступа к этому DataBuffer должны использовать только элементы с offset по offset + size - 1.

Параметры:: dataArray — целочисленные массивы для DataBuffer.; size — размер банков в DataBuffer.; offsets — смещения в каждом массиве.
Вызывает исключение:: IllegalArgumentException — если size меньше или равно нулю.; NullPointerException — если dataArray имеет значение null.; NullPointerException — если какой-либо банк dataArray имеет значение null.; IllegalArgumentException — если dataArray не содержит хотя бы одного банка.; NullPointerException — если offsets имеет значение null.; IllegalArgumentException — если какой-либо элемент offsets меньше нуля.; ArrayIndexOutOfBoundsException — если длины dataArray и offsets различаются.; IllegalArgumentException — если длина любого банка dataArray меньше (size + offsets[bankIndex]).

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

getData

public int[] getData()

Возвращает массив данных типа int банка по умолчанию (первого) в DataBuffer.

Обратите внимание, что вызов этого метода может сделать этот объект DataBuffer несовместимым с оптимизациями производительности, используемыми некоторыми реализациями (например, кэшированием связанного изображения в видеопамяти).

Возвращает:: Первый целочисленный массив данных.

getData

public int[] getData(int bank)

Возвращает массив данных указанного банка.

Параметры:: bank — банк, массив данных которого требуется получить.
Возвращает:: Массив данных указанного банка.
Вызывает исключение:: ArrayIndexOutOfBoundsException — если bank не является допустимым индексом банка.

getBankData

public int[][] getBankData()

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

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

getElem

public int getElem(int i)

Возвращает запрошенный элемент массива данных из первого (банка по умолчанию) банка.

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

getElem в классе DataBuffer

Параметры:

i — элемент массива данных, который требуется получить.

Возвращает:

Запрошенный элемент массива данных в виде целого числа.

Вызывает исключение:

ArrayIndexOutOfBoundsException — если (i + getOffset()) не является допустимым индексом.

См. также:

getElem

public int getElem(int bank, int i)

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

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

getElem в классе DataBuffer

Параметры:

bank — банк, из которого требуется получить элемент массива данных.

i — элемент массива данных, который требуется получить.

Возвращает:

Запрошенный элемент массива данных в виде целого числа.

Вызывает исключение:

ArrayIndexOutOfBoundsException — если bank не является допустимым индексом банка или (i + getOffsets()[bank]) не является допустимым индексом в банке.

См. также:

setElem

public void setElem(int i, int val)

Устанавливает для запрошенного элемента массива данных в первом (банке по умолчанию) банке указанное значение.

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

setElem в классе DataBuffer

Параметры:

i — элемент массива данных, значение которого требуется установить.

val — целочисленное значение, которое требуется присвоить элементу массива данных.

Вызывает исключение:

ArrayIndexOutOfBoundsException — если (i + getOffset()) не является допустимым индексом.

См. также:

setElem

public void setElem(int bank, int i, int val)

Устанавливает для запрошенного элемента массива данных в указанном банке целочисленное значение i.

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

setElem в классе DataBuffer

Параметры:

bank — банк, в котором требуется установить элемент массива данных.

i — элемент массива данных, значение которого требуется установить.

val — целочисленное значение, которое требуется присвоить указанному элементу массива данных.

Вызывает исключение:

См. также:

© 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.