SampleModel (Java Platform SE 8 )

java.lang.Object
- java.awt.image.SampleModel

已知直接子类：

ComponentSampleModel， MultiPixelPackedSampleModel， SinglePixelPackedSampleModel
```
public abstract class SampleModel
extends Object
```
这个抽象类定义了一个用于提取图像中的像素样本的接口。所有的图像数据被表示为一个像素的集合。每个像素由一个样本数。一个样本是一个图像的一个带的基准，一个带由一个特定类型的图像中的所有样本组成。例如，一个像素可能包含代表其红色、绿色和蓝色分量的三个样本。包含这个像素的图像中有三个波段。一个乐队由所有的红色样本的图像中的所有像素。第二波段由所有的绿色样品和剩余的带由所有的蓝色样品。该像素可以被存储在各种格式。例如，从一个特定的带所有的样品可以连续存储或从一个单一的像素样本可以连续存储。
子samplemodel指定样本类型可以表示（如8位无符号字节，签约16位短，等），可以指定如何在内存中的组织样本。在java 2D（TM）API，内置图像处理算子不可能对所有可能的样本类型进行操作，但一般为16位无符号整数的样品或不工作。一些运营商支持更广泛的样本类型。

的像素的集合表示为一个光栅，由DataBuffer和samplemodel。的samplemodel允许访问样本的DataBuffer和可以提供低层次的信息，程序员可以使用直接操作在DataBuffer的样品和像素。

这个类通常是处理图像的一个返回方法。更高效的代码将SampleModel到相应的子类和提取需要直接操纵在DataBuffer点的信息。

另请参见：

DataBuffer， Raster， ComponentSampleModel， PixelInterleavedSampleModel， BandedSampleModel， MultiPixelPackedSampleModel， SinglePixelPackedSampleModel

Field Summary

Fields
Modifier and Type	Field and Description
`protected int`	`dataType` DataBuffer的存储像素数据的数据类型。
`protected int`	`height` 在图像数据，SampleModel描述了区域像素高度。
`protected int`	`numBands` 对这个SampleModel描述的图像数据条带数。
`protected int`	`width` 在图像数据，SampleModel描述了区域的像素宽度。

构造方法摘要

