Module java.desktop

软件包 java.awt.image

Class DataBufferByte

java.lang.Object

java.awt.image.DataBuffer

java.awt.image.DataBufferByte

public final class DataBufferByte
extends DataBuffer

该类扩展了DataBuffer并将数据内部存储为字节。 存储在该DataBuffer的字节数组中的值被视为无符号值。

Note that some implementations may function more efficiently if they can maintain control over how the data for an image is stored. For example, optimizations such as caching an image in video memory require that the implementation track all modifications to that data. Other implementations may operate better if they can store the data in locations other than a Java array. To maintain optimum compatibility with various optimizations it is best to avoid constructors and methods which expose the underlying storage as a Java array, as noted below in the documentation for those methods.

Field Summary

Fields inherited from class java.awt.image.DataBuffer

banks, dataType, offset, offsets, size, TYPE_BYTE, TYPE_DOUBLE, TYPE_FLOAT, TYPE_INT, TYPE_SHORT, TYPE_UNDEFINED, TYPE_USHORT

构造方法摘要

构造方法

Constructor	描述
DataBufferByte(byte[][] dataArray, int size)	使用指定的数组构造一个基于字节的 DataBuffer 。
DataBufferByte(byte[][] dataArray, int size, int[] offsets)	构造一个基于字节的 DataBuffer具有指定的数组，大小和偏移量。
DataBufferByte(byte[] dataArray, int size)	使用指定的数组构建一个基于字节的 DataBuffer与单个库。
DataBufferByte(byte[] dataArray, int size, int offset)	使用指定的数组，大小和偏移量，使用单个存储库构造一个基于字节的 DataBuffer 。
DataBufferByte(int size)	构造一个基于字节的 DataBuffer与一个单独的银行和指定的大小。
DataBufferByte(int size, int numBanks)	构造一个基于字节的 DataBuffer ，其中指定数量的库都是指定的大小。

方法摘要

Modifier and Type	方法	描述
byte[][]	getBankData()	返回所有库的数据数组。
byte[]	getData()	返回默认（第一个）字节数据数组。
byte[]	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)	从给定的整数设置指定库中的请求的数据数组元素。

Methods inherited from class java.awt.image.DataBuffer

getDataType, getDataTypeSize, getElemDouble, getElemDouble, getElemFloat, getElemFloat, getNumBanks, getOffset, getOffsets, getSize, setElemDouble, setElemDouble, setElemFloat, setElemFloat

Methods inherited from class java.lang.Object

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

构造方法详细信息

DataBufferByte

public DataBufferByte(int size)

构造一个基于字节的 DataBuffer与单个银行和指定的大小。

参数

size - 大小的 DataBuffer 。

DataBufferByte

public DataBufferByte(int size,
                      int numBanks)

构造一个基于字节的 DataBuffer ，其中指定数量的库都是指定的大小。

参数

size - 银行的大小在 DataBuffer 。

numBanks - 一个 DataBuffer的银行数量。

DataBufferByte

public DataBufferByte(byte[] dataArray,
                      int size)

使用指定的数组构造一个基于字节的DataBuffer与一个单独的库。 只有第size要素应当由本的访问器只能使用DataBuffer 。 dataArray必须足够大才能容纳size元素。

请注意，由此构造函数创建的DataBuffer对象可能与某些实现使用的performance optimizations不兼容（例如缓存视频内存中的关联图像）。

参数

dataArray -字节数组为 DataBuffer 。

size - 大小的 DataBuffer银行。

DataBufferByte

public DataBufferByte(byte[] dataArray,
                      int size,
                      int offset)

使用指定的数组，大小和偏移构造一个基于字节的DataBuffer与单个库。 dataArray必须至少有offset + size元素。 只有offset到offset + size元素应该由DataBuffer 。

请注意，此构造函数创建的对象DataBuffer可能与某些实现（例如，缓存视频内存中的关联图像）所使用的performance optimizations不兼容。

参数

dataArray -字节数组为 DataBuffer 。

size - DataBuffer银行的大小。

offset - 偏移到dataArray 。 dataArray必须至少有offset + size元素。

DataBufferByte

public DataBufferByte(byte[][] dataArray,
                      int size)

构造一个基于字节的DataBuffer与指定的数组。 银行数量等于dataArray.length 。 这个DataBuffer的访问者只能使用每个数组的第一个size元素。

请注意，此构造函数创建的DataBuffer对象可能与某些实现使用的performance optimizations不兼容（例如在视频内存中缓存关联的图像）。

参数

dataArray -为对的字节数组 DataBuffer 。

size - 银行规模在 DataBuffer 。

DataBufferByte

public DataBufferByte(byte[][] dataArray,
                      int size,
                      int[] offsets)

构造一个基于字节的DataBuffer具有指定的数组，大小和偏移量。 银行数量等于dataArray.length 。 每个阵列必须至少与size +相应的offset一样大。 必须有一个条目offset阵列每个dataArray条目。 对于每个银行，只有元素offset至offset + size应由该DataBuffer 。

请注意，由此构造函数创建的DataBuffer对象可能与某些实现使用的performance optimizations不兼容（例如在视频内存中缓存关联的映像）。

参数

dataArray -为对的字节数组 DataBuffer 。

size - 银行规模在 DataBuffer 。

offsets - 每个数组的偏移量。

方法详细信息

getData

public byte[] getData()

返回默认（第一个）字节数据数组。

请注意，调用此方法可能会导致此DataBuffer对象与某些实现使用的performance optimizations不兼容（例如在视频内存中缓存关联的映像）。

结果

第一个字节数据数组。

getData

public byte[] getData(int bank)

返回指定库的数据数组。

请注意，调用此方法可能会导致此DataBuffer对象与某些实现使用的performance optimizations不兼容（例如在视频内存中缓存关联的映像）。

参数

bank - 您想要获取数据数组的银行。

结果

指定银行的数据数组。

getBankData

public byte[][] getBankData()

返回所有库的数据数组。

请注意，调用此方法可能会导致此DataBuffer对象与某些实现使用的performance optimizations不兼容（例如在视频内存中缓存关联的映像）。

结果

所有的数据阵列。

getElem

public int getElem(int i)

从第一个（默认）库返回所请求的数据数组元素。

重写：

getElem在 DataBuffer

参数

i - 要获取的数据数组元素。

结果

请求的数据数组元素为整数。

另请参见：

setElem(int, int) ， setElem(int, int, int)

getElem

public int getElem(int bank,
                   int i)

从指定的库返回所请求的数据数组元素。

Specified by:

getElem在 DataBuffer

参数

bank - 要从中获取数据数组元素的存储区。

i - 您要获取的数据数组元素。

结果

请求的数据数组元素为整数。

另请参见：

setElem(int, int) ， setElem(int, int, int)

setElem

public void setElem(int i,
                    int val)

将第一个（默认）库中的请求的数据数组元素设置为指定的值。

重写：

setElem在 DataBuffer

参数

i - 要设置的数据数组元素。

val - 要设置数据数组元素的整数值。

另请参见：

getElem(int) ， getElem(int, int)

setElem

public void setElem(int bank,
                    int i,
                    int val)

从给定的整数设置指定库中的请求的数据数组元素。

Specified by:

setElem在 DataBuffer

参数

bank - 要在其中设置数据数组元素的存储区。

i - 要设置的数据数组元素。

val - 要设置指定数据数组元素的整数值。

另请参见：

getElem(int) ， getElem(int, int)