CMCreateMultiProfileTransform 函式 （icm.h）

接受設定檔陣列或單一 裝置連結設定檔 ，並建立色彩轉換。 此轉換是從第一個設定檔指定的色彩空間到第二個設定檔的色彩空間的對應，依此類推到最後一個設定檔。

語法

HCMTRANSFORM CMCreateMultiProfileTransform(
  PHPROFILE pahProfiles,
  DWORD     nProfiles,
  PDWORD    padwIntents,
  DWORD     nIntents,
  DWORD     dwFlags
);

參數

pahProfiles

指向設定檔控點陣列。

nProfiles

指定陣列中的設定檔數目。

padwIntents

指向轉譯意圖陣列。 每個轉譯意圖都會以下列其中一個值表示：

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

如需詳細資訊，請參閱 轉譯意圖。

nIntents

指定意圖陣列中的意圖數目。 可以是 1，或與 nProfiles 相同的值。

dwFlags

指定旗標以使用控制項建立轉換。 如需詳細資訊，請參閱 CMM 轉換建立旗標。

返回值

如果此函式成功，傳回值是 256 到 65,535 範圍內的色彩轉換。 由於只會保留轉換的低 WORD ，因此有效的轉換不能超過此範圍。

如果此函式失敗，傳回值是值小於 256 的錯誤碼。 當傳回值小於 256 時，表示錯誤，CMM 應該使用 SetLastError 將最後一個錯誤設定為 Winerror.h 中定義的有效錯誤值。

備註

每個 CMM 都需要匯出此功能。

意圖陣列會指定設定檔的組合方式。 第 n個意圖用於組合陣列中的第 n個設定檔。 如果只指定一個意圖，則會將其用於第一個設定檔，而所有其他設定檔則使用比對意圖合併。

在呼叫 CMCreateMultiProfileTransform 完成之後，可以用來建立色彩轉換的設定檔控制碼關閉。

需求

另請參閱

• 基本色彩管理概念
• 函數