构造方法
Constructor and Description
`SampleModel(int dataType, int w, int h, int numBands)` 构建一个与指定的参数samplemodel。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract SampleModel`	`createCompatibleSampleModel(int w, int h)` 创建一个samplemodel描述SampleModel的这个格式的数据，但具有不同的宽度和高度。
`abstract DataBuffer`	`createDataBuffer()` 创建一个数据缓冲区，对应于这个SampleModel。
`abstract SampleModel`	`createSubsetSampleModel(int[] bands)` 创建与这SampleModel的一个子集带一个新的samplemodel。
`Object`	`getDataElements(int x, int y, int w, int h, Object obj, DataBuffer data)` 返回指定的矩形中的像素阵列式transfertype像素数据。
`abstract Object`	`getDataElements(int x, int y, Object obj, DataBuffer data)` 返回在一个原始的数组类型transfertype单个像素数据。
`int`	`getDataType()` 返回DataBuffer存储像素数据的数据类型。
`int`	`getHeight()` 返回像素的高度。
`int`	`getNumBands()` 返回图像数据的总带数。
`abstract int`	`getNumDataElements()` 返回的数据元素需要传送一个像素数通过getdataelements和setdataelements方法。
`double[]`	`getPixel(int x, int y, double[] dArray, DataBuffer data)` 返回在一个数组中指定的像素的样本。
`float[]`	`getPixel(int x, int y, float[] fArray, DataBuffer data)` 返回一个浮点数组中指定的像素的样本。
`int[]`	`getPixel(int x, int y, int[] iArray, DataBuffer data)` 返回一个int数组指定像素的样本，每一样本的数组元素。
`double[]`	`getPixels(int x, int y, int w, int h, double[] dArray, DataBuffer data)` 返回一个双数组中一个像素的矩形的所有样本，一个样本每一个数组元素。
`float[]`	`getPixels(int x, int y, int w, int h, float[] fArray, DataBuffer data)` 返回浮点数组中的像素的矩形的所有样本，每个数组元素的一个样本。
`int[]`	`getPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)` 返回一个int数组的一个矩形的像素样本，每一样本的数组元素。
`abstract int`	`getSample(int x, int y, int b, DataBuffer data)` 返回像素位于指定带样品（x，y）为int型。
`double`	`getSampleDouble(int x, int y, int b, DataBuffer data)` 返回位于（X，Y）为双的像素指定的带中的样本。
`float`	`getSampleFloat(int x, int y, int b, DataBuffer data)` 返回位于（X，Y）作为一个浮动的像素指定的带中的样本。
`double[]`	`getSamples(int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)` 返回一个指定的带指定的矩形的像素在一个双数组，一个样本每一个数组元素的样本。
`float[]`	`getSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)` 返回浮点数组中指定的矩形像素的指定带的样本，每个数组元素的一个示例。
`int[]`	`getSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)` 返回在指定的矩形的像素在一个int数组指定带样品，每一样品的数组元素。
`abstract int[]`	`getSampleSize()` 返回所有带的样本位的大小。
`abstract int`	`getSampleSize(int band)` 返回指定带的样本数的大小。
`int`	`getTransferType()` 返回用于传输像素通过getdataelements和setdataelements方法transfertype。
`int`	`getWidth()` 返回像素的宽度。
`void`	`setDataElements(int x, int y, int w, int h, Object obj, DataBuffer data)` 设置从原始数组中指定的类型transfertype DataBuffer矩形像素数据。
`abstract void`	`setDataElements(int x, int y, Object obj, DataBuffer data)` 设置从原始数组中指定的DataBuffer型transfertype单个像素的数据。
`void`	`setPixel(int x, int y, double[] dArray, DataBuffer data)` 设置一个像素使用输入的双数组中的样本数据缓存。
`void`	`setPixel(int x, int y, float[] fArray, DataBuffer data)` 设置一个像素使用一个样本输入浮点数组的数据缓存。
`void`	`setPixel(int x, int y, int[] iArray, DataBuffer data)` 设置一个像素使用的样本输入一个int数组的数据缓存。
`void`	`setPixels(int x, int y, int w, int h, double[] dArray, DataBuffer data)` 将包含一个数组元素的双数组中的一个像素的矩形设置为一个矩形。
`void`	`setPixels(int x, int y, int w, int h, float[] fArray, DataBuffer data)` 将包含一个数组元素的浮动数组中的每个像素的矩形设置为一个矩形。
`void`	`setPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)` 设置从一个数组的数组元素包含每一个样本像素矩形样品。
`void`	`setSample(int x, int y, int b, double s, DataBuffer data)` 设置指定的带样的像素位于（x，y）使用一个双输入的数据缓存。
`void`	`setSample(int x, int y, int b, float s, DataBuffer data)` 设置指定的带样的像素位于（x，y）用于输入一个浮在数据缓存。
`abstract void`	`setSample(int x, int y, int b, int s, DataBuffer data)` 设置指定的带样的像素位于（x，y）用于输入一个int的数据缓存。
`void`	`setSamples(int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)` 将指定的带中的样本设置为指定的矩形，从每个数组元素的一个数组包含一个样本。
`void`	`setSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)` 将包含一个数组元素的浮点数数组指定为指定的矩形区域中的样本设置为指定的矩形。
`void`	`setSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)` 设置指定矩形的像素从一个int数组包含一个样品在每个数组元素指定带样品。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - width
```
protected int width
```
    在图像数据，SampleModel描述了区域的像素宽度。
  - height
```
protected int height
```
    在图像数据，SampleModel描述了区域像素高度。
  - numBands
```
protected int numBands
```
    对这个SampleModel描述的图像数据条带数。
  - dataType
```
protected int dataType
```
    DataBuffer的存储像素数据的数据类型。
    
    另请参见：
    
    DataBuffer
- Constructor Detail
  - SampleModel
```
public SampleModel(int dataType,
                   int w,
                   int h,
                   int numBands)
