Класс DataBufferShort

java.lang.Object

java.awt.image.DataBuffer

java.awt.image.DataBufferShort

public final class DataBufferShort extends DataBuffer

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

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

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

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

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

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

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

DataBufferShort

public DataBufferShort(int size)

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

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

DataBufferShort

public DataBufferShort(int size, int numBanks)

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

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

DataBufferShort

public DataBufferShort(short[] dataArray, int size)

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

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

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

DataBufferShort

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

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

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

DataBufferShort

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

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

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

DataBufferShort

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

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

Параметры:: dataArray — массивы 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()

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

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

Возвращает:: Первый массив данных типа 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.