Spec-Zone.ru › OpenJDK 21

Класс DataBuffer

java.lang.Object
java.awt.image.DataBuffer
Прямые известные подклассы:
DataBufferByte, DataBufferDouble, DataBufferFloat, DataBufferInt, DataBufferShort, DataBufferUShort 
public abstract class DataBuffer extends Object
Этот класс предназначен для обертывания одного или нескольких массивов данных. Каждый массив данных в DataBuffer называется банком. Существуют методы доступа для получения и задания элементов банков DataBuffer с указанием и без указания банка. Методы без указания банка используют 0-й банк по умолчанию. DataBuffer может необязательно принимать смещение для каждого банка, так что данные в существующем массиве могут быть использованы, даже если интересующие данные не начинаются с нулевой позиции массива. Получение или задание 0-го элемента банка использует (0+смещение)-й элемент массива. Поле size определяет, сколько данных массива доступно для использования. Размер + смещение для данного банка никогда не должно быть больше длины соответствующего массива данных. Тип данных буфера данных указывает тип массива(ов) данных и может также указывать дополнительную семантику, например, хранение беззнаковых 8-битных данных в элементах массива байтов. Тип данных может быть TYPE_UNDEFINED или одним из типов, определённых ниже. В будущем могут быть добавлены другие типы. Обычно объект класса DataBuffer будет приведён к одному из его подклассов, специфичных для типа данных, для доступа к методам, специфичным для типа данных, для повышения производительности. В настоящее время API изображений Java 2D(tm) использует TYPE_BYTE, TYPE_USHORT, TYPE_INT, TYPE_SHORT, TYPE_FLOAT и TYPE_DOUBLE DataBuffers для хранения данных изображения.
См. также:
  • Raster
  • SampleModel

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

Модификатор и тип Поле Описание
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
Тег для беззнаковых данных типа short.

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

DataBuffer(int dataType, int size)
DataBuffer(int dataType, int size, int numBanks)
DataBuffer(int dataType, int size, int numBanks, int offset)
DataBuffer(int dataType, int size, int numBanks, int[] offsets)
Модификатор Конструктор Описание
protected
Создаёт DataBuffer, содержащий один банк указанного типа данных и размера.
protected
Создаёт DataBuffer, содержащий указанное количество банков.
protected
Создаёт DataBuffer, содержащий указанное количество банков.
protected
Создаёт DataBuffer, который содержит указанное количество банков.

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

Модификатор и тип Метод Описание
int getDataType()
Возвращает тип данных этого DataBuffer.
static int getDataTypeSize(int type)
Возвращает размер (в битах) типа данных, заданного тегом типа данных.
int getElem(int i)
Возвращает запрашиваемый элемент массива данных из первого (по умолчанию) банка как целое число.
abstract int getElem(int bank, int i)
Возвращает запрашиваемый элемент массива данных из указанного банка как целое число.
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 setElem(int i, int val)
Задает запрашиваемый элемент массива данных в первом (по умолчанию) банке из данного целого числа.
abstract void setElem(int bank, int i, int val)
Задает запрашиваемый элемент массива данных в указанном банке из данного целого числа.
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.

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

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

Подробное описание полей

TYPE_BYTE

@Native public static final int TYPE_BYTE
Тег для данных беззнакового байта.
См. также:
  • Значения константных полей

TYPE_USHORT

@Native public static final int TYPE_USHORT
Тег для данных беззнакового короткого целого.
См. также:
  • Значения константных полей

TYPE_SHORT

@Native public static final int TYPE_SHORT
Тег для данных со знаком короткого целого.
См. также:
  • Значения константных полей

TYPE_INT

@Native public static final int TYPE_INT
Тег для данных int.
См. также:
  • Значения константных полей

TYPE_FLOAT

@Native public static final int TYPE_FLOAT
Тег для данных float.
См. также:
  • Значения константных полей

TYPE_DOUBLE

@Native public static final int TYPE_DOUBLE
Тег для данных double.
См. также:
  • Значения константных полей

TYPE_UNDEFINED

@Native public static final int TYPE_UNDEFINED
Тег для неопределённых данных.
См. также:
  • Значения константных полей

dataType

protected int dataType
Тип данных этого DataBuffer.

banks

protected int banks
Количество банков в этом DataBuffer.

offset

protected int offset
Смещение в стандартный (первый) банк, с которого получать первый элемент.

size

protected int size
Используемый размер всех банков.

offsets

protected int[] offsets
Смещения во все банки.

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

DataBuffer

protected DataBuffer(int dataType, int size)
Создаёт DataBuffer, содержащий один банк указанного типа и размера.
Параметры:
dataType - тип данных этого DataBuffer
size - размер банков

DataBuffer

protected DataBuffer(int dataType, int size, int numBanks)
Создаёт DataBuffer, содержащий указанное количество банков. Каждый банк имеет указанный размер и смещение 0.
Параметры:
dataType - тип данных этого DataBuffer
size - размер банков
numBanks - количество банков в этом DataBuffer

DataBuffer

protected DataBuffer(int dataType, int size, int numBanks, int offset)
Создаёт DataBuffer, содержащий указанное количество банков. Каждый банк имеет указанный тип, размер и смещение.
Параметры:
dataType - тип данных этого DataBuffer
size - размер банков
numBanks - количество банков в этом DataBuffer
offset - смещение для каждого банка

DataBuffer

protected DataBuffer(int dataType, int size, int numBanks, int[] offsets)
Создаёт DataBuffer, содержащий указанное количество банков. Каждый банк имеет указанный тип и размер. Смещение для каждого банка задаётся соответствующим элементом в массиве смещений.
Параметры:
dataType - тип данных этого DataBuffer
size - размер банков
numBanks - количество банков в этом DataBuffer
offsets - массив, содержащий смещение для каждого банка.
Исключения:
ArrayIndexOutOfBoundsException - если numBanks не равно длине offsets

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

getDataTypeSize

public static int getDataTypeSize(int type)
Возвращает размер (в битах) типа данных, заданного тегом типа данных.
Параметры:
type - значение одного из определённых тегов типа данных
Возвращает:
размер типа данных
Исключения:
IllegalArgumentException - если type меньше нуля или больше TYPE_DOUBLE

getDataType

public int getDataType()
Возвращает тип данных этого DataBuffer.
Возвращает:
тип данных этого DataBuffer.

getSize

public int getSize()
Возвращает размер (в элементах массива) всех банков.
Возвращает:
размер всех банков.

getOffset

public int getOffset()
Возвращает смещение стандартного банка в элементах массива.
Возвращает:
смещение стандартного банка.

getOffsets

public int[] getOffsets()
Возвращает смещения (в элементах массива) всех банков.
Возвращает:
смещения всех банков.

getNumBanks

public int getNumBanks()
Возвращает количество банков в этом DataBuffer.
Возвращает:
количество банков.

getElem

public int getElem(int i)
Возвращает запрашиваемый элемент массива данных из первого (стандартного) банка как целое число.
Параметры:
i - индекс запрашиваемого элемента массива данных
Возвращает:
элемент массива данных по указанному индексу.
См. также:
  • setElem(int, int)
  • setElem(int, int, int)

getElem

public abstract int getElem(int bank, int i)
Возвращает запрашиваемый элемент массива данных из указанного банка как целое число.
Параметры:
bank - указанный банк
i - индекс запрашиваемого элемента массива данных
Возвращает:
элемент массива данных по указанному индексу из указанного банка по указанному индексу.
См. также:
  • setElem(int, int)
  • setElem(int, int, int)

setElem

public void setElem(int i, int val)
Устанавливает запрашиваемый элемент массива данных в первом (стандартном) банке из данного целого числа.
Параметры:
i - указанный индекс в массиве данных
val - данные для установки элемента в указанном индексе в массиве данных
См. также:
  • getElem(int)
  • getElem(int, int)

setElem

public abstract void setElem(int bank, int i, int val)
Устанавливает запрашиваемый элемент массива данных в указанном банке из данного целого числа.
Параметры:
bank - указанный банк
i - указанный индекс в массиве данных
val - данные для установки элемента в указанном банке по указанному индексу в массиве данных
См. также:
  • getElem(int)
  • getElem(int, int)

getElemFloat

