Java java.awt.image 类 SinglePixelPackedSampleModel（JDK5）

所有类

java.awt.image
类 SinglePixelPackedSampleModel

java.lang.Object
  java.awt.image.SampleModel
      java.awt.image.SinglePixelPackedSampleModel

public class SinglePixelPackedSampleModel
   
   
   
   
   
extends SampleModel
   
   
   
   
   

此类表示压缩的像素数据：将 N 个样本组成的单个像素存储在单个数据数组元素中，每个数据数组元素只保存一个像素的样本。此类支持 TYPE_BYTE、TYPE_USHORT 和 TYPE_INT 数据类型。所有数据数组元素都位于 DataBuffer 的第一个存储单元中。该类提供了一些存取器方法，以便直接操作图像数据。扫描行跨距是给定样本和下一个扫描行同一列中对应样本之间的数据数组元素的数量。位掩码是提取表示像素 band 的样本所需的掩码。位偏移量是表示像素 band 的样本的数据数组元素中位的偏移量。

以下代码阐释了如何从 DataBuffer data 中提取表示像素 x,y 的 band b 的样本位：

      int sample = data.getElem(y * scanlineStride + x);
      sample = (sample & bitMasks[b]) >>> bitOffsets[b];
 

SinglePixelPackedSampleModel

public SinglePixelPackedSampleModel(int dataType,
                                    int w,
                                    int h,
                                    int[] bitMasks)

构造一个具有 bitMasks.length band 的 SinglePixelPackedSampleModel。每个样本都存储在数据数组元素中其对应位掩码的位置处。每个位掩码必须是邻接的且掩码不能重叠。

参数：

dataType - 存储样本使用的数据类型。

w - 所描述的图像数据区域的（像素）宽度。

h - 所描述的图像数据区域的（像素）高度。

bitMasks - 所有 band 的位掩码。

抛出：

IllegalArgumentException - 如果 dataType 不是 DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT 或 DataBuffer.TYPE_INT

SinglePixelPackedSampleModel

public SinglePixelPackedSampleModel(int dataType,
                                    int w,
                                    int h,
                                    int scanlineStride,
                                    int[] bitMasks)

构造一个 SinglePixelPackedSampleModel，它具有 bitMasks.length band，并且扫描行跨距等于 scanlineStride 数据数组元素。每个样本都存储在数据数组元素中其对应位掩码的位置处。每个位掩码必须是邻接的且掩码不能重叠。

参数：

dataType - 存储样本使用的数据类型。

w - 所描述的图像数据区域的（像素）宽度。

h - 所描述的图像数据区域的（像素）高度。

scanlineStride - 图像数据的行跨距。

bitMasks - 所有 band 的位掩码。

抛出：

IllegalArgumentException - 如果 w 或 h 不大于 0

IllegalArgumentException - 如果 bitMask 中的任何掩码不相邻

IllegalArgumentException - 如果 dataType 不是 DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT 或 DataBuffer.TYPE_INT

getNumDataElements

public int getNumDataElements()

返回通过 getDataElements 和 setDataElements 方法传输一个像素所需的数据元素数。对于 SinglePixelPackedSampleModel，此元素数为 1。

指定者：

类 SampleModel 中的 getNumDataElements

返回：

数据元素的数量。

另请参见：

SampleModel.getDataElements(int, int, Object, DataBuffer), SampleModel.getDataElements(int, int, int, int, Object, DataBuffer), SampleModel.setDataElements(int, int, Object, DataBuffer), SampleModel.setDataElements(int, int, int, int, Object, DataBuffer), SampleModel.getTransferType()

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

创建一个具有指定宽度和高度的新 SinglePixelPackedSampleModel。新 SinglePixelPackedSampleModel 的存储数据类型和位掩码与此 SinglePixelPackedSampleModel 相同。

指定者：

类 SampleModel 中的 createCompatibleSampleModel

参数：

w - 得到的 SampleModel 的宽度

h - 得到的 SampleModel 的高度

返回：

具有指定宽度和高度的 SinglePixelPackedSampleModel。

抛出：

IllegalArgumentException - 如果 w 或 h 不大于 0

createDataBuffer

public DataBuffer createDataBuffer()

创建一个对应于此 SinglePixelPackedSampleModel 的 DataBuffer。DataBuffer 的数据类型和大小将与此 SinglePixelPackedSampleModel 一致。DataBuffer 只有一个存储单元。

指定者：

类 SampleModel 中的 createDataBuffer

返回：

对应于此 SampleModel 的 DataBuffer。

getSampleSize

public int[] getSampleSize()

返回所有 band 的每个样本的位数。

指定者：

类 SampleModel 中的 getSampleSize

返回：

所有 band 样本的大小。

getSampleSize

public int getSampleSize(int band)

返回指定 band 的每个样本的位数。

指定者：

类 SampleModel 中的 getSampleSize

参数：

band - 指定的 band

返回：

指定 band 样本的大小。

getOffset

public int getOffset(int x,
                     int y)

返回像素 (x,y)（在数据数组元素中）的偏移量。包含像素 x,y 的数据元素可以使用 SinglePixelPackedSampleModel sppsm 从 DataBuffer data 中检索：

        data.getElem(sppsm.getOffset(x, y));
 

参数：

x, y - 指定像素的坐标

返回：

指定像素的偏移量。