Класс DataBufferByte

java.lang.Object

java.awt.image.DataBuffer

java.awt.image.DataBufferByte

public final class DataBufferByte extends DataBuffer

Этот класс расширяет 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`	Идентификатор беззнаковых байтовых данных.
`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.

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

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

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

Модификатор и тип	Метод	Описание
`byte[][]`	`getBankData()`	Возвращает массивы данных всех банков.
`byte[]`	`getData()`	Возвращает массив байтовых данных банка по умолчанию (первого банка).
`byte[]`	`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)`	Задаёт значение запрошенного элемента массива данных в указанном банке из переданного целого числа.

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

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

DataBufferByte

public DataBufferByte(int size)

Создаёт байтовый DataBuffer с одним банком и указанным размером.

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

DataBufferByte

public DataBufferByte(int size, int numBanks)

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

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

DataBufferByte

public DataBufferByte(byte[] dataArray, int size)

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

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

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

DataBufferByte

public DataBufferByte(byte[] dataArray, int size, int offset)

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

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

DataBufferByte

public DataBufferByte(byte[][] 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.

DataBufferByte

public DataBufferByte(byte[][] dataArray, int size, int[] offsets)

Создаёт байтовый DataBuffer с указанными массивами, размером и смещениями. Количество банков равно dataArray.length. Каждый массив должен иметь размер не меньше size + соответствующего offset. Для каждой записи dataArray должна существовать запись в массиве offset. Для каждого банка средства доступа этого 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 byte[] getData()

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

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

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

getData

public byte[] getData(int bank)

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

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

getBankData

public byte[][] 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)

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

Указан в:

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.