public float getElemFloat(int i)
Возвращает запрашиваемый элемент массива данных из первого (стандартного) банка как float. Реализация в этом классе — преобразование getElem(i) к float. Подклассы могут переопределить этот метод, если нужна другая реализация.
Параметры:
i - индекс запрашиваемого элемента массива данных
Возвращает:
значение типа float, представляющее элемент массива данных по указанному индексу.
См. также:
  • setElemFloat(int, float)
  • setElemFloat(int, int, float)

getElemFloat

public float getElemFloat(int bank, int i)
Возвращает запрашиваемый элемент массива данных из указанного банка в виде числа с плавающей точкой. Реализация в этом классе заключается в приведении getElem(int, int) к типу float. Подклассы могут переопределить этот метод, если требуется другая реализация.
Параметры:
bank - указанный банк
i - индекс запрашиваемого элемента массива данных
Возвращает:
значение с плавающей точкой, представляющее элемент массива данных из указанного банка по указанному индексу.
См. также:
  • setElemFloat(int, float)
  • setElemFloat(int, int, float)

setElemFloat

public void setElemFloat(int i, float val)
Устанавливает запрашиваемый элемент массива данных в первом (по умолчанию) банке из заданного числа с плавающей точкой. Реализация в этом классе заключается в приведении val к типу int и вызове setElem(int, int). Подклассы могут переопределить этот метод, если требуется другая реализация.
Параметры:
i - указанный индекс
val - значение для установки элемента по указанному индексу в массиве данных
См. также:
  • getElemFloat(int)
  • getElemFloat(int, int)

setElemFloat

public void setElemFloat(int bank, int i, float val)
Устанавливает запрашиваемый элемент массива данных в указанном банке из заданного числа с плавающей точкой. Реализация в этом классе заключается в приведении val к типу int и вызове setElem(int, int). Подклассы могут переопределить этот метод, если требуется другая реализация.
Параметры:
bank - указанный банк
i - указанный индекс
val - значение для установки элемента в указанном банке по указанному индексу в массиве данных
См. также:
  • getElemFloat(int)
  • getElemFloat(int, int)

getElemDouble

public double getElemDouble(int i)
Возвращает запрашиваемый элемент массива данных из первого (по умолчанию) банка в виде числа с двойной точностью. Реализация в этом классе заключается в приведении getElem(int) к типу double. Подклассы могут переопределить этот метод, если требуется другая реализация.
Параметры:
i - указанный индекс
Возвращает:
значение с двойной точностью, представляющее элемент по указанному индексу в массиве данных.
См. также:
  • setElemDouble(int, double)
  • setElemDouble(int, int, double)

getElemDouble

public double getElemDouble(int bank, int i)
Возвращает запрашиваемый элемент массива данных из указанного банка в виде числа с двойной точностью. Реализация в этом классе заключается в приведении getElem(bank, i) к типу double. Подклассы могут переопределить этот метод, если требуется другая реализация.
Параметры:
bank - указанный банк
i - указанный индекс
Возвращает:
значение с двойной точностью, представляющее элемент из указанного банка по указанному индексу в массиве данных.
См. также:
  • setElemDouble(int, double)
  • setElemDouble(int, int, double)

setElemDouble

public void setElemDouble(int i, double val)
Устанавливает запрашиваемый элемент массива данных в первом (по умолчанию) банке из заданного числа с двойной точностью. Реализация в этом классе заключается в приведении val к типу int и вызове setElem(int, int). Подклассы могут переопределить этот метод, если требуется другая реализация.
Параметры:
i - указанный индекс
val - значение для установки элемента по указанному индексу в массиве данных
См. также:
  • getElemDouble(int)
  • getElemDouble(int, int)

setElemDouble

public void setElemDouble(int bank, int i, double val)
Устанавливает запрашиваемый элемент массива данных в указанном банке из заданного числа с двойной точностью. Реализация в этом классе заключается в приведении val к типу int и вызове setElem(int, int). Подклассы могут переопределить этот метод, если требуется другая реализация.
Параметры:
bank - указанный банк
i - указанный индекс
val - значение для установки элемента в указанном банке по указанному индексу в массиве данных
См. также:
  • getElemDouble(int)
  • getElemDouble(int, int)

© 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/DataBuffer.html

Spec-Zone.ru

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