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個設定檔。 如果只指定一個意圖,則會用於第一個設定檔,而所有其他設定檔則會使用 Match 意圖來合併。
在 呼叫 CMCreateMultiProfileTransform 完成之後,就可以關閉用來建立色彩轉換的設定檔控制碼。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
標頭 | icm.h |