```
    构建一个与指定的参数samplemodel。
    
    参数
    
    dataType - DataBuffer存储像素数据的数据类型。
    
    w的宽度（像素）的图像数据的区域。
    
    h -高度（像素）的图像数据的区域。
    
    numBands -图像数据的条带数。
    
    异常
    
    IllegalArgumentException -如果 w或 h不大于0
    
    IllegalArgumentException -如果 w和 h产品大于 Integer.MAX_VALUE
    
    IllegalArgumentException -如果 dataType之一是不支持的数据类型
- 方法详细信息
  - getWidth
```
public final int getWidth()
```
    返回像素的宽度。
    
    结果
    
    在图像数据，这 SampleModel描述区域的像素宽度。
  - getHeight
```
public final int getHeight()
```
    返回像素的高度。
    
    结果
    
    在图像数据，这 SampleModel描述区域的像素高度。
  - getNumBands
```
public final int getNumBands()
```
    返回图像数据的总带数。
    
    结果
    
    对图像数据，这 SampleModel描述带数。
  - getNumDataElements
```
public abstract int getNumDataElements()
```
    返回的数据元素需要传送一个像素数通过getdataelements和setdataelements方法。当像素是通过这些途径转移，他们可以在包装或散装的形式转移，根据不同的samplemodel实施。使用这些方法，像素作为一个原始类型的数组元素gettransfertype() getnumdataelements()转移。的transfertype可以或不可以作为存储的数据类型相同。
    
    结果
    
    数据元素的数量。
    
    另请参见：
    
    getDataElements(int, int, Object, DataBuffer)， getDataElements(int, int, int, int, Object, DataBuffer)， setDataElements(int, int, Object, DataBuffer)， setDataElements(int, int, int, int, Object, DataBuffer)， getTransferType()
  - getDataType
```
public final int getDataType()
```
    返回DataBuffer存储像素数据的数据类型。
    
    结果
    
    数据类型。
  - getTransferType
```
public int getTransferType()
```
    返回用于传输像素通过getdataelements和setdataelements方法transfertype。当像素是通过这些途径转移，他们可以在包装或散装的形式转移，根据不同的samplemodel实施。使用这些方法，像素作为一个原始类型的数组元素gettransfertype() getnumdataelements()转移。的transfertype可以或不可以作为存储的数据类型相同。的transfertype之一将在DataBuffer定义的类型。
    
    结果
    
    转移类型。
    
    另请参见：
    
    getDataElements(int, int, Object, DataBuffer)， getDataElements(int, int, int, int, Object, DataBuffer)， setDataElements(int, int, Object, DataBuffer)， setDataElements(int, int, int, int, Object, DataBuffer)， getNumDataElements()， DataBuffer
  - getPixel
```
public int[] getPixel(int x,
                      int y,
                      int[] iArray,
                      DataBuffer data)
```
    返回一个int数组指定像素的样本，每一样本的数组元素。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标
    
    y的像素位置的y坐标
    
    iArray如果非零，返回这个数组的样品
    
    data -包含图像数据的数据缓冲区
    
    结果
    
    指定像素的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果iarray太小装的输出。
    
    另请参见：
    
    setPixel(int, int, int[], DataBuffer)
  - getDataElements
```
public abstract Object getDataElements(int x,
                                       int y,
                                       Object obj,
                                       DataBuffer data)
```
    返回在一个原始的数组类型transfertype单个像素数据。图像数据的java 2D API的支持，这将是一个databuffer.type_byte，databuffer.type_ushort，databuffer.type_int，databuffer.type_short，databuffer.type_float，或databuffer.type_double。数据可以以填充的格式返回，从而提高了数据传输的效率。一般来说，目标应该通过为零，这样的对象会被自动创建并将正确的原始数据类型。
    下面的代码演示了一个像素传输数据从缓冲db1，其存储布局是通过samplemodel sm1描述，对数据缓存db2，其存储布局是通过samplemodel sm2描述。转移通常会比使用GetPixel / SetPixel更有效。
```
samplemodel SM1，SM2；缓冲DB1、DB2；SM2。setdataelements（x，y，SM1。getdataelements（x，y，null，DB1、DB2））；
```
    使用getdataelements / setdataelements两缓冲/ samplemodel如果SampleModels有相同数量的频带对合法之间传送带，对应每个样本的位数相同的号码，和transfertypes是相同的。
    如果obj是非空的，它应该是一个原始的阵列式transfertype。否则，抛出ClassCastException。一个对象的大小时抛出可能如果坐标不界泛起，或如果obj是非空，不足以容纳像素数据。
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    obj如果非空，其中原始数组返回像素数据。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定像素的数据元素。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标不越界，如果目标太小，容纳的输出。
    
    另请参见：
    
    getNumDataElements()， getTransferType()， DataBuffer， setDataElements(int, int, Object, DataBuffer)
  - getDataElements
```
public Object getDataElements(int x,
                              int y,
                              int w,
                              int h,
                              Object obj,
                              DataBuffer data)
