共用方式為

checkBitmapBits 函式 (icm.h)

  • 發行項

檢查指定之點陣圖中的圖元是否位於指定轉換的輸出 範圍 內。

語法

BOOL CheckBitmapBits(
  HTRANSFORM    hColorTransform,
  PVOID         pSrcBits,
  BMFORMAT      bmInput,
  DWORD         dwWidth,
  DWORD         dwHeight,
  DWORD         dwStride,
  PBYTE         paResult,
  PBMCALLBACKFN pfnCallback,
  LPARAM        lpCallbackData
);

參數

hColorTransform

要使用的色彩轉換句柄。

pSrcBits

要針對輸出遊戲進行檢查之點陣圖的指標。

bmInput

指定點圖的格式。 必須設定為 BMFORMAT 列舉型別的其中一個值。

dwWidth

指定點陣圖每一掃描行的像素數目。

dwHeight

指定點圖的掃描行數。

dwStride

指定從第一個掃描行開始到下一個掃描行的位元元組數目。 如果設定為零，則會假設位圖掃描行會填補，以便對齊 DWORD。

paResult

要放置測試結果的位元組陣列指標。 此結果緩衝區必須至少包含位圖中有圖元的位元組數。

pfnCallback

CheckBitmapBits 定期呼叫的回呼函式指標，以報告進度，並允許呼叫程式取消位圖測試。 (請參閱 ICMProgressProcCallback) 。

lpCallbackData

例如，傳回呼函式的數據，用來識別所報告進度的點陣圖測試。

傳回值

如果此函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。 如需擴充錯誤資訊，請呼叫 GetLastError。

備註

如果輸入格式與色彩轉換不相容， CheckBitmapBits 函式會失敗。

此函式會將測試的結果放在 paResult 所指向的緩衝區中。 緩衝區中的每個位元組都會對應至位圖中的圖元，且具有介於0到255之間的不帶正負號值。 值 0 表示色彩在 gamut 中，而非零值表示其不是遊戲。 對於任何整數 n，例如 0 <n< 255，結果值 n + 1 表示對應的色彩至少與 n 的結果值相同，

使用浮點 BMFORMAT、BM_32b_scARGB或BM_32b_scRGB時，所檢查的色彩數據不應包含 NaN 或無限大。 NaN 和無限大不會被視為代表合法的色彩元件值，而且檢查包含 NaN 或無限大之像素的結果在色彩方面沒有意義。 處理之色彩數據中的 NaN 或無限大值會以無訊息方式處理，而且不會傳回錯誤。

在 WCS 中建立之 gamut 標籤中的遊戲外資訊會使用CIECAM02中的感知色彩距離，也就是 CIECAM02 Jab 空間中的平均平方根。 舊版 ICC 設定檔遊戲標記中的距離是 CIELAB 空間中的平均平方根。 建議您在可用空間時使用CIECAM02空間，因為它可提供更精確的距離計量。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 icm.h
程式庫 Mscms.lib
Dll Mscms.dll

另請參閱