Класс 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+смещение) массива. Поле размера определяет, сколько данных массива доступно для использования. Размер + смещение для данного банка никогда не должны быть больше длины соответствующего массива данных. Тип данных буфера данных указывает тип массива(ов) данных и может также указывать дополнительную семантику, например, хранение беззнаковых 8-битных данных в элементах массива байтов. Тип данных может быть TYPE_UNDEFINED или одним из типов, определенных ниже. В будущем могут быть добавлены другие типы. Обычно объект класса DataBuffer будет приведён к одному из его подклассов, специфичных для типа данных, для доступа к методам, специфичным для типа данных, для повышения производительности. В настоящее время классы изображений API Java 2D(tm) используют DataBuffers TYPE_BYTE, TYPE_USHORT, TYPE_INT, TYPE_SHORT, TYPE_FLOAT и TYPE_DOUBLE для хранения данных изображения.

См. также:: Raster, SampleModel

Поля

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

Конструкторы

Модификатор	Конструктор и описание
`protected`	`DataBuffer(int dataType, int size)` Создаёт DataBuffer, содержащий один банк указанного типа данных и размера.
`protected`	`DataBuffer(int dataType, int size, int numBanks)` Создаёт DataBuffer, содержащий указанное количество банков.
`protected`	`DataBuffer(int dataType, int size, int numBanks, int offset)` Создаёт DataBuffer, содержащий указанное количество банков.
`protected`	`DataBuffer(int dataType, int size, int numBanks, int[] offsets)` Создаёт 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, содержащий указанное количество банков. Каждый банк имеет указанный тип данных и размер. Смещение для каждого банка задаётся соответствующим элементом массива offsets.

Параметры:: 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)

Возвращает запрашиваемый элемент массива данных из указанного банка как тип float. Реализация в этом классе – привести getElem(int, int) к типу float. Подклассы могут переопределить этот метод, если требуется другая реализация.

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

setElemFloat

public void setElemFloat(int i,
                         float val)

Устанавливает запрашиваемый элемент массива данных в первом (исходном) банке из данного значения типа float. Реализация в этом классе – привести val к типу int и вызвать setElem(int, int). Подклассы могут переопределить этот метод, если требуется другая реализация.

Параметры:: i - указанный индекс; val - значение для установки элемента по указанному индексу в массиве данных
См. также:: getElemFloat(int), getElemFloat(int, int)

setElemFloat

public void setElemFloat(int bank,
                         int i,
                         float val)

Устанавливает запрашиваемый элемент массива данных в указанном банке из данного значения типа float. Реализация в этом классе – привести val к типу int и вызвать setElem(int, int). Подклассы могут переопределить этот метод, если требуется другая реализация.

Параметры:: bank - указанный банк; i - указанный индекс; val - значение для установки элемента в указанный банк по указанному индексу в массиве данных
См. также:: getElemFloat(int), getElemFloat(int, int)

getElemDouble

public double getElemDouble(int i)

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

Параметры:: i - указанный индекс
Возвращаемое значение:: значение double, представляющее элемент в массиве данных по указанному индексу.
См. также:: setElemDouble(int, double), setElemDouble(int, int, double)

getElemDouble

public double getElemDouble(int bank,
                            int i)

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

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

setElemDouble

public void setElemDouble(int i,
                          double val)

Устанавливает запрашиваемый элемент массива данных в первом (по умолчанию) банке из заданного double. Реализация в этом классе заключается в приведении val к типу int и вызове setElem(int, int). Подклассы могут переопределять этот метод, если требуется другая реализация.

Параметры:: i - указанный индекс; val - значение для установки элемента по указанному индексу в массиве данных
См. также:: getElemDouble(int), getElemDouble(int, int)

setElemDouble

public void setElemDouble(int bank,
                          int i,
                          double val)

Устанавливает запрашиваемый элемент массива данных в указанном банке из заданного double. Реализация в этом классе заключается в приведении val к типу int и вызове setElem(int, int). Подклассы могут переопределять этот метод, если требуется другая реализация.

Параметры:: bank - указанный банк; i - указанный индекс; val - значение для установки элемента в указанном банке по указанному индексу в массиве данных
См. также:: getElemDouble(int), getElemDouble(int, int)

© 1993, 2020, 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.