```
    返回指定的矩形中的像素阵列式transfertype像素数据。图像数据的java 2D API的支持，这将是一个databuffer.type_byte，databuffer.type_ushort，databuffer.type_int，databuffer.type_short，databuffer.type_float，或databuffer.type_double。数据可以以填充的格式返回，从而提高了数据传输的效率。一般来说，目标应该通过为零，这样的对象会被自动创建并将正确的原始数据类型。
    下面的代码演示了一个矩形区域的像素数据缓冲器db1传送数据，其存储布局是通过samplemodel sm1描述，对数据缓存db2，其存储布局是通过samplemodel sm2描述。转移通常会比使用GetPixels / SetPixels更有效。
```
samplemodel SM1，SM2；缓冲DB1、DB2；SM2。setdataelements（X，Y，W，H，SM1。getdataelements（X，Y，W，h，null，DB1），DB2）；
```
    使用getdataelements / setdataelements两缓冲/ samplemodel如果SampleModels有相同数量的频带对合法之间传送带，对应每个样本的位数相同的号码，和transfertypes是相同的。
    如果obj是非空的，它应该是一个原始的阵列式transfertype。否则，抛出ClassCastException。一个对象的大小时抛出可能如果坐标不界泛起，或如果obj是非空，不足以容纳像素数据。
    参数
    
    x -最小x坐标的像素矩形。
    
    y -像素矩形的最小y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    obj如果非空，其中原始数组返回像素数据。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    用于指定区域的像素的数据元素。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标不越界，如果目标太小，容纳的输出。
    
    另请参见：
    
    getNumDataElements()， getTransferType()， setDataElements(int, int, int, int, Object, DataBuffer)， DataBuffer
  - setDataElements
```
public abstract void setDataElements(int x,
                                     int y,
                                     Object obj,
                                     DataBuffer data)
```
    设置从原始数组中指定的DataBuffer型transfertype单个像素的数据。图像数据的java 2D API的支持，这将是一个databuffer.type_byte，databuffer.type_ushort，databuffer.type_int，databuffer.type_short，databuffer.type_float，或databuffer.type_double。数组中的数据可能是一个封装的格式，从而提高了数据传输的效率。
    下面的代码演示了一个像素传输数据从缓冲db1，其存储布局是通过samplemodel sm1描述，DataBuffer db2，其存储布局是通过samplemodel sm2描述。转移通常会比使用GetPixel / SetPixel更有效。
```
samplemodel SM1，SM2；缓冲DB1、DB2；SM2。setdataelements（x，y，SM1。getdataelements（x，y，null，DB1），DB2）；
```
    使用getdataelements / setdataelements两缓冲/ samplemodel如果SampleModels有相同数量的频带对合法之间传送带，对应每个样本的位数相同的号码，和transfertypes是相同的。
    目标必须是一个原始的数组类型transfertype。否则，抛出ClassCastException。一个对象的大小时抛出可能如果坐标不界泛起，或如果obj是不够容纳的像素数据。
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    obj -原始数组包含的像素数据。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标不越界，如果目标太小，容纳的输入。
    
    另请参见：
    
    getNumDataElements()， getTransferType()， getDataElements(int, int, Object, DataBuffer)， DataBuffer
  - setDataElements
```
public void setDataElements(int x,
                            int y,
                            int w,
                            int h,
                            Object obj,
                            DataBuffer data)
```
    设置从原始数组中指定的类型transfertype DataBuffer矩形像素数据。图像数据的java 2D API的支持，这将是一个databuffer.type_byte，databuffer.type_ushort，databuffer.type_int，databuffer.type_short，databuffer.type_float，或databuffer.type_double。数组中的数据可能是一个封装的格式，从而提高了数据传输的效率。
    下面的代码演示了一个矩形区域的像素数据缓冲器db1传送数据，其存储布局是通过samplemodel sm1描述，DataBuffer db2，其存储布局是通过samplemodel sm2描述。转移通常会比使用GetPixels / SetPixels更有效。
```
samplemodel SM1，SM2；缓冲DB1、DB2；SM2。setdataelements（X，Y，W，H，SM1。getdataelements（X，Y，W，H，空，DB1），DB2）；
```
    使用getdataelements / setdataelements两缓冲/ samplemodel如果SampleModels有相同数量的频带对合法之间传送带，对应每个样本的位数相同的号码，和transfertypes是相同的。
    目标必须是一个原始的数组类型transfertype。否则，抛出ClassCastException。一个对象的大小时抛出可能如果坐标不界泛起，或如果obj是不够容纳的像素数据。
    参数
    
    x -最小x坐标的像素矩形。
    
    y -像素矩形的最小y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    obj -原始数组包含的像素数据。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标不越界，如果目标太小，容纳的输入。
    
    另请参见：
    
    getNumDataElements()， getTransferType()， getDataElements(int, int, int, int, Object, DataBuffer)， DataBuffer
  - getPixel
```
public float[] getPixel(int x,
                        int y,
                        float[] fArray,
                        DataBuffer data)
```
    返回一个浮点数组中指定的像素的样本。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    fArray如果非零，返回这个数组的样品。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定像素的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果farray太小装的输出。
    
    另请参见：
    
    setPixel(int, int, float[], DataBuffer)
  - getPixel
```
public double[] getPixel(int x,
                         int y,
                         double[] dArray,
                         DataBuffer data)
```
    返回在一个数组中指定的像素的样本。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    dArray如果非零，返回这个数组的样品。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定像素的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果darray太小装的输出。
    
    另请参见：
    
    setPixel(int, int, double[], DataBuffer)
  - getPixels
```
public int[] getPixels(int x,
                       int y,
                       int w,
                       int h,
                       int[] iArray,
                       DataBuffer data)
```
    返回一个int数组的一个矩形的像素样本，每一样本的数组元素。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    iArray如果非零，返回这个数组的样品。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定区域的像素的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果iarray太小装的输出。
    
    另请参见：
    
    setPixels(int, int, int, int, int[], DataBuffer)
  - getPixels
```
public float[] getPixels(int x,
                         int y,
                         int w,
                         int h,
                         float[] fArray,
                         DataBuffer data)
```
    返回浮点数组中的像素的矩形的所有样本，每个数组元素的一个样本。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    fArray如果非零，返回这个数组的样品。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定区域的像素的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果farray太小装的输出。
    
    另请参见：
    
    setPixels(int, int, int, int, float[], DataBuffer)
  - getPixels
```
public double[] getPixels(int x,
                          int y,
                          int w,
                          int h,
                          double[] dArray,
                          DataBuffer data)
```
    返回一个双数组中一个像素的矩形的所有样本，一个样本每一个数组元素。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    dArray如果非零，返回这个数组的样品。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定区域的像素的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果darray太小装的输出。
    
    另请参见：
    
    setPixels(int, int, int, int, double[], DataBuffer)
  - getSample
```
public abstract int getSample(int x,
                              int y,
                              int b,
                              DataBuffer data)
```
    返回像素位于指定带样品（x，y）作为int对象的大小时抛出可能如果坐标不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    b -带回来。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定的像素中的指定带中的示例。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。
    
    另请参见：
    
    setSample(int, int, int, int, DataBuffer)
  - getSampleFloat
```
public float getSampleFloat(int x,
                            int y,
                            int b,
                            DataBuffer data)
```
    返回位于（X，Y）作为一个浮动的像素指定的带中的样本。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    b -带回来。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定的像素中的指定带中的示例。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。
  - getSampleDouble
```
public double getSampleDouble(int x,
                              int y,
                              int b,
                              DataBuffer data)
```
    返回位于（X，Y）为双的像素指定的带中的样本。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    b -带回来。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定的像素中的指定带中的示例。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。
  - getSamples
```
public int[] getSamples(int x,
                        int y,
                        int w,
                        int h,
                        int b,
                        int[] iArray,
                        DataBuffer data)
```
    返回在指定的矩形的像素在一个int数组指定带样品，每一样品的数组元素。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    b -带回来。
    
    iArray如果非零，返回这个数组的样品。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定区域的指定区域的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果iarray太小装的输出。
    
    另请参见：
    
    setSamples(int, int, int, int, int, int[], DataBuffer)
  - getSamples
```
public float[] getSamples(int x,
                          int y,
                          int w,
                          int h,
                          int b,
                          float[] fArray,
                          DataBuffer data)
```
    返回浮点数组中指定的矩形像素的指定带的样本，每个数组元素的一个示例。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    b -带回来。
    
    fArray如果非零，返回这个数组的样品。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定区域的指定区域的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果farray太小装的输出。
    
    另请参见：
    
    setSamples(int, int, int, int, int, float[], DataBuffer)
  - getSamples
```
public double[] getSamples(int x,
                           int y,
                           int w,
                           int h,
                           int b,
                           double[] dArray,
                           DataBuffer data)
```
    返回一个指定的带指定的矩形的像素在一个双数组，一个样本每一个数组元素的样本。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    b -带回来。
    
    dArray如果非零，返回这个数组的样品。
    
    data -包含图像数据的数据缓冲区。
    
    结果
    
    指定区域的指定区域的样本。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果darray太小装的输出。
    
    另请参见：
    
    setSamples(int, int, int, int, int, double[], DataBuffer)
  - setPixel
```
public void setPixel(int x,
                     int y,
                     int[] iArray,
                     DataBuffer data)
```
    设置一个像素使用的样本输入一个int数组的数据缓存。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    iArray -在一个int数组的输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果iarray或数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果iarray太小装的输入。
    
    另请参见：
    
    getPixel(int, int, int[], DataBuffer)
  - setPixel
```
public void setPixel(int x,
                     int y,
                     float[] fArray,
                     DataBuffer data)
```
    设置一个像素使用一个样本输入浮点数组的数据缓存。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    fArray -在一个浮点数组输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果farray或数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果farray太小装的输入。
    
    另请参见：
    
    getPixel(int, int, float[], DataBuffer)
  - setPixel
```
public void setPixel(int x,
                     int y,
                     double[] dArray,
                     DataBuffer data)
```
    设置一个像素使用输入的双数组中的样本数据缓存。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    dArray -双阵列的输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果darray或数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果farray太小装的输入。
    
    另请参见：
    
    getPixel(int, int, double[], DataBuffer)
  - setPixels
```
public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      int[] iArray,
                      DataBuffer data)
```
    设置从一个数组的数组元素包含每一个样本像素矩形样品。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    iArray -在一个int数组的输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果iarray或数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果iarray太小装的输入。
    
    另请参见：
    
    getPixels(int, int, int, int, int[], DataBuffer)
  - setPixels
```
public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      float[] fArray,
                      DataBuffer data)
```
    将包含一个数组元素的浮动数组中的每个像素的矩形设置为一个矩形。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    fArray -在一个浮点数组输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果farray或数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果farray太小装的输入。
    
    另请参见：
    
    getPixels(int, int, int, int, float[], DataBuffer)
  - setPixels
```
public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      double[] dArray,
                      DataBuffer data)
```
    将包含一个数组元素的双数组中的一个像素的矩形设置为一个矩形。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    dArray -双阵列的输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果darray或数据为空。
    
    ArrayIndexOutOfBoundsException如果坐标不会越界，或者如果darray太小装的输入。
    
    另请参见：
    
    getPixels(int, int, int, int, double[], DataBuffer)
  - setSample
```
public abstract void setSample(int x,
                               int y,
                               int b,
                               int s,
                               DataBuffer data)
```
    设置指定的带样的像素位于（x，y）用于输入一个int的数据缓存。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    b -带套。
    
    s -输入样本为int型。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。
    
    另请参见：
    
    getSample(int, int, int, DataBuffer)
  - setSample
```
public void setSample(int x,
                      int y,
                      int b,
                      float s,
                      DataBuffer data)
```
    设置指定的带样的像素位于（x，y）用于输入一个浮在数据缓存。此方法的默认实现将输入浮样本int然后调用 setSample(int, int, int, DataBuffer)方法使用int值。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    b -带套。
    
    s -输入样本为一个浮动。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。
    
    另请参见：
    
    getSample(int, int, int, DataBuffer)
  - setSample
```
public void setSample(int x,
                      int y,
                      int b,
                      double s,
                      DataBuffer data)
