java.awt.image
類別 PixelInterleavedSampleModel

java.lang.Object
  java.awt.image.SampleModel
      java.awt.image.ComponentSampleModel
          java.awt.image.PixelInterleavedSampleModel

public class PixelInterleavedSampleModel
extends ComponentSampleModel

此類別表示以像素交替方式存儲的圖像資料，其中像素的每個採樣佔用 DataBuffer 的一個資料元素。該類別子類別化 ComponentSampleModel，不過在對像素交替存儲圖像資料的存取方面，它提供的實作比 ComponentSampleModel 提供的要更為高效。此類別在 DataBuffer 的單個存儲單元中存儲所有 band 的採樣資料。還提供了存取方法，這樣就可以直接操作圖像資料。像素跨度是相同掃瞄行上同一 band 的兩個採樣之間的資料陣列元素數。掃瞄行跨度是給定採樣和下一掃瞄行同一列中的對應採樣之間的資料陣列元素數。band 偏移量表示從保存每個 band 的 DataBuffer 存儲單元的第一個資料陣列元素到第一個 band 採樣之間的資料陣列元素數。band 編號從 0 到 N-1。band 索引表示資料緩衝區的存儲單元和圖像資料 band 之間的對應關係。此類別支持 TYPE_BYTE、TYPE_USHORT、TYPE_SHORT、TYPE_INT、TYPE_FLOAT 和 TYPE_DOUBLE 資料型別。

欄位摘要

從類別 java.awt.image.ComponentSampleModel 繼承的欄位

bandOffsets, bankIndices, numBands, numBanks, pixelStride, scanlineStride

從類別 java.awt.image.SampleModel 繼承的欄位

dataType, height, width

建構子摘要

PixelInterleavedSampleModel(int dataType, int w, int h, int pixelStride, int scanlineStride, int[] bandOffsets)
建構一個帶指定參數的 PixelInterleavedSampleModel。

方法摘要

SampleModel	createCompatibleSampleModel(int w, int h) 創建一個具有指定寬度和高度的 PixelInterleavedSampleModel。
SampleModel	createSubsetSampleModel(int[] bands) 創建一個具有此 PixelInterleavedSampleModel 的 band 子集的 PixelInterleavedSampleModel。
int	hashCode() 返回該物件的雜湊碼值。

從類別 java.awt.image.ComponentSampleModel 繼承的方法

createDataBuffer, equals, getBandOffsets, getBankIndices, getDataElements, getNumDataElements, getOffset, getOffset, getPixel, getPixels, getPixelStride, getSample, getSampleDouble, getSampleFloat, getSamples, getSampleSize, getSampleSize, getScanlineStride, setDataElements, setPixel, setPixels, setSample, setSample, setSample, setSamples

從類別 java.awt.image.SampleModel 繼承的方法

getDataElements, getDataType, getHeight, getNumBands, getPixel, getPixel, getPixels, getPixels, getSamples, getSamples, getTransferType, getWidth, setDataElements, setPixel, setPixel, setPixels, setPixels, setSamples, setSamples

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

PixelInterleavedSampleModel

public PixelInterleavedSampleModel(int dataType,
                                   int w,
                                   int h,
                                   int pixelStride,
                                   int scanlineStride,
                                   int[] bandOffsets)

建構一個帶指定參數的 PixelInterleavedSampleModel。通過 bandOffsets 陣列的長度給出 band 數。

參數：

dataType - 存儲採樣的資料型別。

w - 所描述的圖像資料區域的寬度（以像素為單位）。

h - 所描述的圖像資料區域的高度（以像素為單位）。

pixelStride - 圖像資料的像素跨度。

scanlineStride - 圖像資料的行跨度。

bandOffsets - 所有 band 的偏移量。

拋出：

IllegalArgumentException - 如果 w 或 h 不大於 0

IllegalArgumentException - 如果任意 band 之間的偏移量大於掃瞄行跨度

IllegalArgumentException - 如果 pixelStride 和 w 的乘積大於 scanlineStride

IllegalArgumentException - 如果 pixelStride 小於任意 band 之間的偏移量

IllegalArgumentException - 如果 dataType 不是受支持的資料型別之一

方法詳細資訊

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

創建一個具有指定寬度和高度的 PixelInterleavedSampleModel。新的 PixelInterleavedSampleModel 具有與此 PixelInterleavedSampleModel 相同的 band 數、資料存儲型別和像素跨度。可能壓縮 band 偏移量，使得所有 band 偏移量的最小值是 0。

覆寫：

類別 ComponentSampleModel 中的 createCompatibleSampleModel

參數：

w - 所得 SampleModel 的寬度

h - 所得 SampleModel 的高度

返回：

具有指定寬度和高度的新 SampleModel。

拋出：

IllegalArgumentException - 如果 w 或 h 不大於 0

createSubsetSampleModel

public SampleModel createSubsetSampleModel(int[] bands)

創建一個具有此 PixelInterleavedSampleModel 的 band 子集的 PixelInterleavedSampleModel。新的 PixelInterleavedSampleModel 可以與現有 PixelInterleavedSampleModel 一起使用的所有 DataBuffer 一起使用。新的 PixelInterleavedSampleModel/DataBuffer 組合表示的圖像具有原 PixelInterleavedSampleModel/DataBuffer 組合的 band 子集。

覆寫：

類別 ComponentSampleModel 中的 createSubsetSampleModel

參數：

bands - 此 ComponentSampleModel 的 band 子集

返回：

已創建的具有此 ComponentSampleModel band 子集的 ComponentSampleModel。

hashCode

public int hashCode()

從類別 Object 複製的描述

返回該物件的雜湊碼值。支持此方法是為了提高雜湊表（例如 java.util.Hashtable 提供的雜湊表）的性能。

hashCode 的常規協定是：

• 在 Java 應用程序執行期間，在對同一物件多次調用 hashCode 方法時，必須一致地返回相同的整數，前提是將物件進行 equals 比較時所用的資訊沒有被修改。從某一應用程序的一次執行到同一應用程序的另一次執行，該整數無需保持一致。
• 如果根據 equals(Object) 方法，兩個物件是相等的，那麼對這兩個物件中的每個物件調用 hashCode 方法都必須產生相同的整數結果。
• 如果根據 Object.equals(java.lang.Object) 方法，兩個物件不相等，那麼對這兩個物件中的任一物件上調用 hashCode 方法不 要求一定產生不同的整數結果。但是，開發人員應該意識到，為不相等的物件產生不同整數結果可以提高雜湊表的性能。

實際上，由 Object 類別定義的 hashCode 方法確實會針對不同的物件返回不同的整數。（這一般是通過將該物件的內部位址轉換成一個整數來實作的，但是 Java^TM 程式語言不需要這種實作技巧。）

覆寫：

類別 ComponentSampleModel 中的 hashCode

返回：

此物件的一個雜湊碼值。

另請參見：

Object.equals(java.lang.Object), Hashtable