Module java.desktop
Package java.awt.image

Class DataBufferByte

java.lang.Object
java.awt.image.DataBuffer
java.awt.image.DataBufferByte
public final class DataBufferByte extends DataBuffer
此类扩展了DataBuffer，并将数据内部存储为字节。存储在此DataBuffer的字节数组中的值被视为无符号值。

请注意，某些实现可能会更有效地运行，如果它们可以控制图像数据的存储方式。例如，优化，如将图像缓存到视频内存中，需要实现跟踪对该数据的所有修改。其他实现可能更好地运行，如果它们可以将数据存储在Java数组之外的位置。为了与各种优化保持最佳兼容性，最好避免暴露基础存储为Java数组的构造函数和方法，如下面对这些方法的文档中所述。

  • Constructor Details

    • 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。只应由此DataBuffer的访问器使用前size个元素。 dataArray必须足够大，以容纳size个元素。

      请注意，通过此构造函数创建的DataBuffer对象可能与某些实现使用的性能优化（如将相关图像缓存到视频内存中）不兼容。

      参数:
      dataArray - DataBuffer的字节数组。
      size - DataBuffer存储区的大小。

    • DataBufferByte

      public DataBufferByte(byte[] dataArray, int size, int offset)
      使用指定数组、大小和偏移量构造具有单个存储区的基于字节的DataBuffer。 dataArray必须至少有offset + size个元素。只应由此DataBuffer的访问器使用offset到offset + size - 1的元素。

      请注意，通过此构造函数创建的DataBuffer对象可能与某些实现使用的性能优化（如将相关图像缓存到视频内存中）不兼容。

      参数:
      dataArray - DataBuffer的字节数组。
      size - DataBuffer存储区的大小。
      offset - dataArray中的偏移量。 dataArray必须至少有offset + size个元素。

    • DataBufferByte

      public DataBufferByte(byte[][] dataArray, int size)
      使用指定数组构造具有多个存储区的基于字节的DataBuffer。存储区的数量等于dataArray.length。每个数组的前size个元素应该由此DataBuffer的访问器使用。

      请注意，通过此构造函数创建的DataBuffer对象可能与某些实现使用的性能优化（如将相关图像缓存到视频内存中）不兼容。

      参数:
      dataArray - DataBuffer的字节数组。
      size - DataBuffer存储区的大小。

    • DataBufferByte

      public DataBufferByte(byte[][] dataArray, int size, int[] offsets)
      使用指定数组、大小和偏移量构造具有多个存储区的基于字节的DataBuffer。存储区的数量等于dataArray.length。每个数组必须至少与size +相应offset一样大。每个存储区只应由此DataBuffer的访问器使用offset到offset + size - 1的元素。

      请注意，通过此构造函数创建的DataBuffer对象可能与某些实现使用的性能优化（如将相关图像缓存到视频内存中）不兼容。

      参数:
      dataArray - DataBuffer的字节数组。
      size - DataBuffer存储区的大小。
      offsets - 每个数组的偏移量。

  • Method Details

    • getData

      public byte[] getData()
      返回默认（第一个）字节数据数组。

      请注意，调用此方法可能导致此DataBuffer对象与某些实现使用的性能优化（如将相关图像缓存到视频内存中）不兼容。

      返回:
      第一个字节数据数组。

    • getData

      public byte[] getData(int bank)
      返回指定存储区的数据数组。

      请注意，调用此方法可能导致此DataBuffer对象与某些实现使用的性能优化（如将相关图像缓存到视频内存中）不兼容。

      参数:
      bank - 您要获取数据数组的存储区。
      返回:
      指定存储区的数据数组。

    • getBankData

      public byte[][] getBankData()
      返回所有存储区的数据数组。

      请注意，调用此方法可能导致此DataBuffer对象与某些实现使用的性能优化（如将相关图像缓存到视频内存中）不兼容。

      返回:
      所有数据数组。

    • getElem

      public int getElem(int i)
      返回第一个（默认）存储区中请求的数据数组元素。
      覆盖:
      getElem 在类 DataBuffer中
      参数:
      i - 您要获取的数据数组元素。
      返回:
      请求的数据数组元素作为整数。
      另请参阅:

    • getElem

      public int getElem(int bank, int i)
      返回指定存储区中请求的数据数组元素。
      指定者:
      getElem 在类 DataBuffer中
      参数:
      bank - 您要获取数据数组元素的存储区。
      i - 您要获取的数据数组元素。
      返回:
      请求的数据数组元素作为整数。
      另请参阅:

    • setElem

      public void setElem(int i, int val)
      将第一个（默认）存储区中请求的数据数组元素设置为指定值。
      覆盖:
      setElem 在类 DataBuffer中
      参数:
      i - 您要设置的数据数组元素。
      val - 您要将数据数组元素设置为的整数值。
      另请参阅:

    • setElem

      public void setElem(int bank, int i, int val)
      将指定存储区中请求的数据数组元素从给定整数设置。
      指定者:
      setElem 在类 DataBuffer中
      参数:
      bank - 您要设置数据数组元素的存储区。
      i - 您要设置的数据数组元素。
      val - 您要将指定数据数组元素设置为的整数值。
      另请参阅: