Класс DataBufferUShort

java.lang.Object

java.awt.image.DataBuffer

java.awt.image.DataBufferUShort

public final class DataBufferUShort extends DataBuffer

Этот класс расширяет DataBuffer и хранит данные внутри в виде значений типа short. Значения, хранящиеся в массивах short этого 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.

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

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

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

Модификатор и тип	Метод	Описание
`short[][]`	`getBankData()`	Возвращает массивы данных всех банков.
`short[]`	`getData()`	Возвращает массив данных unsigned short по умолчанию (первый).
`short[]`	`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, либо до истечения заданного промежутка реального времени.

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

DataBufferUShort

public DataBufferUShort(int size)

Создаёт DataBuffer на основе unsigned short с одним банком указанного размера.

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

DataBufferUShort

public DataBufferUShort(int size, int numBanks)

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

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

DataBufferUShort

public DataBufferUShort(short[] dataArray, int size)

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

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

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

DataBufferUShort

public DataBufferUShort(short[] dataArray, int size, int offset)

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

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

DataBufferUShort

public DataBufferUShort(short[][] dataArray, int size)

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

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

DataBufferUShort

public DataBufferUShort(short[][] dataArray, int size, int[] offsets)

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

Параметры:: dataArray — Массивы unsigned short для 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 short[] getData()

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

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

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

getData

public short[] getData(int bank)

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

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

getBankData

public short[][] 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.