java.awt.image
类 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 号元素，请使用数组的 (0+offset) 号元素。size 字段指定数据数组中有多少元素可供使用。给定存储单元的 size + offset 永远不应该大于相关数据数组的长度。数据缓冲区的数据类型指示数据数组的类型，还可以指示其他语义，例如，在字节数组的元素中存储无符号 8 位数据。数据类型可以是 TYPE_UNDEFINED，也可以是下面定义的类型之一。其他类型可以在将来添加。通常，类 DataBuffer 的对象将强制转换为其数据类型的特定子类之一来访问数据类型的特定方法以便改善性能。当前，Java 2D(tm) API 图像类使用 TYPE_BYTE、TYPE_USHORT、TYPE_INT、TYPE_SHORT、TYPE_FLOAT 和 TYPE_DOUBLE DataBuffer 存储图像数据。

另请参见：

Raster, SampleModel

字段摘要

protected int	banks 此 DataBuffer 中存储单元的数量。
protected int	dataType 此 DataBuffer 的数据类型。
protected int	offset 默认（第一个）存储单元的偏移量，从中可获得第一个元素。
protected int[]	offsets 所有存储单元的偏移量。
protected int	size 所有存储单元的可用大小。
static int	TYPE_BYTE 无符号 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) 返回由给定 datatype 标记所代表的数据类型的大小（以位为单位）。
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

public static final int TYPE_BYTE

无符号 byte 数据的标记

另请参见：

常量字段值

TYPE_USHORT

public static final int TYPE_USHORT

无符号 short 数据的标记

另请参见：

常量字段值

TYPE_SHORT

public static final int TYPE_SHORT

有符号 short 数据的标记。供将来使用的占位符。

另请参见：

常量字段值

TYPE_INT

public static final int TYPE_INT

int 数据的标记。

另请参见：

常量字段值

TYPE_FLOAT

public static final int TYPE_FLOAT

float 数据的标记。供将来使用的占位符。

另请参见：

常量字段值

TYPE_DOUBLE

public static final int TYPE_DOUBLE

double 数据的标记。供将来使用的占位符。

另请参见：

常量字段值

TYPE_UNDEFINED

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)

返回由给定 datatype 标记所代表的数据类型的大小（以位为单位）。

参数：

type - 已定义的 datatype 标记之一的值

返回：

数据类型的大小

抛出：

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)