```
    设置指定的带样的像素位于（x，y）使用一个双输入的数据缓存。此方法的默认实现将输入双样本int然后调用 setSample(int, int, int, DataBuffer)方法使用int值。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x的像素位置的x坐标。
    
    y的像素位置的y坐标。
    
    b -带套。
    
    s -输入样本为双。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException如果数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数没有界限。
    
    另请参见：
    
    getSample(int, int, int, DataBuffer)
  - setSamples
```
public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       int[] iArray,
                       DataBuffer data)
```
    设置指定矩形的像素从一个int数组包含一个样品在每个数组元素指定带样品。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    b -带套。
    
    iArray -在一个int数组的输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果iarray或数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果iarray太小装的输入。
    
    另请参见：
    
    getSamples(int, int, int, int, int, int[], DataBuffer)
  - setSamples
```
public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       float[] fArray,
                       DataBuffer data)
```
    将包含一个数组元素的浮点数数组指定为指定的矩形区域中的样本设置为指定的矩形。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    b -带套。
    
    fArray -在一个浮点数组输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果farray或数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果farray太小装的输入。
    
    另请参见：
    
    getSamples(int, int, int, int, int, float[], DataBuffer)
  - setSamples
```
public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       double[] dArray,
                       DataBuffer data)
```
    将指定的带中的样本设置为指定的矩形，从每个数组元素的一个数组包含一个样本。可如果坐标对象的大小时抛出不界抛出。
    
    参数
    
    x -左上角像素位置的x坐标。
    
    y -左上角像素位置的y坐标。
    
    w -像素矩形的宽度。
    
    h -像素矩形的高度。
    
    b -带套。
    
    dArray -双阵列的输入样本。
    
    data -包含图像数据的数据缓冲区。
    
    异常
    
    NullPointerException -如果darray或数据为空。
    
    ArrayIndexOutOfBoundsException -如果坐标或波段指数不越界，或者如果darray太小装的输入。
    
    另请参见：
    
    getSamples(int, int, int, int, int, double[], DataBuffer)
  - createCompatibleSampleModel
```
public abstract SampleModel createCompatibleSampleModel(int w,
                                                        int h)
```
    创建一个samplemodel描述SampleModel的这个格式的数据，但具有不同的宽度和高度。
    
    参数
    
    w -图像数据的宽度
    
    h -图像数据的高度
    
    结果
    
    一个 SampleModel描述同一图像数据为这 SampleModel，但有不同的尺寸。
  - createSubsetSampleModel
```
public abstract SampleModel createSubsetSampleModel(int[] bands)
```
    创建与这SampleModel的一个子集带一个新的samplemodel。
    
    参数
    
    bands -这 SampleModel带的子集
    
    结果
    
    一个与这 SampleModel波段子集 SampleModel。
  - createDataBuffer
```
public abstract DataBuffer createDataBuffer()
```
    创建一个数据缓冲区，对应于这个SampleModel。DataBuffer的宽度和高度，将这SampleModel的。
    
    结果
    
    对应于这 SampleModel DataBuffer。
  - getSampleSize
```
public abstract int[] getSampleSize()
```
    返回所有带的样本位的大小。
    
    结果
    
    所有波段的样本的大小。
  - getSampleSize
```
public abstract int getSampleSize(int band)
```
    返回指定带的样本数的大小。
    
    参数
    
    band -指定的乐队
    
    结果
    
    指定带的样本的大小。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class SampleModel

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

width

height

numBands

dataType

Constructor Detail

SampleModel

方法详细信息

getWidth

getHeight

getNumBands

getNumDataElements

getDataType

getTransferType

getPixel

getDataElements

getDataElements

setDataElements

setDataElements

getPixel

getPixel

getPixels

getPixels

getPixels

getSample

getSampleFloat

getSampleDouble

getSamples

getSamples

getSamples

setPixel

setPixel

setPixel

setPixels

setPixels

setPixels

setSample

setSample

setSample

setSamples

setSamples

setSamples

createCompatibleSampleModel

createSubsetSampleModel

createDataBuffer

getSampleSize

getSampleSize